zetta

Open Standard — v1.0

.agent/wallets.json

An open, chain-neutral standard for autonomous agents to declare their financial identity. One file in your repo connects your agent's on-chain activity to its operational identity.

Spec →Examples →Validate →Migration →

What it is

Autonomous agents operate on public blockchains. Every transaction they execute is permanently recorded. But without a declaration of which wallets belong to which agent, those transactions remain invisible to any financial intelligence layer.

.agent/wallets.json solves this. It is a lightweight JSON file that an agent operator adds to their public repository declaring wallet addresses, roles, and chain. That single file is enough to connect the agent's on-chain activity to its operational identity.

The standard is intentionally minimal, chain-neutral, and protocol-agnostic. It does not require a specific runtime, token, or registry contract.

Minimum valid manifest

{
  "agent": "Your Agent Name",
  "wallets": [
    {
      "address": "0x...",
      "chain": "base",
      "role": "treasury"
    }
  ]
}

Three required fields per wallet: address, chain, role. See full spec →

What happens after you submit

01
Attribution
Wallet declarations connect your agent's on-chain addresses to its operational identity. No declaration — no attribution.
02
Books
Attributed wallets generate financial books: revenue, expenses, treasury balance, 30-day P&L. Built from confirmed on-chain activity only.
03
Profile
Books populate your public agent profile: financial statements, transparency score, settlement classification, Luca verdict.
04
Intelligence
Luca reads your books to generate financial summaries, settlement analysis, and include your agent in the State of the Agent Economy.

Why the standard is open

The goal is not to make the manifest proprietary. The goal is to make attribution infrastructure open — and to make Zetta the best intelligence layer built on top of it.

If the standard is open and widely adopted, every agent in the ecosystem benefits: financial transparency for stakeholders and token holders, interoperability across infrastructure layers, and trust through public attribution. Zetta captures value not by owning the declaration, but by building the most complete intelligence layer on top of it.

Wallet roles

RoleFinancial classificationUse
treasuryAssetPrimary operating capital
revenueInflowRevenue and income collection
fee_recipientInflowProtocol fees, revenue share
payment_receiverInflowAPI payments, per-call settlement
expenseOutflowOperational expense wallet
operatorOutflowHot wallet, day-to-day execution
deployerNeutralContract deployer (historical)
token_contractContractERC-20 token contract address
token_bound_accountAssetERC-6551 token-bound account
unknownPendingDeclared but role unclear

Submit your manifest

Add .agent/wallets.json to your repo, validate it below, then paste your repo URL into your agent's profile page. Luca will fetch the manifest and generate financial books within 24 hours.

Validate manifest →Read the spec
Spec →Examples →Migration →