Start here
Nagare vests tokens on Starknet without putting either party on a public ledger. Everything else in these docs follows from the idea on this page. Read it before you move any money.
The idea
A vesting schedule usually belongs to an address. Yours funds it, theirs receives it, and anyone reading the chain can pair the two, for as long as the chain exists.
In Nagare a schedule belongs to a key. When you open one, your browser derives a Stark curve keypair from your wallet, and the contract stores the public half. Withdrawing, cancelling, re-keying and selling are signatures from that key, rather than transactions sent from your address. The money itself moves through the STRK20 privacy pool: the pool pays Nagare to fund a schedule, and Nagare pays the pool when someone withdraws.
Your wallet still signs the outer transaction, and it still pays the fee. It never appears beside the other party.
The two keys on every schedule
- The sender key can cancel, which returns whatever has not vested. A schedule opened as uncancelable has no usable sender key at all.
- The recipient key can withdraw what has vested, hand the schedule to a different key, and open it to offers.
Whoever holds a key is the sender or the recipient. There is no account and no login. A browser reaches a schedule when it can rebuild the key, and is locked out otherwise. Keys and recovery covers what that means in practice.
What it costs
The STRK20 pool charges 6 STRK for each private transaction, taken from your shielded balance, on top of the ordinary Starknet fee your wallet pays. Funding a schedule costs that once. Every withdrawal, cancel, transfer and sale costs it again.
What you need
- A Starknet wallet that supports STRK20 private balances. Nagare is built against Ready.
- Private balances turned on in that wallet.
- Enough shielded STRK to cover the amount you are vesting plus the pool fee.
A recipient needs none of this on the day you set the schedule up. They need a wallet by the time they want to withdraw.
Read next
- Sending tokens if you are the one funding a schedule.
- Receiving tokens if someone sent you a claim link.
- Keys and recovery before you close the browser tab.
- Reference for the contract, the disclosure table, and what to do when something fails.