X402 Presign Guard

io.github.kaito3636由 GitHub 帳號 kaito3636 發布v0.1.1更新於 Oct 25, 2026

Pre-sign EVM tx/approval safety for AI agents: decode calldata, flag drainers, return GO/HOLD/BLOCK.

已驗證STDIO僅桌面金融安全與監控

概覽

AI 產生的概覽

在簽署前檢查 EVM 交易與代幣授權,標記錢包盜空模式並回傳 GO、HOLD 或 BLOCK 結論。

可以做什麼
  • 簽署前檢查原始 EVM 交易:解碼 calldata,回傳 GO/HOLD/BLOCK 與標記項目。
  • 檢查代幣授權:標記無限額度授權以及授權給已知惡意花費者的情況。
  • 辨識 setApprovalForAll、無 gas permit、轉帳給惡意地址等盜空模式,並以已知可信路由降低誤報。
  • 兩個工具都會轉送到託管的 guard 服務,而非在本機解碼。
適用情境
適合準備 EVM 交易或授權的代理與使用者,在簽署前取得安全判斷,尤其適用於處理陌生合約與花費者的交易或錢包代理。
執行需求
透過 npm 套件 x402-presign-guard 以 npx 在本機執行,並將請求轉送到託管的 guard 端點(GUARD_URL,預設為專案線上網址),因此需要能連線該服務的網路。未宣告任何 API 金鑰或環境變數。
安裝前請注意
結論僅供參考,且來自會收到所提交交易內容的第三方託管服務,不能取代模擬執行或自行審查。README 說明有以 USDC 結算的付費 x402 端點,部分檢查可能涉及花費資金,且該託管服務採匿名自託管錢包模式。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 X402 Presign Guard,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only,透過 STDIO。 STDIO 服務會啟動本機處理程序,因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

x402-presign-guard

"Should I sign this?" — a pay-per-call pre-sign safety layer for AI trading/wallet agents. An agent POSTs a raw EVM transaction (or an approval) before signing; this decodes the calldata, flags the patterns that drain wallets, and returns GO / HOLD / BLOCK. Settles in USDC via x402 to a self-custody (pseudonymous) wallet.

Why this axis (the honest frame)

10-angle research (2026) on the x402 / agent-payment economy concluded:

  • Real x402 demand is tiny and hyper-concentrated (~$28K/day real commerce; the all-time #1 data seller ≈ $940/mo). Flat/commodity APIs — dates, OCR, raw chain reads — earn ≈ $0. (Confirms why the earlier x402-jp-data fleet made nothing.)
  • The only categories with real crypto-native willingness-to-pay: computed risk/safety verdicts a trading agent must get before it signs — and first-party MEASURED data you generate yourself (no scraping ToS / copyright, un-backfillable time-series).
  • This project is both: a computed pre-sign verdict (not a commodity score card), backed by an accumulating malicious-signature set — the moat that gets bigger the longer it runs.

Honest expectation: $1,000/mo is NOT achievable passively on x402 rails in 2026 — it's above the current top seller. The realistic path is distribution: ship this as an MCP tool that lands in agents' default toolsets (dual-rail: x402 pay-per-call + flat MCP key). x402 is the on-ramp; the MCP install base is the demand. The POC proves the mechanism and starts the compounding asset now.

What it does (POC — pure code, no keys, no RPC)

src/decode.ts statically decodes calldata and catches the real drain vectors:

  • unlimited approve / increaseAllowance to an unknown or known-malicious spender
  • setApprovalForAll(true) (classic NFT drainer) to unknown / malicious operators
  • gasless permit / Permit2 approvals (common drainer vector)
  • transfer / transferFrom to known-malicious recipients
  • calls to known-malicious contracts; unknown selectors flagged "simulate before signing" Known-good routers (Uniswap/Permit2/1inch/Seaport) reduce false positives.

Endpoints

pathpricewhat
GET /guard/token?token=&chain=0.05 USDCpre-TRADE ERC-20 safety for trading agents: malicious-DB + on-chain rug/honeypot red-flags (owner controls, mint/pause/blacklist, renounced?)
GET /guard/tx?to=&data=&value=&chain=0.05 USDCfull pre-sign risk check → GO/HOLD/BLOCK + flags
GET /guard/approval?token=&spender=&amount=freeapproval-specific (unlimited + malicious-spender) — free adoption tier
GET /guard/signaturesfreesize of the accumulating signature set (the moat)
GET /, GET /.well-known/x402freedocs + Bazaar discovery

Live (2026-10-24)

Running in production, paid mode on: https://x402-presign-guard.vercel.app

bash
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

A 402 returns the x402 v1 payment requirements (scheme exact, network base, USDC); an x402-capable client pays and retries. Implemented + tested: 25/25 PASS (decode 19 + app 6), tsc clean. Runs on both Cloudflare Workers and Vercel from one codebase.

Use it as an MCP server

Point any MCP client (Claude Desktop, agent frameworks) at the hosted guard — no install build, no npm account needed:

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

Published on npm: x402-presign-guard (or run straight from source: npx -y github:kaito3636/x402-presign-guard). Exposes two tools — presign_guard_tx and presign_guard_approval — that forward to the hosted guard (GUARD_URL, default the live URL above). The agent calls the guard before it signs.

The compounding engine (v2, wired but off)

wrangler.toml has a commented cron + KV: a scheduled job ingests malicious selectors/addresses from live threat feeds + own honeypot probes, timestamped — so the signature set and the never-backfillable time-series grow every day. That daily accrual is the "掘るほど美味い" asset.

Deploy your own

Vercel (how the live one runs):

bash
npm installnpx vercel deploy --prod                       # free mode firstnpx vercel env add PAY_TO production            # Base self-custody wallet 0x… → go paidnpx vercel deploy --prod

Cloudflare Workers (alternative; same code):

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

Distribution (the real lever)

MCP server (this repo, npx github:…) → Official MCP Registry / mcp.so; x402 Bazaar discovery needs a facilitator that implements /discovery/resources (e.g. Coinbase CDP — set FACILITATOR_URL + CDP keys); list on x402scan. The hosted endpoint already serves /.well-known/x402 for crawlers.

來源:README.md,提交 356a459

工具

2

presign_guard_tx

Check whether an EVM transaction is safe to sign BEFORE signing it. Decodes the calldata, flags wallet-drainer patterns (unlimited approvals, setApprovalForAll, gasless permits, transfers/approvals to known-malicious addresses) and returns a GO / HOLD / BLOCK verdict.

輸入參數todatachainvalue

presign_guard_approval

Check whether a token approval is safe to sign. Flags unlimited allowances and approvals to known-malicious spenders. Returns GO / HOLD / BLOCK.

輸入參數chaintoken必填amountspender必填

版本歷史

1
  1. v0.1.1最新Oct 25, 2026

評分

已滿足適用檢查項的 80%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分
  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭,或保持端點能夠回應探測,以便判定其認證方式。

  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分

    請在儲存庫或註冊中心條目中宣告授權條款。