Raffle Refund Claimer

WHAT IT DOES

Raffle Refund Claimer is a non-custodial tool that claims refunds for raffle ticket purchases when a raffle is cancelled or fails to meet participation requirements. It reads raffle refund contract state, user address, token balances, refund parameters, raffle ID, refund amount, refund eligibility, refund deadline, claim status, user's purchase history, prize pool state, refund distribution state, and settlement state to structure the optimal refund claim operation. With a single transaction, it calls claimRefund(), executeRaffleRefund(), or submitRefundClaim() on the target contract, recovering the funds spent on ticket purchases. The tool handles both native currency and ERC-20 token refunds, ensuring users can reclaim their funds when a raffle does not proceed as expected.

HOW TO USE

1. Connect your wallet (EVM-compatible).

2. Paste the raffle refund contract address.

3. Enter the raffle ID and optionally specify a token address.

4. Review the refund eligibility, refund amount, claim status, refund deadline, and settlement state.

5. Click "claim refund" and confirm the transaction in your wallet.

The tool checks refund eligibility and claim status before execution to prevent failed transactions. After the transaction confirms, your refund is claimed on-chain—no centralized custody, no intermediaries. Your ticket purchase funds are returned to your wallet.

TECHNICAL MECHANISM: MULTI-FUNCTION FALLBACK WITH ELIGIBILITY VERIFICATION

Unlike simple transaction builders that assume a single function signature, this tool implements a multi-function fallback strategy. It first attempts claimRefund(), then falls back to executeRaffleRefund() or submitRefundClaim() if the primary method fails—automatically adapting to different contract implementations without requiring the user to know the exact function name. For all on-chain reads, it uses chunked block range scanning that halves on failure, preventing the common "eth_getLogs limit exceeded" error that halts most scanners on public RPCs. It double-verifies refund eligibility by checking both the current refund status and claim deadline from storage, rather than relying on historical events—because an event log proves tickets were purchased, not that a refund can currently be claimed. Gas estimation uses receipt.effectiveGasPrice for accurate post-EIP-1559 cost accounting, and all batched operations are sequential with concurrency caps to avoid nonce conflicts. The tool also validates that the user has an eligible refund claim and that the claim deadline has not passed before execution.

WHAT IT CANNOT SEE

This tool cannot verify that the raffle contract is legitimate or has not been compromised. It cannot detect if the raffle has been manipulated. It cannot ensure that refund will execute at the optimal gas price due to network conditions. It cannot guarantee that refund will succeed if the contract is paused or frozen. It cannot verify that the contract has not been upgraded or modified. It cannot detect if the trade path is optimal or not front-run. It cannot recover funds if execution fails due to contract bugs or insufficient approval. It cannot verify that the refund amount is correct or not. It cannot predict market movements, price gaps, or flash crashes. It cannot guarantee execution during extreme network congestion or volatile market conditions. It cannot detect if the underlying system has been compromised. It cannot prevent the user from canceling or modifying refund parameters. It cannot ensure that the refund will be processed. It cannot protect against loss if refund is rejected. It cannot verify that the user is eligible for a refund. It cannot guarantee that the refund will be issued. It cannot ensure that the refund amount will match expectations. It cannot verify that the claim deadline has not passed.

PLEASE NOTE

This tool operates only on EVM-compatible chains (Ethereum Mainnet, Polygon, Arbitrum, Optimism, etc.). It is non-custodial—you retain full control of your funds at all times. Always verify contract addresses, raffle IDs, and refund parameters before executing. Refund claims are subject to claim deadlines—claims must be made within the refund window. The tool is provided as-is; use at your own risk.