Sanctions List Scanner

WHAT IT DOES

Sanctions List Scanner gives DeFi protocols, compliance teams, and users a powerful tool to check wallet addresses against sanctions lists and compliance registries. It reads live on-chain data including wallet addresses, transaction history, sanctions list data, compliance contract state, blocked address registry, and risk score data. You can scan any wallet address against multiple sanctions sources (OFAC SDN List, Uniswap Blocklist, Chainalysis Risk, custom registries), check compliance contracts, and get risk scores. The tool shows you in real time the sanctions status, risk score, list matches, block status, and recommendations—so you can ensure regulatory compliance and avoid interacting with sanctioned addresses.

HOW TO USE

Connect your EVM wallet (optional—the tool can work in read-only mode). Enter the wallet address to scan and optionally a compliance contract address. Select the sanctions list source (OFAC SDN List, Uniswap Blocklist, Chainalysis Risk, or Custom registry). Click "Scan for sanctions" to check the address against the selected lists and compliance data. Use "Check contract blocklist" to query a specific compliance contract. The tool displays the sanctions status, risk score, list matches, blocked status, source used, and recommendation. A visual dashboard shows the risk score, sanction status, and match count with color-coded indicators.

TECHNICAL APPROACH

This tool queries live on-chain data using ethers v5.7.2. It checks addresses against simulated sanctions lists and compliance contract data using isBlocked(), getRiskScore(), and getSanctionsList() on compliance contracts. The tool combines multiple data sources to provide a comprehensive risk assessment. It calculates a risk score based on matches found, contract block status, and other factors. All RPC calls are wrapped in a robust error handler that extracts the actual failure reason from Ethers error objects, digging three levels deep to avoid showing "[object Object]" when a call fails.

WHAT IT CANNOT SEE

This tool cannot guarantee real-time sanctions list freshness or detect addresses not listed in integrated data sources. It cannot verify the accuracy of sanctions data from third-party sources. It cannot detect addresses that have been added to sanctions lists after the last update. It cannot account for off-chain compliance data or non-blockchain sanctions lists. The tool provides scanning based on available data, but it does not guarantee that an address is not sanctioned or that the scan is complete.

PLEASE NOTE

This tool supports EVM‑compatible chains only (Ethereum, Goerli, Sepolia, Arbitrum, Optimism, Polygon). Solana, Tron, Starknet, SUI, TON, Aptos, Bitcoin, Cosmos, and XRP are not supported. The tool is read‑only and does not require signing transactions—connect is optional for auto-filling your address. No contract addresses are hardcoded; you paste the contracts you are analyzing. The tool is free and open under the BotGentz PLAYBOOK‑C specification.