Skip to main content
ARouter 支持 x402 支付协议,这是面向 HTTP 原生支付的开放标准。 拥有加密钱包的 AI Agent 可以完成认证、支付积分并发起 LLM 请求 — 无需注册账户,也无需登录 Dashboard。

三种接入方式

ARouter 为 Agent 提供三种接入方式。API Key 用户和钱包用户现在遵循各自独立的长期路径:
标准 x402 模式适用于任何 x402 兼容工具@x402/fetchawal、MCP 钱包、Chrome 扩展。 无需 ARouter SDK。

工作原理

标准 x402(任何 x402 客户端)

最简单的接入方式。任何持有 USDC 的钱包都可以立即发起 LLM 请求:
  1. 发送无 API Key 的请求 — 网关返回 HTTP 402 及支付选项。
  2. x402 客户端签署 USDC 支付(通过 EIP-3009 免 Gas 进行)。
  3. 携带 PAYMENT-SIGNATURE 请求头重试。
  4. 网关验证、结算、创建账户并返回响应。
  5. 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 不持有任何资金。