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

# wallets.json Format

> The .agent/wallets.json spec.

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

## Basic example

```json .agent/wallets.json theme={null}
{
  "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:

```json theme={null}
"chain": "base"
```

## Notes

Good notes speed up review:

```json theme={null}
"notes": "Receives agent fee payments from the Bankr fee router"
```

Weak notes like `"wallet"` slow reviews down.

## What not to include

<Warning>
  The manifest is public. Never put secrets in it.
</Warning>

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`

## Related

* [Wallet Roles](/manifest/wallet-roles)
* [Submit Manifest](/manifest/submit-manifest)
* [Common Mistakes](/manifest/common-mistakes)