token-safety-check

token-safety-check

这个代币安全吗？ 为 Base、Ethereum、Arbitrum、Optimism、Polygon 或 Solana 上的任意代币进行跑路风险检查，适用于 AI Agent 和脚本。每次检查都会返回：

• 0–100 的风险分数和等级（低、中、高、严重），并附上通俗易懂的原因：
  • 谁可以铸造、冻结、拉黑、暂停或更改费用
  • 可升级的合约代码
  • Token-2022 永久委托、转账费用和钩子
  • 持有者集中度
  • 流动性不足或缺失
• 支撑评分的事实：所有者、权限、供应量、主要持有者、流动性池；
• USD 价格和流动性；
• 一个指纹。将它作为 since 传回，下次检查就会告知发生了哪些变化：新增风险、权限变更、流动性或价格波动。这样就可以轻松按计划监控代币。

每次检查费用为 $0.01，以 Base 上的 USDC 支付，通过 x402 从你控制的钱包自动扣款。无需账户或 API 密钥。错误和无效输入不会收费，支出上限也会阻止任何超过限额的检查（默认值为 $0.05）。

评分基于规则，不构成投资建议。对于流动性充足的代币，各项权限的影响会降低，因为它们通常是大型发行方的合规控制措施（例如，USDC 可以冻结和铸造代币）。

在 Claude Desktop、Cursor 或任意 MCP 客户端中使用

专门为此新建一个钱包，并向其中转入少量 Base 上的 USDC：$1 可进行 100 次检查。然后将以下内容添加到 MCP 配置中（Claude Desktop 的配置文件为 claude_desktop_config.json）：

{
  "mcpServers": {
    "token-safety-check": {
      "command": "npx",
      "args": ["-y", "token-safety-check"],
      "env": { "X402_PRIVATE_KEY": "0x<private key of the dedicated wallet>" }
    }
  }
}

该服务只有一个工具 check_token_safety（参数为 address，以及可选的 chain 和 since）。可选环境变量：

• TOKEN_SAFETY_MAX_USD：单次检查的支出上限，默认为 0.05。
• TOKEN_SAFETY_ENDPOINT：指定另一个部署地址。

在代码中使用

npm install token-safety-check

import { createTokenSafetyClient } from "token-safety-check";

const client = createTokenSafetyClient({ privateKey: process.env.X402_PRIVATE_KEY as `0x${string}` });

const first = await client.checkToken({ chain: "base", address: "0x4ed4E862860beD51a9570b96d89aF5E1B0Efefed" });
console.log(first.risk.score, first.risk.level, first.risk.summary);
// 15 low Low risk: the owner can pause all transfers; ownership is not renounced.

// Later: what changed since then?
const later = await client.checkToken({ address: first.address, chain: "base", since: first.watch.fingerprint });
if (later.watch.changes?.anythingChanged) console.log(later.watch.changes);

在 Coinbase AgentKit 中使用

import { customActionProvider } from "@coinbase/agentkit";
import { z } from "zod";
import { createTokenSafetyClient } from "token-safety-check";

const safety = createTokenSafetyClient({ privateKey: process.env.X402_PRIVATE_KEY as `0x${string}` });

export const tokenSafety = customActionProvider({
  name: "check_token_safety",
  description: "Rug check a token on Base, Ethereum, Arbitrum, Optimism, Polygon or Solana: 0-100 risk score with reasons.",
  schema: z.object({
    address: z.string().describe("Token contract or Solana mint address"),
    chain: z.enum(["base", "eth", "arbitrum", "optimism", "polygon", "solana"]).optional(),
  }),
  invoke: async (args) => JSON.stringify(await safety.checkToken(args)),
});
// Add tokenSafety to the actionProviders you pass to AgentKit.from(...).

在 LangChain（JS）中使用

import { tool } from "@langchain/core/tools";
import { z } from "zod";
import { createTokenSafetyClient } from "token-safety-check";

const safety = createTokenSafetyClient({ privateKey: process.env.X402_PRIVATE_KEY as `0x${string}` });

export const checkTokenSafety = tool(async (args) => JSON.stringify(await safety.checkToken(args)), {
  name: "check_token_safety",
  description: "Rug check a token on Base, Ethereum, Arbitrum, Optimism, Polygon or Solana: 0-100 risk score with reasons.",
  schema: z.object({
    address: z.string(),
    chain: z.enum(["base", "eth", "arbitrum", "optimism", "polygon", "solana"]).optional(),
  }),
});

输出示例（已精简）

{
  "address": "0x4ed4E862860beD51a9570b96d89aF5E1B0Efefed",
  "chain": "base",
  "name": "Degen",
  "symbol": "DEGEN",
  "risk": {
    "score": 15,
    "level": "low",
    "reasons": [
      { "code": "can-pause", "points": 10, "text": "The owner can pause all transfers." },
      { "code": "owner-not-renounced", "points": 5, "text": "Ownership is not renounced." }
    ],
    "summary": "Low risk: the owner can pause all transfers; ownership is not renounced."
  },
  "market": { "dex": "uniswap-v3", "pairedWith": "WETH", "priceUsd": 0.000963, "quoteSideLiquidityUsd": 134000 },
  "watch": { "fingerprint": "eyJzIjoxNSwi…", "changes": null }
}

不使用此软件包

此检查是一个普通的 x402 端点，因此任何 x402 客户端都可以直接调用： GET https://ca-tax-api-mainnet.lxtap.workers.dev/token?chain=<chain>&address=<address>[&since=<fingerprint>]。 它也已列入 x402 Bazaar。

安全说明

• 使用余额较少的专用钱包。密钥不会离开你的设备；它只会用于签署按报价支付的 USDC 款项。
• 每次检查的价格都会在付款前从服务的付款请求中读取，任何超过 maxUsdPerCheck / TOKEN_SAFETY_MAX_USD 的费用都会被拒绝。

采用 MIT 许可证。