Failed Bridge Message Retrier

WHAT IT DOES

Failed Bridge Message Retrier is a developer tool that lets you retry failed cross-chain bridge messages that were not successfully delivered to the destination chain. When a bridge message fails — due to network issues, gas limits, or contract errors — it remains in a failed state and must be retried. This tool reads the bridge contract state to find failed messages for your address, displays their statuses and details, and allows you to retry them in a single batched transaction. The tool provides a preview of failed messages, retry eligibility, and message details before you execute, enabling efficient and secure recovery of stuck bridge transfers.

HOW TO USE

Connect your EVM wallet via the BGWallet bridge. Enter the bridge contract address. Optionally, enter a specific message ID to retry a single message — leave blank to check all failed messages. Set your preferred batch size (how many retries to include per transaction). Click "Check Failed Messages" to scan for your failed messages. The tool will display the message IDs, details, and status (Retryable, Retried, or Failed). Review the list carefully — only messages with "Retryable" status can be retried. Click "Retry Messages" to sign and broadcast the transaction. The tool will retry messages 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 `getFailedMessages(address)` or `messageStatus(messageId)` to read the status of pending failed messages. It checks retry eligibility by verifying that the message has not already been retried and that the retry window has not expired. When executing retries, the tool uses a multicall or batched call pattern to aggregate multiple `retryMessage` calls into one transaction. The batch size parameter controls how many retries are grouped per transaction to avoid gas limit issues. The tool also checks whether you have already retried each message — if you have, it marks them as "Retried" and skips them. The entire retry process is atomic — if any individual retry 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 retry will succeed if the bridge network remains unavailable or the destination chain's bridge contract state has changed since the original attempt. Bridge retries depend on the bridge network's status and the destination chain's contract state — if the underlying issue persists, the retry may fail again. The tool also cannot predict changes to the bridge contract, such as upgrades or modifications to the retry interface, that may affect the retry process. Additionally, the tool cannot verify that the message payload is still valid — always verify the message details before retrying. This tool is an aid for bridge recovery, not a guarantee that the retry will succeed.

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 retry functions. Different bridges have different retry mechanisms — check your bridge's documentation for specific retry requirements. Some bridges may have a limited retry window — retry your messages promptly to avoid expiration.