Reverted Transaction Root Cause Analyzer

WHAT IT DOES

Reverted Transaction Root Cause Analyzer is a developer-focused tool that analyzes reverted transactions to identify the root cause of failures. It takes a transaction hash and optional contract ABI from the user, then fetches the transaction and receipt via eth_getTransactionReceipt. The tool checks if the transaction reverted (status: 0), then performs a multi-faceted analysis to identify potential causes including insufficient balance, out of gas, stale or future nonce, contract not found, revert reason decoding, and parameter issues. When a contract ABI is provided, the tool decodes function signatures and error messages for more detailed analysis. The results are presented with severity classifications (critical, warning, info) and actionable recommendations for each identified issue. This enables developers to quickly debug transaction failures and resolve issues without manual inspection of logs and state.

HOW TO USE

Connect your wallet to the target EVM chain. Enter the transaction hash into the input field. Optionally, paste the contract ABI (JSON format) to enable decoding of function signatures and error messages. Optionally, provide additional context about the expected behavior. Click "Analyze reverted transaction" to perform the analysis. The tool will display a summary including the transaction details, revert reason, and a root cause analysis with severity levels (critical, warning, info). Each cause includes a description, technical detail, and recommendation for resolution. The analysis report can be copied or downloaded as JSON.

TECHNICAL NOTE: MULTI-FACTOR REVERT ANALYSIS

The tool performs a comprehensive analysis using multiple data sources: the transaction receipt for status and gas usage, the transaction object for nonce and value, the contract ABI for decoding function calls, and balance checks for sufficient funds. It systematically checks for common revert causes: insufficient balance (comparing the sender's balance to the transaction value), out of gas (comparing gas used to gas limit), nonce issues (comparing transaction nonce to current nonce), contract existence (checking if the target address has code), and parameter issues (decoding parameters from the ABI to check for zero addresses or zero values). The tool also attempts to decode revert reasons from transaction data using both standard error signatures and custom error signatures from the provided ABI.

WHAT IT CANNOT SEE

The tool cannot analyze transactions that are not available on the RPC node. It is limited to the accuracy of the provided ABI; without the correct ABI, custom error signatures cannot be decoded. It cannot decode custom error signatures without the correct ABI. The tool is limited by debug_traceTransaction availability on the RPC endpoint; it does not use traces for analysis. It cannot analyze transactions on non-EVM chains. It cannot guarantee that the identified root cause is complete or accurate, as some issues may require deeper analysis of contract state or logic.

PLEASE NOTE

This tool is designed exclusively for EVM-compatible chains (Ethereum, Polygon, BNB Chain, Arbitrum, Optimism, Avalanche C-Chain, etc.). It does not support non-EVM blockchains. The tool is read-only and does not modify any state. The analysis is based on transaction data and heuristics; it may not identify all possible root causes. Always verify the analysis with additional debugging tools and contract source code. The tool provides no warranty that the analysis is complete or accurate; users are responsible for validating the findings.