Overview
What Hadal is, what you hold in it, the three ways an order fills, and where each task is documented.
Hadal is a spot trading venue on Solana. A dark pool, an AMM and an OTC desk on Solana that share one sealed book. Every order is encrypted in the wallet and matched inside Arcium’s MPC cluster, so size, side and price stay unseen until the trade is done.
These docs are for two readers: someone trading on Hadal through the app, and someone building on it with the SDK, the HTTP API or the program itself. Every task has a guide, and every value the product defines is in the reference.
What you hold
You deposit a market's two tokens and from then on hold a sealed balance. The chain stores it as ciphertext that the cluster computes on and that you alone read. Everything you do after the deposit moves that balance and nothing public. Sealed balances tells it in full.
You read your own balances, orders and receipts with the reading key, which your browser derives from one wallet signature. See The reading key.
One order, three ways to fill
A sealed order is one encrypted intent. The order ticket sends it one of three ways.
| Way | Use it to | How it fills |
|---|---|---|
Swap | Trade now | Crosses the book at the pool’s mid, then sweeps the curve for the rest, inside the limit. |
Dark order | Trade size at the mid | Rests in the sealed book and fills only by crossing. No price impact. |
Deal | Trade a block with one party | One counterparty, two sealed limits, the midpoint if they cross. |
- 01Seal
- 02Queue
- 03Cross
- 04Sweep
- 05Rest
- 06Receipt
- 07Sounding
The mechanism of each step is in Sealed orders, the price they share in The book and the pool's mid, and the desk in Deals.
What the chain sees
Once a minute a market prints the pool’s price and the minute’s volume on chain. Nothing else is printed. Between soundings the chain sees deposits, withdrawals, and that a wallet acted. What is sealed and what is seen lists it action by action.
Where to go
The terms
Each term is defined once here and used with this meaning on every page.
| Term | Meaning |
|---|---|
Sealed order | One encrypted order that crosses the book, sweeps the pool or meets one counterparty. Nobody can read it, the team included. |
Sealed balance | What a trader holds in a market after depositing: ciphertext only the cluster can compute on and only the trader can read. |
Market | A pair of two tokens with its own vaults, pool and book. |
Pool | The liquidity that prices every trade in a market and fills what the book cannot. |
Book | The resting orders of a market, sealed. |
Cross | Two orders meeting in the book at the pool’s mid, with no price impact. |
Sweep | The rest of an order trading against the pool’s curve, inside its limit. |
Rest | An order waiting in the sealed book until another order crosses it. |
Deal | A trade with one counterparty at the midpoint of two sealed limits. When they don’t cross, nothing but “No deal” is revealed. |
Receipt | The result of an order, encrypted to its owner: filled, average price, resting. |
Sounding | Once a minute a market prints the pool’s price and the minute’s volume on chain. Nothing else is printed. |
Reading key | The key that reads your sealed balances and receipts, derived in the browser from one wallet signature. |
The surface | The public chain. |
Below | What Hadal holds sealed. |