3 つのエントリーポイント
ARouter は Agent が開始するための 3 つの方法を提供しています。API Key ユーザーとウォレットユーザーは、それぞれ独立した長期パスを辿ります:標準 x402 モードは任意の x402 対応ツールで動作します —
@x402/fetch、awal、MCP ウォレット、Chrome 拡張機能。
ARouter SDK は不要です。仕組み
標準 x402(任意の x402 クライアント)
最もシンプルなエントリーポイント。USDC を持つ任意のウォレットで即座に LLM リクエストが可能です:- API Key なしでリクエストを送信 — ゲートウェイが決済オプション付きの HTTP 402 を返す。
- x402 クライアントが USDC 決済に署名(EIP-3009 経由でガスレス)。
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 で認証され、生の API Key を公開せずに SIWx で再認証できます。
セキュリティ
- 標準 x402 プロトコル: Coinbase の公式 x402 SDK を使用して検証と決済を行います。
- Facilitator 検証: 決済は x402 Facilitator によって暗号学的に検証されてからクレジットが付与されます。
- ガスレス決済: EIP-3009(TransferWithAuthorization)— ユーザーが署名し、Facilitator がオンチェーンで送信。
- 金額上限: 予期せぬ高額請求を防ぐため、単一決済に上限を設定。
- 冪等性: 各決済ペイロードには一意の nonce があります — 同じ署名の再利用は不可。
- SIWx 標準: 認証は CAIP-122 に従い、EIP-4361(EVM)および SIWS(Solana)メッセージ形式をサポート。
- 監査証跡: すべての x402 チャージは Stripe/Helio 決済とともにトランザクション履歴に記録されます。
- 非カストディアル: USDC は受信ウォレットに直接転送されます。Facilitator は資金を保有しません。