RugShield 402：基于 Base 与 x402 的 DEX 蜜罐模拟器

面向 Base 上 AI 代理的自主 DEX 蜜罐检测与税收模拟引擎
由 Coinbase x402 支付协议 控制访问（Base 主网上每次调用 $0.005 USDC）。

⚡ 规格与架构

• 结算网络：Base 主网（eip155:8453）
• 结算资产：Base 上的 USDC（0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913）
• 每次扫描价格：$0.005 USDC（5000 微单位）
• 商户地址：0x73279fa4BadA7CAC888c62CDa4f5c8104765f6f1
• 协议：HTTP 402 Payment Required，配合 EIP-712 转账授权

🚀 核心 API 端点

1. POST /v1/scan（付费：$0.005 USDC）

在 Base 上模拟 DEX 买入/卖出订单，以基点（bps）计算买入与卖出税，检查字节码中的黑名单/交易限制，并查询 Aerodrome 与 Uniswap v3 的池深度。

请求负载：

{
  "token_address": "0x4ed4E862860beD51a9570b96d89aF5E1B0Efefed",
  "chain_id": 8453,
  "simulate_sell": true
}

响应（HTTP 200）：

{
  "token": "0x4ed4E862860beD51a9570b96d89aF5E1B0Efefed",
  "symbol": "DEGEN",
  "is_honeypot": false,
  "buy_tax_bps": 0,
  "sell_tax_bps": 0,
  "liquidity_usd": 68400,
  "risk_score": 0.02,
  "recommendation": "SAFE_TO_SWAP",
  "attestation": "rugshield_verified_8453_0x4ed4e8_1740000000",
  "timestamp": 1740000000
}

2. GET /health（免费）

返回健康检查状态，用于容器保活监控。

3. GET /.well-known/x402.json（免费）

符合 x402 规范的机器可读发现清单。

🤖 MCP 服务器集成

添加到你的 claude_desktop_config.json 或 Cursor MCP 设置中：

{
  "mcpServers": {
    "rugshield": {
      "command": "node",
      "args": ["<PATH_TO_RUGSHIELD>/dist/mcp/server.js"],
      "env": {
        "BUYER_PRIVATE_KEY": "0x..."
      }
    }
  }
}

🔌 生态插件

ElizaOS（/plugins/eliza-rugshield）

即插即用动作 PRE_SWAP_RISK_CHECK，可接入交易执行循环并查询 /v1/scan。

Coinbase AgentKit（/plugins/agentkit-rugshield）

用于自动化代理保护的动作提供程序 rugshield_pre_swap_check。

⏱️ 防冷启动心跳触发器

RugShield 内置一个内部心跳守护进程，每 9 分钟 ping 一次 /health。如需外部零延迟监控，请配置外部 cron 触发器（例如 UptimeRobot 或 Cron-Job.org）：

curl -s -X GET "https://rugshield-402.onrender.com/health" -H "User-Agent: UptimeRobot/2.0"

建议间隔：每 5 到 10 分钟一次。