Guides
New to Hartii or to Quai? Start here. Each guide walks through one task from start to finish using the exact labels you see on screen, then links to the technical reference if you want the details.
Start here
| Guide | You'll learn to |
|---|---|
| What things cost | See every fee in one place before you spend anything |
| Buy and sell a token | Trade any launched token on HartiiLabs |
| HPAY: send to an @name | Pay someone by their Hartii name |
| Play Hartii Games | Play free, then try the daily challenge, Boards and the Shop |
| Glossary | Look up words like bonding curve, gas, slippage and zone |
Which app do I need?
Hartii is a group of separate apps, each on its own site. Pick by what you want to do.
| I want to... | App | What it is | Site |
|---|---|---|---|
| Buy, sell, swap or launch a token | HartiiLabs | Tokens | hartiilabs.com |
| Play a game | Hartii Games | The arcade | hartiigames.com |
| Send or request QUAI or reviewed WQI, airdrop, make an OTC deal or run a claim campaign | Hartii Biome | Payments and distribution tools | hartiibiome.com |
| Buy, sell or make NFTs | Hartii Gallery | NFTs | hartiigallery.com |
| Mine and burn QAXE | QuaiAxe (partner project) | Partner mining | quaiaxe.com |
Do I need a wallet?
No wallet needed: reading these guides, looking at a token page on HartiiLabs, and free play on Hartii Games.
A wallet is needed to do anything that moves money or is saved under your name: buying, selling, swapping or launching a token, sending or requesting a payment, an airdrop, an OTC deal or a claim, buying or selling an NFT, and the daily challenge or a spot on a leaderboard.
Your wallet is the app that holds your keys: Pelagus on a computer, or the Blip app on your phone. Set it to Quai Mainnet and keep some QUAI for the amount plus network gas. Every transaction is signed in your own wallet; Hartii never holds your keys. If something stays pending, check it on quaiscan.io before trying again, and never send a payment twice blindly.
HartiiLabs — launch and trade tokens
| Guide | You'll learn to |
|---|---|
| Receive QUAI | Show your address or QR code and get a payment link |
| Launch a token | Create your own token on a bonding curve |
| Buy and sell a token | Trade any launched token |
| Graduation | Understand what happens when a curve fills |
| Swap tokens | Swap on HartiiSwap |
| Pools and farms | Add liquidity and use farms |
| Boost a token | Buy placement in the Promoted row |
| Share a token chart | Post a chart card to Telegram or X |
| Engrave the Wall of Blocks | Leave a permanent on-chain message |
Hartii Biome — payments and tools
| Guide | You'll learn to |
|---|---|
| HPAY: send to an @name | Pay someone by their Hartii name in QUAI or reviewed WQI |
| HPAY: create a payment link | Ask to be paid with a QUAI link; direct WQI links are planned |
| HPAY: get your @handle | Register an optional shorter link and check its original transaction (staged) |
| HPAY: pay or request WQI | Use exact WQI units with separate QUAI gas (staged) |
| HPAY: take payments in a shop | Charge a QUAI dollar price with a QR code; exact WQI is planned (Beta) |
| HPAY: read your inbox | See the QUAI or WQI payments a wallet sent and received (Beta) |
| HPAY: read the Dashboard | Inspect selected-range sent/received totals, CSV and two-sided PDFs (staged) |
| Airdrop to many wallets | Send to a list of wallets in batches |
| OTC Link: sell a token for QUAI | Make or fill a private token-for-QUAI deal |
| Claim campaigns | Fund a claim campaign, or claim your share |
| Find the right Biome tool | Use the product navigator |
| Hartii: the new site entrances | Understand dedicated HPAY, the collection/archive, the HBOME holder room and tracker |
| HBOME governance | Verify the live governance contract, deployment record and empty-vault boundary |
| Approve a one-time announcement | Review exact Discord text and sign YES or NO without sending funds (staged) |
| Your profile picture | Use an NFT you own as your picture, with one free signature |
| HPAY: PDF receipts and statements | Keep a chain-based receipt or selected-range statement, including WQI limits |
| Read the admin wallet balance | Understand the read-only QUAI snapshot planned for Biome and Labs |
Power users — terminal and AI agents
| Guide | You'll learn to |
|---|---|
| CLI 1: install and first wallet | Install the Hartii CLI and create a wallet |
| CLI 2: your first trade | Check balances, dry-run, then trade |
| CLI 3: connect an AI agent | Let Claude Code or Cursor use Hartii, with caps |
| Agent Terminal: existing vaults (legacy) | Manage or recover a capped vault you already have |
| Personal trader: try it in Paper (beta) | Run the trader in Observe or Paper on your own computer |
Games, Gallery and QuaiAxe
| Guide | You'll learn to |
|---|---|
| Play Hartii Games | Play free or the daily challenge, check Boards, and use the Shop and Me |
| Gallery: buy, sell and offers | Buy, list and make offers on NFTs |
| QuaiAxe: set up a miner | Point a miner at QuaiAxe and track your share |
| QuaiAxe: trade and supply | Trade QAXE and read the live supply tracker |
For developers
| Guide | You'll learn to |
|---|---|
| Build zone-ready Quai apps | Keep a Quai dApp correct as zones are added: the zone model, ten rules, a migration path and a registry sketch |