keich2realg/plugin-tokenguard

# @keich2realg/plugin-tokenguard ElizaOS agents 的交易前**安全网关**。在你的 agent 购买 ERC-20 token 之前，此插件会通过 [**TokenGuard**](https://tokenguard-api-sssu.onrender.com) API 检查它是否存在**蜜罐、高额税费和低流动性**——通过 **x402 按次付费**（Base 上的 USDC），使用 agent 自己的 EVM 钱包。无需 API key，无需注册。 避免一次蜜罐骗局就足以抵消约 30,000 次检查的成本。 ## 新增功能 一个 **`CHECK_TOKEN_RISK`** action，每当消息中包含 ERC-20 地址时就会触发。它返回一个 agent 可以据此采取行动的判定结果： ``` Verdict: SAFE (risk 0/100), honeypot: no, buy tax 0%, sell tax 0%, liquidity $25,477,531. ``` 链：`base`、`ethereum`、`bsc`（无论在哪个链上，agent 均在 Base 上付费）。 ## 安装 ``` elizaos plugins add @keich2realg/plugin-tokenguard # 或 npm install @keich2realg/plugin-tokenguard ``` ## 配置 该插件需要 agent 的 EVM 钱包（在 Base 上准备少量 USDC）来按次付费。添加到你的 character/env 中： ``` EVM_PRIVATE_KEY=0x... # required — agent wallet, small USDC balance on Base TOKENGUARD_URL=https://tokenguard-api-sssu.onrender.com # optional override ``` 然后在你的 character 中注册该插件： ``` import { tokenGuardPlugin } from "@keich2realg/plugin-tokenguard"; export const character = { name: "MyTrader", plugins: [tokenGuardPlugin], // ... }; ``` ## 工作原理 ``` message with 0x token ─▶ CHECK_TOKEN_RISK │ createSigner("base", EVM_PRIVATE_KEY) │ wrapFetchWithPayment(fetch, signer) ← x402, gasless ▼ GET TokenGuard /check ─▶ {verdict, risk_score, taxes, liquidity} ▼ agent replies / decides ``` 支付是免 gas 的（由 facilitator 承担 gas）；agent 只需要 USDC。 默认每次调用的上限为 0.10 USDC；一次检查的成本为 $0.015。 ## 安全性 请使用余额较小的**专用 agent 钱包**。`EVM_PRIVATE_KEY` 仅从设置中读取，且绝对不会被记录到日志中。 ## 构建 ``` npm install npm run build # tsup -> dist/ npm run typecheck ``` ## 链接 - TokenGuard API 及文档：https://tokenguard-api-sssu.onrender.com/docs - 示例 agent (Python)：https://github.com/keich2realg/tokenguard-agent-example - x402：https://x402.org MIT

标签：ElizaOS, Web3, 加密货币交易, 区块链, 智能合约审计, 自动化攻击