蓝图 SDK 如何将 x402 支付转换为可执行任务

HTTP 状态码 402 终于有了用武之地

HTTP 状态码 402 自 1999 年起一直被“保留以供将来使用”。在二十七年的时间里，它始终停留在规范中，作为一个从未实现的支付网络的占位符。到了 2025 年，Coinbase 与 Cloudflare 推出的 x402 协议 赋予了它实际用途：客户端向某个端点发起请求，收到一个包含价格信息的 402 响应，随后签署一笔稳定币支付，并将附带结算证明的请求重新发送，该证明作为 HTTP 请求头附加其中。无需 API 密钥，无需计费仪表盘，也无需月度账单。只需提供加密证明，表明资金已转移，计算资源才被消耗。

Blueprint SDK 通过其 blueprint_x402 工具包集成了 x402 支付协议。该工具包运行一个 axum HTTP 服务器，通过外部协调方验证 x402 支付请求头，在执行前完成链上支付结算，并将每笔已验证的支付转换为标准的 JobCall。如果你还不熟悉 Blueprint 模型，可以阅读 《Blueprint 的工作原理》 了解其架构。无论任务是由 Base 链上的 x402 支付触发、由链上 Tangle 事件触发，还是由定时任务（cron）触发，任务处理器的工作方式完全一致。你只需编写一个接收字节并返回字节的函数，在 TOML 配置文件中设定价格，网关便会自动处理支付验证、多链汇率转换、访问控制和重放攻击防护。集成时，只需添加 blueprint_x402 依赖项，在两个 TOML 文件中配置接受的代币和任务价格，并将 X402Gateway 与 X402Producer 接入 BlueprintRunner 即可。

本文将逐步讲解其工作原理：支付验证流程、价格转换管道、使其具备组合性的生产者抽象，以及将各部分串联起来的配置方式。

集成检查清单

在深入细节之前，先快速概览端到端的连接方式：

1. 将 blueprint_x402 添加为依赖项（需配合 Blueprint SDK 并使用 Rust 2021 版本）
2. 创建 x402.toml 文件，配置协调方 URL、接受的代币及每个任务的访问策略
3. 创建 job_pricing.toml 文件，为每个任务设置以 wei 为单位的基础价格
4. 根据配置初始化 X402Gateway 和 X402Producer
5. 将生产者和网关与你的任务路由一起接入 BlueprintRunner
6. （可选）配置 CachedRateProvider 以获取实时汇率

以下将详细说明每个步骤。

基于信用额度的 API 存在的问题

如果你曾开发过付费 API，一定熟悉这种模式：用户注册后获得一个 API 密钥，向账户充值信用额度，每次调用时系统从余额中扣除相应费用。这种方式虽然可行，但需要配套的计费系统、账户数据库、争议处理机制、欺诈检测功能，以及专门用于处理“为什么我被重复扣款”之类问题的客服队列。

对于在 Tangle 上构建人工智能服务的基础设施运营商而言，这类额外负担相当沉重。你只想通过 HTTP 暴露一个计算任务并获得报酬，而不希望同时运营一套 SaaS 计费平台。

x402 协议彻底移除了账户层。客户端在 HTTP 请求本身中直接提供支付证明，服务器在执行任何操作前先验证该证明。无需跟踪余额，无需对账信用额度，也无需轮换 API 密钥。每个请求都是一次自包含的经济交易。

使用 Blueprint SDK 集成 x402 支付协议

先结算，后执行

Blueprint SDK 采用了一种明确的设计选择：运营商必须在执行任何工作前先收到付款。

该网关使用 X402Middle