warden402-mcp

Warden — Base 上の AI エージェント向け実行前セキュリティ

エージェントがトークンを購入したり、トランザクションに署名したり、アドレスに支払いを行ったりする前に、Warden に確認してください。理由、リスクスコア、そして該当するものがあれば、代わりに署名すべきより安全な内容とともに、block · review · clear が返されます。さらに、エージェントごとのファイアウォールが支出ポリシーを適用します：allow · hold · deny。

稼働中：warden402.xyz · 公開実績：warden402.xyz/track-record

クイックスタート

MCP（Claude、Cursor、あらゆる MCP クライアント）— キーは不要です：

{
  "mcpServers": {
    "warden402": {
      "command": "npx",
      "args": ["-y", "warden402-mcp"],
      "env": { "WARDEN_AGENT_KEY": "wk_... (optional, enables firewall tools)" }
    }
  }
}

ツール：guard_token、guard_tx、guard_address、エージェントキーを使う場合は firewall_check、firewall_status。→ mcp/README.md

SDK（TypeScript、フェイルクローズ）：

import { Warden } from "warden402-sdk";
const warden = new Warden({ agentKey: process.env.WARDEN_AGENT_KEY });

await warden.assertSafe(() => warden.token("0xTOKEN"));         // throws on block
await warden.protect({ to: payee, amountUsd: 5 }, () => pay());  // runs only on allow

→ sdk/README.md（LangChain ツールも含みます）

HTTP：

curl "https://warden402.xyz/api/guard?address=0xTOKEN"                 # token
curl "https://warden402.xyz/api/guard?type=address&address=0xADDR"     # address
curl -X POST https://warden402.xyz/api/guard -H 'content-type: application/json' \
  -d '{"type":"tx","from":"0x..","to":"0x..","calldata":"0x.."}'       # transaction

1 IP あたり1日50回までガードを無料で利用でき、その後は x402 による従量課金です（トークン／アドレスは $0.01、トランザクションは $0.02、Base 上の USDC）。ファイアウォールのエージェントキー：warden402.xyz/onboard（無料：エージェント1つ、月1,000回のチェック）。

チェック項目

対象	シグナル
トークン	実際の保有者によるリアルタイムの売却シミュレーション（売却できるか？）、ハニーポットと税金、所有者権限（ミント、残高設定、ブラックリスト登録、アップグレード可能なロジック）、コントラクト制御、ウォレット保有者の集中度（LP／CEX／バーンアドレスは除外）、流動性、LP ロック、デプロイヤーの評判、OFAC
トランザクション	calldata のデコード（approve、increaseAllowance、EIP-2612 permit、Permit2、setApprovalForAll、transfer）；承認先（コードのないアドレスへの無制限承認 → block）；eth_call シミュレーション（リバート、コントラクトではない相手への呼び出し）；取引相手の OFAC およびコントラクトリスク；送金時のアドレスポイズニング。remediation を返します — 例：代わりに署名する正確な金額の承認
アドレス	OFAC、制裁対象の取引相手との関係、コントラクトリスク、身元（検証済み／名前あり／匿名）

シグナルデータは x402 Bazaar と Base RPC から取得されます。

判定方法

1. 判定経路に LLM は使いません。 判定、スコア、要約は、収集したシグナルに対する決定論的なルールで算出されます。同じ入力には、常に同じ判定が返されます。
2. 安全側に倒します。 重要なシグナルを取得できない場合は unknown → degraded: true となり、判定は最悪でも review です。誤って clear になることはありません。SDK と MCP もフェイルクローズで、判定がなければ例外をスローし、「続行しないでください」となります。
3. スコアにかかわらず、次のケースは必ずブロックします： ハニーポット、制裁対象、売却できないトークン、偽装された類似アドレスの受取人、通常のウォレットへの無制限承認。
4. それ以外の場合：加重リスクが 70 以上なら block、fail がある場合、またはリスクが 35 以上、あるいは warn が2つ以上なら review、それ以外は clear です。
5. すべての判定を記録し、ラグの発生を後から再確認します — これが公開実績です。

ファイアウォール（エージェントごと）

エージェントの価値の流れを制御するポリシー・アズ・コード：呼び出しごと／時間ごと／日ごとの支出上限、許可リストと拒否リスト、無制限承認の禁止、新しい取引相手への初回支払いは人間による確認のため保留（/account または API で承認／却下）、1分あたりの呼び出し回数制限、異常値乗数、キルスイッチ、監査ログ、保留時の Webhook。チームアカウントはウォレット（SIWE）でサインインし、ロールとプランを利用できます。 → FIREWALL.md

リポジトリ

パス	内容
web/	本番サイト および API（Vercel 上の Next.js）：ガード、ファイアウォール、実績、アカウント、x402 の決済ゲート
packages/core/	共通の判定スキーマと calldata デコーダー（@warden/core）
mcp/	warden402-mcp — stdio MCP サーバー
sdk/	warden402-sdk — TypeScript クライアントと LangChain ツール
src/	任意のスタンドアロン Hono API（Node ホスト）。ドリフトテストにより、エンジンが web/ と同一であることを維持します
tests/	Vitest：判定エンジン、calldata デコーダー、ファイアウォールポリシー、ドリフトガード、Web シグナル

npm install && npm test                      # unit tests
cd web && cp .env.example .env.local && npm run dev   # site + API on :3000

デプロイに関する注意事項：DEPLOY.md。

ライセンス

MIT — LICENSE を参照してください。