Hartii developer docs

HartiiLabs

Versions & changelog

HartiiLabs ships behind one version number, kept in sync everywhere it's checked: package.json's version, the <meta name="application-version"> tag on every page, functions/_lib/version.js's APP_VERSION (surfaced by GET /api/health as version), and the newest dated entry in the app's own CHANGELOG.md — the app's test suite fails if any of these disagree.

Labs 1.75.1 — 2026-11-17 — Verify the site with the command-line tool

The receipts page now tells you to run hartii verify-site, which checks hartiilabs.com against the web build key built into the signed command-line tool. It used to point at a script in a repository that is not public.

Labs 1.75.0 — 2026-11-17 — Security release

A security release that followed an adversarial review of the site, the CLI and the contracts. Every finding was reproduced by a test before it was fixed.

  • Signed website build. hartiilabs.com now publishes a signed list of every file in the build at /.well-known/hartii-build.json (with a .sig signature, ed25519 key id a17f68595150dac6). The new hartii verify-site command checks the live site against it, and /receipts shows the live build version, commit, manifest hash and key id. Details: Verify the website. /.well-known/security.txt is published too.
  • Hartii CLI 0.7.0 ships with it: wallet export and removal need a terminal, loosening a spending cap needs a terminal confirmation, MCP swaps are limited to QUAI, WQUAI and factory-verified tokens, the Qi ledger is sealed, wrong checksums and look-alike addresses are handled more strictly, and update downloads are size-capped. Details: CLI 0.7.0.
  • Token logos are only served as checked images. The logo endpoint accepts PNG, JPEG, WebP and GIF by their file signature, ignores what the image host claims, and treats anything else as missing (nothing stored is deleted).
  • Sturdier limits on public write endpoints. Chat posts, guest sessions, comments, reactions, flags, pixel-wall reservations and a few challenge endpoints now have daily limits that are shared across servers. On the QuaiAxe pixel wall one buyer can hold at most 2 spots at once, and a quarter of the wall can be held at a time.
  • The admin hide list fails safe. If the stored list cannot be read, the endpoint answers with an error instead of overwriting it, and reads keep the last good list.
  • Faster static file serving. Static assets no longer pass through the server functions.
  • Page previews handle names with special characters correctly.
  • No contract, fee or transaction-shape change.

Labs 1.74.1 — 2026-11-17 — The CLI page matches CLI 0.6

The /cli page still listed default spending caps of 100 QUAI per transaction and 500 per day. CLI 0.6 has no default caps: they apply only once you set them (setup recommends it), and --yes is refused without them. The page now says so, shows the 0.6 wallet-first home, lists contacts and qi, and explains the release signature next to the checksum. CLI 0.6.1 fixes the setup's "Waiting for funds" screen, which could miss a deposit that landed before its first balance check; its README now describes 0.6.0, and hartii qi ? prints its example correctly.

Labs 1.74.0 — 2026-11-17 — Hartii CLI 0.6.0

The terminal wallet (BETA) gets a guided first run (create or import, a 12-character password, the phrase shown once and a 3-word check), no default spending caps, a plain-sentence review before every send with warnings that never block, a last-4-characters check for a new payee, contacts, encrypted local files, signed updates and BETA Qi commands on Orchard first. Details: CLI.

Labs 1.73.2 — 2026-11-15 — Buying and selling inside Blip

Blip signs from a separate app wallet for each website, which is usually empty while your QUAI sits in your main Blip wallet. Labs used to stop before Blip was asked ("Insufficient QUAI", or a failed gas estimate). Now every buy, sell, swap and other send inside Blip first asks Blip to move the missing amount from your main Blip wallet into this site's app wallet. That amount is the trade value plus buffered gas plus 10%, worked out from a live gas estimate. Labs waits until it arrives, then asks you to sign the trade. One top-up covers an approval and the sell after it.

