ネットワーク識別子は CAIP-2 を使用
x402 v2 のaccepts[].network は CAIP-2 識別子であり、base、solana のような略称ではありません。クライアントがネットワークを照合する際は、CAIP-2 文字列で比較する必要があります:
サポートマトリクス
upto は現在 Base でのみ提供されています。実際に利用可能な項目は API が返す accepts に従います。Facilitator を確認することもできます:
/supported の返却:
- Base と Solana の
exactは固定金額の支払いパスです。 - Base のみが
upto後払い計測パスを提供しており、Permit2 approve に依存します。 uptoエントリ内のextra.facilitatorAddressは、クライアントが署名時に witness へ書き込むアドレスであり、サーバーが返す値と一致しなければなりません。
Base
Base は公式 USDC コントラクトを使用します:exact スキームでは、クライアントは EIP-712 TransferWithAuthorization に署名します。署名内容には以下が含まれます:
from:支払いウォレットアドレスto:Ace Data Cloud の受取アドレスvalue:今回の支払い金額validAfter/validBefore:署名の有効時間ウィンドウnonce:32バイトのランダム nonce
transferWithAuthorization を呼び出して送金を完了します。
Base は最も推奨される本番統合ネットワークであり、特に upto 後払い計測に適しています。これは Permit2、USDC、およびウォレットのエコシステムがより成熟しているためです。
Base exact 検証結果の例:
- API の paid retry はモデルコンテンツ
ADC_BASE_E2E_OKを返します。 - オンチェーン取引は BaseScan で確認でき、ブロック番号は
46726299です。 95215atomic USDC は0.095215USDC に相当し、今回の API 呼び出しの実際の決済金額です。
exact のプログラム実行結果:
- プラットフォーム注文の最終状態は
Finishedです。 - 注文の
pay_idには同じ Base 取引ハッシュが書き込まれます。 1200000atomic USDC は1.2USDC に相当し、旧ポリシーにおけるこの 10 Credits 注文の過去の実支払い金額です。新規注文では X402 支払い方法の割引は追加で適用されなくなり、具体的な署名金額は今回の 402 レスポンスに従います。
Solana
Solana は SPL USDCTransferChecked を使用します。クライアントは送金トランザクションを構築し、署名して送信した後、トランザクション署名またはシリアライズ済みトランザクションを PAYMENT-SIGNATURE envelope に格納します。
Solana の特徴:
- Solana wallet adapter または base58 secret key を使用;
- 資産は Solana USDC mint;
- 現在は
exactのみサポート; - Facilitator は transfer instruction の mint、destination、authority、および amount を検証します。
exact 検証結果の例:
- paid retry はすでに HTTP 200 を返しており、モデルは
ADC_SOLANA_E2E_OKを出力しています。 - パブリック RPC でオンチェーン signature を照会する際、レート制限に遭遇する可能性があります。
- パブリック RPC の照会はレート制限される可能性があるため、ここでは Solana explorer を記載しません。厳密な照合が必要な場合は、自前の Solana RPC またはプラットフォーム側の決済記録を使用してトランザクション署名を確認してください。
選択方法
どのチェーンを選択する場合でも、クライアントに価格をハードコードしないでください。価格はサーバーが返す
accepts[].maxAmountRequired によって決まります。
新しい EVM ネットワークの追加
以下のネットワークにおけるネイティブ USDC の固定金額支払いはコードでサポートされており、ネットワークごとに順次公開されます。 利用可能かどうかは注文または API が返すaccepts に準拠します。すべてのネットワークが本番環境で有効になっていることを意味するものではありません。
これらのネットワークは
exact のみをサポートし、通貨精度は 6 です。同名のブリッジ USDC を使用しないでください。
公式 TypeScript/Python X402 Client を使用する場合、表内の略称または CAIP-2 識別子を渡すことができます。
クライアントは対象チェーン ID を使用して署名を構築します。ウォレットは対象ネットワークをサポートしている必要があります。
Phantom 拡張ウォレットの公式サポート表には Arbitrum と Polygon が掲載されています。Optimism、Avalanche
は現在この表に掲載されていないため、対象チェーンをサポートする Rabby または MetaMask を使用できます。EVM アドレスは異なるチェーン間で同一にすることができますが、
残高は相互に独立しており、Solana アドレスは EVM USDC には適用されません。
Phantom ウォレットのサポート表を参照してください。
新ネットワークのカナリア公開入口
新しいチェーンの入口はデフォルトで非表示です。コンソールまたは Studio にアクセスする際、?features=x402-arbitrum
を使用して対応するチェーンを有効にできます。複数の flag はカンマで区切ります。単一チェーンを無効にするには ?features=-x402-arbitrum を使用し、
ローカルの上書きをクリアするには ?features=none を使用します。スイッチはドメインごとに保存されます。
注文見積もりと支払い再試行では同じスイッチを使用し、サーバー側で独立して検証されます。既存の支払い記録は引き続き閲覧できます。
ページの flag のみを有効にしても、まだ設定されていないチェーンは有効になりません。実際に支払い可能なネットワークは、引き続きリアルタイムの accepts に準拠します。
