三種接入方式
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 不持有任何資金。