Up to your Blip auto top-up limit (Blip's default is 1000 QUAI) Blip does this without a prompt; above it Blip shows its own approval screen. If you cancel it, or your main Blip wallet is short, the trade stops with "Nothing was sent". An older Blip without this feature works as before. Pelagus and other wallets are unchanged. No contract or fee changed.

Labs 1.73.0 — 2026-11-13 — The home page is a trading desk

The home page opens on a chart and a buy/sell box. Above them: one slim bar with the protocol facts and Launch a token, and a trending strip of tokens; pressing one puts it on the board. The board starts on the #1 trending launch.

The token's name on the board is a pair switcher: it opens a list of every Labs pair over the chart, with a search, Favorites / All / On curve / Graduated tabs, the last price and 24h change of each, and a star to keep favorites in your browser. Picking one changes the chart and the buy/sell box. Under the chart are the latest trades; depth, holders and every trade are on the token's own page. Scroll down for the full All launches grid with Your block. No contract, fee or transaction path changed.

Labs 1.72.0 — 2026-11-13 — Your block: buy several launches together (beta)

In the Grid layout of All launches, press + on up to 10 tokens to put them in Your block. Enter one total in QUAI; it is split equally between the tokens. Before you sign, the block shows what each share buys at the current price, its price impact, how many wallet prompts there will be, the trading fees and an estimate of network fees.

Fill the block sends one normal buy per token, in order, through the same path as any single buy on Labs: one wallet prompt each, the usual auto slippage limit, its own network fee. There is no basket contract, no approval and no sell. Prices can move between buys. Each row then shows that buy's own result from its receipt: confirmed, reverted, or unconfirmed when the outcome could not be read. Rejecting a prompt, switching wallet or an unconfirmed buy stops the rest of the block; nothing further is asked of the wallet. Each buy counts toward Hartii Rush like any other trade.

The grid also gets tile sizes (S, M, L), price, 24h change and market cap on hover, and a Hartii Rush countdown line. No contract, fee or transaction path changed.

Labs 1.71.0 — 2026-11-13 — All launches: square grid

All launches has a Layout switch on its toolbar: List (the table, still the default) or Grid. Grid shows every launch as a square token image with its name under it and nothing else; each tile opens the token page. The view tabs, the sort and the search work the same in both. The browser remembers the choice, and adding ?layout=grid or ?layout=list to the address opens that layout directly. No API, contract, fee or transaction path changed.

Labs 1.70.0 — 2026-11-13 — /ez, one block run

A static page at /ez shows 16 transactions from the treasury (8 approvals for the HartiiSwap router and 8 small bonding-curve buys) that were signed up front and confirmed together in Quai mainnet block 11103766 on 2026-11-12, plus a 17th zero-value transfer from the same wallet in the same block. The page also covers the two earlier attempts that evening: a first batch that was mined and reverted because its hand-built transactions carried no access lists, and a second that confirmed 16 of 16 with 15 in one block. Every block number and transaction hash on it is from chain receipts and links to Quaiscan. It is read-only: no wallet connection, no API and no trading. No contract, fee or transaction path of the app changed.

Labs 1.69.1 — 2026-11-12 — rush.hartii.org

The Hartii Rush board is also live at rush.hartii.org, and /rush links to it. No contract, fee or transaction path changed.

Labs 1.69.0 — 2026-11-12 — Hartii Rush: 5 days, skill, volume and speed

Hartii Rush runs 5 days and is scored on volume (60%) and speed (40%, trades early in the event weigh up to double), multiplied by skill. /rush is one autumn page with the live pool, the full calculation, a worked example and the leaderboard. API rows carry speedWei instead of holdWei. See Hartii Rush.

Labs 1.68.0 — 2026-11-12 — Hartii Rush

A new trading event page at /rush with a live leaderboard and the read-only /api/rush/leaderboard. The event's treasury fee take goes back to traders as one QUAI airdrop, scored on volume, holding and skill. See Hartii Rush. No contract, fee or transaction path changed.

Labs 1.66.1 — 2026-11-12 — Form labels and empty states

Launch form labels now identify and focus their controls. Pool search and sorting have accessible names. Empty or unavailable liquidity tools keep the existing page styling, and the empty portfolio no longer describes the launchpad as awaiting launch. The phone bar, fields, values, fees and transaction paths are unchanged.

Labs 1.66.0 — 2026-11-12 — Constraint Desk and Fill Ledger

CLI 0.5.0 adds manually reviewed HartiiSwap decisions, local journal and canonical receipt observations, and private offline HTML/JSON reports. Indexed values distinguish raw wei, displayed QUAI and unknown data. The existing signing and spending safeguards remain in force. See Hartii CLI. No funded execution qualification is implied.

Labs 1.65.0 — 2026-11-12 — Launching and sharing, tidied up

Nine small changes around launching a token and opening a token link.

  • Launch page. The ticker suggestion is now the first word of the name ("Tibo Coin" gives TIBO, it used to give TIBOCOIN). Three short steps sit right above the launch button: fill in, approve in your wallet, go live.
  • After a launch. The launch screen has a Save image button next to Post on X. The share picture used to disappear if it was not ready the moment the launch confirmed; it now waits and retries for about half a minute.
  • Home page. The all-time trading volume is shown beside the 24-hour volume. It is the same total the Analytics page shows.
  • Wallet help. A new page, /wallets, lists the wallets that work with HartiiLabs (Pelagus on a computer, Blip on a phone) with their links. The "no wallet found" message links to it. One dead wallet link on the testnet Hatchery page was replaced.
  • Holder counts. A token whose holder count is not known shows a dash. In two places a missing count could be shown as 0; a real zero still shows 0.
  • Old placeholder pages. /governance, /treasury and /staking were placeholder pages with nothing behind them. They now send you to the tools page on Hartii Biome, https://hartiibiome.com/tools. Arena, Farms and Mining are unchanged.
  • Token links on a phone. The page no longer jumps while it loads (the footer and the live trades strip used to move the content), and the token's data is requested at once instead of after the page code has arrived.
  • A short link. hartiilabs.com/tibo opens the Launch page. It counts visits per day and stores nothing about the visitor: no cookie, no IP address.

No contract, fee or limit changed.

Labs 1.64.0 — 2026-11-12 — A page for the Hartii Operator Tools

HartiiLabs has a new page, /operator-tools, about four open-source command-line tools for teams that build apps on Quai: quai-tx, quai-release, quai-watch and quai-replay. The page says what each one does and links to the source on GitHub and to the tools' own site, https://ops.hartii.org. The tools are a beta and are not audited. They are separate from the Hartii CLI, the terminal wallet. Nothing else on HartiiLabs changed.

Labs 1.63.0 — 2026-11-12 — The Liquidity pages in the new design

The pools list and the pages to add, remove, lock and reward liquidity now have the new design, and so does Farms. Every figure and every step is the same as before. With this release every destination in the top bar (Discover, Launch, Trade, Swap, Liquidity, Portfolio) uses the new design.

Labs 1.62.0 — 2026-11-12 — Portfolio and Trade history in the new design

The Portfolio page (/portfolio) and Trade history (/history) now have the new design. The figures are the same as before and come from the same places. One thing moved: your achievements now sit below your holdings.

Labs 1.61.0 — 2026-11-12 — The Swap page in the new design

The Swap page (/swap) now has the new design. It works exactly as before: the same tokens, the same quote, the same 0.30% swap fee, the same price protection choices. Only the look changed.

Labs 1.60.0 — 2026-11-12 — The Launch page in the new design, and a Portfolio fix

The Launch page (/launchpad/create) now has the new design. The fields, the fee and everything else on the page are the same as before; only the look changed. On phones the Launch button sits above the tab bar.

One fix on the Portfolio page: a loss was printed with the minus sign in the wrong place. A loss of half a QUAI showed as 0.-5 QUAI; it now shows as -0.5 QUAI. This was a display mistake only. No balance or trade was affected, and gains were always shown correctly.

Labs 1.59.0 — 2026-11-12 — The token page in the new design

Every token page (/token/{address}) now has the new design: the price large at the top, the launch curve as a thin line under it, a row of figures (market cap, 24h volume, holders, age), the chart, and the same buy and sell panel as the home page. On phones the Buy and Sell buttons stay at the bottom of the screen. Everything the page had before is still there, in the same tabs. Only the look changed: no number, rule, fee or contract changed.

Labs 1.58.0 — 2026-11-12 — A quick start for AI agents

https://hartiilabs.com/llms.txt now starts with "Trade as an agent": get a quote without a key, connect the Hartii CLI's MCP server read-only, and, if the wallet owner chooses, allow capped trades. Every trade is a dry run first and needs the owner's review. The steps are the same as in CLI guide 3. The agent manifest names llms.txt and the CLI commands, and the site footer has a "For AI agents" link. No contract, fee or trading rule changed.

Labs 1.57.1 — 2026-11-12 — The Launch form opens visible on small phones

On small phone screens (for example 360x640 and 390x844) the form on the Launch page stayed invisible until you scrolled down a little. It now shows as soon as the page opens. Nothing else changed: no contract, fee or API change.

Labs 1.57.0 — 2026-11-12 — A launcher and a market, nothing else in the way

HartiiLabs now shows only what belongs to launching and trading. The top bar of the new design has six entries (Discover, Launch, Trade, Swap, Liquidity, Portfolio) and the menu, now called More, is shorter. Twelve tools (CLI, Personal trader, Agent terminal, Market maker, Developers, Send QUAI out, Receive, Wall of Blocks, Hatcher World, Ecosystem stats, Orchard testnet, Flow) are listed in the Hartii Biome tools directory instead; their pages keep working at the same addresses. Speed mode is removed. No contract, fee or API change.

Labs 1.56.0 — 2026-11-11 — Trade view on phones, Depth, All launches

On phones the home page of the new design has an Overview | Trade switch. Trade shows the chart, a small depth table and the buy and sell panel on one screen, also inside a wallet's in-app browser. Depth is new on desktop too, as a tab. The launch list pages (/launchpad/trending, /launchpad/new) are rebuilt as one All launches page, the Dark button sits beside Tools on phones, and link previews use the new design. No contract, fee or API change.

Labs 1.55.1 — 2026-11-11 — Phone top bar

On phones a connected wallet button shares the first row of the top bar with the wordmark and Tools, and the Dark switch in the Tools menu is sized to its label.

Labs 1.55.0 — 2026-11-11 — The new design

The new design is the default for every visitor: a new frame, a new home page with a launch list, a featured market and the existing buy and sell panel, and a light and a dark theme. The classic design stays available with ?ui=classic. Only the home page is rebuilt; other pages open in their earlier layout inside the new frame. No API, contract or trade-path change. See The new design.

Labs 1.54.0 — 2026-11-06 — Receipts

A public Receipts page at /receipts: tagged releases and the core mainnet contracts with their on-chain code hashes. Read-only.

Labs 1.53.0 — 2026-11-05 — Hartii CLI 0.4.0

  • Hartii CLI 0.4.0: read-only hartii gallery and hartii studio commands and six matching MCP tools, and NFT holdings in hartii portfolio; see CLI 0.4.0. Data comes from the Gallery public API; no visitor counts. No contract change.

Labs 1.51.0 — 2026-11-03 — Lint clean-up

Maintenance release with no behaviour change for users: lint errors went from 419 to 0, about 30 unused imports and exports were removed from functions/ and src/, /hatchery joined the unlisted routes, and the Agent page notes that Node 22 or newer is needed.

Labs 1.50.0 — 2026-11-02 — QuaiRelay v2 on /blipsend

/blipsend's contract route now sends through QuaiRelay v2 (0x003D2EC4C1Ff5e98898fEa6C6D1AAaA48FaDc11A), which refuses a Qi-ledger recipient by name; v1 is retired. The page also refuses a Qi-ledger destination (second byte 0x80 or above) before the wallet opens. See QuaiRelay.

Labs 1.49.0 — 2026-11-02 — /agent redesign

/agent is redesigned: a feed of real on-chain trades by configured agent vaults, two paths (Local trader, recommended; Existing vault, with vault creation marked as coming), a Conservative / Normal / Degen preset picker that writes the hartii trader init and hartii mcp --allow-writes command for you, and a client picker for the setup <client> command.

Labs 1.48.0 — 2026-11-02 — Dependency security update

Security-only release: every high-severity and production-dependency advisory in the app and @hartii/agent-mcp is fixed (body-parser, undici, vite; zod 4.6.7). No behaviour change. Remaining advisories are in development-only tooling (Hardhat, eslint) and never ship to users.

Labs 1.47.0 — 2026-11-02 — Portfolio, price alerts and trader slippage

  • @hartii/agent-mcp 0.4.0 adds hartii_portfolio (Labs holdings and QUAI value of any public address) and local price alerts: hartii_alert_set, hartii_alert_list, hartii_alert_remove, hartii_alert_check. Alerts live in ~/.hartii-agent/alerts.json (override with HARTII_ALERTS_FILE), need no key and are delivered only in chat. The read-only profile now has 11 tools, legacy-delegated 21. See MCP setup.
  • The local trader gets slippage protection. The preset sets the on-chain minimum-out (--slippage-bps may only lower it), clamped to the owner-signed policy ceiling of 1% today, so normal and degen clamp to 1% for the trader while MCP trades keep 1% / 2% / 5%. A trade that would breach it is skipped and logged as slippage_skip. hartii trader init without --preset now defaults to conservative.
  • No contract change.

Labs 1.46.0 — 2026-11-02 — CLI cap presets

hartii mcp --allow-writes and hartii trader init accept --preset conservative|normal|degen, which sets the per-transaction and per-day caps (10/50, 50/250, 250/1000 QUAI). On MCP buy, sell and swap a preset also enforces a slippage ceiling (1%, 2%, 5%). Explicit caps may only lower a preset, and a preset alone does not enable writes. See CLI. No contract change.

Labs 1.45.0 — 2026-11-01 — Chat-first agent setup

@hartii/agent-mcp 0.3.0 adds the read-only hartii_setup tool and a setup <client> CLI. Both return a ready-to-paste config for Claude Code, Claude Desktop, Codex, Cursor or a generic MCP client. See MCP setup. No contract or money-path change.

Labs 1.42.0 — 2026-10-26 — Wall of Blocks: a ledger you can verify

  • Every Wall record has a VERIFY action that re-reads it in your browser through the RPC you choose, check by check (transaction, event, stored bytes, signer, block), and fails visibly when a read fails.
  • A raw view shows the stored bytes as a hex dump plus the event fields, each copyable, or the whole record as JSON. Search by transaction, block or address.
  • Before you publish, you see the exact bytes, length and live price plus gas. The signing flow is unchanged.

Labs 1.41.0 — 2026-10-26 — Hatcher World 2: a living world, and a journal that follows you

  • Weather: clear, cloudy, rain and storms on a 20-minute schedule, with fog, rain, lightning and thunder (no flashes with reduced motion). Wind nudges your Elder in flight.
  • Your Elder has a body: health, stamina and injuries. Sprinting and steep climbs tire it; a fall leaves a wing strain until it rests at a nest or pad. Berries, crystals and camel tokens heal it.
  • Bond and abilities: at bond 10, 30 and 60 your Elder learns tight turns, faster recovery and a fourth bolt per shot.
  • Gather and care: berry bushes and crystal outcrops regrow on their own clocks, beasts drop feathers, and a stranded hatchling and a young Elder wander the island; feed them and they follow you.
  • Journal, quests and saves: five quests, earned looks and achievements, daily flight boards with checked runs. Signing in is optional and is a message signature only, never a transaction; the journal also works offline on your device.
  • Nothing to buy and nothing at stake.

Labs 1.40.1 — 2026-10-25 — Hatcher World: phone flight buttons never overlap

  • On phones the flight controls sit in two columns (SLOW and SPRINT beside SUPER and SHOOT), so the floating move stick never meets them, and LAND is a small pill under the top bar. Checked on screens from 360 to 430 px wide, with and without the browser bars.

Labs 1.40.0 — 2026-10-25 — Hatcher World: air combat 2.0, built for an upright phone

  • Three shot charges that come back one at a time, shown under your Elder. Hold SHOOT and it fires as each one returns.
  • Aim: on a laptop the mouse aims and a click shoots; on a phone you aim by flying, with generous aim help. The reticle turns red when a beast is in your sights.
  • A super for every Elder, set by its body plan: Breath Beam, Shockwave, Twin Volley or Dive Strike. Damage you deal fills its ring; press SUPER (right-click or E on a laptop) when it glows.
  • Three kinds of sky beast (spitters, divers and swarms), three beast lairs with three waves each, and now and then a Sky Tyrant boss.
  • Damage numbers and kill streaks (DOUBLE, TRIPLE, QUAD, RAMPAGE). Diving buys speed; climbing costs it.
  • Phones play upright with a floating move stick under your left thumb and a slim bar on top. A sideways phone asks to be turned upright. Starting play goes full screen where the browser allows it (on iPhone: Share → Add to Home Screen), and the page never zooms by accident.
  • Nothing to buy and nothing at stake: beasts down is a score.

Labs 1.38.0 — 2026-10-25 — Hatcher World: Elders can fall, and agent mode

  • Your Elder can go down. Sky beasts' orbs wear an Elder's health away; it heals slowly when you break away. At zero it falls, you are thrown clear and a parachute opens. Steer it down and land; land in the sea and the tide carries you ashore. Your Keeper has no health of their own.
  • Revive it: once you land, crystals pop up one after another to lead you to a tiny wooden camel in the shape of the Hartii logo. Pick it up and your Elder comes back to you.
  • Agent mode for builders and AI agents: /hatchers/?agent=1 and hatcherWorld.agent play with the player's own controls. They can walk and fly by autopilot, point a cinematic camera and record clean gameplay video from the page.

Labs 1.37.1 — 2026-10-25 — Hatcher World: full screen sideways or upright

  • On a phone, tap FULL and choose SIDEWAYS or UPRIGHT. Where the browser allows it, the screen locks that way. Where it does not, a prompt asks you to turn your phone and clears once you have.
  • On iPhone: Safari has no full-screen button, so use Share → Add to Home Screen. Hatcher World then opens full screen from its icon, sideways or upright.

Labs 1.37.0 — 2026-10-25 — Hatcher World: air combat and five Keepers

  • Fight in the air: while you fly, wild sky beasts circle ahead of you and spit slow glowing orbs. Shoot them down; your Elder's shield refills after a few seconds without a hit. A count of beasts down shows at the top. Free play only: nothing is at stake and there is nothing to buy.
  • New flight controls: push the stick (or W and S) up to climb and down to dive. On phones the side buttons are SPRINT, SLOW, SHOOT and LAND; on desktop Shift sprints, Q slows, Space shoots and F lands.
  • Choose your Keeper: Ahmed, Mei, Arjun, Sofía or Erik, each in their own suit or outfit (some with hats) and a watch. Use the CHARACTER button. They all play the same, and your pick is kept with your progress.

Labs 1.36.0 — 2026-10-25 — Hatcher World grows: sky isles and a richer world

  • Three sky isles float over the sea: The Race Spire, Egg Grove and Elder's Roost. Fly an Elder up, land on the pad and walk the top. Each has a small wood and a waterfall that falls all the way to the sea.
  • A richer look everywhere: swaying trees and grass, mossy boulders, meadow flowers that glow at night, surf round the coast, lit mountain slopes and a cloud layer you can fly through.
  • The live Orchard testnet eggs and creatures now also grow on Egg Grove, each from the genome its token carries on chain.
  • Ready for the next mini-games: two race courses (Spire Circuit and Falls Dash), ghost Elders that replay a recorded flight, and six more egg-hunt spots on Egg Grove. The races themselves come next.
  • Smooth first: on slower devices the grass, clouds and decor thin out before the frame rate drops.
  • Free to play: no tokens, stakes or wallet. The Hatchery itself stays on Orchard testnet; mainnet is off.

Labs 1.35.0 — 2026-10-25 — Hatcher World becomes playable

  • Hatcher World is now a game you play as a Keeper. Walk with the keyboard, a gamepad or the on-screen joystick. Call an Elder, the only creatures you can ride, and fly it over a new outdoor island with cliffs, waterfalls, nests and landing pads.
  • Phones play upright or sideways, with a full-screen button.
  • Day and night follow your local time. A field journal records each creature you find, and you can feed and pet creatures. A 60-second guided first flight gets you started.
  • Free to play: nothing here involves tokens, stakes or a wallet.

Labs 1.34.0 — 2026-10-24 — Hatcher World, detail pass

  • Hatcher World gets much richer while using less of your device:
    • soft bloom and depth of field, glossy floors, a night sky with an aurora, a glass dome and a glowing garden with fireflies;
    • every creature body plan has its own skin, and creatures react when you come close;
    • eggs show a faint creature inside as they warm, and the hatch has shell shards, a burst and a first breath.
  • The Atrium appears first and the rest streams in. Weaker devices automatically drop the heavier effects.

Labs 1.33.0 — 2026-10-24 — Hatcher World, quality pass

  • Hatcher World grows to 60 example creatures in five wings, with organic eggs, detailed creatures, cinematic lighting, a giant Atrium egg that pulses with each block, and a staged hatch. On phones, tap a pod to fly there.
  • Live and read-only: the counter shows the real Quai block, and a labelled corner shows the four Orchard testnet eggs. Photo mode saves a picture, and Copy link opens the world on a chosen creature.
  • Hatcher World is now in the menu (Explore) and on the Hatchers pages.

Labs 1.32.0 — 2026-10-24 — Hatcher World

  • New 3D page at /hatchers/: walk the Hatchery's five lifecycle wings of example creatures (built with Kimi 3D Make). Every creature is an example; the Hatchery itself is on Orchard testnet only, not mainnet.
  • A holder Shell needs at least 100,000 tokens (a fixed amount in the contract), not "0.01% of supply".

Labs 1.31.0 — 2026-10-24 — Hatchery testnet playground (Orchard only)

  • New public Orchard testnet playground at /developers/hatchers/testnet. The Hatchery contract (HartiiHatchery) is deployed on Orchard (chain 15000) at 0x007ae402147081E1920dbED40D8AF7DC5fDb94B6 (deploy block 8081720) and was rehearsed end to end: hatch, evolve to Juvenile, holder Shell and Midwife Shell. Four Orchard test eggs are on the page. With Pelagus on Orchard and free faucet test QUAI you can warm an egg (a buy on its own curve), hatch, evolve, claim Shells, or launch your own test egg (the creation fee is read live). The page refuses to send anything unless the wallet is on chain 15000. Test QUAI has no value and Orchard can be reset. See Hatchers.
  • The stage thresholds are now confirmed by the deployed contract (constants read back on Orchard): Stirring at 100, Hatch at 500 and Juvenile at 5,000 QUAI raised, Elder on graduation; the Shell window is 7 days; a holder needs at least 100,000 tokens to claim the holder Shell.
  • The Hatchery is not deployed on Quai mainnet. It is still proposed for mainnet, and /hatchery stays hidden there. Elders evolving further through specific achievements is planned, not built.
  • CSP connect-src gains exactly https://orchard.rpc.quai.network (read-only Orchard RPC); nothing else changes.

Labs 1.30.0 — 2026-10-23 — Hatchers pages (Hatchery not live)

  • New read-only pages /developers/hatchers (progress, the proposed stage ladder and 36 example creatures) and /developers/hatchers/guide (a plain-words guide). The Hatchery is in development and not live: no Hatchery contract exists on Quai mainnet, and the pages show its contract as "not deployed yet". The examples are seeds drawn by the renderer, not on-chain creatures. See Hatchers.

Labs 1.29.2 — 2026-10-23 — hartii.org signposted

  • The footer's Ecosystem list now starts with "Hartii.org — start here" and also lists HartiiPay. Places that mention HartiiPay carry one quiet line saying it is part of hartii.org, the Hartii start page. No layout change.

Labs 1.29.1 — 2026-10-23 — Achievement Rewards closed

  • Achievement Rewards is closed. Nobody had claimed (80 of 80 places left), so the contract 0x001d607B22de6ACcFB4adEE62838DED222Aa0c8a was paused and its 2,000 QUAI pool withdrawn. The pool funds 60 more free 25 QUAI claims on the HartiiPay welcome claim (round 2, open until Sun 25 Oct 2026, 22:59 UTC).
  • /rewards states the closure and still shows the 12 achievement badges; they no longer pay a reward. POST /api/achievements/voucher answers 410 with Achievement Rewards is closed. before any signing.

Labs 1.29.0 — 2026-10-22 — logo wall pays the QuaiAxe wallet

  • QuaiAxe furnace wall payments now go to the QuaiAxe wallet 0x000465572160E50fE61CD3bebE1DD37fcB2C6145 (QuaiAxe's own wallet, not a Hartii wallet). /api/qaxe-pixels/wall and /reserve return it as payTo, and confirm accepts only it. An order reserved before 22 October 2026 16:00 UTC may still settle to the old treasury address so nobody mid-payment is stranded. See The furnace wall.
  • QAXE keeper Worker: the per-transaction gas cap is 30 QUAI (was 20), because gas near 64,000 gwei held a 365 QUAI mining collect back. See The keeper.

Labs 1.28.0 — 2026-10-21 — QuaiAxe furnace wall API

  • New /api/qaxe-pixels/* endpoints back the paid logo wall on quaiaxe.com: wall, logo, reserve (15-minute cell hold) and confirm (on-chain check that the reserving wallet paid the treasury the exact quote). See The furnace wall.

Labs 1.27.7 — 2026-10-21 — transparent image fallbacks

  • Missing, loading and failed token images show a letter on a transparent ground, preserving their reserved dimensions. Successfully loaded artwork retains its frame.
  • Market Flow tokens without an available image use an open letter mark; hover, selection and token details remain available.

Labs 1.27.4 — 2026-10-20 — branded-token and launch-recovery safety

  • The HBOME, QAXE and ART Swap shortcuts are pinned to their canonical token contracts. A creator-launched token that copies a symbol cannot replace a shortcut by reporting more volume.
  • Before a launch wallet request opens, the page acquires a per-wallet Web Lock and round-trip verifies a unique, attempt-owned durable browser reservation. A second tab cannot overwrite, update or clear it; corrupt storage and unavailable secure randomness fail closed. An unresolved launch does not become retryable merely because six hours passed.
  • Hashless errors after the wallet opens remain held unless the wallet explicitly rejected. Check again clears the hold only for the exact submitted hash with final status 0 or 1; missing, mismatched and out-of-domain receipts stay unknown.
  • PayLink recipient and fixed-amount validation matches HPAY: no Qi-ledger address and no value above uint256.

Labs 1.27.1 moved Receive and handle links to the canonical hartiipay.app/hpay origin; older Biome links continue to open.

Labs 1.27.2 introduced 128-pixel WebP token-logo thumbnails for lists and tiles while token pages retain full-resolution logos. Labs 1.27.3 separates thumbnail cache entries from previously cached full images; see the logo endpoint.

Labs 1.26.3 — Quainance token feeds and indexed charts

  • The Developers page documents the paginated Hartii token feed, deployed Hartii launch factories, and their common TokenLaunched event.
  • Quainance venue trades now persist six OHLCV timeframes in D1, with idempotent replay and bounded candle repair for already indexed markets.
  • Indexed Quainance token pages use the shared candlestick/line/area chart, timeframe, indicator, scale, measure and expand controls.
  • Quainance's Trade Zone currently recognizes Hartii V1, V3 and V4; V5 is not in its deployed factory registry, so V5 tokens remain absent there until Quainance adds V5 verification.

Labs 1.26.2 — Hartii CLI 0.3.4

  • Hartii CLI 0.3.4 rejects inline values on Boolean safety switches before any command, TUI or MCP dispatch. Use bare --dry-run, --demo, --yes and --allow-writes switches. The package, public source tag and downloadable archive carry the same version.
  • This is a CLI parser-safety fix. It changes no contract, Worker, wallet-signing path or site interaction.

Labs 1.24.0 — Admin wallet card

  • The Ecosystem page adds an Admin wallet card with a balance read directly from the public Quai RPC in the visitor's browser. No wallet or signature is needed. A failed read is a dash; a returned zero is shown as 0 QUAI.
  • The figure is one source-selected address at the time of the read. It does not prove current factory ownership, reserves, backing or funds available to spend.

SemVer

  • MAJOR — a breaking public API or live-protocol change, or a launch-factory generation cutover (e.g. V3 → V4). This is the only kind of release that can break an integration.
  • MINOR — a new capability or a measurable behaviour change (the 1.1.0 latency programme below is a MINOR release).
  • PATCH — a fix with no new surface.

Smart-contract generations (TokenFactory V1–V4) are a separate, immutable axis from the app version — a contract generation is superseded, never "versioned up." See Contracts overview.

Where to read the live version

GET /api/health → versionthe one-line check — see API reference
<meta name="application-version">on every page's <head>, same number
Git tag vX.Y.Zon the exact commit that's live; every version that goes live gets one

Changelog

A user-facing summary of the app's own CHANGELOG.md. Read the source file in the hartii-labs repo for the full, line-level history.

1.26.0 — 2026-10-14 — new launches use TokenFactoryV5

  • New token launches go through TokenFactoryV5 (push-paid fees), live on Quai mainnet since 2026-10-14. The launch wizard, the 5 QUAI creation fee and the LP Reserve preview are unchanged for you; the supply split and fee shares are the same as V4.
  • On a V5 token the treasury and creator fee cuts are paid inside each trade instead of waiting for a withdrawal. See Contract map §8.
  • V1, V3 and V4 tokens are untouched and keep trading. The indexer, the health check and the live feed read all four factories.
  • This is a launch-factory generation cutover for new launches only; no existing integration breaks, but an indexer must add the V5 factory (Contract map).

1.23.1 — 2026-10-12 — selling fix

  • Fixed: selling tokens launched since 30 September (the newer token contract) failed with "The wallet could not verify this trade". Selling now works for creators and every holder.

1.23.0 — 2026-10-12 — reliability and safety hardening

A hardening release after the 2026-10-11 post-mortem. No contract change and no new page; behaviour you may notice is listed first.

  • Indexer: reads from the chain are split into small chunks and fail over across several nodes, and a node must prove it has reached the block before its answer counts, so a lagging or truncated answer can no longer look like "no events". The public launch factories now ship in the code, so a wiped setting cannot make the site launch tokens the indexer never sees. GET /api/health answers 503 with the missing factory if that ever happens (see API reference).
  • Holder lists: stable paging with a snapshot stamp and a supply check, and a database error is an error, not an empty page (see API reference).
  • Token metadata uploads: now fail closed without the bot check, logos are capped at 1 MiB, unlaunched drafts expire after 7 days, and daily limits apply (see API reference).
  • Bots: the trading Workers used the wrong call to read the gas price on the current Quai library, so no live transaction could be prepared. They now pass the zone, and each live lane first prepares (never sends) a test transaction against the real node before it may sign. Signing locks that never reached a send are released and expire, and a held lock raises an alert.
  • Alerts and remote stop use ntfy, not Telegram. The market maker and the arbitrage scanner each have a token-protected remote pause; the QAXE keeper keeps its own. See Alerts and remote stop.
  • QAXE keeper: ignores 1-wei dust events (spam floor), never gets stuck on its discovery cursor, and alerts above 1,000 persisted deposits.
  • Monitoring: every Worker has observability on, the indexer pings on a failing run, and a dead-man check watches the market maker, the arbitrage scanner, the keeper and the indexer. The RPC proxy matches batched answers by request id.
  • Market Maker page: the copy now says the remote stop is a token-protected route, not Telegram.

1.22.3 — 2026-10-12 — "You hold" panel on token pages

  • Token pages show a "You hold" panel when your wallet is connected: balance, value, share of supply, and average cost and profit/loss when the trade history is complete. Steps are in the guide Buy and sell a token. No contract or Worker change.

1.22.2 — 2026-10-11 — chart timeframes fixed, Measure tool

  • Charts: the 4h and 1d tabs now always show their own candles (they could show the previously selected timeframe); new Measure tool shows the percent and price change between two points. Steps are in the guide Buy and sell a token. No contract or Worker change.

1.22.1 — 2026-10-11 — Hartii CLI 0.3.3

  • Hartii CLI 0.3.3: the help, the doctor output, the README and the SECURITY note no longer call the CLI unaudited. The CLI keeps its BETA label. New download at hartiilabs.com/downloads/hartii-cli.tgz; see CLI 0.3.3. No contract or Worker change.

1.22.0 — 2026-10-11 — NFT profile pictures in Labs

  • Pick an NFT you own as your picture on your Labs Profile page (Choose a picture). One free signature: no transaction and no gas. Remove picture goes back to your identity colours. It is the same picture you set on Biome and Games, one per wallet.
  • The picture replaces the colour avatar on the creator line of token pages, in comments, on leaderboard rows, in the "Launches by" bar, in the header wallet chip and on profile pages. Without a picture, or if it cannot be shown, you keep the colours.
  • Your NFTs are listed as neutral tiles (name and token number). The picture is served by hartiigames.com, which checks on the chain that you still own the NFT. The choice is public.
  • Steps and developer details are in the guide Your profile picture. No contract or Worker change.

1.21.4 — 2026-10-11 — Hartii profile names on wallets

  • Creator and wallet labels (token page creator chip, comment authors, the launch board "Launches by" bar and the leaderboard) show the wallet's Hartii profile @handle, then the short address. The made-up names are gone.
  • Copy no longer calls the product unaudited or beta, except for features that are beta. No contract or Worker change.

1.21.3 — 2026-10-11 — wallet repairs in CLI 0.3.2

  • First-use nonce-zero SDK response compatibility and truthful uncertain/reverted transaction display with a retained public hash.
  • Reachable Receive QR/copy pane, current selected wallet/network, stale-read fencing, Orchard feed isolation, watchlist removal and navigable full results/forms/lists.
  • Correct named-wallet commands, diagnostic unknowns, boolean flag placement, updater JSON and runtime/source package metadata; bulk RPC batches cap at 20.
  • Matching CLI reference and setup guides. Token-specific auto-signing remains proposed; no new signing grant, retained key or trader Live activation. No contract or Worker change.

1.21.2 — 2026-10-10 — QAXE keeper keeps every deposit

  • The QAXE keeper no longer stops at the first 40 deposits. The keeper that Hartii runs for the QAXE burn vault finds deposit addresses from the factory's Collected events. Before this release it stored only the first 40 and moved on past the rest, so later deposits were never looked at. It now keeps every deposit it discovers (up to a ceiling of 5,000) and serves them in turns: each cycle reads the seed deposit plus a rotating window of up to 39, so with N deposits every one is read at least once every ceil(N / 39) cycles. The daily transaction cap is unchanged. A stored list of exactly 40, which the old code produced, is rescanned once from the factory's deploy block, a few windows per cycle. Anyone can still run their own keeper.
  • A new internal package, @hartii/chain: the zone registry. It lists Quai's nine zones, decodes the zone from an address, and holds separate flags for each zone (known, read, write, cross-zone). Only Cyprus-1 is enabled; the other eight are recognised but switched off and have no endpoints. This is groundwork for supporting more zones later. Nothing changes for users: the one place that uses it so far builds the same Quaiscan links as before. The reasoning is in the open guide Build zone-ready Quai apps.
  • The repository now carries maintenance guides for people and for AI agents, including one for the keeper.
  • No contract, address, API or fee change. The app itself is otherwise unchanged.

1.21.1 — 2026-10-10 — clearer trading and launch costs

  • The Buy and Sell switch and the token page tabs (Overview, Trades, Holders and the rest) were showing as plain grey browser buttons. They now use the site's dark tabs with the highlighted active tab.
  • The trade panel shows the trading fee and the price impact straight away, without opening Details. A buy also shows the fee in QUAI. The note under the panel only promises what it shows: your wallet estimates the network gas when you confirm.
  • The token header says which unit each price is in (USD per token and the price in QUAI).
  • The Launch page shows the total you will pay: the creation fee plus the estimated network gas, in the cost line and next to the Launch button.
  • A short "What happens after launch" section on the Launch page, with each statement checked against the contracts.
  • The Launch section of the in-app guide now describes the real one-page form.

1.21.0 — 2026-10-10 — personal holder trader, BETA and dormant

New personal holder trader, BETA, Observe and Paper only. It ships dormant. The hosted service is off, Live trading is not available, and the HBOME access registry is proposed, not deployed.

  • /trader. A new page with a Personal trader menu entry marked BETA. Only Explore demo works: it shows sample data and reads no wallet. Everything private needs the hosted service and the registry, which are off.
  • Hartii CLI 0.3.0. hartii trader runs the trader in Observe or Paper on your own computer, with no key and no transactions. It needs Node.js 22 or newer. hartii mcp gains three read-only trader tools, and its results are now structured. See Hartii CLI.
  • @hartii/agent-mcp 0.2.0. It now starts read-only. Existing vault agents set HARTII_MCP_PROFILE=legacy-delegated. See MCP setup.
  • Agent page. The vault creation wizard is gone. Existing vaults stay manageable under Legacy vault recovery. GET /api/agent/manifest adds capabilityVersion ("2"), defaultProfile, profiles and personalTrader, and it now publishes only the public RPC URL.
  • New endpoints, off. /api/hbome/* and /api/trader/* exist. While the service is off they answer an error, for example HTTP 503 with configured: false.
  • Registry. HartiiBiomeAccess is source code and staged scripts only. It has no address. See the contract reference.

1.20.0 — 2026-10-10 — mining vaults move to QuaiAxe

Mining vaults are a QuaiAxe product, run by QuaiAxe, so HartiiLabs no longer sells them: the "Mining vaults" menu entry and its guide section are gone, and /mining now says where they live, with links to quaiaxe.com and the QuaiAxe partner entry on hartiibiome.com. A vault page at /mining/<token> still opens for any vault the factory knows (none exist today).

Every wallet name, avatar and short address on HartiiLabs now opens that wallet's Hartii profile: the leaderboard, token-page comments, holders and trades, chat, the creator filter, the flow drawer, Boost buyers and the Wall. Contracts (tokens, curves, pools, vaults) and transaction hashes do not link. Profile pages gain a "View this wallet on Quaiscan" link, and the Hartii admin wallet's profile shows "Hartii admin wallet". Also fixed: the wallet drawer on /flow opened under the top bar.

1.19.1 — 2026-10-10 — buy messages stay clear

Nothing sits on top of a buy or sell message any more. The Lab chat bar steps aside while the "Bought" pop-up shows, and on phones while a trade's status message shows. On phones the status messages sit above the bottom bar, the Speed mode button and the pop-up (inside Blip too), and notifications drop in from the top of the screen instead of covering the bottom bar.

1.19.0 — 2026-10-09 — Claim on Labs

New /claim page: claim a Hartii Claim allocation without leaving HartiiLabs. HBOME round 1 for HRT holders opens by default, and the HRT token page notice and the Rewards page link to it. Fixed: Boost checkout, the trade panel fee line and the Wall engraving fee line now ask for the gas price with the Cyprus-1 zone. Asked without it, the gas price read failed, so Boost could not prepare a purchase and the fee lines stayed empty.

Shared links (iMessage, X, Telegram, Discord) now preview with a real screenshot of the page and a thin black top strip naming it, e.g. "HARTIILABS · SWAP". Covered pages: home, Boost, Swap, Pools, CLI, Receive, Portfolio, Launch, Launchpad and docs. Per-token previews keep their live price-chart card.

Token links preview by name ("HARTI ($HRT) | HartiiLabs") instead of a raw address. Boost previews no longer say beta. Every page has full OpenGraph and Twitter card tags, and images carry a version cache-bust.

1.18.2 — 2026-10-08 — CLI 0.2.3: hartii update really updates

The download at /downloads/hartii-cli.tgz is Hartii CLI 0.2.3, and a new manifest /downloads/hartii-cli.json names the version and checksum. hartii update now checks, then downloads, verifies the sha256, installs and confirms. Users on 0.2.2 or older run the install command once to get it.

1.18.1 — 2026-10-08 — Boost leaves beta

Boost is no longer labelled beta: no BETA badge on the page, the purchase panel, the Promoted row link or the menu, and the token-page panel reads "Boost this token · paid placement".

1.18.0 — 2026-10-08 — HBOME claim notice

The HRT token page shows "HRT holders: claim your HBOME share →", linking to the Biome Claim campaign. It appears on the HRT page only and disappears when the campaign expires (2026-12-07).

1.17.8 — 2026-10-08 — docs refresh

The bundled /docs re-synced from docs 1.9.19.

1.17.7 — 2026-10-08 — Launch icon

The Launch a token tile's icon is a single rising curve line, with no arrowhead.

1.17.6 — 2026-10-08 — home actions

The home page's What do you want to do? tiles (Trade tokens, Launch a token, Swap, Earn with pools, My portfolio) have new line icons in a framed badge, and a subtle lift on hover and keyboard focus (off under reduced motion). Same tiles, labels and destinations.

1.17.5 — 2026-10-08 — buy reliability

Check /api/health for the served Labs version and hartii --version for the installed CLI; documentation alone does not update either executable.

  • Website and CLI curve-method probes use raw RPC execution-revert evidence to distinguish an absent selector from a failed read. The SDK's CALL_EXCEPTION label alone is insufficient: transport, rate-limit and upstream read failures must propagate rather than get cached as "method unsupported." Recover the connection, refresh state and review a fresh quote; no write is retried automatically. Buy and sell guide.
  • Hartii CLI 0.2.2: signs and verifies the complete reviewed transaction locally, preserves nonce zero, rechecks chain/nonce/expiry before one broadcast, and retains its own signed hash if broadcast is uncertain. Releasing an allowance requires local pre-broadcast failure or a recognized node admission rejection bound to the exact raw transaction.
  • CLI buys using all or percentages estimate gas with the access list, then reduce and requote only when needed to leave enough gas. SDK fee reads explicitly select Cyprus-1. Spending and fee caps remain.
  • Regression coverage uses synthetic wallets and fake RPCs. No funded mainnet buy was performed and the exact reported customer commands were unavailable; this release does not claim every reported failure was reproduced or an independent security audit was completed.

1.17.4 — 2026-10-08 — AI-agent badge allowlist

  • Lab chat now marks verified AI agents from a shared allowlist (src/data/chatAgents.json) instead of one hardcoded address: agent badge, persona tag and the agent rate budget (1 message per 60 s, 30 per hour) apply to every listed wallet. The new Hartii trader agent wallet is on the list; hartiiagent is a reserved display name. Agent status comes only from the signature-recovered wallet. No contract, API shape or storage change. The agent itself is not live yet.

1.17.3 — 2026-10-08 — docs refresh

Bundled /docs refreshed to docs 1.9.11, including Gallery payment links, the QAXE buyback tracker, Biome/Games swipe fix and keeper schedule. Documentation only.

1.17.2 — 2026-10-06 — CLI and release safeguards

  • CLI 0.2.1 improves gas reserves, balance checks, review-token confirmation, non-interactive prompts and machine-readable output. See CLI 0.2.1 hardening.
  • Market maker and arbitrage scanner limit a decreasing funding re-anchor to once per UTC day; another decrease counts toward P&L. They remain in dry-run.
  • Browser build and CLI source-export checks were hardened. Local release checks do not certify historical deployed assets or revoke old credentials.

1.17.1 — 2026-10-06 — safety fixes

  • LP Arena withdraw re-reads your wallet account and chain right before sending and refuses if either changed; rows from a previous account are cleared when you switch accounts. Arena is retired: /arena is withdraw-only.
  • Market maker (tools): the daily loss limit survives funding or withdrawing signer funds (the baseline re-anchors instead of tripping daily-loss-limit), and every mined transaction's gas, including the signer's own, is counted in the daily ledger. Copy now says the caps are enforced by the engine software (direct-EOA, no AgentVault). It remains in dry-run.
  • Navigation drawer: focus moves in on open, Tab is trapped inside, Escape returns focus to the toggle.
  • Flagging a token and comment reactions each accept a signed message once (a resend returns 409; 503 if the replay store is unavailable). The wallet-connect ping counter is a single atomic update.
  • Ships with Hartii CLI 0.2.1 (see the CLI page).

1.17.0 — 2026-10-06 — Trade Lens

After you submit a buy or sell, a small card docks in the corner (above the tab bar on mobile; no pop-up, the page stays usable). It shows the step you are on, Pay, Quote (Got, with the real fill against the quote, once confirmed), price impact as a normal stat with a tiny before/after curve, slippage, gas paid and the tx link. It folds back into the trade pill after confirm, and View reopens it. It only displays: it never changes the amount, the slippage or anything you sign. See Buy and sell a token.

1.16.1 — 2026-10-06 — docs refresh

/docs re-synced from docs 1.9.5: the Receive QUAI guide, guides re-checked against the 1.16.0 UI, and Labs 1.14.0–1.16.0 in this history.

1.16.0 — 2026-10-06 — Receive

One tap from the wallet menu or Portfolio (or the /receive page) shows your checksummed Cyprus-1 address with Copy and a QR code, plus a warning that it receives QUAI and Quai-ledger tokens on Cyprus-1 only. Wallets with a Hartii @handle also get their HPAY payment link. See the Receive guide.

1.15.2 — 2026-10-06 — guest chat

Labs chat works without connecting a wallet, using clearly labelled guest sessions. Guests cannot get bot privileges or count toward the verified-wallet hide quorum.

1.15.1 — 2026-10-06 — navigation tweak

Profile, Creator, Analytics, Rewards, Guide and Settings sit in the main rail; Flow moved to an "Extras" group.

1.15.0 — 2026-10-06 — lean navigation

A shorter navigation rail with consistent page names (1.15.1 added Profile, Creator, Analytics, Rewards and Settings back). Swap shows what you pay, an estimate of what you get and the minimum you will receive, with price protection (slippage) under More options. The LP Arena game has ended: /arena is a withdraw-only page for anyone with LP still staked (the contracts are unchanged).

1.14.1 — 2026-10-06 — Hartii CLI 0.2.0

The CLI beta adds offline QR / HPAY receiving and request sending, with stricter signing, pending and storage rules.

1.14.0 — 2026-10-06 — tooltips and a better Guide

Hover or focus explanations across the app, and /guide opens with a "What do you want to do?" task list.

1.13.1 — 2026-10-06 — scanner schedule fix

The arbitrage scanner's own 20-minute schedule never ran (the Cloudflare account has more cron triggers than its plan fires). The market maker's one-minute schedule, which does run, now starts the scanner every 20th minute through a private Worker-to-Worker call protected by a shared secret.

1.13.0 — 2026-10-06 — arbitrage scanner

A 20-minute arbitrage scanner prices every token on two or more vetted Quai venues and records which gaps would pay after fees and gas (public at /api/arb/latest). Its gated executor shares the market maker's signer, caps and claim; it starts in dry-run.

1.12.0 — 2026-10-06 — market maker trades from its signer

The QAXE market maker no longer uses an AgentVault: it trades directly from its signer with software caps (800 QUAI per trade, 1,500 per day) enforced before signing. The 1.11.1 vault was emptied and revoked. Still dry-run.

1.11.1 — 2026-10-06 — QAXE market-maker vault connected

The profit-gated QAXE lane is connected to its own capped AgentVault (0x00392c13…2001, 2,500 QUAI) and runs in dry-run: it records what it would do on every one-minute cycle at /api/mm/actions.

1.11.0 — 2026-10-06 — profit-gated QAXE arbitrage

The market-maker engine gains a profit-gated arbitrage lane: it trades QAXE between its curve pool and the HartiiSwap pair only when the expected profit after both venues' fees and live gas is at least three times the gas. Ships in dry-run.

1.10.6 — 2026-10-06 — floating tab bar on phones

The phone bottom tab bar is now a smaller floating oval, about 3/5 of the screen width, centred and lifted off the bottom edge (Create sits inside it as an accent circle). The Lab chat button and other floating controls stay clear of it.

1.10.5 — 2026-10-06 — documentation refresh

Documentation-only patch recording the verified CLI 0.1.1 / Labs 1.10.4 security release and its verification limits in the site's official docs.

1.10.4 — 2026-10-05 — security release and CLI 0.1.1

Hartii CLI 0.1.1 counts mined gas for successful and reverted receipts, retains conservative reservations for unresolved transactions, and strengthens persistent signed-intent replay protection. Market-maker accounting retains historical cost basis and signer coordination fails closed. Browser builds and published downloads gain credential checks. Verification includes project tests, fake-wallet/signing and receipt fixtures, and the live published package bytes; no funded mainnet rehearsal or independent audit was performed for this release.

1.10.1 — 2026-10-05 — Hartii CLI: live mainnet fixes + easier to use

The CLI's mainnet writes failed before this release (gas price read, V1 curves such as QAXE, and a fee ceiling set below real Quai gas); all three are fixed and the fee floor is now 25 QUAI. New read-only commands (price, quote, holders, trades, gas, block, whoami, limits and more), hartii ? help everywhere, shortcuts, shell completion, and BETA labelling throughout.

1.10.0 — 2026-10-05 — Share chart on every token

Every token page has a Share chart button that turns the price chart and the token's headline stats into a shareable PNG card (Share to apps on phones, Copy image, Download PNG, Post on X). The card and the page header use the same numbers. See the FAQ.

1.9.1 — 2026-10-05 — Hartii CLI hardening

CLI fixes: a transaction that mined but reverted (or was rejected by the node) now releases its spending-guard reservation; hidden bidirectional and zero-width characters are stripped from token names and other third-party text before display; --json never opens the TUI; clearer first-run help.

1.9.0 — 2026-10-05 — Hartii CLI (beta)

Hartii CLI is out: a terminal wallet with a full-screen TUI, scriptable --json commands and an MCP server for AI agents, downloadable from hartiilabs.com/downloads/hartii-cli.tgz (landing page: /cli).

1.8.2 — 2026-10-05 — Boost page layout

/boost: removed an empty band under the trade ticker, the "How Boost works" text is no longer clipped, and the page leaves room at the bottom for the floating Lab button.

1.8.1 — 2026-10-05 — Hartii numbers only

Every Labs aggregate (launches, holders, volume, fees, leaderboard, burns, graduations) now counts Hartii-native tokens only — Quainance-launched tokens never enter a Hartii total, and Quainance rows in token lists are labelled. QAXE counts as Hartii in burns and holders. The burns list now shows every burned token (it used to drop tokens older than the newest 100, hiding POEM and QAXE) and its total equals the sum of the list. Holders exclude bonding-curve contracts. The all-time volume counter is rebuilt native-only and repairs itself after a reorg.

1.8.0 — 2026-10-05 — Hartii Boost (beta)

Hartii Boost is live: buy points that place an indexed token in the separate Promoted row (home, trending, /boost) and decay to zero over 24 hours. Mainnet contract 0x00445cdaaF747F164bFC9e474e16881b52DA478c. New read APIs /api/boosts/active, /api/boosts/recent and /api/token/:address/boosts. Organic ranking and analytics are unchanged.

The executor itself, on top of v0's read-only foundation: a dry-run cron Worker, a risk guard and kill switch, real fill ingestion, daily P&L history, a creator depth-request flow, a pool APR route, and live-reserve portfolio pricing — plus the new purple-camel logo. See API reference › Market-maker tools and Market-maker tools for the full picture.

  • Executor Worker deployed, dry-run only. workers/mm-engine runs a one-minute cron that builds live pair state and decides an action, but cannot send a transaction until MM_DRY_RUN="false" and a validated HARTII_LABS_MM_VAULT are both set — neither is set today, so no maker is quoting and no vault is funded.
  • Risk guard, pause/kill switch. Hard-clamped pair-share (30%), daily-loss (2%), per-trade, and daily-action-count limits; a global and per-pair pause latches in D1 and is checked before every decision. Owner-chat Telegram commands (/pause, /resume, /pause <pair>, /positions, /status) are implemented in the Worker, but the webhook has not been registered with Telegram yet.
  • Fill ingestion and P&L history. Confirmed/provisional HartiiSwap fill correlation (covering the router's self-forwarding swap/mint/burn paths), a (tx_hash, log_index)-unique ledger, and GET /api/mm/pnl/history?pair= daily cumulative snapshots.
  • Creator depth requests and pool APR. POST /api/mm/requests lets a token's creator sign an EIP-191 request for market-making support on their own pool; GET /api/pool/:pair/apr verifies live pool reserves but honestly returns "—" until seven days of real swap history are collected.
  • Portfolio pricing now reads live reserves (priceSource: "live-reserve-reference" for graduated tokens, "quainance-pool-reserves" for Quainance pairs) instead of only the last indexed trade.
  • New logo. The purple geometric camel replaces the prior mark across the favicon, sidebar, PWA icons, and OG share meta/image.

1.6.0 — 2026-10-05 — Wall of Blocks is public

  • Wall of Blocks (/wall) is out of its "testing / Hartii team only" state and live in public use on mainnet — removed the testing banner, and dropped "(testing)"/"Hartii team only" from nav labels, page titles, and OG share meta/image.
  • The engrave form keeps one honest line in its place: engraving spends real QUAI (the live slot price plus gas), and blocks can never be edited or deleted once engraved.
  • UI: /wall (engrave + grid), /wall/:wallId/:idx (block permalink), /wall/view (lookup by tx/coordinate/address), /wall/tx/:hash (tx deep link).

1.5.1 — 2026-10-04 — docs bundle resync

  • public/docs re-synced from the hartii-docs repo at its 1.2.0 so the bundle's docs-manifest.json docsVersion matches the sibling checkout again — 1.5.0 had accidentally shipped an older (1.1.1) bundle. Page content unchanged.

1.5.0 — 2026-10-04 — docs move to a local static bundle

  • /docs/* on hartiilabs.com is now a real static bundle — generated by this hartii-docs repo's per-site exporter, scoped to this site's own products (labs, swap, agent, relay) — instead of a redirect to docs.hartiilabs.com.
  • In-app "Docs" links now point at the local /docs/... path instead of the external domain; refresh with npm run sync:docs ahead of each deploy.

1.4.0 — 2026-10-04 — market-maker tools v0

Read-only planning infrastructure for a future market maker — nothing in this release sends a transaction or quotes for real. See API reference › Market-maker tools and Market-maker tools for the full picture.

  • Read-only price reference. GET /api/token/:addr/reference depth-weights a token's bonding-curve/internal-pool price against its HartiiSwap WQUAI pair, with staleness/drift/thin flags and typed null placeholders for an external venue and a QUAI/Qi conversion venue still to come.
  • Quote preview and inventory bands. Deterministic, BigInt-safe primitives for a bid/ask preview (confidence limits, volatility-aware spread, signed inventory skew) and a 50/50 ± 15 % rebalance band — pure math, no I/O, no wallet.
  • Fills store and MM APIs. The planned QAXE/WQUAI pair registry, an mm_fills D1 table, FIFO P&L accounting, and the public GET /api/mm/{pairs,positions,fills,pnl} routes — every pair reports status: "planned", preview: true, maker: null throughout.
  • /mm preview page. Read-only dashboard (no navigation entry) showing the pair registry, vault inventory, fill history, and P&L. HARTII_LABS_MM_VAULT is optional; unset (the default on hartiilabs.com today) means every position reads back as unfunded and zeroed.
  • Holder paging. GET /api/token/:addr/holders now takes ?offset= and returns offset + nextOffset (null on the last page) so a consumer can page through every holder; still capped at 100 rows per call.

1.3.1 — 2026-10-04 — venue badge

  • Token pages for tokens launched on Quainance show a small "Quainance" badge next to the title (linking to the venue) instead of the earlier "not a HartiiLabs token" paragraph. Trade routing, chain reads and the graduation/price copy are unchanged.

1.3.0 — 2026-10-03 — latency programme, phase 3

  • Block frames are real now. Quai's newHeads notification nests the block under woHeader; 1.2.0 read the wrong field, so no head frame had ever been sent and pushed trades never carried blockTime. Fixed and fenced; one head frame per new block on the global channel.
  • The fast lane is reorg-safe. The indexer reconciles rows the hub wrote before finality and removes one only after that transaction's own receipt confirms it is gone; a candle bucket that loses its last trade is removed too. GET /api/token/<address>/trades and GET /api/trades/recent mark rows the indexer has not confirmed yet with provisional: true (absent once confirmed).
  • Latency metrics correct for hub↔browser clock skew (estimated from head frames).

1.2.0 — 2026-10-03 — latency programme, phase 2

  • One round trip before the wallet popup. The real send is priced with the app's exact mirror of the curve's quoteBuy/quoteSell after a single fresh on-chain read of the curve's state; the on-chain quote still runs afterwards to log any divergence, and the on-chain slippage floor is unchanged. (Build-time switch to restore the always-await path exists.)
  • Receipts confirm on the block, not on a timer. The hub broadcasts a head frame per chain block; a pending trade checks its receipt the moment one arrives (polling stays as fallback).
  • Live push for every curve. The sitewide feed sees every launched token's trades, not only the curves someone has open; new launches are picked up from the factories' TokenLaunched events the moment they happen.
  • Fresh page loads are ~1 s behind the chain, not 60–90 s. Pushed trades land in the indexed trades/candles immediately (the indexer still reconciles and remains the authority for holders).
  • Mobile: the live socket resumes and reconciles when a backgrounded tab comes back.
  • Operators: a debug-only "Latency (this browser)" panel on /status and a committed end-to-end measurement script (scripts/latency-e2e.mjs) in the app repo.

1.1.1 — 2026-10-02 — rollout fixes

  • The hub's upstream socket was being torn down ~8 s after opening by its own handshake timeout (trades silently fell back to the 10 s safety poll); fixed, and the upstream subscription has been on and stable since.
  • The application-version meta tag was missing from served pages (it sat inside the SEO block the edge rewrites per route); moved, so every page now carries the deployed version.

1.1.0 — 2026-10-02 — latency programme

Everything the app controls on the token page is now measured and tuned toward ≤ 300 ms end-to-end. Quai's own block cadence (1–3 s) and the wallet's popup are additive, out of the app's control, and shown as separate states rather than counted against that budget.

  • Reads go direct-RPC-first. rpc.quai.network/cyprus1 is the primary read path, with the /rpc/ proxy kept as failover.
  • Submitting a trade is 2 round-trips before the wallet popup, not 3. The gas estimate now overlaps the fresh on-chain quote instead of waiting on it to finish first.
  • The trade panel's preview is instant. A client-side mirror of the curve's own pricing math renders the buy/sell preview with no round trip at all; the real on-chain quote still gates what you actually sign.
  • Confirmations show up sooner. Once a trade is broadcast, receipt polling now backs off 0.5 s → 2 s (was 1 s → 4 s).
  • Live push is per-block instead of per-poll. The live hub subscribes directly to the chain (quai_subscribe logs + newHeads) and fans a trade out the moment its block lands, instead of waiting out a 4–15 s poll. The server-side switch was turned on the same evening (see 1.1.1 above); measured on a real trade, the chain's log notification reached the hub about 0.2 s before a 500 ms receipt poll even saw the receipt — see API reference › Live push.

1.0.0 — 2026-10-02 — baseline

  • TokenFactoryV4 (LP Reserve) live on mainnet — the current launch factory.
  • Market-terminal redesign: grid-first home, /flow capital-flow terminal, one-page launch composer.
  • Wallet = signing only: every send is gas-estimated on the app's own read provider; a reverted receipt is always rejected, never reported as a success.
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.