covr.Docs

Program reference

Addresses and constants

Every fixed address and identifier the program and the SDK use on Solana mainnet. Each value is exported by @covrfun/maker-sdk, except where a row says otherwise.

ts
import { PROGRAM_ID, USDC_MINT, JITOSOL_MINT, JITO_STAKE_POOL } from '@covrfun/maker-sdk';

Program and chain

NameValueUsed for
PROGRAM_ID8ZpbTPnDECPTDGN5VHHKH5gfer6EUTnRHcFwfUAbkJDgThe covered-call program. Owner of every Maker, market and position account. Every PDA on these pages is derived under it.
GENESIS_HASH5eykt4UsFv8P8NJdTREpY1vzqKqZKvdpKuc147dw2N9dSolana mainnet's genesis hash. The program writes it into every MarketV3 and PositionV3 and refuses records that carry another. Check your RPC serves this chain.
DEPLOYMENT_ID0x13a01f9d69929d8b65db7e9a6cc0805075876a8a66664e4ef30dd26f635527e2A 32-byte identifier of this deployment. It is stored in every MarketV3 (bytes 237 to 269) and PositionV3, and it is mixed into every EIP-712 verifyingContract.
MAINNET{ programAddress, deploymentId, genesisHash }The default last argument of every SDK function that derives an address or a signing domain.

Tokens

NameValueUsed for
USDC_MINTEPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1vThe payment mint of every covered-call market. Premium, fee, strike, deposits and withdrawals of calls are all USDC. A put market names its own payment mint (see Cash-secured puts).
USDC_DECIMALS61 USDC = 1,000,000 USDC atoms. The program requires exactly 6.
JITOSOL_MINTJ1toso1uCk3RLmjorhTtrVwY9HJ7X8V9yYac6Y7kGCPnThe collateral desks can quote today. 9 decimals.
JITO_STAKE_POOLJito4APyf642JPZPx3hGc6WWJ8zPKtRbRs4P815AwbbRead-only extra account on every JitoSOL fill. The program reads its pool totals to cap one order at 50 SOL of stake-pool backing.
Stake pool program (no SDK constant)SPoo1Ku8WFXoNDMHPsrGSTSG1Y47rzgn41SLUNakuHyThe program refuses a stake pool account owned by any other program.
TOKEN_PROGRAMTokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DASPL Token. Owns USDC, JitoSOL, your USDC vault and the position collateral vaults of JitoSOL markets.
TOKEN_2022_PROGRAMTokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEbToken-2022. A market's collateral may use it; USDC never does.

The program refuses native SOL as collateral, in both token programs: So11111111111111111111111111111111111111112 and 9pan9bMn5HatX4EJdBwg9VgCa7Uz5HL8N1m5D3NdXejP.

Signing constants

These go into the EIP-712 messages your quote key signs. The program recomputes them on chain, so a wrong value means BadSignature.

NameValueUsed for
CHAIN_ID2000000001The EIP-712 chainId. A venue discriminator, not an EVM chain.
EIP712_DOMAIN_BASE{ name: "SOL Covered Calls", version: "1", chainId: 2000000001 }Shared by every covr signing domain. Each domain adds its own verifyingContract.
REGISTRATION_SCOPEregistration-v3Scope of the registration grant. Its verifyingContract on mainnet is 0xd2d2b887d02b01d3a4371c7b77f96c3880513b4e (registrationGrantDomain()).
ORDINARY_TERMS_ID0xddae69a8d6ba258eb6501331627a583ee6951df68af6a50760d0a038c0a8379dsha256("COVR:ORDINARY-ATOMIC:1\0"). The terms_id of every ordinary market. Your mint policy must hold it to accept ordinary fills.
RESTRICTED_TERMS_ID0xeedfb6068a9b748d45b3341000c743a4b758460d05a852c8473e9fa0469bd7e1The terms_id of restricted markets with the 7-day cancellation timeout. Restricted (tokenized-stock) markets stay covr-only for now.
RESTRICTED_CANCELLATION_TIMEOUT_SECONDS604800The only cancellation timeout the program accepts (7 days).
JITOSOL_ALIAS0x43127405c3191a0b63a5f3d845f616ffea348c6820-byte wire alias of JitoSOL: the last 20 bytes of keccak256(mint bytes). Not an EVM contract.
USDC_ALIAS0x5ce3bf3a31af18be40ba30f721101b4341690186The same alias for USDC.

