Whitelist Removal Tool

WHAT IT DOES

Whitelist Removal Tool connects to any EVM-based whitelist contract and enables administrators to remove users from the whitelist with a single click. The tool reads comprehensive contract state including user's registration status, whitelist parameters, user address, current block timestamp, removal history, admin privileges, whitelist capacity, and registration window. It then displays the target user's registration status, whitelist capacity, registration window, admin privileges, removal history, and whether the user is currently registered. When you have admin privileges and the target user is registered, the tool enables a one-click removal transaction. The tool handles multiple removal function signatures (removeFromWhitelist, revokeRegistration, executeRemoval) and automatically detects the correct function to call. After submission, the tool displays the transaction hash and refreshes the contract data to show the updated whitelist status. This is ideal for administrators who need to manage whitelist access and revoke registrations.

HOW TO USE

Connect your Web3 wallet (MetaMask, WalletConnect, or any EIP-1193 provider). Select the correct network for your whitelist contract — the tool supports Ethereum, Polygon, Arbitrum, Optimism, Base, Avalanche C-Chain, and BNB Chain. Paste your whitelist contract address into the input field. Enter the user address you want to remove from the whitelist. The tool reads the contract using a default ABI that covers standard whitelist removal functions, but you can paste a custom ABI if your contract uses non-standard naming. Review the displayed data carefully: target user's registration status, whitelist capacity, registration window, admin privileges, removal history, and whether the user is currently registered. The status indicator will show "Active" when the whitelist is open, "Registered" if the user is registered, "Pending" while processing, or "Eligible" when eligible. When you have admin privileges and the target user is registered, the "Remove from whitelist" button becomes enabled. Click it to submit the removal transaction — the tool will show a confirmation dialog with all details, submit the transaction, and wait for confirmation. After successful execution, the contract data refreshes automatically to show the updated whitelist status.

THE REAL MECHANISM

This tool does not assume a single removal interface — it adapts to the contract's actual implementation. It first detects the correct removal function by testing common names (removeFromWhitelist, revokeRegistration, executeRemoval) through static calls, falling back to the user-provided name if none are found. For whitelist data, the tool reads registrationStatus(targetAddress) to determine the user's current state (0=active, 1=registered, 2=pending, 3=eligible), whitelistCapacity() to display the total slots, registrationWindow() to show the open period, adminPrivileges(yourAddress) to verify you are authorized, removalHistory(targetAddress) to show past removals, and isRegistered(targetAddress) to confirm the user is currently registered. This multi-step verification ensures you only attempt to remove a user when you are authorized and the user is registered. The tool auto-refreshes data after each removal to keep the display current. All transaction parameters are estimated using eth_estimateGas and sent with the wallet's preferred gas strategy. The tool monitors the transaction receipt and extracts the effectiveGasPrice to display actual gas cost, not the cap.

WHAT IT CANNOT SEE

Whitelist Removal Tool cannot verify that the removal is justified, fair, or appropriate. It cannot detect if the removal rules have been changed without notice or if the admin privileges are correctly assigned. It cannot guarantee that the removal will be processed correctly or that the contract will update the whitelist accordingly. It cannot ensure that the whitelist contract has not been upgraded, modified, or paused by its owner. It cannot prevent the admin from removing users. It cannot recover funds if the removal transaction fails due to contract bugs, out-of-gas errors, or network conditions. It cannot verify that the user was properly notified of the removal or that the user is aware of the revocation. It cannot detect if the whitelist contract is malicious, contains hidden fee structures, or has been deployed by an untrusted party. It cannot validate that the removal is correctly processed or that the whitelist capacity is accurately updated. It cannot predict the impact of removal on user access or user experience.

PLEASE NOTE — EVM CHAINS ONLY

This tool works exclusively with EVM-compatible blockchains. Non-EVM chains are not supported. The tool does not deploy contracts, manage private keys, or sign anything outside the connected wallet's secure environment. It is a read-and-execute interface that relies entirely on the whitelist contract's implementation and the removal logic defined therein. Always verify the whitelist contract address and admin privileges directly on-chain before removing a user.