Revert Message Plain-English Decoder

WHAT IT DOES

Revert Message Plain-English Decoder is a read-only tool that decodes transaction revert messages into plain English, generating AI-powered explanations of what condition caused the revert and how to fix it. It reads revert error bytes, revert message string (if present), transaction calldata, target contract address, contract bytecode, ABI fragments, function selector, call trace, gas used, block number, timestamp, sender address, contract state at call time, and failure history for similar revert patterns. The tool then presents this data alongside an AI-generated explanation of the revert, decoding the message into plain English, explaining what condition caused the revert, and recommending specific actions to fix the issue — helping you understand and resolve transaction failures before retrying.

HOW TO USE

Connect your wallet using the BGWallet bridge and select your target network. Enter the transaction hash or revert bytes you want to decode, along with the target contract address. Click "Decode revert" to read on-chain revert data. The tool displays the revert data, contract address, revert message, and function selector. Detailed information includes the condition that caused the revert, call trace, gas used, block number, sender address, and similar revert patterns. A recommended fix box provides specific steps to resolve the issue. An AI explanation appears below the on-chain data, decoding the revert message into plain English, explaining what condition caused the revert, and recommending how to fix it before you retry the transaction. 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 revert data. No hardcoded contract addresses are used — you are always in control of which contract you trust. When decoding revert messages, the tool reads the revert error bytes from the transaction receipt or simulation, extracts the revert message string if present (e.g., via ethers.utils.toUtf8String() for string reverts), reads transaction calldata from the transaction object, reads the target contract address from the user input, reads contract bytecode via provider.getCode(contract), reads ABI fragments from the contract metadata or source code, extracts the function selector from the calldata, analyzes the call trace from the simulation, reads gas used from the receipt or simulation, reads block number and timestamp from the provider, reads sender address from the transaction, reads contract state at call time via view functions, and checks failure history for similar revert patterns by scanning past failed transactions. 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 decode the revert message into plain English, explain what condition caused the revert, and recommend specific actions to fix the issue — while stating plainly that it cannot decode custom error types that are not present in the contract's ABI or source code, cannot guarantee that the decoded message accurately reflects the intent behind the revert, and cannot predict whether a retry will succeed. The AI response is capped at 1,024 tokens to ensure concise, focused revert explanations. All computed values are guarded against negative numbers — if a gas used or block number appears invalid, the tool flags it rather than displaying nonsensical values.

WHAT IT CANNOT SEE

This tool cannot decode custom error types that are not present in the contract's ABI or source code. It cannot guarantee that the decoded message accurately reflects the intent behind the revert. It cannot detect off-chain factors or social engineering that may have caused the revert. It cannot predict whether a retry will succeed. The AI explanation is generated from on-chain revert data only and cannot detect off-chain conditions, hidden contract state, or social engineering factors. It cannot predict whether a retry will succeed after making the recommended fixes. The tool does not continuously monitor revert patterns; each analysis is a snapshot at the time of the lookup. It cannot detect delayed failures, off-chain changes, or hidden conditions. 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 success or fix correctness.

PLEASE NOTE

Revert Message Plain-English Decoder 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. Revert messages can be cryptic and difficult to understand. Use this tool as a guide only; always cross-check with contract documentation and independent sources for critical decisions. This is experimental software; use at your own risk.