HartiiLabs docs

HartiiLabs

Using HartiiLabs — FAQ

HartiiLabs is the token launchpad for Quai Network: anyone can launch a token with a bonding curve, trade it the moment it is live, and — since 2026-09-23 — give it a standard HartiiSwap pool. Every number in the app is a real on-chain read.

How does the launchpad work?

Each token is paired with its own bonding curve — a contract that holds the liquidity and prices the token from how much has been sold. That means instant trading (the curve always buys and sells), fair launch by default (presets set the creator allocation to 0% for meme and experimental launches; other types disclose it up front), and the curve holds the QUAI, not the creator. When the curve sells out it graduates into its own internal pool whose liquidity can never be withdrawn. The math is in Bonding curve; how to price a token is in Pricing a token.

How do I burn my tokens?

Use the Burn panel on the token's page. Sending tokens to the zero address (0x000…000) always fails — a deliberate guard against destroying tokens by mistake. Each token has a real burn() function that lowers total supply and records the burn on-chain; the Burn panel calls it and shows how much you can burn right now.

Why can't a creator send or burn their whole balance?

A creator's allocation vests linearly over 7 days (VESTING_DURATION = 7 days). Until it is fully vested, the still-locked part cannot be transferred or burned — small amounts go through, larger ones are refused. The Creator page shows a live lock bar. Regular holders have no lock at all.

Why did my send fail even below the vesting limit?

Every transfer needs a little native QUAI for gas, paid from the same wallet and separate from your token balance. With no QUAI, no send goes through. A stuck earlier transaction can also block the next one until it clears. Top up QUAI (or clear the pending transaction) and retry.

My token isn't showing in my wallet — is it gone?

No. Wallets such as Pelagus only show tokens you have added by contract address. Import the token's address once and your balance appears — the tokens were on-chain and yours all along.

What changes when a token graduates?

When the curve sells out (or reaches its raise target) it switches from formula pricing to an internal pool seeded with the real QUAI raised and the remaining tokens. That liquidity is locked by construction — the contract has no withdraw function. Your tokens stay freely transferable and burnable before, during and after graduation. Expect a small price step at the graduating trade; see Bonding curve › Graduation mechanics.

Can a token also have a normal liquidity pool?

Yes. Anyone can create a HartiiSwap pool for any token from its page (Create the first pool) and anyone can add liquidity to it. The pool and the curve are separate markets; arbitrage keeps their prices close. See HartiiSwap › Liquidity. Liquidity providers earn a share of every swap automatically — see the next question for when and how that's paid.

I added liquidity but my LP isn't showing — is it lost?

No. The LP tokens are minted to your address in the same transaction as the deposit, so once it confirms they are yours on-chain. The success screen shows the exact amount you received, and Pools → My positions keeps checking every few seconds after a deposit until the position appears. Public Quai nodes can briefly lag the newest block. To check independently, open the pair contract on Quaiscan and look up your LP token balance. See Seeing your position.

When are LP rewards paid out?

There's no payout date and nothing to claim for the swap fee itself. Every HartiiSwap pair (the Uniswap V2 port) charges 0.30% on each swap, kept in the pool's own reserves. Of that, 1/6 (≈0.05% of volume) is minted as LP tokens to the treasury on the next liquidity event — the standard Uniswap V2 fee switch — so liquidity providers keep ≈0.25% of every swap's volume. That 0.25% isn't a separate transfer: it raises the underlying QUAI/token amount each LP token is worth the moment the swap happens, and you receive it automatically — together with your deposit — when you remove liquidity. See HartiiSwap › What liquidity providers earn.

Farm rewards (staking LP tokens for a separate reward token, with a real schedule) are a different mechanism — and no farm is funded for any pool today. When one is, it appears on hartiilabs.com/farms with its own duration and rate. See Farms.

Can a creator secretly disable selling (a honeypot)?

No. The token is a plain ERC-20 with no transfer fee, no blacklist, no pause and no owner transfer hooks — there is no place in the contract to add one. The only restriction anywhere is the time-based creator vesting above.

How do I browse the market?

The home page opens on a grid of token cards by default (a dense list view is also available — your choice is remembered), led by a horizontal "Trending now" strip. Use the sort dropdown and the advanced filter (minimum market cap, hide launches under an hour old) to narrow the grid down.

What's under "Details" on a buy/sell panel?

Every trade panel and the /swap quote collapse the rate, price impact, minimum received, fee and route behind a "Details" disclosure — tap it to expand; your choice is remembered per device.

Do I have to sign a message for every chat message?

No. Sign in once with your wallet and every message, delete or report for the rest of that browser session is linked to your wallet automatically — no repeat signatures. Sign out any time from the chat panel.

What is /flow?

/flow is the live market-flow terminal: it shows trades across every token as they happen. (The AgentVault "Agents" view is temporarily switched off and will return in a later release.)

How many tokens does the market list show?

All of them. The board, search and compare views load every page of /api/tokens, so HartiiLabs-launched tokens and indexed Quainance tokens appear together; the API itself ranks the whole directory before paging (100 per page, follow nextCursor).

Quai Network mainnet · chain 9 · Cyprus-1. Figures marked "read on" a date were read from the chain that day; re-read before relying on them.