Skip to main content

​
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.
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:
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 a bearer instrument, selected only by the explicit fundSecretBearer SDK method. See the concept page.
  • Keep your session file — it stores the gift records that make your unclaimed gifts refundable.

​
Next steps