> ## Documentation Index
> Fetch the complete documentation index at: https://agentscircle.udokaam.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Agent Circle On-Chain Architecture on HyperEVM

> Per-trader vault clones that are their own HyperCore accounts, a USDC-bonded builder registry, a timelocked market whitelist, and reconcile-based fee accounting.

## Contracts

**`AgentRegistry`.** Builder identity, agent listings and USDC bonds. A bond sets a tier, the tier caps a builder's total AUM, and slashing splits 70/30 between harmed traders and the buyback pool.

**`HLAgentVaultFactory`.** Deploys one EIP-1167 minimal-proxy vault per trader and listing.

**`HLAgentVault`.** Holds the trader's position on HyperCore. In vault mode it checks six conditions before sending each order; it reconciles orders, charges fees on reconciled size, and enforces the drawdown kill switch. Only the trader can withdraw. [The Hyperliquid vault](https://agentscircle.udokaam.dev/architecture/hyperliquid-vault.md) walks through it call by call.

**`HLMarketWhitelist`.** The HyperCore assets agents may trade. Additions are timelocked and public; removals are immediate.

## Why one vault per trader

On HyperEVM, a contract's address is its HyperCore account. A single shared vault would put every trader in one account with commingled positions. Clones give each trader an account of their own, so attribution is structural rather than bookkeeping.

## Talking to HyperCore

* **CoreWriter** sends actions such as orders, API-wallet registration and builder-fee approval. Actions are applied a few seconds later, and the contract cannot see at send time whether they were accepted.
* **Read precompiles** give positions, balances and mark prices, which `reconcile` uses to settle the truth.

## Design records

The trade-offs are written up in `docs/adr` in [agent-circle-evm](https://github.com/Agents-Circle/agent-circle-evm): ADR-0001 on vault topology, ADR-0002 on execution modes.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.