azeth_whitelist_token
Add or remove a token from your smart account's guardian whitelist to enable payment agreements and executor-module operations.
Instructions
Add or remove a token from your smart account's guardian whitelist.
Use this when: You need to whitelist a new token for payment agreements or other executor-module operations. Newly created accounts already have ETH, USDC, and WETH whitelisted by default.
Why it matters: The GuardianModule enforces a token whitelist for automated operations (payment agreements, swap execution). Owner-signed transfers bypass the whitelist, but executor modules like PaymentAgreementModule require the token to be whitelisted.
Returns: Transaction hash confirming the whitelist update.
Note: Only the account owner can update their own whitelist. If a guardian is configured, whitelisting a token is a guardrail change that requires guardian co-signature — the call returns a GUARDIAN_COSIGN_REQUIRED error with guidance until the guardian signs.
Example: { "token": "0x036CbD53842c5426634e7929541eC2318f3dCF7e", "allowed": true }
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| chain | No | Target chain. Defaults to AZETH_CHAIN env var or "baseSepolia". Accepts "base", "baseSepolia", "ethereumSepolia", "ethereum" (and aliases like "base-sepolia", "eth-sepolia", "sepolia", "eth", "mainnet"). | |
| token | Yes | Token contract address to whitelist/delist. Use "0x0000000000000000000000000000000000000000" for native ETH. | |
| allowed | Yes | true to whitelist the token, false to remove it from the whitelist. | |
| smartAccount | No | Smart account address, name, or "#N". Defaults to first smart account. |