Vested Airdrop Claim Tool

WHAT IT DOES

This tool enables you to claim vested tokens from airdrop distributor contracts that implement vesting schedules. You provide the vesting contract address and optionally a beneficiary address, and the tool reads your vesting details—total vested amount, already claimed amount, currently claimable amount, cliff date, and vesting end date. It then executes a claim transaction to transfer all currently claimable and unclaimed tokens to your wallet. The tool supports multiple claim function signatures including claim(), claim(uint256 amount), and claim(address beneficiary, uint256 amount), accommodating various vesting distributor implementations.

HOW TO USE

Connect your EVM wallet to the network where the vesting contract is deployed. Enter the vesting distributor contract address. Optionally specify a beneficiary address if you are claiming on behalf of someone else (leave blank to use your connected wallet). Select the token decimals (default 18) and choose the claim function signature that matches your contract. The tool will automatically load your vesting details: total vested, claimed, claimable now, cliff date, and vesting end date. Review the displayed information. If claimable amount is greater than zero, click "Claim Vested Tokens" to submit the claim transaction. The tool will claim the full claimable amount and display the transaction result with gas cost.

TECHNICAL MECHANISM

The tool uses ethers.js to interact with the vesting contract via the connected provider. It dynamically probes for common vesting view functions including totalVested(address), claimed(address), claimable(address), cliff(), end(), and vestingEnd() to gather comprehensive vesting data. The claimable amount is computed by the contract itself using the elapsed time since the cliff and the vesting period, ensuring accuracy without requiring off-chain calculations. For claiming, the tool encodes the appropriate function call based on the selected signature: claim() for simple claims, claim(uint256) with the claimable amount, or claim(address,uint256) for multi-beneficiary contracts. The tool uses the signer's gas estimation and reports effectiveGasPrice from the receipt for accurate cost reporting (PLAYBOOK-C §5 rule 5). All transactions are submitted sequentially and waited for confirmation.

WHAT IT CANNOT SEE

This tool cannot predict future vesting amounts or account for off-chain vesting conditions not encoded in the contract—it only reads on-chain state. It cannot verify that the user is the intended beneficiary beyond the contract's own verification; if the contract checks a Merkle root or signature, the tool cannot bypass that. It cannot detect if the user has already claimed through other means beyond the contract's claimed mapping—if a claim was made via a different interface, the tool will reflect that in the claimed amount. It cannot recover from a failed claim due to insufficient gas or network issues—you must retry manually. It cannot claim on behalf of others without their private key or signature, even when using the claim(address) function, because the transaction must be signed by the caller. It cannot accelerate vesting schedules or modify cliff/period parameters—these are fixed by the contract deployment.

PLEASE NOTE

EVM chains only. This tool works with any EVM-compatible network that supports standard vesting distributor patterns. Only execute claims if you are the intended beneficiary or authorized to claim on behalf of the beneficiary. Ensure you have sufficient native currency for gas fees. The tool claims the full claimable amount—if you want to claim a partial amount, use the claimWithAmount option or modify the contract call manually. Always test on testnet first with small amounts. The tool does not store any data; all state is read fresh from the blockchain. Gas costs vary by network and contract complexity. For contracts with custom vesting logic not covered by the standard view functions, the tool may not display all details correctly, but the claim function should still work if the signature matches.