Guide: HartiiSwap on Hartii.org
Read a quote
- Open Swap on Hartii.org. Choose the token you pay with and the token you receive. QUAI is native; WQUAI is a separate wrapped-token balance.
- Choose Exact amount to pay or Exact amount to receive, then enter a plain decimal amount. The client rejects unsupported precision and scientific notation.
- Read Your route, the minimum received or maximum sent, pool fee and pool generation. A missing route means no available liquidity in the supported pools, even if the token itself is supported. No trade is offered from an invented price.
- Trade settings controls slippage and deadline. The defaults are0.50% and20minutes; the workspace accepts0.01–5.00% and1–30minutes. A review expires after120seconds and must be refreshed. A higher tolerance can allow a worse fill.
- Choose Connect wallet only when you want to review an action. Loading the page and reading quotes do not request a wallet connection.
The curated list includes QAXE, WQI and HBOME as well as QUAI/WQUAI. WQI is an ERC-20 asset, not native Qi, and this page provides no conversion or redemption mechanism. Its backing/redemption remains unverified. Add token by contract explicitly imports session-only metadata for another supported ERC-20; check the full address. A name or symbol is not an endorsement.
Approve, then review the trade
An ERC-20 allowance may require Review token approval first. Read the exact amount, token contract, spender and maximum gas. If an existing allowance must be cleared, Reset token allowance requests zero first. Each wallet request is separate.
After an approval confirms, read a new quote and review again. Approval never sends a swap automatically. When Review swap is available, check the account, network, assets, amounts, slippage limits, generation, spender and maximum gas. Acknowledge the terms, then choose Confirm in wallet. A higher fresh gas maximum or moved price requires another review.
QUAI must cover both the value sent and the actual transaction's gas reserve. Native Max remains unavailable when that exact reserve cannot be established. Each approval and each later trade has its own gas cost; a failed transaction may also consume gas.
Follow an unresolved transaction
Activity reports pending, confirmed, failed, rejected or unknown. A transaction hash alone is not confirmation. An explicit final receipt status1 confirms the call; status0 means it reverted. A timeout does not prove nothing was sent.
The client saves a bounded public transaction check on this device before opening the wallet. It survives reload, disconnect and account changes. Check a transaction checks that same operation without sending again. Other tabs cannot overwrite the pending record. An unrelated receipt cannot unlock it, and elapsed time never clears it automatically.
Do not clear an unresolved record and repeat the action before verifying the original outcome. The visible activity list is tab memory; it is separate from the saved recovery record. Export CSV saves the visible activity you choose to export. The privacy notice explains public-chain reads and device storage.
Add or remove liquidity
- Choose Liquidity, then select a readable pool. Load more follows bounded pages; an empty page of positions does not necessarily mean there are no later positions.
- Choose add or remove. Enter both desired token amounts for an addition or an exact LP amount for removal. For a WQUAI leg, explicitly choose whether to deposit or receive native QUAI.
- Calculate the terms. Review the currently quoted amounts, Maximum first asset, Maximum second asset, minimum assets and projected LP tokens, then complete any exact token/LP approval separately. The desired amounts are maximum deposits: a changed ratio can use more than the quoted input while staying within those reviewed caps. Recalculate after approval before confirming the liquidity action.
- Create a pool selects two distinct wrapped/ERC-20 identities. The first deposit sets the starting ratio. Native QUAI is a separate payment choice for a WQUAI leg. The structural minimum-liquidity seed remains permanently locked by the pool accounting.
Unreadable pool rows are unavailable, not zero balances. An existing empty pool can receive its first deposit; zero LP cannot be removed. Your positions describes actual LP balances and current reserve claims; missing earned-fee history is unknown, not a promised return. LP fees remain in the pool and the protocol fee can dilute LP supply.
Migration and later features
Existing pools keep working. Moving liquidity is optional: separately remove from the old pool, inspect the received assets, then review an addition to the new pool. Gas and prices may change between actions. No automatic migration or company-funded liquidity is provided by this flow.
The workspace identifies the existing deployment as generation1. The successor contract source and limit/recurring order features have separate review, rehearsal and release gates. This guide does not claim those contracts or an executor are live.
When an action is unavailable
- No route: choose another pair, or inspect available liquidity. Supporting a token does not create a pool.
- Wrong account or network: reconnect to the intended Cyprus-1 Quai account on mainnet chain9, then obtain a new review. Native Qi and other zones are unsupported.
- Stale review or moved terms: refresh and check the new limits before signing.
- Storage or browser coordination unavailable: use a supported browser with the required device storage and Web Locks. New sends stay blocked because unresolved outcomes must remain recoverable.
- RPC unavailable: wait for a successful fresh read. Missing data is not a zero balance.
- Pending or unknown: check the existing hash and receipt; do not send again merely because time passed.
Read the native exchange reference and liquidity mechanics for fees, boundaries and integration details.