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 不持有任何資金。