covr.Docs

Users: contract design

Admin and upgrade powers

What covr can change, what a maker can change, and what stays fixed in your position.

The program can be upgraded

covr can upgrade the program. The program is deployed under Solana's upgradeable loader, so its code can be replaced at the same address. The program has no other admin instruction: there is no covr key that can move tokens out of a position, change a position's terms or skip a check.

What an upgrade could change

An upgrade replaces the program's logic for every transaction after it lands. That includes transactions on positions that are already open. In particular, a new version could:

  • change any check, deadline or formula on this site;
  • change how an existing position's recorded terms are read and enforced;
  • add new instructions, including ones that act on existing accounts.

What an upgrade cannot change

  • Anything already settled. Premiums already in your wallet, completed exercises, releases and early closes are final token transfers. An upgrade cannot reverse them.
  • Past transactions. The record of every fill and exit stays on chain.
  • Your position's stored data, on its own. The terms recorded at fill stay in the position account until an instruction writes to it. No current instruction rewrites them: the only fields that ever change after fill are the state, the writer (by transfer or sale, signed by you) and, for tokenized-stock positions, the funding fields.
Recorded at fill and never rewritten by the current program
Partiesmaker, maker owner key, maker quote key
Marketmarket address, terms id, asset fingerprint, network and deployment ids
Tokensasset and payment mints, their token programs and decimals
AmountsQ, G and T
Datesopened_at, expiry and exercise window
Accountsthe position's vault and escrow addresses, the maker's policy and usage addresses
Noncethe maker's quote nonce

These protections hold for the program described on this site. A future version reads the same accounts and could treat them differently. What stands between an upgrade and your open position is how covr upgrades: every change is reviewed and tested, and upgrades are rehearsed locally against the live program's bytes, with synthetic test positions. See Guarantees. You can check which code is live yourself; see Program facts.

How upgrades are announced

covr announces program upgrades on X at @covrdotfun. To see exactly which build is running at any moment, check the deployed program yourself: see Program facts.

Market controls

Each market is created once, by any wallet. Its creator can do exactly one thing afterwards: pause or unpause it. covr's app lists only markets made by creator keys that covr pins, so for those markets the creator is covr. Addresses lists them.

InstructionSignerEffect
set_market_v3_pauseThe market's creatorCovered-call markets
set_restricted_market_v3_pauseThe market's creatorTokenized-stock markets
set_market_v3x_pauseThe market's creatorPut markets

What a pause blocks: new fills on that market, and sales of positions on that market to a maker's desk.

What a pause does not block: exercise, flash exercise, release, early close, transfer, close, and tokenized-stock funding, delivery and cancel. None of them read the pause flag.

Every other market field is fixed at creation: asset, payment token, strike, expiry, exercise window, size cap, fee rate and fee owner. No instruction changes them. The pause flag is also the only market field left out of the maker's signing domain, so pausing does not invalidate signed quotes; it only stops them from filling while paused.

Maker controls

Each maker controls its own settings with its own keys. None of them can touch your locked tokens or disable release after the deadline. Some do reach other paths, as the table shows: the nonce floor cancels early-close quotes and decides when a settled position's account can be closed, and the flash policy decides whether flash exercise can run.

Maker actionSignerEffect on you
Raise the nonce floor (configure_maker)Maker owner keyCancels every unfilled quote, early-close quote and sale quote that maker signed below the new floor. They fail with InvalidOrder. Also lets you close settled positions with a lower nonce. The floor can never go down.
Change the operator (configure_maker)Maker owner keyChanges which second key may exercise. The operator cannot withdraw or change settings.
Pause its mint policy (pause_mint_policy_v1, pause_mint_policy_v2)Maker owner key, or the policy's watcher keyStops new fills by that maker on that asset. Exits are not affected.
Update its mint policy, exposure limit or premium budgetMaker owner keyCan stop new fills by that maker. Exits are not affected.
Turn flash exercise off or change its limits (update_flash_exercise_policy_v1, disable_flash_exercise_policy_v1, and the put equivalents)Maker owner keyChanges only whether the maker can use flash exercise. Ordinary exercise still works, and you are paid the same either way.
Withdraw its USDC vault (withdraw) or put asset vault (withdraw_put_asset_v1)Maker owner keyThe program does not reserve the maker's exercise payment. If the maker cannot pay at exercise, exercise fails and you get your full locked amount back by release after the window. You keep the premium.

What no one can do under the program's rules

  • Settle your locked tokens to anyone except you or, at a valid exercise, the maker in your position against full payment. In a flash exercise, an outside swap route may spend exactly your locked amount first, but the transaction succeeds only if you are paid in full.
  • Change your position's strike, quantity, premium, expiry or exercise window.
  • Disable release after the exercise window with a pause or a setting. Release needs no signature and pays only you. It still needs the token transfers to work, and a tokenized-stock position the maker has funded ends by delivery or a joint cancel instead.
  • Exercise outside the window, or exercise part of a position.

Two limits sit outside the program. A token's issuer may be able to freeze accounts: USDC and USDT can, and tokenized-stock issuers can also move or pause their tokens. A put escrow frozen by its issuer must be thawed before release can return your funds. And an upgrade can change the program itself, as described above. See Risks.