Guides
Go-live checklist
Work through this before your desk goes live. Desks cannot win customer orders yet (see Status today), so use the time to test what practice mode cannot reach.
Keys
- Your quote key lives in a KMS or HSM, and your adapter matches every golden vector.
- Your authority is in cold or well-guarded storage. It is needed for setup, deposits, withdrawals,
configureMaker, re-enabling a paused policy, and exercise (unless an operator exercises). - Optional: an operator key, set with
configureMaker, exercises so the authority can stay offline. - Your gateway token is stored as a secret, never in code or logs.
On chain
- All eight setup steps are finalized.
- Your exposure, mint policy caps and premium budget match the risk you want. The premium limits cap what forged fills from a leaked quote key could cost; forged early closes stop only when you retire the key.
- Your vault holds enough USDC for the premiums you expect, plus the strikes you plan to pay, or a tested top-up plan, or a flash policy with a tested swap route (Flash exercise).
- Your authority's JitoSOL token account exists, for exercise deliveries (setup step 8).
Quoting
- Your pricing replaced the example's stub.
- Bids use
exactPriceAtOrBelow, so every premium is a whole USDC atom. - Every nonce is journaled durably before its quote is signed, and only one process writes each journal.
- On start you read
min_nonceand begin at or above it. - You answer every award with a quote or
award_decline. - You treat
OutcomeUnknownErroras a possibly live quote. - You reconnect with backoff after every
closedevent.
Fills and expiry
- A reconciler finds fills on chain, because the gateway sends no fill message.
- An exercise job runs at each market's expiry and lands inside the window, which can be as short as 60 seconds.
- The exercise job uses
exerciseV3Instructions, which creates fresh customer token accounts and sets the compute limit in the same transaction. The expiry keeper example is a starting point.
Emergencies
- Your mint policy names a watcher key, kept hot, so you can pause without the authority. Set it at setup: changing it later needs your authority.
- You have rehearsed pausing the policy and raising
min_nonce, and know who holds the authority at 3 a.m. - You alert on gateway disconnects, refused bids, unresolved quotes and a low vault balance.
- You ran in practice mode for at least a day with no unexplained refusals.
- You tested what practice mode cannot reach: awards, quotes, your journal, fill detection and exercise. See Practice mode.