fund-agent-wallet

Overview

For an overview of the Circle CLI's full capability set — bridging, smart contract execution, x402 payment, and more — see the use-circle-cli master skill. This skill is the narrower funding flow.

Funding an agent wallet means putting USDC where the CLI can spend it. There are two balance pools to be aware of:

• On-chain (vanilla x402) — USDC sitting at the wallet address on a specific chain. Each chain is separate. Used to pay endpoints whose accepts[] does not include GatewayWalletBatched. Settles in one block.
• Nanopayments (powered by Gateway) — USDC held off-chain in your Circle Gateway balance, batched and settled for you across supported chains. Per source chain — no cross-chain pooling at payment time. Used to pay endpoints whose accepts[] includes GatewayWalletBatched. Settles in <500ms once the balance exists.

Gas note

Agent wallet payment flows are gas-abstracted — users can pay with USDC without pre-funding native gas.

This skill covers funding both pools. Pick the path with the shortest time-to-result and hide chain complexity from the user.

Prerequisites

# Confirm session is good
circle wallet status