Initial DEX Offering Refund Claim Tool

WHAT IT DOES

Initial DEX Offering Refund Claim Tool enables users to claim refunds from IDOs that failed to meet their funding goals, were cancelled, or where users are eligible for partial refunds. The tool reads your connected wallet address, the IDO contract address, your contribution amount, refund eligibility, refund amount, claim status, current block timestamp, claim deadline, and optional Merkle proof data. It checks your eligibility for the refund, displays the refund amount and deadline, and submits the claim transaction—including Merkle proof if required. This ensures you can recover your funds from failed or cancelled IDOs quickly and securely.

HOW TO USE

Connect your wallet and select your network. Enter the IDO contract address and the refund token address (the token you originally contributed). If the refund requires a Merkle proof, enter the proof as a comma-separated list of hex strings. Click "Check refund eligibility" to verify whether you are eligible for a refund, your contribution amount, the refund amount, claim status, and the claim deadline. If you are eligible and the claim is still open, click "Claim refund" to submit the claim transaction. The tool will handle the Merkle proof if provided and confirm the claim on-chain. Your refunded tokens will be sent to your wallet.

THE REAL MECHANISM — ELIGIBILITY VERIFICATION WITH MERKLE PROOF AND DEADLINE ENFORCEMENT

Unlike simple refunds that only check a boolean flag, this tool implements a comprehensive refund verification system. The tool first calls getRefundInfo, which returns the user's contribution amount, refund amount, and claim deadline as a struct. It then checks eligibility via canClaimRefund, which verifies that the user is eligible and that the deadline has not passed. The isRefundClaimed function prevents double-claims. For Merkle-based refunds, the claim function accepts a proof array of bytes32 values, which the contract verifies against a Merkle root stored on-chain—this allows gas-efficient distribution of refunds to large numbers of users without storing individual claim records. The tool reads the refund token via getRefundToken to display the token being refunded. The claim transaction submits the refund amount and proof to the contract, which validates the proof and transfers the refund amount to the caller. All arithmetic uses ethers.js BigNumber with the token's decimal precision, and gas costs are reported using receipt.effectiveGasPrice. The tool also checks the claim deadline before allowing the claim to proceed.

WHAT IT CANNOT SEE

Cannot verify off-chain IDO legitimacy—the tool has no visibility into the project's team, roadmap, or whether the IDO was legitimate. It cannot ensure refund calculation accuracy—the tool relies on the contract's refund calculation and cannot audit the formula. It cannot predict future token price performance—the tool cannot forecast whether refunding or holding tokens would be more beneficial. It cannot detect if the IDO contract contains vulnerabilities or malicious code—the tool does not audit the IDO logic. It cannot recover funds if the claim fails or if the refund has already been claimed.

PLEASE NOTE — EVM CHAINS ONLY

This tool exclusively supports EVM-compatible chains where ethers.js can connect via standard JSON-RPC. It does not support non-EVM chains such as Solana, Tron, Starknet, SUI, TON, Aptos, Bitcoin, Cosmos, or XRP. The IDO contract must implement the specific interface expected by this tool (claimRefund, canClaimRefund, isRefundClaimed, getRefundInfo, getRefundToken). Always test with small amounts on a testnet before claiming on mainnet. This tool is a refund claim interface, not a financial advisor or investment consultant.