token-safety-check

token-safety-check

このトークンは安全ですか？ AI エージェントやスクリプト向けに、Base、Ethereum、Arbitrum、Optimism、Polygon または Solana 上のあらゆるトークンをラグチェックできます。各チェックでは、次の情報が返されます。

• 0～100 のリスクスコアとレベル（低、中、高、重大）、および平易な言葉による理由：
  • 誰がミント、凍結、ブラックリスト登録、一時停止、手数料変更を行えるか
  • アップグレード可能なコントラクトコード
  • Token-2022 の恒久的な委任、送金手数料、フック
  • 保有者の集中度
  • 流動性の薄さ、または流動性がないこと
• スコアの根拠となる事実：所有者、権限、供給量、上位保有者、プール
• USD 価格と流動性
• フィンガープリント。これを since として渡すと、次のチェックで変更点（新たなリスク、権限の変更、流動性や価格の変動）がわかります。定期的なトークン監視が簡単になります。

チェック料金は Base 上で 1 回につき 0.01 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 というツールが 1 つあります（address、任意の chain と since）。任意の環境変数は次のとおりです。

• TOKEN_SAFETY_MAX_USD：チェック 1 回あたりの支出上限。デフォルトは 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 ライセンスです。