Token Launch Anti-Bot Whitelist Setter

WHAT IT DOES

This tool provides on-chain management of anti-bot whitelists for token launches, enabling you to control which addresses can participate in the token sale before bots can front-run the transaction. It reads your connected wallet address, token contract address, whitelist contract address, whitelisted addresses, whitelist status, current block timestamp, max whitelist size, and whitelist enable status. You can then sign and send transactions to add addresses to the whitelist, remove addresses from the whitelist, enable or disable the whitelist, and batch update whitelist entries in a single transaction. All whitelist parameters are displayed in a clear review panel before you sign, so you know exactly what you are updating. The tool also logs transaction hashes, confirmation status, and gas costs, providing a complete audit trail of all whitelist activities.

HOW TO USE

Connect your wallet using the built-in wallet bridge, choose the network that matches your token and whitelist contracts, and paste the token contract address and whitelist contract address. Enter the addresses you want to add or remove as a comma-separated list. The review panel shows all inputs, the current whitelist status, and the current sender contract fee before you sign. Use the numbered action buttons: add addresses to include new addresses in the whitelist, remove addresses to exclude them, enable whitelist to activate the whitelist restriction, or disable whitelist to turn off the restriction. You can also check status to view current whitelist state, count, and owner. Each transaction is signed sequentially, and the tool displays transaction details and confirmation status.

THE REAL MECHANISM

This tool uses ethers.js v5.7.2 to build and send transactions through the wallet's signer. It does not rely on any hardcoded contract addresses – you paste the whitelist contract you are using, so you are in full control. The tool reads the live fee from the shared sender contract before every transaction, ensuring that the fee is always current and not hardcoded. When you add or remove addresses, the tool constructs contract calls to the addAddresses or removeAddresses functions, which batch update the whitelist state. When you enable or disable the whitelist, the tool calls enableWhitelist or disableWhitelist, which toggles the whitelist restriction on the token contract. The tool reads whitelist state via whitelistEnabled, whitelistCount, and owner view functions. All transactions are sequential to prevent nonce conflicts, and gas costs are calculated using effectiveGasPrice for accurate post-EIP-1559 reporting.

WHAT IT CANNOT SEE

This tool cannot verify off-chain address legitimacy, detect bot activity, prevent all bot attacks, or ensure that the whitelist contract handles updates correctly. It cannot detect if the addresses being added are legitimate or if they belong to bots. The tool also cannot verify that the whitelist contract correctly handles edge cases like duplicate addresses, maximum size limits, or permission checks. It cannot simulate the outcome of a transaction before you sign it, nor can it guarantee that the whitelist update will be processed correctly if the contract is not properly implemented.

PLEASE NOTE

This tool works only on EVM-compatible chains supported by your wallet and provider. Always double-check the contract addresses and parameters before signing. Use testnet first. The tool is a transaction-signing interface and whitelist management tool, not a bot detection or address verification system.