Guide: pools and farms

This guide is for anyone who wants to put their tokens into a HartiiSwap pool, or take them out again. A pool holds two tokens, usually a token and QUAI. People swap against it. When you add liquidity, you get LP tokens, a receipt that shows your share of the pool.

#What you need

• A Quai wallet: Pelagus on a computer or Blip on a phone, set to Quai Network.
• Some of the token and some QUAI, in matching value.
• Extra QUAI for network gas, the small fee every transaction pays to the network. Creating a brand new pool costs much more gas than adding to an existing one.

#Add liquidity

1. Press Pools in the left menu (or the Pools tab in the bottom bar on a phone), or open hartiilabs.com/pools. The page says "Add liquidity to a pool and earn a share of its trading fees. Pick a pool, press Add." You see All pools and, if you are connected, My positions. Use Search this page… or the sort list (TVL (high to low) or Name (A–Z)) to find a pool.
2. Press Add liquidity at the top right. On a pool's row you can press Add instead.
3. Under Token, pick your token (search, or paste an address and press Use this address). Paired with is set to QUAI by default.
4. Type the first Amount. You can press Max.
5. If the pool already exists, the other amount fills in at the pool's ratio. If it does not exist, you are creating it. The page warns you that the ratio you deposit sets the starting price. For a HartiiLabs token the QUAI side fills in at the token's curve price ("Filled from the bonding-curve price"). If you have edited it, Match curve price puts it back. Change it only on purpose.
6. Check Starting price, Your share of the pool (est.), Network fee (est.) and LP tokens you'll receive (est.).
7. Choose a Slippage tolerance: 0.1%, 0.5%, 1.0% or Custom. It is how much the price may move before your deposit cancels.
8. Optional: Approve unlimited skips the approval step on future deposits.
9. Press Create pool (new pool) or Add liquidity (existing pool). Your wallet first asks for a one-time token approval, then the deposit. The button says Approve in wallet… and then Confirm deposit….

You then see LP tokens received, with links to View my positions and Manage this position.

#See your position

Open Pools and look at My positions. It lists your LP tokens, your share, what they are worth now, and Add and Remove shortcuts. Public nodes can lag a few seconds, so a new position may take a moment to appear. It is already yours on-chain.

#Remove liquidity

1. On My positions, press Remove.
2. Pick 25%, 50%, 75% or 100%, drag the slider, or type an exact amount under Or exact LP amount.
3. Read You'll receive. It includes your share of the swap fees collected while you were in.
4. Optional: tick Receive as WQUAI instead of native QUAI.
5. Press Remove liquidity. Approve the LP tokens first if asked, then confirm.

#Locking liquidity (optional)

On the add page you can choose to lock a percent of your new LP tokens for a fixed time, from 1 to 90 days (the field reads Lock this % of my new LP for a fixed period, off by default). It runs as a second transaction after your deposit. Locks are always temporary and never permanent. You can also lock later: Remove liquidity has a Lock liquidity button, next to Reward LP holders.

#Fees

The Pools page also shows an Expected APR column, marked APR BETA. It is an estimate from the last 7 days of real fees. It shows a dash when there are fewer than 7 days of verified swap data, and it is not a promise of any result.

Your share of fees is not a separate payment. It builds up inside the pool and comes back with your tokens when you remove liquidity. The amount depends entirely on trading and is never guaranteed.

#Farms

A farm pays a reward token to people who stake LP tokens. Farms are not in the left menu any more: no farm is configured at the moment, and the page is only linked from a pool that has one (the add-liquidity success screen then shows Farm this LP token). You can still open hartiilabs.com/farms. While no farm is live it says No farms configured yet.

When a farm exists, its card shows Total staked, Your stake, Earned, Reward rate, Period ends and APR (shown as a dash when it cannot be priced). Type an LP amount, then use:

• Stake to deposit LP tokens (it asks for an approval first).
• Withdraw to take LP tokens back.
• Claim to collect rewards.
• Exit to withdraw everything and claim in one go.

#Common mistakes

• Wrong network. Switch your wallet to Quai Network.
• "Not enough" on the button. You lack one of the two tokens. Lower the amounts.
• Wrong starting price on a new pool. Anyone can trade against a badly priced pool right away. Keep the curve price the page fills in.
• Position not showing. Wait a few seconds, then check the pair on quaiscan.io.
• Pending transaction. Do not send again. Read the receipt on Quaiscan first.
• Looking for LP Arena? It has ended and has no menu entry. If you still have LP staked there, a small Withdraw legacy LP Arena stake link on Pools and Portfolio (shown only when you have a stake) opens a withdraw-only page.

#Next

• Liquidity and Farms reference pages.
• HartiiSwap overview.
• Swapping: Guide: swap tokens.