Stuck Transaction Diagnosis Tool

WHAT IT DOES

Stuck Transaction Diagnosis Tool is a read-only tool that analyzes pending transactions to diagnose why they are stuck, generating AI-powered plain-language explanations of the root cause and recommended actions. It reads pending transaction status, transaction nonce, sender address, gas price, current block number, mempool state, transaction hash, calldata, confirmation count, gas price trends, network congestion, pending pool depth, transaction age, transaction replacement attempts, gas price compared to current mempool, miner and validator behavior, block inclusion probability, and transaction propagation status. The tool then presents this data alongside an AI-generated diagnosis of why the transaction is stuck, identifying the root cause (low gas price, network congestion, nonce issues, etc.), and recommending specific actions to resolve the situation — helping you take the right steps to unstick your transaction.

HOW TO USE

Connect your wallet using the BGWallet bridge and select your target network. Enter the transaction hash of the stuck transaction you want to diagnose. Optionally enter the sender address (auto-detected if not provided). Click "Diagnose stuck transaction" to read mempool and on-chain data. The tool displays the transaction hash, sender address, nonce, gas price, transaction age, and stuck severity level (Low/Medium/High). Detailed information includes root cause, mempool state, gas price compared to current mempool, network congestion, pool depth, replacement attempts, block inclusion probability, propagation status, and calldata hash. A recommended action box provides specific steps to resolve the situation. An AI explanation appears below the on-chain data, diagnosing why the transaction is stuck, identifying the root cause, and recommending specific actions to resolve the situation before you take action. 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 mempool and on-chain data. No hardcoded contract addresses are used — you are always in control of which contract you trust. When diagnosing stuck transactions, the tool reads the pending transaction status via provider.getTransaction(txHash) and checking if it exists in the mempool, reads the transaction nonce from the transaction object, reads the sender address from the transaction, reads the gas price from the transaction, reads the current block number via provider.getBlockNumber(), reads the mempool state by checking for the transaction and analyzing the surrounding mempool, reads the transaction hash from the user input, reads the calldata from the transaction object, estimates confirmation count based on gas price and mempool position, analyzes gas price trends from recent blocks and mempool, assesses network congestion from the pending transaction count, reads the pending pool depth via provider.getPendingTransactions().length, calculates transaction age by comparing block timestamps, reads transaction replacement attempts by scanning for transactions with the same nonce from the same sender, compares gas price to current mempool gas prices, reads miner and validator behavior from block proposer histories, estimates block inclusion probability by comparing the gas price to current mempool gas prices, and reads transaction propagation status by checking node connectivity. The tool fetches event logs by walking backwards in chunks and halving chunk size on failure, ensuring logs are properly read despite varying RPC limitations. 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 diagnose why the transaction is stuck, identify the root cause (low gas price, network congestion, nonce issues, replacement conflicts, etc.), and recommend specific actions to resolve the situation — while stating plainly that it cannot guarantee that a stuck transaction will eventually be mined or replaced, cannot predict block inclusion timing or validator behavior, and cannot detect if the transaction has been dropped from the mempool by all nodes. The AI response is capped at 1,024 tokens to ensure concise, focused diagnosis assessments. All computed values are guarded against negative numbers — if a gas price or nonce appears invalid, the tool flags it rather than displaying nonsensical values.

WHAT IT CANNOT SEE

This tool cannot guarantee that a stuck transaction will eventually be mined or replaced. It cannot predict block inclusion timing or validator behavior. It cannot detect if the transaction has been dropped from the mempool by all nodes. It cannot detect private mempool inclusions or replacements not publicly visible. The AI explanation is generated from public mempool and on-chain data only and cannot detect private transaction inclusion, hidden replacement attempts, or validator collusion. It cannot predict whether a stuck transaction will be resolved by the next block proposer. The tool does not continuously monitor stuck transactions; each analysis is a snapshot at the time of the lookup. It cannot detect delayed resolution, private transaction pools, or stale mempool data. 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 resolution or recovery.

PLEASE NOTE

Stuck Transaction Diagnosis Tool 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. Stuck transactions carry significant risk including gas fee loss, delayed transactions, and unexpected outcomes. Use this tool as a guide only; always cross-check with independent sources and monitor transaction status. This is experimental software; use at your own risk.