在5分钟内为任何 x402 代理付款添加托管保护

Source: Dev.to

概述

x402 处理超过 6 亿美元的代理间支付，但每笔支付都是最终的——没有退款、争议或追索权。如果代理为一次 API 调用支付 50 美元，却收到空响应、幻觉数据或 500 错误，钱就会丢失。

PayCrow 为任何 x402 支付添加信任评分、USDC 托管以及链上争议解决。如果 API 返回垃圾数据，资金将保持锁定，由仲裁人审查案件；如果响应有效，资金将自动释放。

安装

npm install -g paycrow
npx paycrow init

init 命令会创建一个全新的钱包并打印 Claude Desktop 配置。将输出中的私钥复制下来。

为钱包充值

向打印的 Base 地址发送少量 ETH（≈ 0.50 美元）用于支付 gas，然后发送你计划用于支付的 USDC（例如，起始时发送 5–10 美元）。

Claude Desktop 配置

在 claude_desktop_config.json 中添加以下内容（macOS 路径：~/Library/Application Support/Claude/claude_desktop_config.json）：

{
  "mcpServers": {
    "paycrow": {
      "command": "npx",
      "args": ["paycrow"],
      "env": {
        "PRIVATE_KEY": "0xYOUR_KEY_FROM_STEP_2"
      }
    }
  }
}

重启 Claude Desktop。

使用 safe_pay

告诉 Claude：

“使用 safe_pay 调用 https://api.example.com/data — 卖家地址是 0xABC123… 并支付 2 美元 USDC。”

Claude 将调用 safe_pay 工具，其流程如下：

1. 检查卖家的信任评分。
2. 在 Base 上创建托管。
3. 调用 API。
4. 验证响应（JSON + 2xx 状态码）。
5. 自动释放或自动争议付款。

流程图

trust_gate check
    |
    v
Score >= 75?  --> 15 min timelock, up to $100
Score 45‑74? --> 60 min timelock, capped at $25
Score  <45?  --> 4 hr timelock, capped at $5
Unknown / high dispute rate? --> BLOCKED

    |
    v
escrow_create (USDC locked on Base)
    |
    v
HTTP call to the API
    |
    v
Response valid (2xx + JSON)?
   / \
 YES  NO
  |    |
auto‑release   auto‑dispute (arbiter reviews)
(seller paid)  (arbiter reviews)

托管生命周期（链上）

自定义调用

如需更细粒度的控制（自定义 JSON‑Schema 验证、哈希锁验证或特定的时间锁值），请使用 x402_protected_call。它接受与 safe_pay 相同的参数，但允许你手动指定所有细节。

信任评分

PayCrow 将四个链上来源聚合为单一的 0‑100 分数：

基于分数的决策

附加信息

• 许可证： MIT 许可证
• npm 包： paycrow（v1.2.0）
• 实时 API：

341 tests. Deployed on Base mainnet. Works with Claude Desktop, Claude Code, Cursor, Windsurf, and any MCP client.