# 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](https://docs.covr.markets/reference/program/instructions.md#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](https://docs.covr.markets/concepts/flash-exercise.md).
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.

| Account | One per | Seeds | Created by | What it holds |
| --- | --- | --- | --- | --- |
| Maker | quote key | `"maker"`, quote key address (20 bytes) | `register_maker_v3` | Your Solana authority, optional operator and nonce floor (`min_nonce`). |
| MakerOriginV1 | Maker | `"maker-origin-v1"`, Maker | `register_maker_v3` | Your registration record. Every fill passes it. |
| USDC vault | Maker | `"stable"`, Maker, USDC mint | `initialize_vault` | Your USDC. An SPL token account whose owner is the Maker PDA. |
| PremiumBudget | Maker | `"premium-budget"`, Maker, USDC mint | `initialize_vault` | Optional lifetime cap on gross premium paid. |
| Exposure | Maker and collateral mint | `"exposure"`, Maker, mint | `initialize_exposure_v3` | Cap on open collateral atoms across all markets of that mint. |
| MintPolicyV1 | Maker and collateral mint | `"mint-policy"`, Maker, mint | `initialize_mint_policy_v1` | Per-mint caps and the market terms you accept. |
| MintUsageV1 | Maker and collateral mint | `"mint-usage"`, Maker, mint | `initialize_mint_policy_v1`, then `bootstrap_mint_usage_v1` | Running totals the caps are checked against. |
| MarketV3 | creator and salt | `"market-v3"`, creator, salt (u64 LE) | `create_market_v3` | One market's immutable terms. Any wallet can create one. |
| PositionV3 | Maker 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 vault | position | `"collateral"`, position | `fill_v3` | The customer's locked collateral. |
| FlashExercisePolicyV1 | Maker and mint pair | `"flash-policy-v1"`, Maker, collateral mint, USDC mint | `initialize_flash_exercise_policy_v1` | Optional. Lets you [flash exercise](https://docs.covr.markets/concepts/flash-exercise.md) JitoSOL positions within your limits. |

Full layouts are in [Accounts](https://docs.covr.markets/reference/program/accounts.md). Puts use their own maker accounts, keyed by asset and payment token. They are listed in [Put setup](https://docs.covr.markets/reference/program/instructions.md#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

| Signer | Key | What it signs |
| --- | --- | --- |
| Quote key | Ethereum-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 authority | The 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. |
| Operator | Optional 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 delegate | A 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 watcher | Optional 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 creator | Any wallet. | `create_market_v3` or, for a put market, `create_market_v3x`, and pausing that market. |
| Anyone | No 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

| Instruction | SDK builder | Signed by |
| --- | --- | --- |
| `register_maker_v3` | [`registerMakerV3`](https://docs.covr.markets/reference/sdk/setup.md#registermakerv3) after [`signRegistrationGrant`](https://docs.covr.markets/reference/sdk/setup.md#signregistrationgrant) | authority |
| `initialize_vault` | [`initializeVault`](https://docs.covr.markets/reference/sdk/setup.md#initializevault) | authority |
| `set_premium_budget` | [`setPremiumBudget`](https://docs.covr.markets/reference/sdk/setup.md#setpremiumbudget) | authority |
| `deposit` | [`deposit`](https://docs.covr.markets/reference/sdk/setup.md#deposit) | authority |
| `withdraw` | [`withdraw`](https://docs.covr.markets/reference/sdk/setup.md#withdraw) | authority |
| `configure_maker` | [`configureMaker`](https://docs.covr.markets/reference/sdk/setup.md#configuremaker) | authority |
| `initialize_exposure_v3` | [`initializeExposureV3`](https://docs.covr.markets/reference/sdk/setup.md#initializeexposurev3) | authority |
| `set_exposure_limit` | [`setExposureLimit`](https://docs.covr.markets/reference/sdk/setup.md#setexposurelimit) | authority |
| `initialize_mint_policy_v1` | [`initializeMintPolicyV1`](https://docs.covr.markets/reference/sdk/setup.md#initializemintpolicyv1) with [`mintPolicySettingsFor`](https://docs.covr.markets/reference/sdk/setup.md#mintpolicysettingsfor) | authority |
| `update_mint_policy_v1` | [`updateMintPolicyV1`](https://docs.covr.markets/reference/sdk/setup.md#updatemintpolicyv1) | authority |
| `pause_mint_policy_v1` | [`pauseMintPolicyV1`](https://docs.covr.markets/reference/sdk/setup.md#pausemintpolicyv1): the [fast, reversible brake](https://docs.covr.markets/reference/program/instructions.md#pause_mint_policy_v1) | authority or watcher |
| `bootstrap_mint_usage_v1` | [`bootstrapMintUsageV1`](https://docs.covr.markets/reference/sdk/setup.md#bootstrapmintusagev1) | authority |
| `create_market_v3` | [`createMarketV3`](https://docs.covr.markets/reference/sdk/markets.md#createmarketv3) | creator |
| `create_restricted_market_v3` | [`createRestrictedMarketV3`](https://docs.covr.markets/reference/sdk/markets.md#createrestrictedmarketv3). Restricted (tokenized-stock) markets stay covr-only for now. | creator |
| `set_market_v3_pause` | none | creator |
| `fill_v3`, `fill_restricted_v3` | [`fillV3`](https://docs.covr.markets/reference/sdk/settlement.md#fillv3) (the customer signs; use it to simulate or audit) | writer |
| `exercise_v3` | [`exerciseV3Instructions`](https://docs.covr.markets/reference/sdk/settlement.md#exercisev3instructions) (recommended: the whole transaction), [`exerciseV3`](https://docs.covr.markets/reference/sdk/settlement.md#exercisev3) | authority or operator |
| `release_v3`, `release_restricted_v3` | [`releaseV3Instructions`](https://docs.covr.markets/reference/sdk/settlement.md#releasev3instructions) (recommended: the whole transaction), [`releaseV3`](https://docs.covr.markets/reference/sdk/settlement.md#releasev3) | anyone |
| `fund_restricted_exercise_v3` | [`fundRestrictedExerciseV3`](https://docs.covr.markets/reference/sdk/settlement.md#fundrestrictedexercisev3). Restricted markets stay covr-only for now. | authority or operator |
| `complete_pending_delivery_v3` | [`completePendingDeliveryV3`](https://docs.covr.markets/reference/sdk/settlement.md#completependingdeliveryv3) | anyone |
| `cancel_pending_delivery_v3` | none (the SDK encodes only its argument, [`encodeCancellationRequestV1`](https://docs.covr.markets/reference/sdk/settlement.md#encodecancellationrequestv1)) | authority and writer together |
| `early_close_v3`, `buy_position_v3` | none | writer (seller) |
| `initialize_flash_exercise_policy_v1`, `update_flash_exercise_policy_v1`, `disable_flash_exercise_policy_v1` | none yet (planned). See [Flash exercise](https://docs.covr.markets/concepts/flash-exercise.md#instructions). | authority |
| `begin_flash_exercise_v3`, `finish_flash_exercise_v3` | none yet (planned). See [Flash exercise](https://docs.covr.markets/concepts/flash-exercise.md#instructions). | authority or operator, plus the delegate |
| The 25 put instructions | none. 0.1.1 has no put builders, decoders or signing helpers. See [Cash-secured puts](https://docs.covr.markets/reference/program/instructions.md#cash-secured-puts). | see [Put instructions](https://docs.covr.markets/reference/program/instructions.md#put-instructions) |

To read your accounts, the SDK ships five decoders: [`decodeMaker`](https://docs.covr.markets/reference/sdk/setup.md#decodemaker), [`decodeMintPolicy`](https://docs.covr.markets/reference/sdk/setup.md#decodemintpolicy), [`decodeMintUsage`](https://docs.covr.markets/reference/sdk/setup.md#decodemintusage), [`decodeMarketV3`](https://docs.covr.markets/reference/sdk/markets.md#decodemarketv3) and [`decodePositionV3`](https://docs.covr.markets/reference/sdk/settlement.md#decodepositionv3). [Accounts](https://docs.covr.markets/reference/program/accounts.md) 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](https://docs.covr.markets/reference/program/addresses.md): program ID, the deployed build and how to verify its hash, mints and chain constants.
- [Accounts](https://docs.covr.markets/reference/program/accounts.md): seeds, sizes and every field your desk reads.
- [Instructions](https://docs.covr.markets/reference/program/instructions.md): accounts, arguments, checks and money movement of each instruction, plus the money rules.
- [Errors](https://docs.covr.markets/reference/program/errors.md): every error code you can hit, and how to decode one.

---

Source: https://docs.covr.markets/reference/program/overview · Part of covr Docs, https://docs.covr.markets/llms.txt
