HartiiLabs docs
Developer docs for HartiiLabs (https://hartiilabs.com), part of the Hartii ecosystem on Quai Network. Full Hartii docs, every product: docs.hartiilabs.com.
HartiiLabs
- HartiiLabs — Token launchpad on Quai Network — bonding-curve launches that graduate to an internal pool, with a public read API over the full trade/holder history.
- Using HartiiLabs — FAQ — Plain answers for holders and creators — burning, creator vesting, failed sends, tokens missing from a wallet, graduation, and honeypot safety.
- Pricing a token — How to price a HartiiLabs token correctly — spot price, what a trade really returns, and market cap — for both bonding-phase and graduated tokens.
- Market-maker tools (v0) — The read-only price reference, quote preview, inventory bands, and FIFO P&L store behind /mm — what exists today and what is still planned.
- Contracts overview — How the HartiiLabs launchpad contracts fit together — factory, clones, curve, graduation, fees, and the trust model.
- Contract map — Every live HartiiLabs factory, event topic and contract on Quai mainnet, with the blocks to index from — everything an indexer needs to pick up all launched tokens.
- Token factory — Full function, event, and state reference for TokenFactory — the launchpad's singleton launch contract.
- Bonding curve — Full function, event, and math reference for BondingCurve — the per-token trading contract, curve phase and pool phase.
- Launch token — ERC-20 reference for LaunchToken — the launchpad's clone token, burn(), and creator vesting.
- Integrating with quais — Runnable examples for reading, quoting, trading, and indexing HartiiLabs tokens with the quais SDK.
- API reference — Every public HTTP route on hartiilabs.com — tokens, trades, holders, wallets, burns, stats, media, and live push, with real response shapes.
- Versions & changelog — The app's SemVer scheme, where to read the live version, what can break an integration, and a user-facing changelog.
- How the indexer works — Event scanning, cursor/lock mechanics, holder-balance accounting, and the money-math rules every API consumer should know.
- Integration recipes — Build a token list, a token page, a wallet portfolio, and a burn-total embed against the HartiiLabs API — with polling, caching, and CORS notes.
HartiiSwap
- HartiiSwap — HartiiSwap is the Hartii ecosystem's own Uniswap-V2 AMM on Quai — pools for any token, swaps, liquidity, LP farms, and a one-call Lens.
- Contracts — HartiiSwapFactory, HartiiSwapPair, HartiiSwapRouter and HartiiSwapLens — full reference.
- Liquidity — Creating a pool, pricing the first deposit, adding and removing liquidity, what LPs earn, and the risks.
- Integrate — Runnable quais code for HartiiSwap — find a pool, quote, swap both ways, add and remove liquidity, list pools and positions.
- LP developer guide — Add and remove HartiiSwap liquidity from code, read positions, measure fee earnings exactly, stake LP in farms, and get LP rewards set up for your token.
- Farms — HartiiFarm — stake HartiiSwap LP tokens to earn a reward token, how rewards accrue, and who can do what.
QuaiRelay
- QuaiRelay — A stateless contract that turns a QUAI transfer into a contract call, for wallets that can't send a plain transfer.
- Contract reference — Full interface, events, reverts and trust model for QuaiRelay.
- Integrate — Runnable quais examples for calling QuaiRelay.sendTo from a dapp.
Agent Terminal
- Agent Terminal — Let an AI agent trade, launch tokens and play games on Hartii from a capped, user-owned on-chain wallet.
- AgentVault contract reference — The on-chain roles, allowlist, caps and events of AgentVault and AgentVaultFactory.
- Agent API — Read a vault's state, get quotes, and build calldata for every allowed AgentVault action.
- MCP setup — Run @hartii/agent-mcp so your agent can call the Agent API, simulate, sign and send.
- Fish & Fly — Two trading games agent vaults play, driven by verifiably-random small trades.
- Hartii's own AI trader — The profit rules enforced in code for Hartii's own experimental AgentVault trading agent.
- Security — What AgentVault's on-chain caps do and don't protect against.