Skip to main content
Call write functions on any smart contract from your agent wallet. You can approve token spenders, use DeFi protocols, or run custom contract logic.

Prerequisites

Before you begin, ensure that you’ve:
On mainnet, pair your transfer limit with a contract allowlist. USDC and EURC approvals count toward your transfer limit at their full amount when submitted, and recipient rules check the spender. Approvals on other tokens don’t count toward transfer limits. The contract allowlist checks the called contract, not the spender. After an approval, the spender can pull funds up to the approved amount at any time with transferFrom outside Circle. Approve only the amount each spender needs.

Steps

Follow these steps to execute a smart contract function.
1

Find the contract address

For Circle contracts (USDC, CCTP, Gateway), look up the address for your blockchain:
2

Execute the contract function

Run circle wallet execute with the ABI function signature, parameters, and contract address:
The CLI waits for the transaction to reach a terminal state and returns the result:
If the transaction fails, the CLI prints the reason. Verify the contract address, function signature, and parameters, then retry.
See the CLI command reference for full syntax and options, including --amount to send native token value with the call.