Guide: swap tokens

This guide is for anyone who wants to exchange one token for another, or QUAI for a token, at hartiilabs.com/swap. The swap runs on HartiiSwap, a standard pool-based exchange. A pool is a pot of two tokens that anyone can trade against. The price comes from how much of each token is in the pot.

#What you need

• A Quai wallet: Pelagus on a computer or Blip on a phone.
• The token you want to pay with. For QUAI, keep a little extra for network gas, the small fee every transaction pays to the network.
• Your wallet set to Quai Network.

#Steps

1. Press Swap in the left menu (or the Swap tab in the bottom bar on a phone), or open hartiilabs.com/swap. The page is titled Swap, with the one-line description "Exchange one token for another."
2. Under TOKEN YOU PAY WITH, QUAI is already chosen. To change it, click the box. You can search by name or symbol, or paste a token address. Choose Use this address after pasting.
3. Under TOKEN YOU WANT, click Select a token and pick what you want.
4. Type the amount under HOW MUCH YOU PAY. If you are connected, you can press 50% or Max next to your balance. When you pay in QUAI, Max keeps some back for gas. The arrow button between the two boxes reverses the direction.
5. Read YOU GET (ESTIMATE). Under it the page says, for example, "At least X even if the price moves" (with your protection percentage), plus the swap fee and a small network fee.
6. Press Connect wallet if you have not connected. Approve in your wallet.
7. If you pay with a token other than QUAI, the button first says Approve and the token symbol. This lets the swap contract move that amount of your token. Press it and confirm. It is a separate transaction.
8. Press Swap and confirm in your wallet.

#What you will see

• While it works: Confirming transaction….
• When done: Confirmed. with a View on Quaiscan link, and a message that you swapped one token for the other.

#More options

Press More options to open extra settings (it then says Fewer options).

• Rate, price impact, minimum received, route, LP fee and Network fee (est.) are listed. Price impact is how much your own swap moves the pool's price. Large swaps against small pools move it more.
• Route says Direct pair, or Via WQUAI (2-hop) when no direct pool exists. WQUAI is wrapped QUAI, and the swap simply goes through it in two steps.
• Price protection (slippage) is how far the price may move against you before the swap cancels instead of filling at a worse price. Choose 0.1%, 0.5%, 1.0% or Custom. If you leave a high value set, a red warning stays visible even when this section is closed, with a Review button.
• Unlimited approval skips the approve step next time. Leave it off if you prefer to approve exact amounts. The page remembers your choice.

#Fees

#Good to know

• If you buy a HartiiLabs token with QUAI and its bonding curve would give you more, a notice says so and links to Trade on the curve.
• If the price moves past your tolerance while the page is open, the button shows Price updated and a notice offers Accept new price. Read the new number before you accept.
• Hover or long-press the labels to see short explanations of each term.

#Common mistakes

• Wrong network. Switch your wallet to Quai Network.
• Button says "Not enough" plus the token name. Your balance is lower than the amount. Lower the amount.
• Failed with a slippage message. The price moved during signing. Try again. Raise slippage only a little; very high slippage can let the swap fill at a bad price.
• Max left no gas. Keep a few QUAI aside, or use 50%.
• Waiting a long time. Do not press Swap again. Open the View on Quaiscan link, or check your wallet on quaiscan.io, and read the receipt first.

#Next

• Full HartiiSwap reference: HartiiSwap.
• Adding liquidity yourself: Guide: pools and farms.
• Pricing the two venues: Pricing a token.