x402のv2バージョン

作者:YQ,コンパイル:ブロックユニコーン

x402プロトコルのv2リリースは、実運用での経験に基づくもので、基本的なアーキテクチャの変更を表しています（興味のある方は、x402のファウンデーションでご覧いただけます：https://www.x402.org/writing/x402-v2-launch)。1億件以上のトランザクションを処理した後、チームは主要な摩擦点を特定し、レイヤーの明確な分離、ブロックチェーンにとらわれないスケーラビリティ、ウェブ標準への準拠という3つの目標を中心にプロトコルを再設計した。

v2における変更点

従来のエージェント決済と x402 エージェント決済の比較

従来の決済プロセスでは、複数の手動ステップと人の介在が必要でした。

v2におけるアーキテクチャの改善

統合支払いインターフェース

v2はデフォルトでマルチチェーン決済をサポートしています。単一のAPIで、コードを変更することなく、Base、Solana、またはサポートされているブロックチェーンのいずれかでUSDC支払いを受け入れることができます。

ネットワーク識別子：CAIP-2が使用されています

バージョン 1v2ではCAIP-2（Chain Independent Improvement Proposal 2）を採用し、"namespace: reference "という形式になっています。reference "である。これにより、どのようなブロックチェーンでも、ブロックチェーンでない決済システムでもサポートすることが可能になります。

支払い要件のリファクタリング

バージョンv1では、各支払いオプションのリソースメタデータが重複していました。サーバーが3つのトークンを受け入れた場合、URL、説明、およびコンテンツ タイプが3回繰り返されます。v2はこれを共有リソース オブジェクトに抽出し、メッセージ サイズを縮小して矛盾をなくします。

拡張機能

バージョンv2では、正式な拡張システムが導入されました。これはコアの支払いメカニズムとは独立して動作するオプション機能のためのものです。各拡張機能には、拡張機能固有のデータを含むinfoオブジェクトと、JSONスキーマによって構造を定義するスキーマオブジェクトがあります。

明示的な支払い選択

バージョンv1ではフィールドマッチングを使用します。v2では、選択された支払い条件をすべて含む「accepted」フィールドにより、選択プロセスがより明示的になります。span leaf="">HTTPトランスポートの更新

RFC6648準拠

IETFは、実験的なヘッダが事実上の標準になりがちであったが、一貫して実験的であるとラベル付けされていたため、HTTPヘッダの "X-"接頭辞を非推奨とした。v2ではこれらの接頭辞を削除し、支払い要件をレスポンスボディからヘッダーに移動しました。なぜヘッダーに移動したのか？プロトコルのメタデータをアプリケーションのコンテンツから分離することで、サーバーは、ヘッダー内の機械可読の支払い要件を維持しながら、ブラウザ用にカスタムHTMLペイウォールを返すことができます。これにより、ミドルウェアの互換性とフレームワークの統合が向上します。

SDKリファクタリング

ハードコーディングからモジュール性へ

ハードコーディングからモジュール性へ

v1のSDKは、ブロックチェーン固有のロジックをネストされたif/elseチェーンに埋め込みます。新しいブロックチェーンを追加するには、コアファイルの変更と新しいSDKのリリースが必要です。v2では、プラグアンドプレイのブロックチェーン・サポートを可能にする3つのインターフェイスが導入されました。

ビルダーモード登録

開発者は、CAIP-2を使用してブロックチェーン実装を登録します。を使用してブロックチェーン実装を登録する場合、SDKはネットワークパターンに基づいて操作を正しい実装にルーティングします。ワイルドカードのパターンマッチ:eip155:* すべてのEVMチェーンに一致 - ソラナ:*&。- eip155:8453&

ラムダベースのポリシーエンジン

財布の種類と支払いスキームは、v1ではハードコードされていました。

フックシステム

バリデーション後、決済前のv1バージョン。はビジネスロジックを実行します。決済が失敗した場合、サーバーはすでに不可逆的な操作（ファイル転送、API呼び出し、データベース書き込み）を実行しています。v2では、6つのライフサイクルフックが導入されています。

コンフィギュレーション

v2バージョンのミドルウェアは、ルートベースのコンフィギュレーションをサポートし、実行時の意思決定のためのコールバック関数を提供します。

ミドルウェアのv2バージョンは、ルートベースの設定をサポートし、実行時の決定機能を提供します。align: left;">ファシリテーターAPIの強化

/supportエンドポイントは現在、3つの主要な機能をアドバタイズしています：プロトコルバージョンごとにグループ化されたサポートされる支払いタイプ、決済操作のための署名アドレス、および実装された拡張機能です。

/support endpoint now advertisement three key capabilities: supported payment types group by protocol version and signature addresses and implemented extensions.align: left;">オートディスカバリー

ディスカバリー拡張機能によって、サービスは自動インデックス作成のために構造化されたメタデータを公開することができます。Facilitator x402プロトコルをサポートするエンドポイントを検索し、手動で送信することなく最新の価格カタログを維持します。

x402プロトコルをサポートするエンドポイントを検索し、手動で送信することなく最新の価格カタログを維持します。align: left;">マイグレーションポリシー

v2は名前空間の分離によって後方互換性を維持します。名前空間の分離による後方互換性。ファシリテーター そしてサーバーは両方のバージョンをサポートできます。クライアントは x402Version フィールドで優先するバージョンを指定し、実装はそれにマッチするプロトコルのバージョンで応答する。