Web3支付新标准：Coinbase推出的x402协议解析

Coinbase近日发布了一项全新的支付协议——x402。作为由Coinbase发起的协议，x402天然支持Base Sepolia网络，并且默认可用。此外，该协议还对Solana链提供了支持，证明了其并不绑定于某一条特定区块链。

https://github.com/coinbase/x402

为了深入理解x402的运行流程，我们创建了一个示例仓库（https://github.com/gin-lsl/x402-solana-demo），其中包含了完整的Server、Client和Facilitator代码。该项目基于Koa框架实现，演示了客户端如何通过支付Solana Devnet上的USDC（自定义Token）来获取服务器接口的访问权限。

项目说明

首先，我们使用spl-token工具创建了一个测试用的Token，您可以通过以下链接查看：https://solscan.io/token/9gKBTRXgVTszU31A12oJKKSy6aje8LyoVvNfSimembHo?cluster=devnet。

选择Solana链的原因在于其对开发者非常友好，提供了几乎无限量的测试代币，无需任何门槛即可进行开发和测试。开发者无需登录、绑定社交账号或在主网上拥有余额。

如果需要运行该项目，请先创建一个.env文件并填写所需的环境变量，然后在终端启动服务器并运行客户端代码：

代码结构解析

由于该项目仅用于演示，因此所有代码均集中在一个地方。以下是主要文件的说明：

solana.ts

该文件提供了一个「/solana/get-balance」接口，假设这是一个高价值接口，调用它需要支付一定费用。作为服务器角色，它对应序列图中的(5)~(8)部分，尤其是(7)。通常情况下，服务器只需处理业务逻辑，而无需涉及链上交易等复杂操作。这意味着即使开发人员不了解Web3技术，也可以在不改动现有业务代码的情况下接入Web3支付方式。

facilitator.ts

该文件实现了Facilitator的功能，提供了/supported、/verify和/settle接口，分别用于查询支持的链、验证交易数据以及执行链上结算。这是与区块链交互的核心部分，需要私钥以支付链上交易费用。Facilitator在架构上独立于Server（即solana.ts），对应序列图中的(9)和(10)。

即使您决定自行提供Facilitator服务，这部分代码也是标准化的，可直接使用官方模式而无需自行实现。不过，目前官方仅对Base链有完整支持，若需使用其他链，则需进行适配。例如，在Solana链中，POST /settle请求会调用「x402/facilitator」中的settle函数，经过验证后通过sendTransaction发送交易，并通过waitForRecentTransactionConfirmation等待交易确认。相关代码由@solana/kit提供。EVM链的逻辑与此类似。

x402-middleware.ts

该文件用于将Server和Facilitator关联起来，作为Koa中间件，能够保护需要付款才能调用的接口。参考了官方提供的「x402-express」代码，作用是自动返回402状态码、转发/verify和/settle请求。

在这部分代码中，我们主要组装参数并将其转发给Facilitator或返回给客户端。为简化测试，我们将大部分参数设为固定值，包括：

• 将maxAmountRequired设置得非常大，该值会在客户端校验，若用户需支付金额超过此值则抛出异常。
• 将asset设置为我们自定义的Token地址：9gKBTRXgVTszU31A12oJKKSy6aje8LyoVvNfSimembHo，而非x402内置的Token地址。在主网环境中，应使用USDC官方地址。

有趣的是，x402-express通过重写Response函数实现了类似Koa的洋葱模型。因此，在Express中间件中，实际流程为verify -> 业务逻辑 -> settle。提交上链操作是在业务逻辑执行后完成的，这与序列图一致。相比之下，Koa实现这一逻辑更为简单，而Express则需额外代码，这可能是官方优先提供Express中间件的原因。

payment-client-fetch.ts

该文件充当客户端角色，向服务器发起请求，对应流程图中的1~4。它使用了「x402-fetch」提供的辅助函数，自动处理402状态码、生成签名并通过X-PAYMENT Header重新发送交易信息。

了解项目基本结构后，可通过以下命令运行Server和Client：

客户端执行结果及日志：

思考与展望

个人认为，如果说Web3开发者此前的努力是为了降低普通用户使用Web3生态的门槛，那么x402则是为了降低Web2开发者接入Web3支付渠道的门槛而诞生的。

x402/client部分提供的辅助函数虽然功能明确，但其意义更多体现在对开发者和服务提供方的支持上。当前用户已能通过钱包支付USDC等资产，体验相对便捷。因此，x402的价值更在于为开发者和服务提供方提供了一种标准化的解决方案。

然而，x402的大规模应用仍面临诸多挑战。一些大型公司内部已有成熟的结算系统，在对接新标准时会有自己的节奏和态度。将新的支付方式集成到现有系统中仍需克服许多障碍。此外，大型公司在对接支付时还需考虑监管影响，这可能导致他们放弃更便捷的支付方式，继续使用传统方案。

或许Node RPC提供方会对x402更加青睐。除了基础接口外，RPC提供方还可通过x402提供高级API和交易加速服务，从而吸引更多用户。

最后需要注意的是，x402本身只是一个基础支付协议，其意义在于提出了一套公认的技术标准。有了统一的标准后，开发者和各类型公司可以共同完善整个生态。我们应该理性看待新标准的提出，避免陷入炒作者的叙事陷阱。

本文由ZAN Team（X账号@zan_team）撰写。