Finality Risk Explainer

WHAT IT DOES

Finality Risk Explainer is a read-only tool that analyzes on-chain data for transaction finality and generates AI-powered plain-language explanations of finality risk. It reads transaction receipts, block finality status, L1 finality, L2 finality, rollup finality state, safe block status, finalized block status, confirmation depth, chain head, validator set, checkpoint status, finalization delay, protocol parameters, reorg history, and finality oracle status. The tool then presents this data alongside an AI-generated explanation of current finality risk, including finality status, confirmation depth, and potential risks — helping you understand transaction security before acting on a confirmation.

HOW TO USE

Connect your wallet using the BGWallet bridge and select your target network (Ethereum Mainnet for L1, or Arbitrum/Optimism for L2). Enter the transaction hash you want to analyze. Select the chain type (L1 or L2). Optionally, for L2 transactions, enter the rollup contract address to check L2-specific finality. Click "Analyze finality risk" to read on-chain data. The tool displays the transaction hash, chain type, finality status, confirmation depth, L2 finality status, and finality risk level. Detailed information includes safe block status, finalized block status, chain head, validator set, checkpoint status, finalization delay, protocol parameters, reorg history, and finality oracle status. A finality confidence meter visually indicates the overall confidence level. An AI explanation appears below the on-chain data, describing the transaction's finality risk including current finality status, confirmation depth, and potential risks if finality is delayed or fails. The wallet's own signature step still protects you — this explanation is informational only and does not replace reviewing what you approve in your wallet.

TECHNICAL MECHANISM

The tool uses ethers.js v5.7.2 with the provider from the BGWallet bridge to read on-chain data. When analyzing finality risk, the tool reads transaction receipts via provider.getTransactionReceipt(), block finality status by analyzing the block number and confirmation depth, L1 finality by checking the safe block (typically 6 blocks) and finalized block (typically 12-15 blocks) status, L2 finality by reading the rollup contract's finalization state (e.g., isFinalized(), finalizedBatches), rollup finality state from the rollup's L1 finalization contract, safe block status by comparing the block number to the chain's safe block threshold, finalized block status by comparing to the chain's finalized block threshold, confirmation depth by calculating blocks between the transaction's block and the current chain head, chain head via provider.getBlockNumber(), validator set from the consensus layer or validator registry, checkpoint status from the rollup's checkpoint contract (L2), finalization delay from the protocol's finalization parameters, protocol parameters from the parameter storage, reorg history from event logs (e.g., FinalizationUpdated, CheckpointFinalized) by walking backwards in chunks and halving chunk size on failure, and finality oracle status from the oracle contract. The data is formatted and passed to the AI bridge via BGAI.generate() with a structured prompt that includes all the on-chain data read. The AI is instructed to explain the transaction's finality risk including current finality status, confirmation depth, and potential risks — while stating plainly that it cannot predict future finality failures, consensus issues, or validator misbehavior, and cannot guarantee that transactions will achieve finality within any specific timeframe. The AI response is capped at 1,024 tokens to ensure concise, focused risk assessments. All computed values are guarded against negative numbers — if a confirmation depth or risk score appears invalid, the tool flags it rather than displaying nonsensical values.

WHAT IT CANNOT SEE

This tool cannot predict future finality failures, consensus issues, or validator misbehavior. It cannot guarantee that transactions will achieve finality within any specific timeframe. It cannot detect off-chain finality problems, network partitions, or validator honesty issues not reflected on-chain. The AI explanation is generated from on-chain data only and cannot detect hidden consensus problems, validator collusion, network latency, or off-chain finality delays. It cannot predict network congestion, validator downtime, or consensus failures that may occur after the analysis. The tool does not continuously monitor finality; each analysis is a snapshot at the time of the lookup. It cannot detect delayed finalization, stale checkpoints, or off-chain data latency. The tool does not store any data persistently; all state is in-memory and resets on reload. The AI explanation is informational and does not constitute financial advice, legal advice, or a guarantee of transaction finality or safety.

PLEASE NOTE

Finality Risk Explainer works exclusively with EVM-compatible chains. It requires a Web3 wallet (MetaMask or similar) and the BGWallet bridge. Explanations are AI-generated from data the app reads on-chain — always review what you are actually signing in your wallet before approving it. Finality failures carry significant risk including transaction reversal, double-spending, and loss of funds if a transaction does not achieve finality. Use this tool as a guide only; always cross-check with blockchain explorers and independent sources for critical decisions. This is experimental software; use at your own risk.