x402-presign-guard

x402-presign-guard

「これに署名してもいい？」—— AI トレーディング／ウォレットエージェント向けの、従量課金制の署名前安全レイヤーです。 エージェントが署名する前に、生の EVM トランザクション（または承認）を POST すると、コールデータをデコードし、ウォレットから資金を抜き取るパターンにフラグを立て、GO / HOLD / BLOCK を返します。x402 経由で、自己管理型（匿名の）ウォレットに USDC で決済します。

この分野を選んだ理由（率直な見解）

x402／エージェント決済の経済圏について10の観点から調査（2026年）した結果、次のことが分かりました。

• x402 の実需はごくわずかで、極端に集中しています（実際の商取引は約28,000ドル／日、累計1位のデータ販売者でも月約940ドルです）。日付、OCR、生のチェーン読み取りなどの定型的なAPIの収益は約0ドルです。（以前の x402-jp-data 群が収益を上げられなかった理由を裏付けています。）
• 暗号資産ネイティブのユーザーが実際に支払う意思を持つカテゴリは、トレーディングエージェントが署名前に必ず取得しなければならない 計算済みのリスク／安全性の判定と、自ら生成する独自の実測データ（スクレイピングに伴う利用規約違反や著作権上の問題がなく、後から補完できない時系列データ）だけです。
• このプロジェクトはその両方を備えています。定型的なスコアカードではなく、計算済みの署名前判定を提供し、さらに蓄積されていく悪意のある署名セットを活用します。稼働期間が長くなるほど強固になる堀です。

率直な見通し： 2026年に、x402 の仕組みだけで受動的に月1,000ドルを達成することはできません。現在のトップ販売者の実績を超える金額だからです。現実的な道筋は配布です。エージェントのデフォルトのツールセットに組み込まれるMCP ツールとして提供します（二重の決済方式：x402 の従量課金と、定額の MCP キー）。x402 は導入の入り口であり、需要を生み出すのは MCP のインストール基盤です。この POC は仕組みを実証するとともに、複利的に価値が増す資産を今から築き始めます。

機能（POC — 純粋なコードで、キーも RPC も不要）

src/decode.ts がコールデータを静的にデコードし、実際に資金を抜き取る次のベクトルを検出します。

• 見知らぬ、または悪意があると判明している使用先への、無制限の approve／increaseAllowance
• 見知らぬ、または悪意のあるオペレーターに対する setApprovalForAll(true)（典型的な NFT 資産窃取）
• ガスレスの permit／Permit2 承認（よく使われる資産窃取ベクトル）
• 悪意があると判明している受取先への transfer／transferFrom
• 悪意があると判明しているコントラクトへの呼び出し。見知らぬセレクターには「署名前にシミュレーションしてください」とフラグを立てます

既知の安全なルーター（Uniswap／Permit2／1inch／Seaport）を除外することで、誤検知を減らします。

エンドポイント

パス	価格	内容
GET /guard/token?token=&chain=	0.05 USDC	トレーディングエージェント向けの取引前ERC-20 安全性チェック：悪意のあるアドレスのDBと、オンチェーンのラグ／ハニーポット危険信号（所有者による制御、mint／pause／blacklist、放棄済みかどうか）
GET /guard/tx?to=&data=&value=&chain=	0.05 USDC	署名前の包括的なリスクチェック → GO／HOLD／BLOCK ＋ フラグ
GET /guard/approval?token=&spender=&amount=	無料	承認に特化したチェック（無制限の承認＋悪意のある使用先）— 無料の導入プラン
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（デコード19件＋アプリ6件）、tsc は問題なし。単一のコードベースから Cloudflare Workers と Vercel の両方で動作します。

MCP サーバーとして使う

任意の MCP クライアント（Claude Desktop、エージェントフレームワーク）から、ホストされているガードを指定してください。インストールやビルドは不要で、npm アカウントも必要ありません。

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

npm で公開済み：x402-presign-guard （またはソースから直接実行：npx -y github:kaito3636/x402-presign-guard）。 2つのツール — presign_guard_tx と presign_guard_approval — を公開し、ホストされているガードにリクエストを転送します（GUARD_URL。デフォルトは上記の稼働中 URL）。エージェントは署名する前にガードを呼び出します。

複利を生み出す仕組み（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 を実装したファシリテーターが必要です（例：Coinbase CDP — FACILITATOR_URL と CDP キーを設定）。x402scan に掲載してください。ホスト型エンドポイントは、クローラー向けにすでに /.well-known/x402 を提供しています。