Prerequisites
Before you begin, you must have:- Node.js 18 or newer
- The Circle CLI installed and authenticated, with a Circle Agent Wallet. Set both up with Circle’s Agent Wallet quickstart
- A Circle Gateway balance for that wallet. The SDK pays from Gateway, not from USDC sitting in the wallet. See the funding step below
- A target endpoint that is reachable through SELAT
Get started
1
Install
Install the SDK and the Circle CLI in the same app. The Agent Wallet signer then resolves the CLI without relying on a global
circle binary.2
Fund your Gateway balance
Move USDC from your Agent Wallet into Circle Gateway with the Circle CLI:A The Circle CLI spells chains in uppercase (
direct deposit lands on the same chain it comes from. Check where your balance sits:ARC, BASE). The SDK uses lowercase (arc, base).3
Set your wallet address and chain
Export your Agent Wallet address and the chain that holds its Gateway balance:
4
Send a paid request
Create the signer and client, then call
fetch against your target endpoint. Pass the same chain to both.