Claimable Transfers (Gifts)
Send shielded funds to an Ethereum wallet address that has not registered with
Privacy Boost yet, and reclaim the funds if they go unclaimed. See
Claimable Transfers for the concept and
trust model.
Preview feature — pending external audit, and enabled per deployment. All
commands below require an authenticated session (run privacy-boost login
first, or pass --private-key).
Funding a gift
When you know the recipient’s wallet but they have not joined Privacy Boost, use
gift-fund-to-wallet. The refund block is a height after which you can reclaim an
unclaimed gift; the allowed range is advertised from the server’s /info.
Output:
Share the claim link with the recipient out of band. Treat it like a
password — it reveals the amount and recipient to anyone who reads it.
If the recipient is already a Privacy Boost user, include their privacy address
with gift-fund so the ciphertext is sealed to their viewing key:
Funding parameters
The gift binds irrevocably to --recipient-wallet. The CLI shows the
checksummed address and asks you to confirm; a wrong-but-valid address can be
claimed by whoever owns it, and only an unclaimed gift is refundable.
Claiming a gift
List the pending gifts addressed to your wallet:
Output:
Claim one by its index in that list. --acknowledge-unknown-sender is required —
the hidden-sender model cannot reveal who funded the gift, so you explicitly
accept funds from an unknown sender:
Or claim straight from a claim link, without listing first:
Refunding an unclaimed gift
A claim and a refund spend the same nullifier, so only one can settle. After the
refund deadline, reclaim using the saved record’s index in your local gift ledger
(persisted in your session file, in the order you funded them):
If you no longer have the local record, refund by supplying every field manually:
Previewing a claim link offline
Decode and decrypt a claim link into a preview, with no network call:
Notes
- The secret-bearer funding mode is intentionally not exposed in the CLI; it
is experimental and a bearer instrument. See the
concept page.
- Keep your session file — it stores the gift
records that make your unclaimed gifts refundable.
Next steps
