Bridge Fee Refund Claimer

WHAT IT DOES

Bridge Fee Refund Claimer is a developer tool that lets you claim refunds of unused prepaid bridge fees. When you prepay bridge fees for future cross-chain transactions, any unused balance may be refundable if you stop using the bridge or if the bridge contract supports refunds. This tool reads your prepaid fee balance, refund eligibility, and refund history from the bridge contract, then allows you to claim your refunds in a single batched transaction. It provides a preview of your refundable balance, already claimed amounts, and refund status before you execute, enabling efficient and secure fee recovery.

HOW TO USE

Connect your EVM wallet via the BGWallet bridge. Enter the bridge contract address. Optionally, enter a specific refund ID to check a single refund — leave blank to check all pending refunds. Set your preferred batch size (how many refund claims to include per transaction). Click "Check Refunds" to scan for your refundable balances. The tool will display the refund amounts and status (Ready, Claimed, or Pending) for each refund. Review the list carefully — only refunds with "Ready" status are available to claim. Click "Claim Refunds" to sign and broadcast the transaction. The tool will claim refunds in batches according to your batch size setting, providing progress updates for each batch.

TECHNICAL MECHANISM

The tool interfaces with the bridge contract using view functions like `refundableBalance(address)` or `pendingRefunds(address)` to read your eligible refund amounts. It checks refund eligibility by verifying that the prepaid balance is unused and that the refund window has not expired. When executing refund claims, the tool uses a multicall or batched call pattern to aggregate multiple `claimRefund` calls into one transaction. The batch size parameter controls how many refunds are grouped per transaction to avoid gas limit issues. The tool also checks whether you have already claimed each refund — if you have, it marks them as "Claimed" and skips them. The entire refund process is atomic — if any individual claim fails, the transaction reverts. The tool estimates gas using `estimateGas` and displays the estimated cost before execution.

WHAT IT CANNOT SEE

This tool cannot guarantee that the refund will be processed if the bridge contract changes or if the refund window expires before claiming. Some bridges have time-limited refund windows — if you wait too long, you may lose the ability to claim your refund. The tool also cannot predict changes to the bridge contract, such as upgrades or modifications to the refund interface, that may affect the refund process. Additionally, the tool cannot verify that the refund amount is correct — always verify the refund details before executing. This tool is an aid for fee recovery, not a guarantee that the refund will be processed.

PLEASE NOTE

EVM chains only. This tool relies on the BGWallet connector and will not function on Solana, Tron, Starknet, SUI, TON, Aptos, Bitcoin, Cosmos, or XRP. The user is responsible for ensuring the supplied bridge contract address is correct and that the contract supports refund functions. Different bridges have different refund mechanisms — check your bridge's documentation for specific refund requirements. Claim your refunds promptly to avoid refund window expiration.