covr.Docs

Users: how it works

Exercise and expiry

What happens at and after expiry, step by step.

The timeline

Every market has an expiry and an exercise window. The window starts at expiry. Its end is the deadline. The app calls the window the "fill window".

PeriodWhat can happen to your positionWho can do it
Before expiryNothing, in covr's app. The program also supports early close, transfer and sale to a maker.You (early close and sale also need a maker's signed price)
From expiry until the deadlineExercise, including flash exerciseThe maker's authority or its operator
From the deadline onRelease: your tokens go back to youAnyone

For covered calls, covr's app tells you before you confirm: your tokens stay locked and you can't cancel early. Early close is a contract feature that needs the original maker to sign a buyback price; the app does not offer it.

  • The window is fixed when the market is created. It is between 1 minute and 1 hour. The app shows it on each order.
  • Exercise is allowed from the exact second of expiry up to, but not including, the deadline. At the deadline exercise is refused and release becomes possible.
  • Release has no end date. If no one releases, your tokens wait in the vault. Nothing else can touch them. Tokenized-stock markets differ: see below.

Deadlines use the chain clock

Every time rule is checked against the Solana chain's own clock (the Clock account's Unix timestamp), not against covr's servers or your device. The chain clock can differ slightly from the time on your screen. Near a boundary, the chain's time is the one that counts. covr's keeper and the app both read the chain clock before they act, and the keeper refuses to act when the two clocks disagree by too much.

Exercise

Exercise is the maker using the right it paid for. No price oracle decides it. Within the window, the maker decides, and the program enforces the fixed strike. The only price the program reads is a bound the maker sets for its own flash exercises, and that bound protects the maker.

A covered-call exercise is one transaction:

  1. The program moves the full strike, in USDC, from the maker's vault to a token account you own.
  2. It moves your locked JitoSOL to the maker.
  3. It returns anything extra in your vault, and the vault's rent deposit, to you.
  4. It marks the position exercised.

If any step fails, for example because the maker's vault is short, the whole transaction fails and no tokens move.

A cash-secured put works the same way in the other direction. Your locked stablecoins (the full strike) go to the maker, and exactly the JitoSOL amount comes from the maker's vault to you, in one transaction.

How covr's keeper decides

covr's maker runs an exercise keeper for covered calls: a bot that watches its open positions. Other makers run their own. covr's keeper:

  • works through positions with the earliest deadline first;
  • acts only inside the window, by the chain clock, and stops a safety margin before the deadline;
  • values your locked tokens at the low edge of its price source's range;
  • exercises only if that value, minus the strike, minus network fees and the cost of new token accounts, is at least the maker's minimum gain;
  • tries flash exercise first where it is enabled, and falls back to paying the strike from the maker's vault.

So a covered call that ends at or below the strike is not exercised by covr's keeper. You keep your JitoSOL and the premium. See FAQ.

For a cash-secured put, the program's rules are what count. The maker's authority or operator may exercise inside the window, and no price oracle is consulted. Exercise takes your locked stablecoin and delivers exactly the JitoSOL amount, from the maker's JitoSOL vault or through a flash exercise. A maker gains from exercising a put only when JitoSOL is worth less than the strike. If it does not exercise, you release your stablecoin after the deadline.

Flash exercise

Flash exercise is how a maker can exercise without holding the strike in advance. It sells your locked tokens and pays you, all inside one Solana transaction. For you, the result is the same as a normal exercise: you receive exactly the full strike.

Flash exercise of covered calls has been live on mainnet since the program upgrade of 22 October 2026. This section covers what it means for you. The maker's side, including its flash policy and how a desk builds the transaction, is in Flash exercise in the maker docs.

Step by step (covered call)

