covr.Docs

Program reference

Program overview

This section is the reference for covr's covered-call program on Solana mainnet, as a market-making desk uses it. It lists every account your desk owns or reads, every instruction you sign or depend on, and every error you can get back.

Since 4 November 2026 the same program also runs cash-secured puts. Desks cannot quote puts yet, and @covrfun/maker-sdk 0.1.1 has no put support. The put instructions, accounts and errors are listed for reference: start at Cash-secured puts.

What the program does for a desk

  1. It keeps your USDC in one vault that only the program can move, and it records each call you buy as a position account.
  2. When a customer fills one of your signed quotes, it pays the premium from your vault (the customer gets it minus the market fee) and locks the customer's collateral (JitoSOL) in a vault owned by the position.
  3. From expiry until the exercise window closes, your authority or operator can exercise: the program pays the strike from your vault to the customer and sends the collateral to your authority's token account. With a flash policy, it can instead sell the collateral inside the same transaction and pay the strike from the proceeds. See Flash exercise.
  4. Once the window has closed without an exercise, anyone can release the collateral back to the customer, and your position ends with nothing returned.
  5. Every fill is checked on chain against your quote signature, your nonce floor and the limits you set on your own accounts.
Note

Desks receive covr's RFQs and can bid on them today, but cannot win yet. covr's markets list only covr's own maker, so your bids are verified and then refused ("practice mode"). Listing other desks is planned engineering work. The on-chain rules on these pages apply from your first real fill.

Your accounts

A desk has one Maker account per quote key. Everything else hangs off it.

AccountOne perSeedsCreated byWhat it holds
Makerquote key"maker", quote key address (20 bytes)register_maker_v3Your Solana authority, optional operator and nonce floor (min_nonce).
MakerOriginV1Maker"maker-origin-v1", Makerregister_maker_v3Your registration record. Every fill passes it.
USDC vaultMaker"stable", Maker, USDC mintinitialize_vaultYour USDC. An SPL token account whose owner is the Maker PDA.
PremiumBudgetMaker"premium-budget", Maker, USDC mintinitialize_vaultOptional lifetime cap on gross premium paid.
ExposureMaker and collateral mint"exposure", Maker, mintinitialize_exposure_v3Cap on open collateral atoms across all markets of that mint.
MintPolicyV1Maker and collateral mint"mint-policy", Maker, mintinitialize_mint_policy_v1Per-mint caps and the market terms you accept.
MintUsageV1Maker and collateral mint"mint-usage", Maker, mintinitialize_mint_policy_v1, then bootstrap_mint_usage_v1Running totals the caps are checked against.
MarketV3creator and salt"market-v3", creator, salt (u64 LE)create_market_v3One market's immutable terms. Any wallet can create one.
PositionV3Maker and nonce"position", quote key address, nonce (u64 LE)fill_v3 (the customer pays the rent)One filled quote: size, premium, strike, expiry, current writer.
Position collateral vaultposition"collateral", positionfill_v3The customer's locked collateral.
FlashExercisePolicyV1Maker and mint pair"flash-policy-v1", Maker, collateral mint, USDC mintinitialize_flash_exercise_policy_v1Optional. Lets you flash exercise JitoSOL positions within your limits.

Full layouts are in Accounts. Puts use their own maker accounts, keyed by asset and payment token. They are listed in Put setup.

text
 quote key (0x..., secp256k1)                 Solana authority (ed25519)
   signs the registration grant,                signs setup, exercise and
   bid intents and quotes (off chain)           withdrawals (on chain)
            \                                        /
             v                                      v
  Maker ["maker", quote key] ---------- MakerOriginV1 ["maker-origin-v1", Maker]
    | authority, operator, min_nonce
    |
    +-- USDC vault     ["stable", Maker, USDC]           pays premium at fill,
    +-- PremiumBudget  ["premium-budget", Maker, USDC]   strike at exercise
    |
    +-- for each collateral mint M (JitoSOL today):
    |     +-- Exposure      ["exposure", Maker, M]
    |     +-- MintPolicyV1  ["mint-policy", Maker, M]
    |     +-- MintUsageV1   ["mint-usage", Maker, M]
    |
    +-- PositionV3 ["position", quote key, nonce]   one per fill, any market
          |  terms_account ------------------------> MarketV3 ["market-v3", creator, salt]
          +-- collateral vault ["collateral", PositionV3]

