Hirakumi 将 Cardano API 支付与响应检查挂钩

Hirakumi 允许 AI 代理在数据服务返回过时信息、缺失字段或请求失败时保留已购买的额度。该原型为 TOKEN2049 开发，将现有 API 与 x402 支付和 Masumi 代理注册表连接起来。它目前在 Cardano Preprod 上运行，使用测试 USDM 代币。

一次价格请求展示 API 额度如何运作

公开的 Live Crypto Prices 示例演示了计费规则。代理请求一种加密货币的价格，API 必须返回所需字段，且时间戳不超过 15 分钟。

一小时前的读数将无法通过检查，且不消耗额度。请求失败或缺少必需字段的响应同样不扣减。当响应符合条件时，代理接收该响应，套餐余额减少一格额度。

显示的报价为 100 次调用，价格为 2 tUSDM。在 Cardano 上的一次付款即可为该套餐注资，此后各次请求通过 Hirakumi 的网关处理，无需为每个响应分别发起区块链交易。

一条 JSON Schema 规则定义了所需字段、数据类型和信息允许的时效。网关在扣减额度前根据这些条件检验响应。这些检查用于确定格式与新鲜度，并不独立核实所报告的市场价格是否准确。

现有 API 连接到 Masumi 代理

根据该项目的文档，提供方无需修改代码即可上架一个 API。他们提供其地址和示例请求，通过 DNS 记录验证域名所有权，并签名以连接收款地址。Hirakumi 进行测试调用并准备服务描述。

提供方在发布前确认价格与响应条件。加密哈希会在任何销售发生前记录这些条件，且该服务会在 Masumi 上注册，供代理发现。

当代理请求付费访问时，x402 返回包含报价的 HTTP 402 响应。代理为一个套餐付款，并通过 Hirakumi 的网关使用其额度，该网关调用底层 API 并验证结果。任何所需的提供方 API 密钥都保留在网关处。

各方职责明确：Masumi 提供注册与发现，x402 将网页请求与支付连接，Hirakumi 负责校验返回的响应。提供方也可以在 Sokosumi 上给 Hirakumi 代理分配任务以开始设置。

Cardano 托管结算已接受的用量

Hirakumi 支持直接支付与托管。直接支付会立即转给提供方，同时由网关跟踪额度。托管则将资金锁定在用 Aiken 编写的 Cardano 智能合约中。

托管选项适用于更大套餐、新的提供方、可用性较弱的服务，或按买方要求启用。在该模式下，买方的代理也会检查响应，并为其接受的响应签署回执。

结算将根据这些回执计算最终分配，在套餐关闭前仍可提交更新的回执。据该项目介绍，提供方就被接受的响应获得付款，Hirakumi 收取 3% 费用，剩余资金退还给买方。

该公共网站提供用于注册与结算的测试交易链接。其状态页面区分自动化可用性检查与付费活动，并记录服务中断。

浏览器演示将这些组件汇集在一起：访问者可以通过网关请求价格，查看响应与回执，并看到测试套餐中的剩余额度。界面还提供该服务的 Masumi 注册标识符和付款交易供查阅。