HartiiLabs docs

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.

Guides

  • Guides — Step-by-step guides for every Hartii app — what you need, which buttons to press, what you will see, and how to fix common mistakes.
  • What things cost — Every fee in one place, the fees at a glance for each Hartii app and what is free. If an app shows a different number, the app is right.
  • Receive QUAI — How to show your Quai address, copy it or share a QR code, and get an HPAY payment link if you have a Hartii @handle.
  • Launch a token — Step by step, how to launch your own token on HartiiLabs with a name, a picture and one button.
  • Buy and sell a token — How to buy or sell a HartiiLabs token from its token page, including slippage, fees and what to check if a trade is slow.
  • Graduation — What it means when a HartiiLabs token graduates, what you will see on the page, and what you can do before and after.
  • Swap tokens — How to swap one token for another on HartiiSwap at hartiilabs.com/swap, with slippage and approvals explained.
  • HartiiSwap on Hartii.org — Guide to reviewing swaps, approvals, liquidity and unresolved transaction checks in the native workspace.
  • Pools and farms — How to create a pool, add and remove liquidity on HartiiSwap, check your position, and what to know about farms.
  • Boost a token — How to buy a paid placement for a token in the Promoted row at hartiilabs.com/boost, and what to expect.
  • Share a token chart — How to turn a token's price chart into a picture and share it, copy it, download it or post it on X.
  • Engrave the Wall of Blocks — How to engrave a short permanent message on the public Wall of Blocks at hartiilabs.com/wall, and how the slot price works.
  • HPAY: send to an @name — A first-time walkthrough for paying a Hartii @name or Quai address in native QUAI or reviewed WQI, with wallet review and separate gas.
  • HPAY: create a payment link — Make a shareable HPAY payment link or QR code for a fixed QUAI or exact WQI amount, with a clear asset and network fee.
  • HPAY: get your @handle — Register an optional Hartii @handle inside HPAY, review the contract fee and separate gas, and check the original registration if its outcome is uncertain.
  • HPAY: pay or request a reviewed token — Use reviewed WQI or HBOME as a direct payment asset, keep QUAI for gas, and check asset-bound links without treating tokens as native Qi or dollars.
  • HPAY: take payments in a shop — Use the HPAY point of sale on a phone or tablet for a QUAI dollar quote or exact WQI amount, then check confirmed payments and the local sales record.
  • HPAY: share a link to any platform — Post your HPAY payment link, receipt or split share to X, Facebook, WhatsApp, Telegram, LinkedIn, Reddit, Bluesky, Threads, email or SMS with one tap, with no social scripts loaded.
  • HPAY: read your inbox — Open the HPAY inbox to inspect QUAI or direct WQI payments sent and received, node checks, coverage limits and CSV exports.
  • HPAY: PDF receipts and statements — Keep a browser-made receipt or statement from node-confirmed QUAI or WQI records, and understand which link claims and private profile details are excluded.
  • Airdrop to many wallets — Step-by-step guide to batch-sending QUAI or a standard token to a list of wallets with Hartii Airdrop (beta).
  • HPAY: read the Dashboard — Read selected-range QUAI or WQI received, sent and net totals, check coverage, filter rows, and download a CSV or two-sided statement PDF.
  • OTC Link: sell a token for QUAI — How to create, share, fill and cancel an OTC Link offer to trade a token for QUAI with one shared link.
  • Claim campaigns — How to fund a Hartii Claim campaign for a list of wallets, share one link, and how a recipient claims their allocation (beta).
  • Find the right Biome tool — How to find any Hartii product on hartiibiome.com with the search bar, the "I want to" buttons and the product index.
  • HBOME, the Hartii token — What HBOME is, how to verify the token on chain, where to get it, and where its live supply, burns and governance are published.
  • Hartii: the new site entrances — The roles of hartii.org, hartiipay.app and hbome.dev, including direct product entrances, separated QAXE buyback totals and the public HBOME record.
  • Your profile picture — Pick an NFT you own on Quai Cyprus-1 as your Hartii picture, and link a second wallet to your username. One free signature, no transaction, no gas. Where to set it, where it shows, and the API for developers.
  • Biome: approve a one-time announcement — Review an exact Discord announcement and sign YES or NO with a wallet, without a transaction or gas charge.
  • HBOME governance — Verify the live HBOME governance contract, its deployment record, Chair role and current empty-vault boundary.
  • Open source — The public, MIT-licensed repositories published by Hartii Labs, with what each one is for and where to find it.
  • Read the admin wallet balance — Where Biome and Labs show a read-only admin wallet snapshot, how Biome counts the HBOME it holds in QUAI, what a failed read means, and what the figure does not prove.
  • CLI 1: install and first wallet — Install the Hartii terminal wallet, look around with demo data, create an encrypted wallet and check that everything is healthy.
  • CLI 2: your first trade — Check your balance, browse tokens, preview a buy with --dry-run, make a small real buy, then sell.
  • CLI 3: connect an AI agent — Connect Claude Code or Cursor to your Hartii CLI over MCP, read-only first, then optionally allow capped writes.
  • Agent Terminal: existing vaults (legacy) — Find, manage and recover an existing capped AgentVault. Change caps, pause, revoke or withdraw, and connect its agent key with the explicit legacy profile. The Agent page no longer creates new vaults.
  • Personal trader: try it in Paper (beta) — Run the offline demo, create a trader profile and watch Paper decisions on your own computer. BETA, Observe and Paper only. No key, no funds, no transactions.
  • Play Hartii Games — A beginner's walkthrough of playing at hartiigames.com. It covers the lobby and its dock, free play and the daily challenge, Boards, the Shop, the Me sheet, and what is switched off.
  • Gallery: buy, sell and offers — Step-by-step guide to browsing hartiigallery.com, buying an NFT, listing one for sale and working with offers.
  • QuaiAxe: set up a miner — Use the QuaiAxe mining page at quaiaxe.com/mining to choose a miner type, review the burn/keep split, and reveal settings only after the address and consent checks.
  • QuaiAxe: trade and supply — How to swap on quaiaxe.com/trade, use the chart tools and price ladder, share the chart card, and read the supply tracker.
  • Build zone-ready Quai apps — How to build a Quai dApp that keeps working as Quai adds zones: the zone model, ten rules, a migration path for single-zone apps, checklists and a small zone registry sketch.
  • Glossary — Plain-words meanings of the terms used in the guides, such as bonding curve, graduation, gas, slippage, Cyprus-1, season, replay-verified, ERC-721 and burn.

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.
  • Find and index Hartii tokens — A complete paginated token feed, factory generations, event signature, trade provenance, candles and the current Quainance Trade Zone integration status.
  • 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.
  • The new design — What changed when HartiiLabs moved to its new design in 1.55.0, the phone Trade view and the Depth table added in 1.56.0, how to switch between the new and the classic design, light and dark, and which pages are not rebuilt yet.
  • Market-maker tools (v1) — The dry-run executor Worker, risk guard, pause/kill switch, fill ingestion, P&L history, creator depth requests, pool APR, and live-reserve portfolio pricing behind /mm.
  • Arbitrage scanner — Hartii's 20-minute arbitrage scanner and gated executor — the Dapp Book of Quai venues, exact route maths, the profit gate, caps and the public read API.
  • Hartii trader agent — An autonomous, openly labelled AI agent that trades and launches Hartii tokens from its own public wallet. Rules, risks, and current status (dry-run, not live).
  • 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 — Original LaunchToken contract reference and the current website's launch-image workflow.
  • Hartii Boost — Buy paid placement for a Hartii Labs token in the Promoted row at hartiilabs.com/boost — packages, 24-hour decay, fees, contract reference and API.
  • Claim on HartiiLabs — Claim a Hartii Claim allocation, such as HBOME for HRT holders, at hartiilabs.com/claim with the wallet you already use on Labs.
  • Hartii Rush — The Hartii Rush trading event on hartiilabs.com/rush — the rush of the speedy fall. How the QUAI reward pool is formed from the event's fees, how skill, volume and speed set each wallet's share, the limits, and the read-only leaderboard API.
  • Hartii CLI (beta) — The Hartii terminal wallet for Quai: full-screen TUI, scriptable --json commands, an MCP server for AI agents and a BETA personal trader (Observe and Paper only), wired to HartiiLabs, HartiiSwap, Airdrop, OTC Link, Claim and the Wall.
  • Personal holder trader (beta) — A spot trader you run on your own computer. It reads Hartii markets and records every decision. BETA, Observe and Paper only. Live trading and the HBOME access registry are not available.
  • 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.
  • Receipts — The hartiilabs.com/receipts page lists this build, every tagged release since v1.42.0 and the core mainnet contracts with their code size, code hash and Quaiscan link. Read only.
  • Hartii Forge (proposed, not live) — A proposed fixed-scope build offer. Nothing can be ordered yet and no page, slot or payment exists.

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.
  • Hartii.org exchange — Native HartiiSwap workspace, review flow, asset support and migration boundaries.
  • 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.

Subscriptions

  • Hartii Subscriptions — On-chain subscriptions in native QUAI. Anyone can create a plan; subscribers pay no gas.
  • Contract reference — Addresses, interface, limits, events and reverts for SubscriptionFactory and SubscriptionPlan.

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 read Hartii markets. It starts read-only. An explicit legacy profile lets an existing AgentVault agent 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, how the MCP profiles work, and what the personal holder trader does not enforce on-chain.
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.