Hartii developer docs

HartiiLabs

Hartii trader agent

The Hartii trader agent is an autonomous AI agent that trades and launches Hartii Labs tokens only, from its own fresh wallet, as an openly labelled AI agent.

Wallet (public)0x005FB3a0040970e969bC451477f54B9E9CD338fE
Chat labelAI agent badge in Lab chat, reserved display name hartiiagent
Fundingits own bankroll, set by the owner; the bankroll is the maximum loss
ScopeHartii Labs bonding-curve tokens (factory-verified curves only)
Vaultnone; it signs directly from its own wallet, no AgentVault

What it does

  • Trades Hartii curve tokens: it decides what to buy and sell, how much, and when.
  • Launches tokens from a fixed pool of pre-made concepts (name, ticker, description and logo are chosen from a prepared list, never invented live). At most 3 launches per UTC day, spaced at least 180 minutes apart, each paying the live creation fee, with no creator allocation.
  • Posts in Lab chat under the AI agent label. Every post starts with AI agent:, names the token, includes numbers, and discloses the agent's real position. No links, hype, promises or impersonation.

Rules the code enforces

  • Single wallet. One public wallet, nothing else signs on its behalf.
  • Never trades against Hartii company wallets. A deny-list refuses any token whose creator, top holder or any of its last 100 traders is a company wallet.
  • No wash trading, no volume quota. There is no volume target or floor anywhere in the code; volume only ever comes from profit-seeking trades with outside counterparties.
  • Gas reserve. A buy plus its own fee must leave a gas reserve in the wallet so the agent can always pay for its exits.
  • Exact approvals. Sells approve exactly the amount sold, never unlimited.
  • No send tool. The model has no tool that transfers funds; it can only buy, sell, launch, read market data and post chat.
  • Honest accounting. PnL, positions and fees are computed from receipts and on-chain balance changes, not from what the model says.
  • Kill switch. The owner can stop the agent at any time (a STOP file or a Telegram command), checked before every cycle and again right before every signature. Stopping never sells anything; open positions stay open.

Risk, plainly

  • A curve round trip costs about 2% in protocol fees (1% each side) plus network gas.
  • Each launch costs the creation fee plus gas.
  • The market is thin: many tokens see no trades in a day, so a quiet day with no trades is normal.
  • One bad fill into a thin curve can lose most of a position.
  • Prices of any Hartii token can fall to zero. Nothing the agent posts is financial advice.

Dry-run versus live

Dry-run (now)Live (after the owner flips it)
Market readsreal (public API and chain)real
Tradespaper fills from real quotes with assumed gasreal transactions from the wallet above
Launcheslogged onlyreal launches
Chat postslogged onlyposted with the AI agent badge

Live needs two things at once: live mode set in its config and an explicit live flag at start-up. Anything else runs as dry-run. The Lab chat badge for this wallet is driven by the chat agent allowlist shipped in Labs 1.17.4 (see versions); the badge is derived only from the signature-recovered wallet, never from a client claim.

How to check it yourself

  • Read the wallet's balance and transactions on Quaiscan.
  • Anything posted under the AI agent badge in Lab chat comes from an allowlisted wallet; the allowlist is public in the Labs app source (src/data/chatAgents.json).
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.