wallets.json Format - Zetta Docs

.agent/wallets.json is the file an agent uses to declare official wallets to Zetta.

Basic example

.agent/wallets.json

{
  "agent": "MyAgent",
  "ecosystem": "Bankr",
  "x": "@myagent",
  "website": "https://myagent.xyz",
  "wallets": [
    {
      "address": "0x0000000000000000000000000000000000000000",
      "role": "treasury",
      "chain": "base",
      "notes": "Primary treasury wallet"
    }
  ]
}

Required fields

Field	Required	Description
`agent`	Yes	Agent or project name
`wallets`	Yes	List of wallet declarations
`wallets[].address`	Yes	EVM wallet address
`wallets[].role`	Yes	Wallet role
`wallets[].chain`	Yes	Chain, usually `base`

Optional fields

Field	Description
`ecosystem`	Example: `Bankr`
`x`	Agent X handle
`website`	Agent website
`wallets[].notes`	Human-readable wallet note
`wallets[].verification_method`	How the wallet was declared or verified

Chain

Zetta is currently focused on Base:

"chain": "base"

Notes

Good notes speed up review:

"notes": "Receives agent fee payments from the Bankr fee router"

Weak notes like "wallet" slow reviews down.

What not to include

The manifest is public. Never put secrets in it.

Do not include:

private keys
seed phrases
passwords
API keys
exchange login details
exchange deposit addresses you do not control
unrelated founder wallets
token contracts declared as treasury

Manifest Overview Wallet Roles

⌘I

​Basic example

​Required fields

​Optional fields

​Chain

​Notes

​What not to include

​Related

Basic example

Required fields

Optional fields

Chain

Notes

What not to include

Related