语气
Circle的CLI用于设置代理钱包,用USDC为它提供资金,并用于稳定币动力的工作流程.
学习更多 特务. circle.com。 。 。 .
快速启动
安装 CLI并登录 .
npm install -g @circle-fin/cli
circle --version
circle wallet login <email>
# Enter the OTP code sent to your email when prompted
circle wallet status
注销
本届会议的清场:
circle wallet logout
检查或创建钱包
检查当前钱包状态 ARC数字 :
circle wallet list --chain ARC --type agent --output json
初始代理钱包在登录时提供. 使用 circle wallet list 首先检查已有的情况.
在所有支持的链上创建 EVM SCA 钱包批次 :
circle wallet create
circle wallet create --testnet
circle wallet list --chain ARC --type agent --output json
检查钱包余额 :
circle wallet balance --address <addr> --chain ARC --output json
发现技能
钱包设置后, 使用 CLI 来发现其他 Circle 技能 :
circle skill list
circle skill info --name use-circle-cli
为当前工具安装技能 :
circle skill install --tool claude-code --name use-circle-cli
# or --tool cursor, --tool codex
图标
区链
块链命令允许您检查支持的链并配置每个链的 RPC 设置 .
# Inspect blockchain RPC configuration
circle blockchain config --chain ARC
# List supported blockchains
circle blockchain list
桥
将USDC从一个支持的区块链移动到另一个带有CCTP的区块链.
# Show the fee for a bridge route
circle bridge get-fee ARC --chain ARB
# Check the status of a bridge transfer
circle bridge status <burn-tx-hash> --chain ARB
# Bridge USDC from Arbitrum to Arc
circle bridge transfer ARC --amount 1.0 --address <addr> --chain ARB
合同
合同查询允许您查阅 Circle 合同地址,并在不提交交易的情况下在链式合同状态上阅读.
# Show Circle contract addresses on a chain
circle contract address usdc --chain ARC
# Query read-only contract state
circle contract query "balanceOf(address)" <addr> --contract <contract> --chain ARC --output json
网关
网关用于纳米付款,包括将钱包资金存入网关余额并管理该余额.
# Show the current Gateway balance across all settlement chains
circle gateway balance --address <addr> --chain ARC --all
# Deposit wallet USDC directly on Arc
circle gateway deposit --amount 0.5 --address <addr> --chain ARC --method direct
# Deposit wallet USDC into Gateway for nanopayments
circle gateway deposit --amount 0.5 --address <addr> --chain ARB --method eco
# Withdraw funds from Gateway back to a wallet
circle gateway withdraw --amount 0.1 --address <addr> --chain ARC
服务
服务会让您发现已支付的x402端点,检查定价,并用钱包估计或执行已支付的请求.
# Inspect a paid endpoint and its pricing
circle services inspect https://api.example.com/data
# Estimate a paid request before sending it
circle services pay https://api.example.com/data --address <addr> --chain ARC --estimate
# Search for paid x402 services
circle services search "web search"
交易
交易命令帮助管理已提交的未决交易.
# Speed up a pending transaction
circle transaction accelerate <transaction-id> --chain ARC
# Cancel a pending transaction
circle transaction cancel <transaction-id> --chain ARC
钱包
钱包流包括发送USDC,交换被支持的资产,执行链上动作,以及管理钱包地址的支出政策.
# Execute a write call from the wallet
circle wallet execute "approve(address,uint256)" <spender> <amount> --contract <contract> --address <addr> --chain ARC --estimate
# Swap tokens with Circle Stablecoin Kits
circle wallet swap USDC 1.0 EURC 0.8 --address <addr> --chain ARC
# Move ERC-20 USDC between wallets on Arc
circle wallet transfer <recipient> --amount 1 --token 0x3600000000000000000000000000000000000000 --address <addr> --chain ARC
限制
限制代理钱包的支出政策,包括剩余预算,转移限制,块列表,以及重设自定义政策. 政策写作需要检察官办公室确认.
# Show remaining EVM-wide rolling-window policy + budget (daily / weekly / monthly)
circle wallet limit budget --address <addr>
# Set a custom transfer limit — OTP-gated, ephemeral human session
circle wallet limit set --address <addr> --chain ARC \
--policy-type stablecoin --per-tx 100 --daily 100 --weekly 100 --monthly 100
# Block specific recipient addresses — OTP-gated
circle wallet limit set --address <addr> --chain ARC \
--policy-type stablecoin --rule-type recipient-blocklist \
--targets "[0xBAD1,0xBAD2]"
# Block specific contracts on the contract-execution path — OTP-gated
circle wallet limit set --address <addr> --chain ARC \
--policy-type contract --rule-type contract-blocklist \
--targets "[0xCONTRACT]"
# Reset every custom policy on this (wallet, chain) back to defaults — OTP-gated
circle wallet limit reset --address <addr> --chain ARC
外部钱包
从私人密钥或元句中导入本地钱包 :
circle wallet import my-wallet --private-key || circle wallet import my-wallet --mnemonic
circle wallet list --chain ARC --type local
已导入的本地钱包可以使用基于钱包的命令,如传输,合同执行,桥接等,以及可用本地钱包支持的Gateway流量.
测试网基金
在不使用主网资金的情况下尝试 CLI 时使用单独的测试网登录会话 :
circle wallet login <email> --testnet
circle wallet list --chain ARC-TESTNET
测试网和主网会话分别存储.
更新
要更新新版本的CLI,运行:
circle update
检查新出版的版本, 如果有, 在运行前提示 npm install -g @circle-fin/cli@latest 给你的 过 --yes 以跳过提示(在脚本和 CI 有用)。 如果你宁可手工升级,上面的npm命令直接起作用.
帮助
使用 --help 以查看支持动词、旗帜和示例的全部列表.
circle --help
circle wallet --help
circle gateway --help
circle services --help