Each market has its own quote domain. Its verifyingContract commits to every immutable byte of that market, so build it with quoteDomain from the decoded account, never by hand.

Deployed program

The program at PROGRAM_ID is upgradeable. This is the build live on mainnet:

Current buildSHA-256 59fb4cd6fb9f22ed82037aa63d2917e9695f335483eb51d2fb7d22de23f12e06, 2,427,600 bytes
Deployed4 November 2026, finalized at slot 465101356
Previous buildSHA-256 473de63c44eae678b3530767bc36002e3097767c314eb1cba15cff9e70c79602, 1,840,304 bytes. Live from 22 October to 4 November 2026.
Build before thatSHA-256 90907e09d8756141f946ae8e8090129b2ab869c005de58f713a787cb075e1ca5, 1,813,120 bytes. Live until 22 October 2026.
Upgrade authorityAhwMUppQXVfJRjn4sbb5Kpb67tee1z6qSSzEkRkjXpQS

The 4 November upgrade did two things:

  • It added cash-secured puts: 25 new instructions and their own accounts. Desks cannot quote puts through covr yet.
  • It raised the JitoSOL size cap from 2 SOL to 50 SOL of stake-pool value per fill.

It added instructions without changing the accounts, arguments or seeds of the existing ones. @covrfun/maker-sdk 0.1.1 builds only covered-call instructions, and they work as before. Its decoders refuse the new put markets and put positions: see SDK overview. The 22 October upgrade before it added the flash exercise instructions. Every change is listed in the Changelog.

Verify the deployed build

Dump the program's code from your own RPC and hash it. These commands only read.

sh
solana program dump 8ZpbTPnDECPTDGN5VHHKH5gfer6EUTnRHcFwfUAbkJDg covr.so --url https://<your rpc>
head -c 2427600 covr.so | shasum -a 256          # on Linux: sha256sum
tail -c +2427601 covr.so | tr -d '\000' | wc -c   # must print 0

The first command must print 59fb4cd6fb9f22ed82037aa63d2917e9695f335483eb51d2fb7d22de23f12e06. The dump holds the whole code area of the program's ProgramData account, which may be longer than the build. Hash only the first 2,427,600 bytes; anything after them must be zero bytes, which the second command checks. For this build the code area is exactly 2,427,600 bytes, so the dump has nothing after the build and the second command prints 0. This is how covr's own servers check the build before they use it.

If the hash differs, the program was upgraded after this page was written. Check the Changelog, and stop quoting until you know what changed.

Check the program on chain

All the commands below only read. Point them at your own RPC.

1. Confirm the chain. The genesis hash must equal GENESIS_HASH.

sh
solana genesis-hash --url https://<your rpc>

2. Inspect the program. This prints the loader, the ProgramData address, the upgrade authority and the slot of the last deployment.

sh
solana program show 8ZpbTPnDECPTDGN5VHHKH5gfer6EUTnRHcFwfUAbkJDg --url https://<your rpc>

The program is upgradeable. At the time of writing, covr's own tooling expects the mainnet upgrade authority to be AhwMUppQXVfJRjn4sbb5Kpb67tee1z6qSSzEkRkjXpQS. If solana program show prints another authority, stop. Message us on Telegram: @malviyaop before you fund a vault.

Warning

An upgrade can change any rule on these pages, including how your vault is spent. Record the last-deployed slot when you go live and alert on any change.

3. Check an account's owner. Every Maker, market and position account must be owned by PROGRAM_ID. Your USDC vault and the position collateral vaults are token accounts, owned by a token program.

sh
solana account <address> --output json --url https://<your rpc>

The SDK decoders check discriminators, sizes and PDAs, but not the owner. Read accounts at finalized commitment (a pause or update may read the policy generation at confirmed: a stale value only fails with 6012) and check owner === PROGRAM_ID yourself before you call decodeMaker, decodeMintPolicy, decodeMintUsage, decodeMarketV3 or decodePositionV3.