·
隆重推出 x402 V2:互联网原生支付标准的演进
简而言之 :基于六个月的实际应用经验,x402 V2 将协议功能扩展到单次调用精确支付之外。它新增了基于钱包的身份认证(无需每次调用都进行偿还)、自动 API 发现、动态支付接收方、通过 CAIP 标准支持更多区块链和法币,以及用于自定义网络和方案的完全模块化 SDK。所有这些改进旨在使 x402 更简洁、更易扩展且面向未来,从而为代理商和用户提供统一的支付模型和基于钱包的访问方式。
简而言之 :基于六个月的实际应用经验,x402 V2 将协议功能扩展到单次调用精确支付之外。它新增了基于钱包的身份认证(无需每次调用都进行偿还)、自动 API 发现、动态支付接收方、通过 CAIP 标准支持更多区块链和法币,以及用于自定义网络和方案的完全模块化 SDK。所有这些改进旨在使 x402 更简洁、更易扩展且面向未来,从而为代理商和用户提供统一的支付模型和基于钱包的访问方式。
注: 本次更新是在针对拟议的 V2 规范进行为期两周的社区反馈期之后发布的。非常感谢来自各个生态系统的开发者、研究人员和团队,感谢他们审阅早期草案并分享反馈意见。正因为有了你们,x402 才更加强大。我们很高兴很快能分享更多关于该协议的更新以及独立 x402 基金会 的成立。x402 的参考 SDK 完全向下兼容 V1 版本。
为什么 x402 需要 V2 版本?
x402 于 2025 年 5 月推出,其理念很简单:利用长期闲置的 402 状态码,将支付功能直接嵌入到 HTTP 请求中。短短几个月内,它已处理了超过 1 亿笔支付交易,涵盖 API、应用程序和 AI 代理,为从付费 API 调用到自主代理按需购买计算和数据等各种应用场景提供支持。
V2 版本根据 x402 在过去 6 个月中执行实际支付操作所获得的经验,对规范进行了改进:
- 更清晰地划分客户端、服务器、协调器和 x402 参考 SDK。
- 对数据类型声明进行调整,以提高清晰度、减少冗余,并使 x402 更易于在新链上实现。
- 将“扩展”的概念正式化,以便更轻松地对 x402 进行实验和扩展,而无需 fork 项目。
- 将所有支付数据移至 HTTP 传输的标头中,从而释放响应体,使其可以与 402 状态码和“需要支付”标头一起使用。
- 自下而上重写了 x402 参考 SDK,使其具备模块化、可组合架构。
- 将参考 SDK 迁移到
@x402npm 组织
与此同时,x402 的任务始终保持不变:
让价值像信息一样在互联网上无缝流动,无论参与者是人、应用程序还是代理。
x402 V2 旨在满足下一阶段互联网经济的需求。它重构了协议,使其更简洁、更具互操作性且更具前瞻性,同时保留了 V1 的所有成功特性。
什么是新的
V2 是一次重大升级,使协议更具通用性、灵活性,并更易于跨网络、传输方式、身份模型和支付类型进行扩展。规范更加简洁、模块化,并与包括 CAIP 和 IETF 标头约定在内的现代标准保持一致,从而为链上和链下支付提供统一的接口。
1. 统一支付接口
x402 V2 规范了网络和资产的识别方式,创建了一种可跨链使用且与传统支付渠道兼容的单一支付格式。
主要升级:
- 默认支持多链 :支持 Base、Solana、其他链以及新的 L2 代币上的稳定币和代币,无需任何自定义逻辑。
- 与传统支付渠道兼容 :ACH、SEPA 或卡网络的支付服务商均采用相同的支付模式。
- 动态“payTo”路由 :可根据请求将资金路由至指定地址、角色或基于回调的支付逻辑——非常适合市场平台和多租户 API。此外,它还可根据输入数据实现动态定价。
- 无破坏性变更 :采用新的方式在扩展程序中发展功能,而不是修改规范。
所以 ,x402 可以成为一个灵活的经济层,支持基于使用量、类似订阅、预付费和多步骤工作流程,而无需更改 API 架构或升级核心规范。
2. 可扩展架构和广泛的兼容性
V2 明确区分了协议规范、其 SDK 实现和促进者,使协议成为插件驱动的,并具有面向未来的特性。
主要升级:
- 稳定规范 :添加新的支付链或支付行为无需对参考 #SDK 的标准进行任何更改。
- 插件驱动的 SDK :开发者注册区块链、资产和支付方案,而不是编辑 SDK 内部代码。
- 生命周期钩子 :允许构建者在支付流程的关键点(例如,付款前/后、结算验证前/后)注入自定义逻辑。这可以解锁条件支付路由、自定义指标、复杂的故障恢复机制等功能。
- 现代化的 HTTP 标头 :
- 移除已弃用的 X-* 标头以提高兼容性
- 使用更现代的 PAYMENT-SIGNATURE、PAYMENT-REQUIRED、PAYMENT-RESOPSE
- 【即将推出】 全新“使用 X 登录”标题
所以 ,x402 V2 变成了一个即插即用的平台。任何人都可以添加新的区块链、支付服务商或支付模型作为独立软件包,而无需修改底层协议带来的额外开销和协调工作。
3. 基于钱包的访问、可重复使用的会话和模块化付费墙
V2 重构了与身份和访问相关的关键组件,为更高效的会话管理奠定了基础,并使服务器端架构具有高度灵活性。
主要升级:
- 模块化付费墙包 :付费墙已完全改造并提取到一个专用的模块化包中:
@x402/paywall。这使得开发人员可以轻松贡献新的支付后端并创建自定义付费墙变体(内置对 #EVM 和 #Solana 的支持)。 - 可重用访问的基础 :V2 协议现在包含了支持钱包控制会话或其他形式身份的逻辑,允许客户端 跳过完整的支付流程 ,并且如果资源之前已购买,则无需 进行链上交互即可重复访问 。
- 支持订阅和会话模式 :这种架构使得人类用户和自主代理都可以使用类似订阅或基于会话的访问模式。
关于 Sign-In-With-X (SIWx) 的说明 :完整的基于钱包的身份功能,包括专用的 Sign-In-With-X (SIWx) 标头(基于 CAIP-122),将作为后续快速发布项目推出。这标志着用于证明钱包控制权以访问可重用会话的首批扩展功能最终完成。
所以,这意味着什么 ?这种组合改善了服务器端开发人员的体验,并释放了更低延迟、更少往返次数和更低重复调用成本的核心优势。这些效率提升使得 x402 适用于高频工作负载,例如 LLM 推理、多呼叫代理以及按请求付费速度过慢或成本过高的复杂应用程序。
4. 自动发现和动态服务元数据
V2 的 Discovery 扩展允许启用 x402 的服务公开结构化元数据,供协助者抓取。
主要升级:
- 促进者会自动为可用端点建立索引
- 价格、路线和元数据会自动保持最新状态。
- 无需手动更新或硬编码目录
所以 ,Discovery 扩展创建了一个更加自主的生态系统,卖家只需发布一次 API,促进者就可以保持同步,而无需开发人员干预。
5. 提升开发者体验和多方支持
V2 大幅简化了配置,同时使多方支持成为一流水平。
主要升级:
- 注册支持的区块链、资产和支付模型;禁止内部 SDK 破解
- 表达业务偏好(“优先选择 Solana”、“避免使用主网”、“仅使用 USDC”)
- 同时使用多个协调员;SDK 会选择最佳匹配项
- 针对复杂支付环境的更清晰的过滤和选择逻辑
这意味着什么 ?开发者可以编写更少的粘合代码,而将更多精力投入到业务逻辑中。SDK 会处理链选择、支付服务商发现、支付路由和方案选择等复杂环节。
试试看
x402 协议 V2 代表着价值在互联网上像信息一样便捷流动的又一重要里程碑。通过扩展兼容性、简化开发者体验以及支持新的支付和身份模型,V2 将 #x402 转变为一个更加灵活的支付层,支持人工、应用和代理驱动的支付。我们非常期待看到随着生态系统的发展,开发者们将创造出怎样的精彩作品。
您可以 在这里 查看代码库,或者 加入 Telegram 群组 与 600 多名其他开发者交流。 #Base #coinbase
作者 Erik Reppel、Carson Roscoe、Josh Nickerson
来源 https://www.x402.org/writing/x402-v2-launch
转发此帖子?
与您的关注者分享。
回复