covr.Docs

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_nonce and begin at or above it.
  • You answer every award with a quote or award_decline.
  • You treat OutcomeUnknownError as a possibly live quote.
  • You reconnect with backoff after every closed event.

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.