Who signs what

SignerKeyWhat it signs
Quote keyEthereum-style secp256k1 key. It never signs a Solana transaction.The registration grant, bid intents and quotes (EIP-712). The program checks the quote signature inside fill_v3.
Maker authorityThe Solana key named at registration. It can never change.Every setup and configuration instruction, withdraw, exercise_v3, begin_flash_exercise_v3, and every flash policy write. Exercised collateral goes to a token account it owns.
OperatorOptional Solana key set with configure_maker. The zero key means none.exercise_v3, begin_flash_exercise_v3, fund_restricted_exercise_v3, and for puts exercise_put_v3 and begin_flash_put_v3. Nothing else.
Flash delegateA temporary key you choose for one flash exercise.begin_flash_exercise_v3 or begin_flash_put_v3, then your swap. It may spend only what the begin instruction moved into a temporary account: a call's collateral, or a put's locked cash.
Policy watcherOptional Solana key stored in a mint policy.pause_mint_policy_v1, or pause_mint_policy_v2 for a put policy. Nothing else.
Writer (customer)The customer's wallet.fill_v3, early_close_v3, and transfers of its own position. For puts: fill_put_v3, early_close_put_v3, transfer_position_v3x.
Market creatorAny wallet.create_market_v3 or, for a put market, create_market_v3x, and pausing that market.
AnyoneNo special key.release_v3, or release_put_v3 for a put, after the exercise window. It needs no signer beyond the fee payer.

Which SDK builder emits each instruction

InstructionSDK builderSigned by
register_maker_v3registerMakerV3 after signRegistrationGrantauthority
initialize_vaultinitializeVaultauthority
set_premium_budgetsetPremiumBudgetauthority
depositdepositauthority
withdrawwithdrawauthority
configure_makerconfigureMakerauthority
initialize_exposure_v3initializeExposureV3authority
set_exposure_limitsetExposureLimitauthority
initialize_mint_policy_v1initializeMintPolicyV1 with mintPolicySettingsForauthority
update_mint_policy_v1updateMintPolicyV1authority
pause_mint_policy_v1pauseMintPolicyV1: the fast, reversible brakeauthority or watcher
bootstrap_mint_usage_v1bootstrapMintUsageV1authority
create_market_v3createMarketV3creator
create_restricted_market_v3createRestrictedMarketV3. Restricted (tokenized-stock) markets stay covr-only for now.creator
set_market_v3_pausenonecreator
fill_v3, fill_restricted_v3fillV3 (the customer signs; use it to simulate or audit)writer
exercise_v3exerciseV3Instructions (recommended: the whole transaction), exerciseV3authority or operator
release_v3, release_restricted_v3releaseV3Instructions (recommended: the whole transaction), releaseV3anyone
fund_restricted_exercise_v3fundRestrictedExerciseV3. Restricted markets stay covr-only for now.authority or operator
complete_pending_delivery_v3completePendingDeliveryV3anyone
cancel_pending_delivery_v3none (the SDK encodes only its argument, encodeCancellationRequestV1)authority and writer together
early_close_v3, buy_position_v3nonewriter (seller)
initialize_flash_exercise_policy_v1, update_flash_exercise_policy_v1, disable_flash_exercise_policy_v1none yet (planned). See Flash exercise.authority
begin_flash_exercise_v3, finish_flash_exercise_v3none yet (planned). See Flash exercise.authority or operator, plus the delegate
The 25 put instructionsnone. 0.1.1 has no put builders, decoders or signing helpers. See Cash-secured puts.see Put instructions

To read your accounts, the SDK ships five decoders: decodeMaker, decodeMintPolicy, decodeMintUsage, decodeMarketV3 and decodePositionV3. Accounts gives byte offsets for the rest. None of them reads put accounts: decodeMarketV3 throws on a put market and decodePositionV3 throws on a put position.

Pages in this section

  • Addresses: program ID, the deployed build and how to verify its hash, mints and chain constants.
  • Accounts: seeds, sizes and every field your desk reads.
  • Instructions: accounts, arguments, checks and money movement of each instruction, plus the money rules.
  • Errors: every error code you can hit, and how to decode one.