蓝图 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 事件还是定时任务触发，作业处理器的工作方式完全相同。你只需编写一个接收字节并返回字节的函数，在 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