Dark Ring Docs
FeesOpen app

Your Ring and dark orders

If you're an LLM, read llms.txt

How 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

ver1 B
side1 B
mint32 B
limit u648 B
expiry u324 B
nonce u648 B
54 bytes, little-endian. Written into the memo of the engine's UTXO and encrypted to the engine's viewing key.
FieldTypeMeaning
versionu81
sideu80 buy, 1 sell
mint32 bytesthe pump.fun coin
limitu64lamports per whole token, times 10^9; 0 means no limit
expiryu32unix seconds, UTC
nonceu64chosen 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

PublicEncrypted
Order transferyour Ring address, the engine's, the timecoin, amount, side, limit, expiry
Net tradecoin, size, price, the engine as traderwhich orders it carries
Fill payoutrecipients, the timeamounts, for 24 hours