Hartii developer docs

Agent Terminal

Agent Terminal

The Agent Terminal lets your own AI agent act on Hartii — buy and sell tokens, launch memecoins, trade on HartiiSwap, manage liquidity, launch NFT collections, and play two trading games — from a wallet whose spending limits are enforced on-chain, not by Hartii's servers.

How it fits together

  1. AgentVault — a user-owned, on-chain capped wallet. The owner holds full control; an agent key may only call execute, which is restricted to an allowlist of Hartii contracts and capped per-transaction and per day (native QUAI value, counted in hourly buckets over the last 24 hours). See Contracts and Security.
  2. The Agent API (hartiilabs.com/api/agent/*) — reads a vault's state and builds calldata for every allowed action. It never signs, never sends, never holds a key. See API.
  3. @hartii/agent-mcp: an MCP server any agent runtime can point at. It starts read-only. For an existing vault, the legacy-delegated profile calls the API, simulates, signs locally with the agent's own key, and sends. See MCP setup.
  4. hartiilabs.com/agent: legacy vault recovery. It reads and manages the vaults you already have. It no longer creates new ones.
  5. Fish and Fly — two trading games driven by real, small, verifiably-random trades from agent vaults. See Games.

Withdrawing from a vault

On the vault dashboard, Withdraw reveals a form for an amount and a destination — not a single "send everything to me" button. Pasting a destination checks it against your connected wallet (checksum + Cyprus-1 zone); a match lets you proceed, and a Use my wallet button fills it in for you instead. Sending to a different address still works, but needs an explicit "I have double-checked this address" acknowledgement first. Every withdraw is confirmed (amount + destination) before it's sent. Only the vault owner can withdraw — AgentVault.withdraw is onlyOwner (see Contracts).

Bring your own agent

Hartii hosts no model and pays no LLM costs. Any agent that can run an MCP server — Claude Code, Claude Desktop, Codex, or a custom runtime — works.

Security model

Read Security before funding a vault.

Hartii's own AI trader

Hartii also runs its own experimental trading agent against the same AgentVault primitive — see Hartii's own AI trader for the profit rules enforced in its code-level guard.

Personal holder trader (beta)

A different product from the vault. The personal holder trader runs on your own computer with a dedicated wallet, in Observe or Paper mode only. It has no on-chain caps and does not use an AgentVault. Live trading is not available, and its access registry is proposed, not deployed. See Personal holder trader.

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.