bitpro가 원문에서 글자만 모은 내용이에요. 표·그림·수식은 빠지거나 깨질 수 있어요. 전체 75쪽 중 2쪽
ns/withdraw) | Move remaining USDC from your Gateway balance back to your agent wallet on the same blockchain. | `circle gateway withdraw` |
# How-to: Deposit for nanopayments
Source: https://developers.circle.com/agent-stack/agent-nanopayments/operations/deposit
Deposit USDC into Gateway to enable gas-free, sub-cent payments powered by Circle Gateway.
Deposit USDC into Gateway once, then make payments without incurring gas costs
on each transaction.
## Prerequisites
Before you begin, ensure you have:
* Installed [Node.js v20.18.2 or later](https://nodejs.org/).
* Installed Circle CLI:
```bash theme={null}
npm install -g @circle-fin/cli
```
* Completed the
[Agent Wallets quickstart](/agent-stack/agent-wallets/quickstart)
(authenticates and funds your wallet).
## Steps
<Steps>
<Step title="Deposit USDC into Gateway">
Deposit USDC with your amount, wallet address, and blockchain. Direct
deposits work from any
[Gateway-supported blockchain](/gateway/references/supported-blockchains):
```bash theme={null}
circle gateway deposit --amount 5 --address 0xYourWalletAddress --chain ARC --method direct
```
<Tip>
Use `--method eco` for fast deposits through Eco, which supports Base
as the source blockchain and settles balances on Arc. Eco is a
third-party fast-deposit service that Circle does not operate or
audit. Test the flow before using it in production.
</Tip>
</Step>
<Step title="Check your Gateway balance">
Confirm the deposit arrived:
```bash theme={null}
circle gateway balance --address 0xYourWalletAddress --chain ARC
```
The command returns your current Gateway balance. A non-zero value
confirms the deposit arrived.
</Step>
</Steps>
See the [CLI command reference](/agent-stack/circle-cli/command-reference) for
full syntax and options.
# How-to: Pay for a service
Source: https://developers.circle.com/agent-stack/agent-nanopayments/operations/pay-for-service
Discover and pay for x402-compatible API services using USDC.
Pay for [x402](/x402-facilitators/x402)-compatible API services directly from
your agent wallet. Payment is processed before the request is forwarded to the
service.
## Prerequisites
Before you begin, ensure you have:
* Installed [Node.js v20.18.2 or later](https://nodejs.org/).
* Installed Circle CLI:
```bash theme={null}
npm install -g @circle-fin/cli
```
* Completed the
[Agent Wallets quickstart](/agent-stack/agent-wallets/quickstart)
(authenticates and funds your wallet).
<Note>
Most x402 services require a Gateway balance. See [Deposit for
nanopayments](/agent-stack/agent-nanopayments/operations/deposit) to set one
up.
</Note>
## Steps
<Steps>
<Step title="Find a service">
Browse available services at
[agents.circle.com/services](https://agents.circle.com/services), or search
by keyword from the CLI:
```bash theme={null}
circle services search "weather data"
```
To inspect the payment requirements for a specific URL before paying:
```bash theme={null}
circle services inspect https://api.example.com/weather
```
</Step>
<Step title="Pay for the service">
Run `circle services pay` with the service URL and your wallet details. Use
`--max-amount` to set a spending cap and avoid unexpected charges. Use
`--estimate` to preview payment requirements without paying:
```bash theme={null}
# Preview payment requirements without paying
circle services pay https://api.example.com/weather \
--address 0xYourWalletAddress \
--chain ARC \
--estimate
# Pay for the service
circle services pay https://api.example.com/weather \
--address 0xYourWalletAddress \
--chain ARC \
--max-amount 0.01
```
The CLI prints the service's response body.
</Step>
</Steps>
See the [CLI command reference](/agent-stack/circle-cli/command-reference) for
full syntax and options, including `-X` for HTTP method and `-d` for a request
body.
# How-to: Withdraw your balance
Source: https://developers.circle.com/agent-stack/agent-nanopayments/operations/withdraw
Withdraw remaining USDC from your Gateway balance back to your agent wallet.
Withdraw remaining USDC from your Gateway balance back to your agent wallet on
the same blockchain. Useful when you're done making nanopayments and want to
recover unused funds.
## Prerequisites
Before you begin, ensure you have:
* Installed [Node.js v20.18.2 or later](https://nodejs.org/).
* Installed Circle CLI:
```bash theme={null}
npm install -g @circle-fin/cli
```
* Completed the
[Agent Wallets quickstart](/agent-stack/agent-wallets/quickstart)
(authenticates and funds your wallet).
<Note>
USDC is minted on the same blockchain as your Gateway balance. Crosschain
withdrawals aren't supported.
</Note>
## Steps
<Steps>
<Step title="Withdraw from Gateway">
Run `circle gateway withdraw` with the amount, your wallet address, and
the blockchain where your Gateway balance lives:
```bash theme={null}
circle gateway withdraw --amount 1 --address 0xYourWalletAddress --chain ARC
```
To send the withdrawn USDC to a different address, add `--recipient`:
```bash theme={null}
circle gateway withdraw --amount 1 --address 0xYourWalletAddress --chain ARC --recipient 0xOtherAddress
```
<Tip>
Not sure which blockchain your balance lives on? Run
`circle gateway balance --all` to see all blockchains.
</Tip>
</Step>
<Step title="Confirm the withdrawal">
Check that your Gateway balance decreased:
```bash theme={null}
circle gateway balance --address 0xYourWalletAddress --chain ARC
```
Then check that your wallet balance increased:
```bash theme={null}
circle wallet balance --address 0xYourWalletAddress --chain ARC
```
</Step>
</Steps>
See the [CLI command reference](/agent-stack/circle-cli/command-reference) for
full syntax and options.
# Quickstart: Make a nanopayment
Source: https://developers.circle.com/agent-stack/agent-nanopayments/quickstart
Deposit USDC into Gateway, find an x402-compatible service, and pay for it with your agent wallet.
By the end of this quickstart, your agent will have made a nanopayment to an
x402-compatible service.
## Prerequisites
Before you begin, ensure you have:
* Installed [Node.js v20.18.2 or later](https://nodejs.org/).
* Installed Circle CLI:
```bash theme={null}
npm install -g @circle-fin/cli
```
* Completed the
[Agent Wallets quickstart](/agent-stack/agent-wallets/quickstart)
(authenticates and funds your wallet).
## Steps
<Steps>
<Step title="Deposit USDC into your nanopayments balance">
Deposit 5 USDC from your wallet on Arc:
```bash theme={null}
circle gateway deposit --amount 5 --address 0xYourWalletAddress --chain ARC --method direct
```
</Step>
<Step title="Find an x402-compatible service">
Search the Circle Agent Marketplace for available services:
```bash theme={null}
circle services search "weather"
```
Pick a service and inspect its payment requirements:
```bash theme={null}
circle services inspect https://api.example.com/weather
```
</Step>
<Step title="Pay for the service">
Pay with your Gateway balance on Arc. Replace `0xYourWalletAddress` with
your wallet address:
```bash theme={null}
circle services pay https://api.example.com/weather \
--address 0xYourWalletAddress \
--chain ARC \
--max-amount 0.01
```
The CLI prints the service's response body. The payment settles against
your Gateway balance.
</Step>
<Step title="Check your balance">
Confirm your remaining Gateway balance:
```bash theme={null}
circle gateway balance --address 0xYourWalletAddress --chain ARC
```
</Step>
</Steps>
## Next steps
* [Pay for more services](/agent-stack/agent-nanopayments/operations/pay-for-service)
using your remaining balance.
* [Withdraw your balance](/agent-stack/agent-nanopayments/operations/withdraw)
back to your wallet when you're done.
# Seller integration tools
Source: https://developers.circle.com/agent-stack/agent-nanopayments/seller-integration-tools
Third-party platforms that help API providers accept x402 and nanopayments.
If you run an API or online service, you can charge AI agents per request by
accepting [x402](/x402-facilitators/x402) payments and
[nanopayments](/agent-stack/agent-nanopayments). The third-party platforms below
help you add this support without building the integration yourself.
<Tip>
To integrate nanopayments directly into your own server, follow the [seller
quickstart](/gateway-nanopayments/quickstarts/seller) or the [how-to for
adding nanopayments to an existing x402
seller](/gateway-nanopayments/howtos/x402-seller).
</Tip>
## Third-party platforms
These independent platforms offer hosted tooling and onboarding flows for
accepting agent payments. Supported payment standards and blockchains vary by
platform, so check each platform for details.
### Blockrun
[Blockrun](https://blockrun.ai) supports x402 and nanopayments. It helps API
sellers list their services in a directory and accept payments settled in USDC
onchain.
### Proceeds
[Proceeds](https://myproceeds.xyz) supports x402, nanopayments, and the Machine
Payments Protocol (MPP). It helps sellers accept agent payments on Arc and other
blockchains.
### Sponge
[Sponge](https://paysponge.com) supports x402 and MPP, but not nanopayments. It
lets API providers accept agent payments with minimal code changes.
### x402scan
[x402scan](https://www.x402scan.com/) by Merit Systems is a registry for x402
and agent-native APIs. It helps providers make their services discoverable to AI
agents and accept onchain USDC payments for each request.
# Agent Wallets
Source: https://developers.circle.com/agent-stack/agent-wallets
Wallets that let your agent autonomously hold, spend, trade, and earn USDC and other tokens with built-in spending controls.
Agent Wallets let your AI agent hold funds and transact onchain autonomously,
within spending policies you define. Your agent operates the wallet through
Circle CLI without writing integration code.
Built on [Circle's user-controlled wallets](/wallets/user-controlled) with
2-of-2 MPC key management, key shares are never exposed to the agent. The user
retains custody, and Circle cannot unilaterally move funds without their
involvement. All transfers are screened against sanctions controls before
submission onchain.
## Get started
Paste this prompt into your AI agent:
```text theme={null}
Run curl -sL https://agents.circle.com/skills/setup.md, and use the returned setup instructions to set up my agent wallet.
```
The agent installs Circle CLI, creates and funds your agent wallet, and helps
you discover and pay for services with it. Prefer a manual setup? Follow the
[quickstart](/agent-stack/agent-wallets/quickstart) instead.
If your agent stalls waiting for an email verification prompt, use the
[non-interactive authentication flow](/agent-stack/agent-wallets/wallet-operations/authenticate#non-interactive-scripts-and-ai-agents),
which is built for scripts and AI agents that can't respond to interactive
prompts.
## Use cases
<CardGroup>
<Card title="Autonomous trading" icon="chart-line">
Run onchain strategies like dollar-cost averaging or token monitoring for
autonomous execution within user-defined rules.
</Card>
<Card title="AI assistants with budgets" icon="robot">
Execute real-world tasks like booking flights or paying for subscriptions
within a scoped USDC budget.
</Card>
<Card title="Crosschain operations" icon="arrow-right-arrow-left">
Hold, transfer, bridge, and swap USDC across all [supported
blockchains](/agent-stack/agent-wallets/supported-blockchains) from a single
agent wallet.
</Card>
<Card title="Custom spending policies" icon="sliders">
Set [transfer limits, recipient allowlists, and contract
blocklists](/agent-stack/agent-wallets/wallet-operations/custom-policies)
per agent wallet. Your agent operates only within rules you define.
</Card>
</CardGroup>
<Warning>
When running autonomous trading strategies, start with small amounts and
validate your approach before scaling. Only commit funds you are comfortable
spending.
</Warning>
## Features
<AccordionGroup>
<Accordion title="User-custody wallet" icon="shield-check">
Built on [Circle user-controlled wallets](/wallets/user-controlled). Key
shares are never exposed to the agent. Users retain custody while agents
operate in defined spending limits.
</Accordion>
<Accordion title="Command-line interface" icon="terminal">
Operate wallets through Circle CLI commands from any agent framework. No
custom integration code required.
</Accordion>
<Accordion title="Spending policies" icon="sliders">
Set USDC spending limits for outbound transfers and x402 payments. Limits
can be time-bound (for example, daily, or monthly). Configure allowlists and
blocklists for wallet and contract addresses.
</Accordion>
<Accordion title="x402 and nanopayments" icon="coins">
Pair your agent wallet with [Agent
Nanopayments](/agent-stack/agent-nanopayments) for gasless, sub-cent USDC
payments to [x402](/x402-facilitators/x402)-compatible services.
</Accordion>
<Accordion title="Built-in compliance controls" icon="scale-balanced">
All transfers are screened against sanctions controls before submission
onchain. Transactions involving sanctioned entities are blocked, ensuring
agents operate within regulatory requirements.
</Accordion>
<Accordion title="Token support" icon="coins">
Agent Wallets support USDC, EURC, and other ERC20 tokens, and native tokens
(for example, ETH, MATIC). USDC is the primary asset for transfers,
bridging, and x402 payments.
</Accordion>
</AccordionGroup>
<Note>
Agent wallet transactions are gas-sponsored. Sponsorship is capped and subject
to change. See [Fees](/agent-stack/agent-wallets/fees) for the full breakdown.
</Note>
# Agent wallet fees
Source: https://developers.circle.com/agent-stack/agent-wallets/fees
Fee breakdown for agent wallet operations, including bridging, swapping, and payments.
The following fees may apply depending on the operations your agent wallet
performs:
| Fee | Amount | When it applies |
| :- | :- | :- |
| Gas | \$0 (sponsored) | All onchain transactions |
| CCTP fast transfer fee | Varies by source blockchain | Bridging |
| Forwarding service fee | \$0.05 | Bridging |
| Forwarding gas fee | Varies by destination blockchain | Bridging |
| Swap provider fee | 2 bps | Swapping |
| Gateway protocol fee | 0.5 bps | Crosschain x402 payments (free for same-chain) |
| Eco deposit fee | Set by Eco | Gasless Gateway deposits using Eco |
<Note>
Eco is a third-party fast-deposit service that Circle does not operate or
audit. Test the flow before using it in production.
</Note>
What to know about agent wallet fees:
* **Gas sponsorship**: Onchain transactions on agent wallets are gas-sponsored
at no cost to you. Sponsorship is capped, subject to fair use, and may change
over time.
* **CCTP fast transfer**: Agent Wallets use CCTP fast transfer only for
bridging, which provides near-instant finality at a higher fee than standard
transfers. For fast transfer rates by source blockchain, see
[CCTP fees](/cctp/concepts/fees).
* **Forwarding gas fee**: Bridging also incurs a forwarding gas fee that varies
by destination blockchain.
# Quickstart: Create an agent wallet
Source: https://developers.circle.com/agent-stack/agent-wallets/quickstart
Get your first agent wallet set up in minutes.
Create an agent wallet and fund it with USDC on Arc using Circle CLI.
Prefer a guided setup? Paste this prompt into your AI agent instead:
```text theme={null}
Run curl -sL https://agents.circle.com/skills/setup.md, and use the returned setup instructions to set up my agent wallet.
```
<Warning>
Never give an AI agent unrestricted access to your email account. Circle sends
a one-time password (OTP) to the email you log in with. Anyone who can read
that inbox can use the OTP code to log in to your agent wallet. They can then
perform any wallet operation, including changing your spending policies. Enter
the OTP code yourself instead of giving your agent access to your email.
</Warning>
## Prerequisites
Before you begin, ensure you have:
* Installed [Node.js v20.18.2 or later](https://nodejs.org/).
* Installed Circle CLI:
```bash theme={null}
npm install -g @circle-fin/cli
```
## Steps
Follow these steps to create an agent wallet and fund it with USDC.
<Steps>
<Step title="Authenticate">
```bash theme={null}
circle wallet login you@example.com
```
<Note>
To use testnet, add `--testnet` to the command. Sessions are stored separately
for mainnet and testnet and expire after 28 days.
</Note>
On first run, Circle CLI prompts you to accept the Terms of Use and
Privacy Policy. Then Circle sends a one-time password to verify your
identity. After authentication, agent wallets are created automatically
on all supported blockchains.
</Step>
<Step title="Get your wallet address">
```bash theme={null}
circle wallet list --type agent --chain ARC
```
Copy the wallet address returned. You will use it in the steps below.
</Step>
<Step title="Fund your wallet">
Run `circle wallet fund` to add USDC to your wallet from another wallet you
own. Replace `0xYourWalletAddress` with the address from the previous step:
```bash theme={null}
circle wallet fund --address 0xYourWalletAddress --chain ARC --amount 10 --method crypto
```
The CLI prints a terminal QR code and an
[EIP-681](https://eips.ethereum.org/EIPS/eip-681) deposit URI. Scan the QR
code with your mobile wallet to send the funds.
To buy USDC with a card instead, pass `--method fiat` to open the onramp
provider in your browser. See
[Fund wallet](/agent-stack/agent-wallets/wallet-operations/fund) for all
funding options.
<Note>
To use testnet, replace `BASE` with a testnet blockchain (for example,
`ARC-TESTNET`) and omit `--method` and `--amount`. On testnet, `circle wallet
fund` draws 20 USDC from the Circle faucet. See [supported
blockchains](/agent-stack/agent-wallets/supported-blockchains) for the full
list.
</Note>
</Step>
<Step title="Check your balance">
Confirm the funds arrived. Replace `0xYourWalletAddress` with your wallet
address:
```bash theme={null}
circle wallet balance --address 0xYourWalletAddress --chain ARC
```
</Step>
</Steps>
## Next steps
Now that you have a funded wallet, you can:
* [Deposit for nanopayments](/agent-stack/agent-nanopayments/operations/deposit)
and
[pay for a service](/agent-stack/agent-nanopayments/operations/pay-for-service).
* [Transfer USDC](/agent-stack/agent-wallets/wallet-operations/transfer) to
another address.
* [Bridge USDC](/agent-stack/agent-wallets/wallet-operations/bridge) to another
blockchain.
* [Swap tokens](/agent-stack/agent-wallets/wallet-operations/swap) using your
agent wallet.
* Explore [wallet operations](/agent-stack/agent-wallets/wallet-operations) for
more tasks.
# Agent wallet supported blockchains
Source: https://developers.circle.com/agent-stack/agent-wallets/supported-blockchains
Blockchains supported by Agent Wallets on mainnet and testnet.
Agent Wallets supports the following blockchains on both mainnet and testnet.
Pass the blockchain identifier to the `--chain` flag in CLI commands.
Run `circle blockchain list` to retrieve the current list.
| Blockchain | Mainnet identifier | Testnet identifier |
| :- | :-: | :-: |
| Arbitrum | `ARB` | `ARB-SEPOLIA` |
| Arc | `ARC` | `ARC-TESTNET` |
| Avalanche | `AVAX` | `AVAX-FUJI` |
| Base | `BASE` | `BASE-SEPOLIA` |
| Ethereum | `ETH` | `ETH-SEPOLIA` |
| Monad | `MONAD` | `MONAD-TESTNET` |
| Optimism | `OP` | `OP-SEPOLIA` |
| Polygon PoS | `MATIC` | `MATIC-AMOY` |
| Unichain | `UNI` | `UNI-SEPOLIA` |
# Wallet operations
Source: https://developers.circle.com/agent-stack/agent-wallets/wallet-operations
Tasks you can perform with an agent wallet using Circle CLI, including transfers, bridging, payments, and more.
Wallet operations are tasks you can perform with an agent wallet using
[Cir프로젝트로 돌아가기
