x402-presign-guard

x402-presign-guard

“我应该签名吗？”——面向 AI 交易／钱包 Agent 的按调用付费签名前安全层。 Agent 在签名之前提交原始 EVM 交易（或授权）；此工具会解码 calldata、标记会掏空钱包的模式，并返回 GO / HOLD / BLOCK。费用通过 x402 以 USDC 结算至自托管（假名）钱包。

为什么选择这个方向（坦诚的分析）

2026 年针对 x402／Agent 支付经济的 10 角度研究得出结论：

• 真实的 x402 需求极小且高度集中（真实交易额约为每天 $28K；历史销量第 1 的数据卖家每月约为 $940）。固定／通用 API——日期、OCR、原始链上读取——收入约为 $0。（这印证了此前 x402-jp-data 集合毫无收益的原因。）
• 真正有加密原生付费意愿的品类只有：交易 Agent 在签名之前必须获取的计算所得风险／安全判定，以及你自行生成的第一方实测数据（不抓取违反 ToS／版权的内容，且无法事后补齐的时间序列）。
• 本项目两者兼具：计算所得的签名前判定（不是通用评分卡），并由不断累积的恶意签名集合提供支持——运行时间越长，这道护城河就越深。

坦诚的预期：2026 年，在 x402 通道上被动实现每月 $1,000 的收入并不可行——这一目标已高于当前头部卖家的收入。现实的路径是扩大分发：将其作为 MCP 工具发布，让它进入各 Agent 的默认工具集（双通道：x402 按调用付费 + 固定 MCP 密钥）。x402 是接入渠道；MCP 安装量才是需求来源。POC 证明了这一机制，并从现在开始积累复利资产。

功能（POC——纯代码，无密钥、无 RPC）

src/decode.ts 静态解码 calldata，并捕获真实的资产掏空手段：

• 对未知或已知恶意的 spender 执行无限额 approve / increaseAllowance
• 对未知／恶意 operator 执行 setApprovalForAll(true)（典型 NFT 掏空手段）
• 无 gas permit / Permit2 授权（常见的掏空手段）
• 向已知恶意收款方执行 transfer / transferFrom
• 调用已知恶意合约；未知 selector 会标记为“签名前先模拟” 已知可信的路由器（Uniswap/Permit2/1inch/Seaport）可减少误报。

端点

路径	价格	功能
GET /guard/token?token=&chain=	0.05 USDC	面向交易 Agent 的 交易前 ERC-20 安全检查：恶意数据库 + 链上跑路／蜜罐预警（所有者控制权限、铸币／暂停／黑名单、是否已放弃权限？）
GET /guard/tx?to=&data=&value=&chain=	0.05 USDC	完整的签名前风险检查 → GO/HOLD/BLOCK + 标记
GET /guard/approval?token=&spender=&amount=	免费	授权专项检查（无限额 + 恶意 spender）——免费使用层
GET /guard/signatures	免费	不断累积的签名集合规模（护城河）
GET /、GET /.well-known/x402	免费	文档 + Bazaar 发现入口

在线运行（2026-10-24）

正在生产环境运行，付费模式已启用： https://x402-presign-guard.vercel.app

curl https://x402-presign-guard.vercel.app/.well-known/x402            # discovery (free)
curl "https://x402-presign-guard.vercel.app/guard/tx?to=0x..."         # 402 + payment requirements

402 响应会返回 x402 v1 支付要求（scheme exact、network base、USDC）；支持 x402 的客户端付款后重试。已实现并通过测试：25/25 PASS（decode 19 + app 6）， tsc 检查通过。使用同一套代码，可在 Cloudflare Workers 和 Vercel 上运行。

将其用作 MCP 服务

将任意 MCP 客户端（Claude Desktop、Agent 框架）指向托管版 guard 即可——无需安装构建，也无需 npm 账号：

{
  "mcpServers": {
    "presign-guard": {
      "command": "npx",
      "args": ["-y", "x402-presign-guard"]
    }
  }
}

已发布至 npm：x402-presign-guard （也可直接从源代码运行：npx -y github:kaito3636/x402-presign-guard）。 它提供两个工具——presign_guard_tx 和 presign_guard_approval——用于转发至托管版 guard（GUARD_URL，默认值为上述在线 URL）。Agent 会在签名前调用 guard。

复利引擎（v2，已接入但未启用）

wrangler.toml 中注释掉了 cron 和 KV：定时任务会从实时威胁源和自有蜜罐探测中采集恶意选择器／地址，并为其添加时间戳——因此，特征集和无法事后补录的时间序列每天都会增长。这种每日累积正是「越挖越值钱」的资产。

部署你自己的版本

Vercel（线上版本的运行方式）：

npm install
npx vercel deploy --prod                       # free mode first
npx vercel env add PAY_TO production            # Base self-custody wallet 0x… → go paid
npx vercel deploy --prod

Cloudflare Workers（替代方案；代码相同）：

npx wrangler login && npx wrangler deploy
npx wrangler secret put PAY_TO && npx wrangler deploy

分发（真正的杠杆）

MCP 服务（本仓库，npx github:…）→ Official MCP Registry / mcp.so；要通过 x402 Bazaar 发现服务，需要一个实现了 /discovery/resources 的 facilitator（例如 Coinbase CDP——设置 FACILITATOR_URL 和 CDP 密钥）；在 x402scan 上发布。托管端点已为爬虫提供 /.well-known/x402。