How Saturn works

A buy holds HYPE and asks for at least a number of coins. A sell holds coins and asks for at least an amount of HYPE. Both name one pool, the price you set and how long the order is good for: an hour, a day, a week or a month.

The limit price in the app is turned into that minimum. A buy of 10 HYPE at 0.001 HYPE per coin asks for at least 9,980 coins (10 HYPE less the 0.2% fee, divided by the price).

fill(id) swaps the whole order, exact input, in its own pool, and checks what came out by the book's balance. If the owner would get less than the minimum, it reverts and the order stays open. If the pool pays more, all of it goes to the owner.

Anyone can call it. Saturn's filler tries every open order every 15 seconds and sends the ones that pass. It is paid half of the fee.

The owner can cancel(id) at any time: a buy returns all its HYPE including the fee set aside, a sell returns its coins. After the expiry anyone can call it, and the funds still go only to the owner. The filler does this for expired orders.

Uniswap v4 pools on Elysium's pool manager with any hook (Montra, Ascend, Volta, Kleos and the rest), and HYPE pools on KleosSwap, ElysPump and Stockium v3. A v4 pool must exist in the manager; a v3 pool must be the one its factory returns. Each pool is added once, by whoever places its first order.

HYPE can be native or one of Elysium's two wrapped HYPE tokens; the book wraps and unwraps itself.

• No owner on funds. The contract owner can only add pool managers, v3 factories and wrapped HYPE to the allowlist. Nothing moves an order's funds except its fill or its refund.
• Payment caps. During a fill the pool can be paid at most the order's own amount, and only the order's pool can call back.
• Measured output. What the owner gets is counted from the balance, so coins that tax transfers can't make an order look filled.
• Not audited. Tested on forks of Elysium against real pools of every venue above.

Elysium, chain id 99901.