Cross-Chain Token Burn Reconciliation Tool

WHAT IT DOES

Cross-Chain Token Burn Reconciliation Tool is a specialized Developer Tools application that reconciles token burns across source and destination chains to ensure accurate cross-chain transfers. It reads source chain token contract state, destination chain token contract state, and bridge contract state to compare burn and mint amounts. The tool fetches the user's token balances, burn transaction history, mint transaction history, and bridge message state. It reads the burn amount, mint amount, reconciliation period state, chain ID, block timestamp, and transaction nonce. The tool verifies burn execution on the source chain and mint execution on the destination chain, then checks the burn and mint verification statuses. It reads oracle price feeds, gas price, bridge fee configuration, validation threshold, and reconciliation report state. The tool supports three key actions: verifying the burn on the source chain, verifying the mint on the destination chain, and confirming the bridge message to complete the reconciliation.

HOW TO USE

Connect your wallet and select your network from the dropdown. Paste the source chain token contract address, destination chain token contract address, and bridge contract address. Click "Run Reconciliation" to fetch burn and mint data from both chains and compare them. The tool displays bridge message state, burn amount, mint amount, burn verification status, mint verification status, reconciliation period, transaction histories, validation threshold, discrepancy, and reconciliation status. Review the action preview showing burn and mint verification status, bridge fee, and readiness for confirmation. Use the three action buttons: "Verify Burn" to confirm the burn transaction on the source chain, "Verify Mint" to confirm the mint transaction on the destination chain, and "Confirm Bridge Message" to finalize the reconciliation. All actions are submitted as on-chain transactions with appropriate gas parameters.

DISCREPANCY DETECTION AND RECONCILIATION VERIFICATION ENGINE

The tool implements a comprehensive reconciliation engine that compares burn and mint amounts across chains to detect discrepancies. It reads the burn amount from the source chain token contract and the mint amount from the destination chain token contract, then calculates the absolute difference. The tool compares this difference against the validation threshold (e.g., 1% of the total amount) to determine if the reconciliation passes or requires investigation. It reads the burn and mint verification statuses from the bridge contract to track which steps have been completed. The tool also reads the bridge message state—which can be Pending, Verified, Confirmed, or Failed—to determine the current progress. For discrepancy detection, the tool calculates the percentage deviation and displays it alongside the absolute difference. The tool also reads the reconciliation period to determine the time window for validations. When verifying burn, the tool calls the verifyBurn function on the bridge contract, passing the user's address and burn amount. When verifying mint, it calls verifyMint with the appropriate parameters. For final confirmation, it calls confirmBridgeMessage with the message ID, which triggers the bridge contract to complete the settlement. The tool uses the provider's effectiveGasPrice for accurate gas estimation and applies a safety multiplier for transaction submission to ensure competitiveness under varying network conditions.

WHAT IT CANNOT SEE

This tool cannot verify that the burn transaction was correctly executed on the source chain beyond on-chain state. It cannot detect if the bridge message was manipulated, corrupted, or intercepted off-chain. It cannot guarantee that the mint transaction will succeed on the destination chain due to network conditions or contract state. It cannot recover funds if reconciliation fails or is disputed by the bridge. It cannot verify that the token amounts are accurate beyond on-chain data. It cannot provide financial or investment advice. It cannot ensure that the bridge will process the reconciliation or confirm the message. It cannot detect if the bridge has been compromised, paused, or upgraded. It cannot predict bridge processing delays. It cannot verify off-chain reconciliation data or supporting documentation.

PLEASE NOTE

This tool supports EVM-compatible chains only. It requires an active RPC connection and a wallet with signing capabilities. The tool does not custodial funds or private keys. Always verify bridge contract addresses and reconciliation details before confirming. Reconciliation is time-sensitive—complete all steps within the reconciliation period. The tool is for advanced users and developers; you bear full responsibility for reconciliation decisions.