Your Ring and dark orders
If you're an LLM, read llms.txtHow your Ring key is opened, what an order contains, how limits and expiry work, and what other people can see.
Your Ring key
Your wallet signs one plain-text message twice. The two signatures must match; the SHA-256 of the signature is the Ed25519 seed of your Ring key. The key lives in the tab's memory and opens the same Ring on every visit. The message names this site's domain, so the key cannot be phished by another site asking for the same signature. Phantom, Solflare and Backpack all sign it.
Your Ring must be registered in the Privacy Rings registry before it can receive fills: a transfer to an unregistered address becomes a public withdrawal, so the engine refuses orders from unregistered senders. Registration is one transaction from your wallet, made before your first order.
Order layout
| Field | Type | Meaning |
|---|---|---|
| version | u8 | 1 |
| side | u8 | 0 buy, 1 sell |
| mint | 32 bytes | the pump.fun coin |
| limit | u64 | lamports per whole token, times 10^9; 0 means no limit |
| expiry | u32 | unix seconds, UTC |
| nonce | u64 | chosen by the client, makes each order unique |
The order is written with ProofOutputUtxo.withMemo(bytes) on the engine's output; the engine reads it back from the decrypted UTXO data. Where a wallet's transaction path cannot carry the memo, the same 54 bytes are sealed to the engine's X25519 key and posted to /api/order with the Ring transfer's signature, signed by your Ring key. Same privacy; the engine matches the two by signature.
Limits and expiry
A buy with a limit fills only when spot is at or below it; a sell only when spot is at or above it. A limit order waits through as many windows as it needs, hidden, until spot meets it or it expires. Expiry runs from 1 minute to 24 hours in the order ticket.
Refunds
At expiry, the engine sends what you sent back into the same Ring by private transfer. A buy refunds in SOL. A sell refunds the coin.
What is visible
| Public | Encrypted | |
|---|---|---|
| Order transfer | your Ring address, the engine's, the time | coin, amount, side, limit, expiry |
| Net trade | coin, size, price, the engine as trader | which orders it carries |
| Fill payout | recipients, the time | amounts, for 24 hours |