Blacklist Function Detector

WHAT IT DOES

Blacklist Function Detector reads live on-chain bytecode from any EVM token contract and uses AI to detect address blocking capabilities, owner-controlled exclusion, and censorship risks. It examines the contract bytecode for blacklist function signatures such as addToBlacklist(), removeFromBlacklist(), isBlacklisted(), addToWhitelist(), removeFromWhitelist(), and isWhitelisted(). It scans for blacklist check patterns in transfer functions that prevent blocked addresses from sending or receiving tokens. It identifies admin access controls that restrict blacklist management to a single owner or privileged role. It detects whitelist exemptions that allow certain addresses to bypass blacklist restrictions. The AI generates a plain-language verdict—SAFE, RISKY, or CRITICAL—along with specific explanations of the blacklist risks before you buy, hold, or transfer the token.

HOW TO USE

Paste any EVM token contract address into the input field. The tool reads the contract's bytecode and scans for known blacklist function signatures using 4-byte method identifiers—addToBlacklist() (0xfa4c9e8d), removeFromBlacklist() (0x6a1a5a3e), isBlacklisted() (0x3b5a0e5d), addToWhitelist() (0x8d6e7a5f), removeFromWhitelist() (0x7a5e3b1d), and isWhitelisted() (0x3d7c5a2f). It also scans for bytecode patterns indicating blacklist checks within transfer logic, owner-only blacklist controls, whitelist-based access control, and blacklist event emissions. The AI receives all this data and returns a verdict: SAFE (no blacklist functions detected), RISKY (blacklist exists with some controls), or CRITICAL (multiple blacklist mechanisms, owner-controlled with no timelock, or absence of removal functionality). The AI also provides a detailed plain-language explanation of the specific censorship and fund freeze risks.

BYTECODE PATTERN ANALYSIS AND SIGNATURE DETECTION

The tool scans the contract's bytecode for known function signatures using 4-byte method identifiers extracted from the first four bytes of calldata. This detects blacklist administration functions even when source code is not verified. It also analyzes the raw bytecode for common blacklist implementation patterns: mapping declarations for blacklisted addresses (often indicated by mapping patterns or SLOAD operations on specific storage slots), blacklist checks in transfer functions that revert or block transfers, admin-only modifiers around blacklist management functions, and event emissions for blacklist changes. It detects whitelist exemptions by scanning for whitelist-related signatures and logic that bypasses blacklist checks. The tool does not require executing a transaction to detect these patterns; it reads the deployed bytecode directly from the chain. If a blacklist function signature is present and appears in a transfer context, it flags the contract as having address blocking capability.

WHAT IT CANNOT SEE

This tool cannot detect off-chain blacklist coordination or centralized off-chain censorship that occurs outside the blockchain. It cannot analyze bytecode that is obfuscated beyond EVM disassembly limits; some contracts use anti-analysis techniques to hide blacklist logic. It cannot verify if blacklist checks are bypassable through alternative transfer methods such as using a proxy or calling transfer functions directly on the underlying implementation. It cannot detect blacklist logic implemented through external contract calls or hooks. It cannot see pending blacklist updates not yet executed on-chain. It cannot determine the intent behind blacklisting beyond on-chain patterns—a blacklist could be for regulatory compliance, security, or malicious fund freezing. It cannot verify if whitelist exemptions are granted legitimately or arbitrarily.

PLEASE NOTE

EVM chains only. This tool reads on-chain data and generates AI explanations—it does NOT sign transactions or execute any on-chain actions. The wallet's own signature prompt remains the final gate for every real action. Always review the exact transaction details in your wallet before approving any token purchase, transfer, or approval. The AI assessment is informational only and does not constitute financial or security advice. Always verify blacklist details independently through block explorers and official project documentation before assuming any token is safe to hold or trade.