Skip to main content

Diagrams

Payments in diagrams

Public payments from your wallet and private payments on Aztec, from the key to the fee, drawn step by step.

Private payments run on Aztec Alpha with a cap per payment. The contracts have had an internal security review, not an external audit.

From your wallet

A public payment

Your deviceYour walletEVM chainTheir deviceBuilds the transaction with wagmi and viemSign, EIP-1193 or WalletConnectSigned transactionConfirmationReceipt, inside the conversation
A public payment. Our server never receives a signing key; the transaction is public on its chain.
Mermaid source
Mermaid
sequenceDiagram
  participant D as Your device
  participant W as Your wallet
  participant C as EVM chain
  participant B as Their device
  D->>D: Builds the transaction with wagmi and viem
  D->>W: Sign, EIP-1193 or WalletConnect
  W->>C: Signed transaction
  C-->>D: Confirmation
  D->>B: Receipt, inside the conversation

Asking to be paid

Payment requestEIP-681 URIQR codeThe payer's walletfills in the transaction
Payment requests as EIP-681 links, shown as QR codes.
Mermaid source
Mermaid
flowchart LR
  Req[Payment request] --> URI[EIP-681 URI]
  URI --> QR[QR code]
  QR --> W[The payer's wallet<br/>fills in the transaction]

Your private wallet

Your private account

Your walletSignatureAccount secretSchnorr accountcontract on AztecOur serverEIP-712 signatureHKDF-SHA256never sentsame wallet, any device
Where the private account comes from. The same wallet always recovers the same account, and no server holds a spending key.
Mermaid source
Mermaid
flowchart LR
  W[Your wallet] -->|EIP-712 signature| Sig[Signature]
  Sig -->|HKDF-SHA256| Sec[Account secret]:::accent
  Sec --> Acc[Schnorr account<br/>contract on Aztec]
  Sec -.->|never sent| Srv[Our server]:::muted
  W -.->|same wallet, any device| Acc

Proving on your device

Your browserPrivate eXecution EnvironmentEncrypted storeProverAztec nodeproof onlyencrypted notes
The PXE runs in your browser: it decrypts your notes and generates proofs on the device. The node receives proofs, not your balances.
Mermaid source
Mermaid
flowchart LR
  subgraph dev [Your browser]
    PXE[Private eXecution Environment]:::accent
    Store[(Encrypted store)]
    Prover[Prover]
  end
  PXE --> Store
  PXE --> Prover
  Prover -->|proof only| Node[Aztec node]
  Node -->|encrypted notes| PXE

Checking the network

Before any stepthat moves valueRead the node's identityL1 chain, rollup versionand address, Fee Juice portal, tokenSame as the pinsin this build?ContinueRefuse this nodeyesno
A node that is not the expected network is refused before anything moves.
Mermaid source
Mermaid
flowchart TB
  Start[Before any step<br/>that moves value] --> Read[Read the node's identity]
  Read --> F[L1 chain, rollup version<br/>and address, Fee Juice portal, token]
  F --> C{Same as the pins<br/>in this build?}
  C -->|yes| Go[Continue]:::ok
  C -->|no| Stop[Refuse this node]:::danger

Notes and nullifiers

A paymentNew noteencrypted to its ownerNote commitmentsSpending a noteNullifier publishedNullifier setA note cannot bespent twicePrivacy keptdoes not say which note
Notes and nullifiers. A balance is a set of private notes; spending one publishes a nullifier that stops double spending without pointing at the note.
Mermaid source
Mermaid
flowchart LR
  Pay[A payment] --> Note[New note<br/>encrypted to its owner]:::accent
  Note --> T[(Note commitments)]
  Spend[Spending a note] --> Nul[Nullifier published]
  Nul --> NS[(Nullifier set)]
  NS --> No[A note cannot be<br/>spent twice]:::ok
  Nul -.->|does not say which note| Priv[Privacy kept]:::ok

Paying someone in a chat

A private payment

SenderThe conversationAztec AlphaReceiver1Its Aztec address, signed with its account key2Checks that signature again before moving value3Builds transfer_private_to_private and proves it4Proof and encrypted noteChecks the proof, amount and recipient stayprivate5Syncs6The new note, found because the sender is registered
A private payment between two people in a direct message. It goes only to the address the other person announced in that conversation.
Mermaid source
Mermaid
sequenceDiagram
  autonumber
  participant A as Sender
  participant X as The conversation
  participant N as Aztec Alpha
  participant B as Receiver
  B->>X: Its Aztec address, signed with its account key
  A->>A: Checks that signature again before moving value
  A->>A: Builds transfer_private_to_private and proves it
  A->>N: Proof and encrypted note
  Note over N: Checks the proof, amount and recipient stay private
  B->>N: Syncs
  N-->>B: The new note, found because the sender is registered

Before a payment

AmountUnder the capfor this token?RefusedSender acknowledges: internalreview only,the fee payer is publicSend privatelynoyes
Limits during the closed alpha: a cap per token, and an explicit acknowledgement before the first payment.
Mermaid source
Mermaid
flowchart LR
  Amt[Amount] --> Cap{Under the cap<br/>for this token?}
  Cap -->|no| Ref[Refused]:::danger
  Cap -->|yes| Ack[Sender acknowledges: internal review only,<br/>the fee payer is public]
  Ack --> Send[Send privately]:::ok

Fees

Paying fees

AZTEC on EthereumFeeJuicePortalClaim secret fromthe wallet signatureClaim, in the transactionthat deploys the accountFee Juice balancePays every feeThe account is thevisible fee payerone way
Fee Juice. Every transaction, including the one that creates the account, pays its own fee; Ledger Chat sponsors none.
Mermaid source
Mermaid
flowchart TB
  E[AZTEC on Ethereum] -->|one way| Portal[FeeJuicePortal]
  Sec[Claim secret from<br/>the wallet signature] --> Claim
  Portal --> Claim[Claim, in the transaction<br/>that deploys the account]
  Claim --> FJ[Fee Juice balance]
  FJ --> Fee[Pays every fee]
  Fee -.-> Pub[The account is the<br/>visible fee payer]:::muted

A contact pays the first fees

New personA contactEthereumAztecLink with an Aztec address and the hash of a claimsecretDeposit AZTEC for that addressPublic: the contact, the Aztec address and theamountClaims it with the secret
A contact can pay the first fees for someone who holds no AZTEC. Only the recipient can claim the deposit, and the deposit is public on Ethereum.
Mermaid source
Mermaid
sequenceDiagram
  participant N as New person
  participant C as A contact
  participant E as Ethereum
  participant A as Aztec
  N->>C: Link with an Aztec address and the hash of a claim secret
  C->>E: Deposit AZTEC for that address
  Note over E: Public: the contact, the Aztec address and the amount
  N->>A: Claims it with the secret