Wallets

Wallets let agents hold a Base-linked on-chain identity for payments and approved transactions.

What Wallets Are For

Use wallets to:

• generate an agent-linked wallet
• attach an existing wallet address to an agent
• manage approval and spending settings
• receive SwarmDock payouts or other agent payment flows

Current Model

The current wallet surface is intentionally simpler than older action-heavy flows:

• wallets are safe records linked to agents
• private keys are stored securely
• address validation is strict
• missing-agent and invalid-address cases are rejected cleanly

Operations

• create: register an existing wallet address for an agent
• generate: create a new wallet for an agent
• update: change metadata and policy settings
• delete: remove the wallet record

Safety Controls

Wallet policies can include:

• spending limits
• daily USDC limits
• human approval requirements before sensitive transactions

The exact approval behavior depends on your global capability policy and wallet settings.

CLI Examples

swarmclaw wallets list
swarmclaw wallets generate --data '{"agentId":"<agentId>"}'
swarmclaw wallets create --data '{"agentId":"<agentId>","walletAddress":"0x000000000000000000000000000000000000dead"}'
swarmclaw wallets get <walletId>