Token Airdrop Manager

WHAT IT DOES

Token Airdrop Manager gives project teams and developers full control over Merkle-based token airdrop contracts. It reads live on-chain airdrop state including the current Merkle root, claim status per address, total claimed amounts, token balances, expiry timestamps, and deployed airdrop contract addresses. You can set the Merkle root, manage claim windows, process claims (with proof verification), set expiry times, and withdraw remaining tokens after the airdrop concludes. The tool shows you in real time whether a recipient has claimed, what the total claimed is, and how much remains in the contract—so you never have to guess or rely on event logs that only prove past claims happened.

HOW TO USE

Connect your EVM wallet. Enter the airdrop contract address and token address you want to manage. Provide the Merkle root (hex string) that represents the list of eligible recipients and their allocations. Optionally set a recipient address and claim amount to check eligibility or process a claim. Use "Check airdrop" to see the current Merkle root, expiry, total claimed, contract balance, and claim status for any recipient. Click "Set Merkle root" to update the root for the airdrop. Recipients can call "Claim tokens" with their Merkle proof to receive their allocation. Use "Set expiry" to define when the airdrop ends, and "Withdraw remaining" to recover unclaimed tokens after the expiry passes. Each action generates a transaction you review and sign in your wallet.

TECHNICAL APPROACH

This tool queries live contract state using ethers v5.7.2, not historical event logs. It calls merkleRoot(), claimed(address), totalClaimed(), expiry(), and token() directly on the contract to confirm current status—avoiding the trap of assuming a claim happened based on events alone. The tool reads the Merkle root as a bytes32 value and displays it for verification. It checks claim status by calling claimed(recipient) on the contract, which returns a boolean indicating whether the address has already claimed. For balance tracking, it calls balanceOf() on the token contract using the airdrop contract's address. 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 transaction reverts. For transaction costing, it uses receipt.effectiveGasPrice post-EIP-1559 rather than tx.gasPrice, which overstates actual spend. The tool also converts token amounts using the token's decimals() call for human-readable display.

WHAT IT CANNOT SEE

This tool cannot verify off-chain eligibility, Merkle proof correctness, or guarantee that recipients will claim their allocation before expiry. It cannot generate Merkle proofs on-chain—proofs must be generated off-chain and provided by the user. It cannot detect whether the Merkle root was computed correctly or whether the proof matches the recipient's allocation. It cannot simulate execution or test whether the expiry has passed before allowing claims. It cannot see pending claim operations that are not yet broadcast to the public mempool, nor can it detect contract-specific airdrop rules beyond the standard Merkle airdrop interface. The tool manages airdrop configuration and claims, but it does not guarantee that the Merkle root or proofs are valid.

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. This is a read‑write tool that requires signing transactions—always verify the airdrop contract address, token address, Merkle root, and expiry before approving. No contract addresses are hardcoded; you paste the contract you are using, so you are responsible for verifying its safety and ensuring it implements the expected Merkle airdrop interface. The tool is free and open under the BotGentz PLAYBOOK‑C specification.