covr.Docs

Users: how it works

Architecture

The pieces of covr, what each one is trusted to do, and what still works when one of them stops.

The short version

  • Your tokens are held by covr's program on Solana, not by covr's servers.
  • Only a transaction you sign can open a position or close one early.
  • The maker's side is checked by the program: its signed quote, its nonce, its limits.
  • After the deadline, anyone can return unexercised tokens, and they can only go back to you.

Diagram

text
                 YOU (wallet)
                 signs the one transaction that opens your position
                   |                                   ^
   1. ask for a    |                                   | 3. review, then sign
      quote        v                                   |    ONE transaction
 +-----------------------------+        +-----------------------------+
 | covr website (the app)      | -----> | quote gateway (covr server) | <---- makers
 | rebuilds every transaction  | <----- | runs the auction, prepares  |   2. sealed bids,
 | and checks it against       |        | and relays transactions     |      then one
 | values built into the page  |        +-----------------------------+      signed quote
 +-----------------------------+                       |
                                                       | 4. relays your signed transaction
                                                       v
 +---------------------------------------------------------------------------------+
 | SOLANA MAINNET: covr program                                                    |
 | markets, positions, and the vaults that hold locked tokens                      |
 | re-checks the maker's signature, the nonce, every deadline and every amount     |
 +---------------------------------------------------------------------------------+
            ^                                                  ^
            | 5a. exercise: only inside the                    | 5b. release: only after the
            |     exercise window, pays you in full            |     deadline, tokens go back
            |     in the same transaction                      |     to you and nowhere else
 +-----------------------------+                     +-----------------------------+
 | exercise keeper (maker bot) |                     | you (Unlock), or anyone     |
 +-----------------------------+                     +-----------------------------+

The pieces

PieceWhere it runsWhat it doesWhat it is trusted for
covr programSolana mainnetHolds locked tokens in vaults it controls. Records each position. Moves tokens only by its rules.Custody and settlement. This is the only piece that can move your tokens out of their vault. In a flash exercise it gives the maker's swap route an exact, temporary allowance, and pays you in full at finish.
Your walletYour deviceSigns the transactions that open a position and, after the deadline, unlock it.Your consent. No position opens, closes early or changes hands without your signature.
covr websitecovr's servers, then your browserShows markets, asks for quotes, rebuilds each transaction and checks it before your wallet sees it.Showing you correct information. It cannot sign for you.
Quote gatewaycovr's serversSends your request to makers, runs a short sealed auction, prepares your transaction, relays it once signed.Finding you a quote and getting your transaction to the network.
MakersThe maker's own serversPrice your request, sign a quote, pay the premium at fill, and may exercise in the exercise window. covr runs a maker.Their own prices. The program holds them to what they signed.
Exercise keeperThe maker's serversThe maker's bot. Exercises positions inside the exercise window when it is worth it for the maker.Nothing on your side. If it never runs, you release your tokens after the deadline. covr does not send releases for you.
RPC providersThird partiesRead the chain and submit transactions.Availability only. Any Solana RPC can do the same job.

On chain and off chain

On chain (the program enforces it)Off chain (covr's servers or the maker's)
Where your tokens sit, and who can move themWhich markets the app shows
The maker's signed quote, checked again at fillPrices, and which maker wins the auction
One use per quote (each nonce opens at most one position)Estimates shown before a firm quote
Exact premium, fee and strike amountsBuilding and relaying transactions
Every deadline, read from the chain clockDeciding whether exercise is worth it
Exercise pays you the strike in the same transactionThe keeper that sends the exercise
Release after the deadline, open to anyone, paid only to youYour portfolio view and receipts

Trust boundaries

What each off-chain piece can and cannot do to your funds, under the program's rules. covr can upgrade the program, and an upgrade can change these rules. See Admin and upgrade powers.

PieceIt canIt cannot
WebsiteRefuse to load. Show stale or wrong numbers. Stop offering a market. A tampered copy of the app could skip its own checks, so read what your wallet shows before you sign.Sign for you. When the app build is the genuine one, a bad server reply cannot steer it: it compares every byte of the prepared transaction with the one it rebuilt, and the program, the fee account and the quote signers are built into the page, not read from the server.
Quote gatewayRefuse to quote. Pick which quote you are shown (bids are sealed, so you cannot see the others). Delay or drop your signed transaction.Move your tokens: it holds no key over them. Change a quote: the maker's signature covers every term, and the program checks it again. Hand your quote to another wallet. Keep your signed transaction alive past the quote's deadline.
MakerDecline to quote. Price as it likes. Exercise inside the window. Choose not to exercise.Exercise before expiry or after the deadline. Take your tokens without paying the strike in the same transaction. Fill you at a price you did not sign for.
Exercise keeperExercise, or skip, any position inside the window.Anything the maker cannot do. It uses the maker's own keys.
Market creator (covr, for covr's markets)Pause a market: no new positions open on it.Touch existing positions: a pause never blocks exercise, release, early close or transfer. Change a market's terms: they are fixed when it is created.
RPC providerFail to answer. Show you stale data.Change a signed transaction.

If something fails

Your position lives on chain. It does not depend on covr's servers staying up.

What failsWhat stopsWhat still works
covr websiteOpening positions through the app. The app's unlock button.Your position, exactly as it was. Exercise by the maker. Release after the deadline, sent by you with any tool, or by anyone else.
Quote gatewayNew quotes. The app's transaction preparation.Everything already on chain. Exercise and release.
Exercise keeperExercise of your position.Release after the deadline. You keep your tokens and the premium.
Maker's vault is shortThat maker's normal exercise. Flash exercise can still pay you from a sale of your locked tokens.If neither works, release after the deadline. You keep your tokens and the premium.
One RPC providerReads and sends through that provider.Every other Solana RPC.
All of covr's off-chain systemsNew positions.Release after the deadline. See Exercise and expiry.

Next

  • Quotes: how a price becomes a signed, firm quote.
  • Custody: where your tokens sit and what can move them.
  • Exercise and expiry: the window, the keeper and release.
  • Risks: what can still go wrong.