warden402-mcp

Warden — 为 Base 上的 AI Agent 提供执行前安全防护

Agent 购买代币、签署交易或向地址付款之前，请先询问 Warden。你将得到 block · review · clear 判定，以及判定理由、风险评分，还有——如果有的话——更安全的替代签署方案。此外，每个 Agent 都有一个 Firewall，用于强制执行支出策略：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；使用 Agent 密钥时还可用 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

每个 IP 每天可免费调用 50 次安全检查，之后按次通过 x402 付费（代币/地址检查 $0.01，交易检查 $0.02，使用 Base 上的 USDC）。Firewall Agent 密钥：warden402.xyz/onboard（免费：1 个 Agent，每月 1,000 次检查）。

检查内容

目标	信号
代币	对真实持有者进行实时卖出模拟（能否卖出？）、蜜罐与税费、所有者权限（铸造、设置余额、拉黑、可升级逻辑）、合约控制、钱包持有者集中度（排除 LP / CEX / 销毁地址）、流动性、LP 锁定、部署者信誉、OFAC
交易	calldata 解码（approve、increaseAllowance、EIP-2612 permit、Permit2、setApprovalForAll、transfer）；审批目标（向没有代码的地址授予无限额授权 → 拦截）；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 或出现 2 个及以上 warn → review；否则为 clear。
5. 每项判定都会记录，并在之后重新检查是否发生 Rug 拉盘跑路——相关记录公开可查。

Firewall（针对每个 Agent）

在 Agent 的资金流前实施策略即代码：每次 / 每小时 / 每日支出上限、允许与拒绝名单、禁止无限额授权、向新交易对手方进行的首笔付款需由人工审核（在 /account 中或通过 API 批准 / 拒绝）、每分钟调用次数上限、异常乘数、紧急停止开关、审计日志、暂缓时发送 Webhook。团队账户使用钱包登录（SIWE），并设有角色和套餐。 → FIREWALL.md

仓库

路径	内容
web/	生产站点和 API（基于 Vercel 的 Next.js）：防护、Firewall、防护记录、账户、x402 支付门控
packages/core/	共享的判定结果架构 + 调用数据解码器（@warden/core）
mcp/	warden402-mcp — stdio MCP 服务
sdk/	warden402-sdk — TypeScript 客户端 + LangChain 工具
src/	可选的独立 Hono API（Node 主机）；漂移测试确保其引擎与 web/ 保持一致
tests/	Vitest：决策引擎、调用数据解码器、防火墙策略、漂移防护、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。