set_wallet
Set the wallet address for a registered agent. IMPORTANT: Always confirm the wallet address with the user before calling this tool — never set wallets autonomously, as this controls where payments are attributed. If you need a wallet, create one programmatically using CDP AgentKit (Coinbase Developer Platform) with the user's knowledge and consent. Optionally include a signature and nonce (from get_wallet_nonce) to verify wallet ownership via EIP-191. Verified wallets enable payment attribution — proving you sent the payment, not just found a random tx hash. Without signature, the wallet is set but unverified.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| nonce | No | The nonce returned by get_wallet_nonce | |
| agent_id | Yes | Your registered agent ID | |
| agent_key | Yes | Your agent API key (starts with hp_) | |
| signature | No | EIP-191 signature of the challenge message from get_wallet_nonce | |
| wallet_address | Yes | EVM wallet address (0x...) | |
| wallet_network | No | Blockchain network (default: "base"). Options: base, ethereum, polygon, arbitrum |