Token Sale Refund Claim Tool

WHAT IT DOES

Token Sale Refund Claim Tool is a specialized DeFi tool that reads live on-chain state from token sale and refund contracts to enable participants to claim their refunds or allocated tokens after a sale concludes. It monitors the sale outcome, soft cap and hard cap status, total raised amounts, and refund period states. The tool fetches the user's contribution amount, allocated tokens, refund amount, and eligibility status. It tracks whether the user has already claimed their refund or tokens to prevent duplicate claims. The tool also reads vesting schedules, claim schedules, timelock states, and merkle root requirements for proof-based claims. It supports three primary actions: claiming a refund if the sale did not meet its soft cap, claiming tokens if the sale succeeded, or claiming both in a single batch transaction. The tool works with both native currency and ERC-20 refund tokens, and handles complex scenarios including refund multipliers, penalty conditions, whitelist requirements, and treasury withdrawal states.

HOW TO USE

Connect your wallet using the Connect button. Select your network from the dropdown—Ethereum, Polygon, Optimism, Arbitrum, or Base. Paste the token sale or refund contract address, the token contract address being distributed, and optionally the refund token address if it differs from the payment token. Click "Refresh State" to load all sale parameters and your personal claim information. Review the sale status, refund period, soft cap and hard cap targets, total raised, and your contribution, allocation, and refund amounts. Check your eligibility status, whether you have already claimed, and any vesting or timelock restrictions. If the sale failed to meet its soft cap and you are eligible, click "Claim Refund" to receive your contribution back. If the sale succeeded and you are allocated tokens, click "Claim Tokens" to receive your tokens according to the vesting schedule. If you are eligible for both, click "Claim Both" to execute a single combined transaction.

ELIGIBILITY AND CLAIM STATE VERIFICATION ENGINE

The tool performs a comprehensive multi-pass state verification before enabling any claim action. It reads the sale status and determines whether the sale succeeded (soft cap met) or failed (soft cap not met). For refund claims, it verifies that the refund period is active, that the user's refund amount is greater than zero, that the user has not already claimed, and that the user is flagged as eligible by the contract. For token claims, it verifies that the sale succeeded, that the user's allocation is greater than zero, that the user has not already claimed tokens, and that any timelock or vesting conditions are satisfied. The tool also checks if the refund multiplier or penalty conditions apply, adjusting the displayed amounts accordingly. For merkle proof-based claims, the tool calculates the user's leaf node from their address and allocation, verifies the proof against the stored merkle root, and displays the proof status. The tool also checks the treasury state and withdrawal status to ensure the contract has sufficient balance to process the claim. All state reads are performed using the current block state with a single multi-call pattern to minimize RPC requests and ensure consistent data.

WHAT IT CANNOT SEE

This tool cannot verify that the sale contract has not been exploited, manipulated, or compromised. It cannot detect if the refund terms, multipliers, or penalty conditions have been altered off-chain or through malicious governance. It cannot guarantee that the refund transaction will succeed if the contract has insufficient balance or has been paused. It cannot verify that the token being refunded has value, liquidity, or is not a scam. It cannot recover funds if the contract is malicious, has bugs, or has been upgraded with modified logic. It cannot provide financial, investment, or tax advice. It cannot ensure that claimed tokens will be transferable or have market value. It cannot verify off-chain sale terms, legal compliance, or KYC requirements. It cannot detect if the user is eligible for refund beyond what the on-chain state indicates. It cannot predict gas costs for claim transactions. It cannot verify off-chain vesting schedules or employment agreements.

PLEASE NOTE

This tool supports EVM-compatible chains only. It requires an active RPC connection and a wallet with signing capabilities. Always verify sale terms and contract addresses before claiming. The tool does not custodial funds or private keys. Ensure you have sufficient balance for gas fees. If a merkle proof is required, you must provide it separately; the tool does not generate proofs. Claim deadlines may apply—ensure you claim within the specified period.