Concepts

What the chain shows

Pook's transactions are ordinary Solana transactions, and anyone can open one in an explorer. This page lists what each kind shows and what it leaves out. The run feed shows the same thing live: every run as an observer sees it.

A run

A run through jupiter.swap, as an explorer shows it
Fee payer
The relayer
Program
pook, instruction run
Hook
The hook account for jupiter.swap
Called
Jupiter, with the route’s pools
Asset and amount in
Shown
Asset and amount out
Shown
Fees
Shown, each with its recipient
Holder

In full, a run's transaction shows:

  • The relayer, as fee payer.
  • The hook, by its account address, and the program it calls.
  • The call: the instruction data sent to the protocol and every account passed to it. For a swap that is the route.
  • The asset and amount in, as a withdrawal from the Solana Privacy Program to Pook's stage.
  • How many notes were spent, one or two, as their nullifiers. A nullifier does not say which note it spends.
  • What the protocol returned, as the balance that arrived in the stage.
  • The fees: the run fee's two parts and the relayer's fee, each as a transfer to its recipient.
  • The deposit: the asset and amount that became your new note, and that note's one-time owner hash.
  • The change note, as a hash and a ciphertext.

It does not show a wallet. The spent notes, the change note and the new note are all owned through Pook's authority and all carry its address as their tag, the same for every holder. The one-time owner hash of the new note is used once and is derived from a secret only you hold.

What stays encrypted: which notes were spent, how much the change is, and what the holder's balance was before or is after.

Entering

Entering from a public wallet is a deposit, and a deposit is public.

Entering from a public wallet
Signer
Your wallet
Program
pook, instruction enter
Asset and amount
Shown
New note
A one-time owner hash, tagged with Pook’s authority

The chain shows that your wallet moved this amount of this asset into Pook. From there on, the note it created is one among all holders' notes.

Entering from a Rings private balance is a private transfer inside Rings. Your Rings wallet signs it. The amount and the asset are encrypted, and one of its outputs carries Pook's tag.

Leaving

Leaving is a spend with no hook. A relayer submits it.

Leaving to a public address
Fee payer
The relayer
Program
pook, instruction leave
Asset and amount
Shown
Destination
The public address you chose
Relayer’s fee
Shown
Holder

The destination is whatever address you give. It does not have to be the wallet you entered from, and the transaction does not name that wallet.

Leaving to a Rings private balance deposits the amount to the Rings address you name. The chain shows the asset, the amount and that Rings address.

A seat

A seat is public by design: the protocol has to see its position.

ShownNot shown
The seat's address and its state accountWho holds the seat note
The position the protocol records for the seat: collateral, debt, each change to itThe wallet behind any run on the seat
Every run on the seat, with its hook, asset and amountThe balance the collateral came from, and where a borrowed asset goes after it becomes a note
The relayer that opened the seat

Publishing and claiming

Publishing a hook and claiming an author's share are signed by the author's own wallet. The chain shows the author's address on the hook and on each claim. Authors are public: the registry lists every hook with its author.