Presale Whitelist Distributor

WHAT IT DOES

Presale Whitelist Distributor connects to any EVM-based presale whitelist contract and enables you to distribute whitelist allocations with a single click. The tool reads comprehensive contract state including whitelist entries, allocation amounts per address, presale parameters, token address, user address, current block timestamp, distribution status, claim window, and allocation history. It then displays a list of all whitelist entries with their addresses and allocation amounts, shows the token type, claim window, and distribution status, and enables a one-click distribution transaction. The tool handles multiple distribution function signatures (distributeWhitelist, allocatePresaleSlots, executeDistribution) 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 distribution status. This is ideal for presale organizers who need to assign and manage whitelist allocations efficiently.

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. The tool reads the contract using a default ABI that covers standard whitelist distribution functions, but you can paste a custom ABI if your contract uses non-standard naming. The tool displays a list of all whitelist entries with their addresses and allocation amounts. Review the displayed data carefully: token address, number of whitelist entries, claim window, distribution status, and the complete whitelist list. The status indicator will show "Active" when the distribution is open, "Distributed" after successful distribution, "Pending" while processing, or "Ready" when you are eligible to distribute. When whitelist entries are present and the distribution is ready, the "Distribute" button becomes enabled. Click it to submit the distribution 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 distribution status.

THE REAL MECHANISM

This tool does not assume a single distribution interface — it adapts to the contract's actual implementation. It first detects the correct distribution function by testing common names (distributeWhitelist, allocatePresaleSlots, executeDistribution) through static calls, falling back to the user-provided name if none are found. For whitelist data, the tool reads entryCount() to determine how many entries are registered, then iterates through each one using the whitelistEntries(index) view function to get the address and allocation amount for each entry. The tool also reads token() to identify the token being distributed, claimWindow() to show the claim period, and distributionStatus() to determine the current state (0=active, 1=distributed, 2=pending, 3=ready). When you execute the distribution, the tool calls the contract's distribution function, which processes all whitelist entries and assigns the allocations. 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

Presale Whitelist Distributor cannot verify that the whitelist entries are fair or accurately reflect the intended distribution. It cannot detect if the allocation amounts have been changed without notice or if the whitelist has been tampered with. It cannot guarantee that the whitelist will be honored by the presale or that the presale will proceed as expected. It cannot ensure that the distribution contract has not been upgraded, modified, or paused by its owner. It cannot prevent the admin from modifying allocations or removing entries. It cannot recover funds if the distribution transaction fails due to contract bugs, out-of-gas errors, or network conditions. It cannot verify that the recipients are valid, authorized, or controlled by the intended parties. It cannot detect if the distribution contract is malicious, contains hidden fee structures, or has been deployed by an untrusted party. It cannot validate that the allocation calculation is correct or that the claim window is accurately represented. It cannot predict the success of the presale or the number of claims that will be made.

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 distribution logic defined therein. Always verify the whitelist contract address and entry list directly on-chain before distributing.