Bridge Transaction Canceller

WHAT IT DOES

Bridge Transaction Canceller is a developer tool that lets you cancel pending or stuck bridge transactions before they are processed by the bridge network. When a bridge transaction is initiated but not yet finalized — due to network congestion, gas issues, or user error — it may remain in a pending state. This tool reads the bridge contract state to find pending transactions for your address, displays their statuses and details, and allows you to cancel them in a single batched transaction. The tool provides a preview of pending transactions, cancellation eligibility, and transaction details before you execute, enabling efficient and secure management of stuck bridge transfers.

HOW TO USE

Connect your EVM wallet via the BGWallet bridge. Enter the bridge contract address. Optionally, enter a specific transaction ID to cancel a single transaction — leave blank to check all pending transactions. Set your preferred batch size (how many cancellations to include per transaction). Click "Check Pending Transactions" to scan for your pending transactions. The tool will display the transaction IDs, details, and status (Pending, Completed, or Cancelled). Review the list carefully — only transactions with "Pending" status can be cancelled. Click "Cancel Transactions" to sign and broadcast the transaction. The tool will cancel transactions 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 `getPendingTransactions(address)` or `transactionStatus(txId)` to read the status of pending transactions. It checks cancellation eligibility by verifying that the transaction has not already been completed or cancelled. When executing cancellations, the tool uses a multicall or batched call pattern to aggregate multiple `cancelTransaction` calls into one transaction. The batch size parameter controls how many cancellations are grouped per transaction to avoid gas limit issues. The tool also checks whether you have already cancelled each transaction — if you have, it marks them as "Cancelled" and skips them. The entire cancellation process is atomic — if any individual cancellation 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 cancellation will be processed by the bridge network before the transaction is executed, or that the bridge network will honor the cancellation request. Bridge networks operate independently and may process transactions faster than the cancellation request. The tool also cannot predict changes to the bridge contract, such as upgrades or modifications to the cancellation interface, that may affect the cancellation process. Additionally, the tool cannot verify that the transaction is still pending — always verify the transaction status before cancelling. This tool is an aid for bridge transaction management, not a guarantee that the cancellation will be processed in time.

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 cancellation functions. Different bridges have different cancellation mechanisms — check your bridge's documentation for specific cancellation requirements. Cancelling a transaction may incur gas fees — ensure you have sufficient balance. Some bridges may not support cancellation at all — check your bridge's documentation first.