Airdrop Recipient List Deduplicator

WHAT IT DOES

This tool processes and deduplicates lists of wallet addresses for airdrop distributions. You paste a list of recipient addresses—one per line or comma-separated—and the tool identifies and removes duplicate addresses based on exact equality (case-insensitive), flags invalid addresses, and optionally resolves ENS names (.eth domains) to their corresponding wallet addresses. It provides statistics on the original count, unique addresses, duplicates removed, invalid addresses flagged, and ENS names resolved. The output can be exported as CSV or JSON, or copied directly to your clipboard for use in distribution contracts or batch send tools.

HOW TO USE

Connect your EVM wallet to enable ENS resolution (optional, but recommended if your list contains .eth names). Paste your recipient list into the text area—addresses can be separated by newlines or commas. Check "Validate addresses" to enable checksum validation and format checking; uncheck to accept raw addresses without validation. Check "Resolve ENS" to automatically convert .eth domains to their resolved addresses. Click "Deduplicate" to process the list. The tool displays the unique addresses with a visual indicator, shows removed duplicates and invalid addresses, and provides statistics. Use the export buttons to save the deduplicated list as CSV or JSON, or copy it directly to your clipboard. Invalid addresses are flagged and excluded from the final list.

TECHNICAL MECHANISM

The tool is entirely off-chain and processes the list in memory using JavaScript. It first splits the input by newlines and commas, then trims each entry. If ENS resolution is enabled and the wallet is connected, it uses the ethers.js provider's resolveName() method to convert .eth domains to addresses via the ENS registry (requires a network connection). For validation, it uses ethers.js's isAddress() and getAddress() methods to verify address format and convert to checksummed addresses. The deduplication uses a JavaScript Set with lowercase keys to ensure case-insensitive matching (0xAb... and 0xab... are treated as identical). The tool counts duplicates by tracking which addresses have been seen, and collects invalid addresses separately. All processing respects the sandboxed frame environment—no data is sent to any server. The tool follows PLAYBOOK-C §7 by clearly stating its limits and not implying sybil detection beyond exact matches.

WHAT IT CANNOT SEE

This tool cannot verify off-chain identity or prove that two addresses belong to different individuals—it only matches exact addresses. It cannot detect sybil attacks or address farming beyond exact address matches; if a user submits multiple addresses that all belong to the same person, the tool will treat them as distinct unless the addresses are identical. It cannot validate that addresses are active, funded, or capable of receiving tokens without performing on-chain checks. It cannot merge or deduplicate based on any criteria other than exact address equality (case-insensitive). It cannot prevent a user from submitting multiple addresses that belong to the same person. It cannot detect if addresses are contract addresses, exchanges, or multisigs that may not support the token being distributed. It also cannot resolve ENS names without an active provider connection.

PLEASE NOTE

EVM chains only. This tool is read-only and does not submit on-chain transactions. It is designed for airdrop organizers preparing recipient lists before distribution. ENS resolution requires a connection to the Ethereum mainnet or a network that supports ENS. The tool does not store any data; all processing is performed in-memory during the session. For large lists (thousands of addresses), performance remains fast due to the efficient Set-based deduplication. Invalid addresses are excluded from the final list, so review the invalid count to ensure no legitimate addresses were accidentally flagged due to formatting issues.