Skip to main content

Quickstart

Every trade in Covenant routes through the Uniswap v4 hook on the canonical CVN/ETH pool. You don't interact with covenants directly — the hook creates, absorbs, and settles them for you during the swap.

Prerequisites

A wallet (e.g. MetaMask) connected to the network Covenant is deployed on, and some test ETH. See Deployments for the current network and contract addresses.

Buy CVN​

  1. Open the dApp and connect your wallet.
  2. Go to Trade, select the Buy tab, and enter how much ETH to pay.
  3. The widget shows whether your buy will absorb open covenant debt (and at what discount) or run as a plain pool swap when the queue is empty.
  4. Confirm. In a single transaction the hook levies the 3% ETH tax, absorbs as much covenant debt as your ETH covers at the current 5–20% discount, and routes the remainder through the pool.

Buys absorb active covenant debt first, then settle against the pool.

Sell CVN​

  1. On Trade, select the Sell tab and enter how much CVN to sell.
  2. The widget shows the breakdown: the amount retained as a covenant (20% of the net), the amount sold to the pool, and the 3% creator tax.
  3. Confirm. This is a two-step flow the first time: (1/2) approve CVN, then (2/2) sell. The hook creates your covenant and books it into the queue with a frozen discount and a 7-day expiry.

20% of your net sell is retained as covenant debt. Unabsorbed debt becomes locked liquidity at expiry.

What happens next​

Your covenant is now live in the queue. Buyers can absorb it at a discount for the next 7 days. If it is still open at expiry, anyone can call the permissionless settlement to convert it into locked liquidity.

To understand each step in depth, continue to How it works.