Your hold Ring and watch keys
A hold Ring is a Privacy Ring for one coin, derived from your wallet. You give Ring Yield its watch keys so the keeper can see the bag and whether it was spent, and nothing more.
The three keys
| Key | Who holds it | What it can do |
|---|---|---|
| Spend (signing) key | Your browser, from your wallet signature | Move the bag. Never leaves you. |
| Viewing key | You and the keeper | Decrypt the notes the Ring receives: asset, amount, memo. |
| Nullifier key | You and the keeper | Compute each note's nullifier to see whether it was spent. |
Why two keys
A viewing key alone cannot tell spent from unspent notes: a nullifier is Poseidon(utxo_hash, blinding, nullifier_secret). With only the viewing key the keeper would keep paying people who already sold. With the viewing key and the nullifier key it runs the normal sync and gets every note with its spent flag. Spending still needs the signing key and a proof, and the signing key never leaves your browser. The SDK builds exactly this holder: LocalShieldedKeys.fromKeys({ address, viewingKeys, nullifierKey }).
Derivation
seed = sha256(wallet signature over "Ring Yield: open my hold Rings\n<wallet>")
hold seed = sha256(seed || "hold" || <coin mint>)
hold Ring = ShieldedKeypair.fromKeypair(SigningKey.fromEd25519Bytes(hold seed))The same wallet always gets the same hold Ring for the same coin. Delegation covers that Ring only, never your main Ring.
Opening one
- Connect a wallet and paste the coin's mint.
- Sign once to derive the hold Ring.
- Register it: a permanent User Registry record, 0.00115824 SOL of rent.
- Move the bag in by private transfer from your Ring, or by deposit from your wallet (a deposit's amount is public).
- Seal the watch keys to the keeper's public key in your browser and submit them.