Airdrop Claim Tool

WHAT IT DOES

Airdrop Claim Tool gives recipients a simple, secure way to claim tokens from Merkle-based airdrop contracts. It reads live on-chain airdrop state including the Merkle root, claim status per address, token balances, and expiry timestamps. You can check eligibility for any address, verify claim status, and submit claims with Merkle proofs. The tool shows you in real time whether you are eligible, whether you have already claimed, how much you can claim, and when the airdrop expires—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 interact with. The tool will auto-fill your connected wallet address as the recipient. Enter the claim amount (in human-readable units) and your Merkle proof (as a comma-separated list of hex strings) that you received off-chain. Use "Check eligibility" to see the current Merkle root, expiry, contract balance, and whether your address is eligible and has not already claimed. If eligible, click "Claim tokens" to submit your proof and claim your allocation. The transaction will be sent to your wallet for signing. After confirmation, the tool refreshes claim status and shows you a transaction explorer link.

TECHNICAL APPROACH

This tool queries live contract state using ethers v5.7.2, not historical event logs. It calls merkleRoot() and claimed(address) directly on the contract to confirm eligibility status—avoiding the trap of assuming a claim is possible based on events alone. The tool reads the Merkle root as a bytes32 value and compares it against the provided proof during claim submission. It checks the expiry timestamp against the current block time to ensure the airdrop is still active. 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 or guarantee that the submitted Merkle proof will be accepted by the contract. It cannot generate Merkle proofs—proofs must be obtained from the airdrop distributor off-chain. It cannot detect whether the proof was computed correctly or whether it matches your address and allocation. It cannot simulate execution or test whether the proof will pass the contract's verification. It cannot see pending claim operations that are not yet broadcast to the public mempool. The tool facilitates claims, but it does not guarantee that the airdrop contract will accept your proof or that the contract has sufficient token balance to fulfill the claim.

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, claim amount, and proof 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.