SKILL.md
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 includeGatewayWalletBatched. 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[]includesGatewayWalletBatched. 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