StepInstructionWhat happens
1begin_flash_exercise_v3The program checks the window and the signer (the maker's authority or operator). It locks your position in a temporary "flash" state. It moves exactly your locked JitoSOL into a fresh temporary account it controls, and lets a temporary key chosen by the maker spend at most that amount.
2Swap steps (not covr)The maker's route sells JitoSOL for USDC into a second temporary account the program controls. covr's keeper uses Jupiter routes.
3finish_flash_exercise_v3The program counts the new USDC. It must reach the floor. It pays you exactly the strike, sends the rest to the maker's vault, sends any unsold JitoSOL to the maker, returns your vault's extra tokens and rent to you, closes the temporary accounts and marks the position exercised.

What the program guarantees

  • One transaction, all or nothing. If the swap fails, pays too little or any check fails, its instruction effects roll back, including the lock and every token transfer. Your position stays open as before. Whoever sent the transaction still pays its network fee.
  • You are paid in full. The floor is at least the strike plus the maker's own minimum surplus, so the strike is always covered before anything is paid out.
  • The swap cannot reach your accounts. The steps between begin and finish may not reference your wallet, your token accounts, the position, its vault or the maker's vault. covr's program never signs for the swap.
  • Fixed recipients, open route. The temporary key may spend exactly your locked amount, and the route may pass it through outside swap pools. The program does not limit where those tokens go in between. It fixes who is paid at finish: you first, then the maker's own accounts.
  • No interference. Begin and finish must be top-level instructions, finish must be the last instruction, and no other covr instruction may appear in the transaction.
  • Narrow scope. Flash exercise is admitted only for JitoSOL with USDC for covered calls. The maker can tighten it or switch it off. Adding a token pair needs a program upgrade.

Flash exercise of a cash-secured put

The same design runs the other way. The program isolates exactly your locked stablecoins (the strike), the route buys JitoSOL with them, and finish pays you exactly the JitoSOL amount of your put. Any extra JitoSOL goes to the maker. If the route buys too little, the transaction fails. Flash puts are admitted for JitoSOL with USDC or USDT. They have been in the program since the upgrade of 4 November 2026.

Release after the deadline

If your position was not exercised, release returns your tokens.

  • Anyone can send it. It needs no signature from you, the maker or covr. The sender only pays the network fee.
  • It pays only you. The program sends the whole vault to a token account owned by the position's owner, and closes the vault with its rent deposit to you. It refuses a destination with a delegate or a foreign close authority.
  • It returns everything. For a covered call, all your JitoSOL. For a cash-secured put, all your stablecoins.
  • You keep the premium. It was paid to you at fill.
  • It still needs the token transfer to work. For a cash-secured put, if the stablecoin's issuer has frozen the position's escrow, release fails until the issuer lifts the freeze. A different receiving account does not help, because the escrow is the source.

For a covered call, the app's Unlock button prepares a release you sign in your wallet. You pay only the network fee. covr's keeper can also send releases on its own when covr turns its auto-release on (whether it is on: to confirm with covr).

Without the app, any tool that can build the instruction will do. The public maker SDK, @covrfun/maker-sdk, has releaseV3Instructions, which builds a complete covered-call release that any wallet can send. It creates a fresh token account owned by you to receive the tokens. Whoever sends it pays that account's deposit and the network fee.

For a cash-secured put, the app's Unlock works the same way. release_put_v3 also needs no signature. Its ten accounts are listed under release_put_v3, and any wallet can build and send it. The escrow can only go to a stablecoin account owned by you.

Small positions

Exercise costs the maker a network fee and the deposits for the token accounts it creates for you. Those costs do not shrink with the size of the position. On a small position, the gain from exercise can be smaller than the costs, so covr's keeper skips it, even if the price ended a little above the strike.

Example, with round illustrative numbers: you sold a call on 0.01 JitoSOL with a $220 strike. At expiry JitoSOL is $221. The maker would gain $0.01 before costs, so it does not exercise. After the deadline you release your 0.01 JitoSOL, and you keep the premium.

Tokenized-stock markets

covr may list markets that lock a tokenized stock (a Token-2022 token) instead of JitoSOL. The stock's issuer can pause or restrict its transfers, so these markets settle in two steps instead of one.

StepInstructionWho signsWhenWhat happens
Fundfund_restricted_exercise_v3The maker's authority or its operatorInside the exercise windowThe maker moves the full strike, in USDC, into an escrow owned by your position. The position becomes pending.
Delivercomplete_pending_delivery_v3AnyoneAny time after fundingOne transaction: the whole escrowed strike to you, exactly your stock amount to the maker, any extra tokens and the vault's rent to you. If a leg is blocked, for example because the issuer has paused transfers, no tokens move and it can be tried again later.
Cancelcancel_pending_delivery_v3You and the maker, bothFrom 7 days after fundingThe strike goes back to the maker and your stock tokens back to you. You keep the premium.
Releaserelease_restricted_v3AnyoneFrom the deadline, only if the maker never fundedReturns whatever is in the vault to you.
  • Once the maker has funded, the position can no longer be released. It ends by delivery, or by a cancel that both of you sign.
  • Stock tokens carry issuer powers that covr cannot switch off: freeze, pause, and a permanent delegate that can move tokens out of any account, including your position's vault. If the vault holds less than you locked, release returns what is left. covr does not cover the shortfall.
  • These markets have no early close and no flash exercise.

If covr is offline

What is offlineBefore expiryIn the windowAfter the deadline
covr websiteNo new positions through the app. Your position is unchanged.The maker can still exercise.Release with any tool, or anyone can send it for you.
Quote gatewayNo new quotes.The maker can still exercise.Release with any tool.
Exercise keeperNo effect.No exercise.Release returns your tokens. You keep the premium.
Everything covr runsNo new positions.No exercise by covr's maker.Release returns your tokens. You keep the premium.

See Position lifecycle for every state, and Before and after expiry for the plain-English version.