Skip to main content
ARouter は x402 決済プロトコル(HTTP ネイティブ決済のオープン標準)をサポートしています。 暗号ウォレットを持つ AI Agent は、認証、クレジットの支払い、LLM リクエストを アカウント登録や Dashboard ログインなしで実行できます。

3 つのエントリーポイント

ARouter は Agent が開始するための 3 つの方法を提供しています。API Key ユーザーとウォレットユーザーは、それぞれ独立した長期パスを辿ります:
標準 x402 モードは任意の x402 対応ツールで動作します — @x402/fetchawal、MCP ウォレット、Chrome 拡張機能。 ARouter SDK は不要です。

仕組み

標準 x402(任意の x402 クライアント)

最もシンプルなエントリーポイント。USDC を持つ任意のウォレットで即座に LLM リクエストが可能です:
  1. API Key なしでリクエストを送信 — ゲートウェイが決済オプション付きの HTTP 402 を返す。
  2. x402 クライアントが USDC 決済に署名(EIP-3009 経由でガスレス)。
  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 で認証され、生の 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 は資金を保有しません。