The parts
A Decom guardian is a node that holds a share of the disclosure key. It is not a Palliora Guardian. Palliora Guardians have a different job: they protect the stored report. See Accountable privacy and disclosure and Palliora integration.
Life of a private transaction
- Create and register your account. Your wallet signs a fixed message. The app turns the signature into your keys. You then register, which links your public address to your shielded address so others can send to you. See Shielded accounts.
- Deposit. Tokens move from your wallet into the pool. A proof creates notes worth that amount. You pay gas for this step from your wallet, so it is public.
- Settle. New notes join the commitment tree after the next tree update. A tree update is a proof that anyone can submit, and the app does it for you. Until then the balance shows as pending. See Notes and commitments.
- Send, swap or withdraw. You spend notes. The proof shows the notes exist, you own them, the value adds up, and the new notes are correct. The transaction reveals a nullifier for each spent note and a commitment for each new one, and nothing else about them. A relayer submits it. See Shielded transactions and Relaying and gas.
- Call another protocol, if you want. For a swap, a loan or a stake, the pool sends the tokens to an adaptor, the adaptor calls the other protocol, and the result comes back to you as new notes. See Adaptors.
- Disclose, only when needed. Every transaction includes an encrypted seed. A revoker and a threshold of Decom guardians can de-anonymize it together. No one of them can do it alone. The revoker then keeps what it de-anonymized on Palliora, as an encrypted report. The revoker, or any third party the revoker grants access to, can open it. See Palliora integration.
What the public sees
Privacy is as strong as the number of other people using the pool. Read the Privacy model for what this means in practice.
Where to go next
- Concepts for each part in detail.
- Quickstart to send a private transaction yourself.
- Network reference for contract addresses.