token-scan — команда для Claude Code: аудит токена на rug pull
Слэш-команда token-scan для Claude, которая ищет векторы rug pull в контрактах токенов и мемкоинов на Solidity и Solana. Пригодится перед покупкой чужого токена или проверкой своего.
MIT ★ 16 193 обновлён 2026-10-29
/plugin marketplace add elementalsouls/Claude-BugHunter
/plugin install claude-bughunter@elementalsoulsЧто делает token-scan
Команда принимает путь к контракту или каталогу и прогоняет восемь классов проверок на rug pull: скрытый минт, honeypot, подкрутка комиссий, вывод ликвидности, bonding curve, сохранённые authorities, фальшивый renounceOwnership, усиление сэндвича. Работает с EVM на Solidity и с Solana на Rust/Anchor — для второй нужен флаг --chain solana.
Внутри набор grep-запросов по исходникам: mint_authority, blacklist, setSellFee без верхней границы, emergencyWithdraw, virtualReserve. Опциональный token_scanner.py на PATH даёт быстрый риск-скор, но без него команда не ломается: ручной аудит покрывает все восемь классов. Перед кодом идут пять вопросов вне контракта. Верифицирован ли исходник, есть ли у деплоера история rug pull, торгуется ли токен больше часа, больше ли $5K в пуле, не прокси ли с оставленным админом. Если хотя бы на один ответ «нет», доверять коду рано.
На выходе — оценка 0–100, вердикт от CLEAN до CRITICAL RISK и находки с file:line. Если за пять минут по всем классам ничего не нашлось, команда советует остановиться, а не искать фантомные баги.
Какие задачи решает
- Найти скрытый минт и
delegatecallв незнакомом контракте - Проверить Solana-программу на сохранённые
mint_authorityиfreeze_authority - Отличить поддельный
renounceOwnershipот настоящего отказа от прав - Собрать отчёт с
file:lineи оценкой риска по чужому токену - Понять до покупки, не honeypot ли это
Примеры запросов агенту
- Прогони
/token-scan contracts/Token.solи покажи находки с номерами строк. - Проверь Solana-программу:
/token-scan programs/token/ --chain solana --recursive, меня интересуютmint_authorityиfreeze_authority. - Сделай
/token-scan src/ --recursive --output findings/report.mdи сохрани отчёт в файл.
Как установить token-scan
1Через маркетплейс плагинов
/plugin marketplace add elementalsouls/Claude-BugHunter/plugin install claude-bughunter@elementalsouls2Вручную: положить файлы
.claude/commands/token-scan.mdВызов — /token-scan. Для всех проектов — ~/.claude/commands/
Вручную: положить файлы
~/.codex/prompts/token-scan.mdВызов — /prompts:token-scan. В Codex этот формат помечен устаревшим, замена — скиллы
Вручную: положить файлы
.github/prompts/token-scan.prompt.mdВручную: положить файлы
.gemini/commands/token-scan.tomlGemini хранит команды в TOML: текст запроса — в поле prompt
Вопросы о token-scan
Как установить token-scan в Claude Code?
Сначала добавьте маркетплейс: /plugin marketplace add elementalsouls/Claude-BugHunter. Потом поставьте плагин: /plugin install claude-bughunter@elementalsouls. После этого команда доступна как /token-scan.
Что делает token-scan?
Прогоняет восемь классов проверок на rug pull по исходникам контракта и отдаёт оценку риска 0–100, вердикт и находки с номерами строк. Поддерживает Solidity на EVM и Solana на Rust/Anchor.
Нужен ли token_scanner.py, чтобы команда работала?
Это опциональный ускоритель. Если скрипта нет на PATH, команда переходит к ручному grep-аудиту, который покрывает все восемь классов.
Исходный текст
token-scan.md · MIT
--- name: token-scan description: Meme coin and token security scan — checks for rug pull vectors (hidden mint, honeypot, fee manipulation, LP lock bypass, authority retention, bonding curve exploits, fake renounce, sandwich amplification). Manual 8-class grep audit (with an optional automated scanner if present). Usage: /token-scan <contract_path_or_dir> [--chain solana] --- # /token-scan Fast rug pull detection for meme coins and token contracts. Covers EVM (Solidity) and Solana (Rust/Anchor). ## Usage ``` /token-scan contracts/Token.sol # Single EVM contract /token-scan src/ --recursive # Scan entire directory /token-scan programs/token/ --chain solana --recursive # Solana program /token-scan contracts/Token.sol --output findings/report.md # Save report ``` ## Step 0: Quick Kill Signals Before scanning code, check: ``` [ ] Contract is verified (source code available)? [ ] Deployer has no rug history? [ ] Token has been trading > 1 hour? [ ] Liquidity > $5K? [ ] Not a proxy with retained admin? ``` If ANY answer is NO → flag and proceed with extreme caution. ## Step 1: Optional Automated Scanner > **Optional accelerator — not bundled by default.** If you have a local > `token_scanner.py` (or any rug-vector scanner) on PATH, run it first for a quick > risk score. If you don't, **skip straight to Step 2** — the manual 8-class grep > audit below is the real, self-contained check and needs no extra tooling. ```bash # If present: python3 tools/token_scanner.py <contract_path> # EVM python3 tools/token_scanner.py <program_dir> --chain solana --recursive # Solana ``` The manual audit (Steps 2-9) covers all 8 bug classes via grep and is sufficient on its own. ## Step 2: Hidden Mint Check ```bash grep -rn "function mint\|_mint(\|_balances\[.*\] +=" src/ --include="*.sol" | grep -v "test\|lib" grep -rn "delegatecall" src/ --include="*.sol" # Solana: grep -rn "MintTo\|mint_to\|mint_authority" src/ --include="*.rs" ``` Look for: mint without MAX_SUPPLY cap, direct balance manipulation, delegatecall to unknown targets. ## Step 3: Honeypot Check ```bash grep -rn "blacklist\|isBlacklisted\|_bots\|maxTxAmount\|approve.*override" src/ --include="*.sol" # Solana: grep -rn "freeze_authority\|transfer_hook\|permanent_delegate" src/ --include="*.rs" ``` Look for: blacklist mappings, max tx setters without minimum bound, approve overrides that don't call super. ## Step 4: Fee Manipulation Check ```bash grep -rn "setFee\|setSellFee\|_taxFee\|_sellFee" src/ --include="*.sol" grep -rn "function set.*Fee" -A5 src/ --include="*.sol" | grep -v "require\|MAX" ``` Look for: fee setters without upper bound, fee exclusion for owner. ## Step 5: LP Drain Check ```bash grep -rn "migrateLP\|emergencyWithdraw\|\.sync()\|setPair\|setRouter" src/ --include="*.sol" grep -rn "addLiquidityETH" -A5 src/ --include="*.sol" | grep "owner\|msg.sender" ``` Look for: LP migration functions, emergency withdraw, auto-LP to owner wallet. ## Step 6: Bonding Curve Check ```bash grep -rn "virtualReserve\|setCurve\|graduate\|bonding_curve" src/ --include="*.sol" --include="*.rs" ``` Look for: mutable curve parameters, manipulable graduation threshold. ## Step 7: Authority Check (Solana) ```bash grep -rn "mint_authority\|freeze_authority\|update_authority\|close_authority" src/ --include="*.rs" grep -rn "set_authority.*None" src/ --include="*.rs" grep -rn "upgrade_authority" src/ --include="*.rs" ``` Look for: retained authorities that should be None, upgradeable programs. ## Step 8: Fake Renounce Check ```bash grep -rn "renounceOwnership.*override" src/ --include="*.sol" grep -rn "_shadowAdmin\|_backupOwner" src/ --include="*.sol" ``` Look for: overridden renounce without actual transfer, secondary admin roles. ## Step 9: Sandwich Amplification Check ```bash grep -rn "swapExactTokensForETH" -A5 src/ --include="*.sol" | grep "0," grep -rn "swapThreshold\|_rebase\|reflect()" src/ --include="*.sol" ``` Look for: auto-swap with amountOutMin=0, rebase on every transfer. ## Output Summarize the audit (whether driven by the manual steps or the optional scanner) as: - **Risk score** (0-100) based on finding severity - **Verdict** (CLEAN / LOW RISK / MEDIUM RISK / HIGH RISK / CRITICAL RISK) - **Individual findings** with file:line, code snippet, and recommendation ## What to Do Next - If CRITICAL findings → **DO NOT INTERACT**. Report if on Immunefi/Code4rena. - If HIGH findings → Manual deep review. May be intentional design. Check deployer history. - If MEDIUM findings → Flag for awareness. Likely not rug but worth monitoring. - If CLEAN → Token passes automated checks. Still verify on-chain state manually. ## 5-Minute Rule If you've been scanning for 5 minutes and found no red flags across all 8 classes + automated scan → the token is likely clean. Move on. Don't hunt for phantom bugs.
© Sachin Sharma · MIT · elementalsouls/Claude-BugHunter