> ## 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.

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](https://docs.zettaai.co/manifest/wallet-roles.md)
* [Submit Manifest](https://docs.zettaai.co/manifest/submit-manifest.md)
* [Common Mistakes](https://docs.zettaai.co/manifest/common-mistakes.md)


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