x402 的 v2 版本

文章作者：YQ

文章編譯：Block unicorn

x402 協(xié)議版本 2 基于生產(chǎn)部署經(jīng)驗，代表著一次根本性的架構(gòu)變革（有興趣可以自行到 x402 的基金會觀看：https://www.x402.org/writing/x402-v2-launch）。在處理了超過 1 億筆交易后，團隊識別出了關(guān)鍵的摩擦點，并圍繞三個目標重新設(shè)計了協(xié)議：清晰的層級分離、與區(qū)塊鏈無關(guān)的可擴展性以及符合 Web 標準。

版本 2 中的變化

傳統(tǒng)代理支付 vs x402 代理支付

傳統(tǒng)的支付流程需要多個手動步驟和人工干預。x402 通過實現(xiàn)自主、即時支付來消除了摩擦。

版本 2 的架構(gòu)改進

統(tǒng)一的支付接口

版本 2 默認支持多鏈支付。單個 API 即可在 Base、Solana 或任何受支持的區(qū)塊鏈上接受 USDC 支付，而無需修改代碼。

網(wǎng)絡(luò)標識符：采用 CAIP-2

版本 1 使用了自定義網(wǎng)絡(luò)標識符，例如 “base-sepolia” 和 “base”。版本 2 采用了 CAIP-2（鏈無關(guān)改進提案 2），格式為 "namespace:reference"。這使得它能夠支持任何區(qū)塊鏈，甚至非區(qū)塊鏈支付系統(tǒng)。

支付需求重構(gòu)

版本 1 在每個支付選項中都重復了資源元數(shù)據(jù)。如果服務(wù)器接受了三種代幣，它會重復三次 URL、描述和內(nèi)容類型。版本 2 將其提取到一個共享資源對象中，從而減小了消息大小并消除了不一致性。

擴展

版本 2 引入了一個正式的擴展系統(tǒng)，用于獨立于核心支付機制運行的可選功能。每個擴展都有一個包含擴展特定數(shù)據(jù)的 info 對象和一個通過 JSON Schema 定義結(jié)構(gòu)的 schema 對象。

顯式的支付選擇

版本 1 使用字段匹配啟發(fā)式方法來確定客戶端選擇了哪個支付選項。版本 2 通過一個包含完整所選支付要求的 “accepted” 字段，使選擇過程更加明確。

HTTP 傳輸更新

符合 RFC 6648 標準

IETF 棄用了 HTTP 標頭的 “X-” 前綴，因為實驗性標頭往往會成為事實上的標準，但卻始終被標記為實驗性。版本 2 移除了這些前綴，并將支付要求從響應體移至標頭。為什么要移至標頭？將協(xié)議元數(shù)據(jù)與應用程序內(nèi)容分離，使得服務(wù)器能夠為瀏覽器返回自定義 HTML 付費墻，同時在標頭中保持機器可讀的支付要求。這提高了中間件兼容性和框架集成性。

SDK 重構(gòu)

從硬編碼到模塊化

版本 1 的 SDK 將區(qū)塊鏈特定的邏輯嵌入到嵌套的 if/else 鏈中。添加新的區(qū)塊鏈需要修改核心文件并發(fā)布新的 SDK 版本。版本 2 引入了三個接口，實現(xiàn)了即插即用的區(qū)塊鏈支持。

構(gòu)建器模式注冊

開發(fā)者使用 CAIP-2 通配符注冊區(qū)塊鏈實現(xiàn)。SDK 會根據(jù)網(wǎng)絡(luò)模式將操作路由到正確的實現(xiàn)。通配符模式匹配：eip155:*匹配所有 EVM 鏈 ?solana:*匹配所有 Solana 網(wǎng)絡(luò)? eip155:8453特指 Base 主網(wǎng)

基于 Lambda 的策略引擎

版本 1 中錢包類型和支付方案是硬編碼的。版本 2 引入了可組合的策略函數(shù)，用于運行時支付授權(quán)。

鉤子系統(tǒng)

版本 1 在驗證之后、結(jié)算之前執(zhí)行業(yè)務(wù)邏輯。如果結(jié)算失敗，服務(wù)器已經(jīng)執(zhí)行了不可逆操作（文件傳輸、API 調(diào)用、數(shù)據(jù)庫寫入）。版本 2 引入了六個生命周期鉤子。

配置

版本 2 中間件支持基于路由的配置，并提供回調(diào)函數(shù)以進行運行時決策。

Facilitator API 增強功能

能力通告

/support 端點現(xiàn)在通告三個關(guān)鍵功能：按協(xié)議版本分組的受支持支付類型、用于結(jié)算操作的簽名地址以及已實現(xiàn)的擴展。

自動發(fā)現(xiàn)

發(fā)現(xiàn)擴展允許服務(wù)暴露結(jié)構(gòu)化元數(shù)據(jù)以實現(xiàn)自動索引。Facilitator 可以抓取支持 x402 協(xié)議的端點，無需手動提交即可維護最新的價格目錄。

遷移策略

版本 2 通過命名空間隔離保持向后兼容性。相同的 SDK、facilitator 和服務(wù)器可以同時支持這兩個版本。客戶端通過 x402Version 字段指定版本偏好，實現(xiàn)會響應匹配的協(xié)議版本。

如果覺得文章好看，你可以將Block unicorn 標注星標和添加桌面。

本文提供的信息僅用于一般指導和信息目的，本文的內(nèi)容在任何情況下均不應被視為投資，業(yè)務(wù)，法律或稅務(wù)建議。對于根據(jù)本文做出的個人決定，我們不承擔任何責任，我們強烈建議您在采取任何行動之前進行自己的研究。盡管已盡最大努力確保此處提供的所有信息都是準確的和最新的，但可能會發(fā)生遺漏或錯誤。