三种接入方式
ARouter 为 Agent 提供三种接入方式。API Key 用户和钱包用户现在遵循各自独立的长期路径:标准 x402 模式适用于任何 x402 兼容工具 —
@x402/fetch、awal、MCP 钱包、Chrome 扩展。
无需 ARouter SDK。工作原理
标准 x402(任何 x402 客户端)
最简单的接入方式。任何持有 USDC 的钱包都可以立即发起 LLM 请求:- 发送无 API Key 的请求 — 网关返回 HTTP 402 及支付选项。
- x402 客户端签署 USDC 支付(通过 EIP-3009 免 Gas 进行)。
- 携带
PAYMENT-SIGNATURE请求头重试。 - 网关验证、结算、创建账户并返回响应。
PAYMENT-RESPONSE请求头包含用于后续钱包认证请求的jwt扩展字段。
SIWx 认证(钱包登录)
证明钱包所有权以获取钱包 JWT,无需先支付: SIWx 遵循 CAIP-122 标准 — 与 QuickNode 及其他支持 x402 的服务采用相同协议。API Key 用户
现有 API Key 用户继续使用标准 ARouter API Key 流程:支持的网络
钱包兼容性
所有钱包均可使用 — 无需导出私钥:SDK 使用方法
标准 x402(无需 ARouter SDK)
直接使用 Coinbase 官方@x402/fetch:
SIWx 认证(获取钱包 JWT)
Node.js SDK
Go SDK
ARouter SDK + 自动支付(推荐高频使用)
Go SDK — EVM (Base)
WithX402CoinbasePayment 设置带 JWT 缓存的钱包 x402 支付:
- 首次成功支付在
PAYMENT-RESPONSE中返回钱包 JWT - 后续请求使用
Bearer <jwt> 401触发 SIWx 重新认证402触发 x402 支付
Go SDK — Solana
Node.js SDK — EVM (Base)
Node.js SDK — 双链(EVM + Solana)
CLI 工具的 GET 端点
适用于无法发送 POST 请求体的 x402 CLI 工具(如awal):
支付请求头
积分工作原理
- x402 支付以积分形式充入租户余额 — 与 Stripe 和 Helio 支付共享同一积分池。
- 所有 x402 交易均显示在账单页面的交易记录中,参考类型为
x402_topup。 - 余额充值后,网关按每次请求照常扣除积分。
- 钱包用户按租户计费,通过钱包 JWT 认证,并可通过 SIWx 重新认证,无需暴露原始 API Key。
安全
- 标准 x402 协议:使用 Coinbase 官方 x402 SDK 进行验证和结算。
- Facilitator 验证:支付通过 x402 Facilitator 加密验证后才会授予积分。
- 免 Gas 支付:EIP-3009(TransferWithAuthorization)— 用户签名,Facilitator 提交上链。
- 金额上限:单次支付设有上限,防止意外大额扣费。
- 幂等性:每个支付载荷具有唯一 nonce — 同一签名不可重放。
- SIWx 标准:认证遵循 CAIP-122,支持 EIP-4361(EVM)和 SIWS(Solana)消息格式。
- 审计跟踪:所有 x402 充值与 Stripe/Helio 支付一同记录在交易记录中。
- 非托管:USDC 直接转入接收钱包。Facilitator 不持有任何资金。