A Claude Code skill bundle for bug hunting and external red-team work - 82 skills, 15 slash commands, 681 disclosed-report patterns curated across 24 core vulnerability classes, plus enterprise identity + infrastructure attack matrices.
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 [--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.
# 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
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
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
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
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
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)
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
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
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.