メインコンテンツへスキップ
Ace Data Cloud X402 は現在 USDC 決済を中心としており、EVM と Solana の2種類のチェーンをサポートしています。ネットワークごとに署名方式、資産アドレス、gas の挙動、および適用シナリオが異なるため、統合前にネットワークを選択する必要があります。

ネットワーク識別子は CAIP-2 を使用

x402 v2 の accepts[].network は CAIP-2 識別子であり、base、solana のような略称ではありません。クライアントがネットワークを照合する際は、CAIP-2 文字列で比較する必要があります:

サポートマトリクス

upto は現在 Base でのみ提供されています。実際に利用可能な項目は API が返す accepts に従います。Facilitator を確認することもできます:
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
Facilitator は署名を検証した後、オンチェーンで USDC の transferWithAuthorization を呼び出して送金を完了します。 Base は最も推奨される本番統合ネットワークであり、特に upto 後払い計測に適しています。これは Permit2、USDC、およびウォレットのエコシステムがより成熟しているためです。 Base exact 検証結果の例:
結果の説明:
  • API の paid retry はモデルコンテンツ ADC_BASE_E2E_OK を返します。
  • オンチェーン取引は BaseScan で確認でき、ブロック番号は 46726299 です。
  • 95215 atomic USDC は 0.095215 USDC に相当し、今回の API 呼び出しの実際の決済金額です。
注文支払い Base exact のプログラム実行結果:
結果の説明:
  • プラットフォーム注文の最終状態は Finished です。
  • 注文の pay_id には同じ Base 取引ハッシュが書き込まれます。
  • 1200000 atomic USDC は 1.2 USDC に相当し、旧ポリシーにおけるこの 10 Credits 注文の過去の実支払い金額です。新規注文では X402 支払い方法の割引は追加で適用されなくなり、具体的な署名金額は今回の 402 レスポンスに従います。

Solana

Solana は SPL USDC TransferChecked を使用します。クライアントは送金トランザクションを構築し、署名して送信した後、トランザクション署名またはシリアライズ済みトランザクションを PAYMENT-SIGNATURE envelope に格納します。 Solana の特徴:
  • Solana wallet adapter または base58 secret key を使用;
  • 資産は Solana USDC mint;
  • 現在は exact のみサポート;
  • Facilitator は transfer instruction の mint、destination、authority、および amount を検証します。
ウォレット fee payer モードを使用する場合、ウォレットが直接トランザクションを送信し、Facilitator はトランザクションの確認と settlement 結果の返却を担当します。 Solana 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 に準拠します。