DEX Failed Trade Diagnostics Tool

WHAT IT DOES

DEX Failed Trade Diagnostics Tool is an essential troubleshooting assistant that automatically detects and diagnoses failed swap transactions on DEXs. When you're on a supported DEX (Uniswap, SushiSwap, 1inch, Curve, or Balancer) and a trade fails, the tool captures the error reason—whether it's slippage exceeded, insufficient liquidity, gas too low, contract revert, or insufficient balance—and displays a comprehensive diagnostic panel. The panel shows the failure reason, transaction details, severity level, and actionable recommendations. A step-by-step troubleshooting guide provides specific actions based on the error type, such as increasing slippage tolerance, adjusting gas price, reducing trade amount, or checking token approvals. The tool includes quick-action buttons to apply the recommended fixes (e.g., "Increase Slippage to 2%"). All failure history is tracked for monitoring and analysis.

WHERE IT RUNS

This overlay operates on major DEX platforms including Uniswap (app.uniswap.org, uniswap.org), SushiSwap (sushi.com), 1inch (1inch.io), Curve (curve.fi), and Balancer (balancer.fi). It works in any browser that supports the BotGentz extension framework and has an EVM-compatible wallet extension installed. The panel activates automatically when you're on a supported DEX page.

HOW TO USE

Install the extension and connect your wallet. Navigate to any supported DEX and attempt a trade. If the trade fails, the tool automatically detects the failure and displays a diagnostic panel with the error reason, severity, and actionable suggestions. Review the failure diagnosis to understand why the trade failed. Follow the step-by-step troubleshooting guide for your specific error type. Use the quick-action buttons to apply recommended fixes—for example, "Increase Slippage" or "Increase Gas." Configure your settings: enable or disable auto-diagnose, toggle notifications on failure, set the slippage override suggestion, and set the gas buffer suggestion. Use the "Refresh" button to manually update the diagnosis, "Save Settings" to apply changes, and "Copy Report" to export a summary. The tool tracks all failure history for performance review.

MECHANISM: TRADE FAILURE DETECTION WITH TRANSACTION RECEIPT PARSING AND ERROR CLASSIFICATION

The extension implements a trade failure detection system that monitors the DEX page for failed trade indicators and wallet transaction receipts. When a trade is initiated, the tool waits for the transaction result, checking the wallet's eth_getTransactionReceipt for the transaction status. If the status is 0x0 (failed), the tool parses the revert reason from the receipt data (if available) to identify the specific error. The tool also monitors the page DOM for error messages displayed by the DEX UI, capturing text patterns like "Slippage exceeded," "Insufficient liquidity," "Gas too low," or "Contract revert." The error classification engine maps detected error patterns to specific failure types: slippage, insufficient_liquidity, gas, contract_revert, or balance. Each failure type has a pre-defined set of diagnostic steps and recommendations. The severity level is assigned based on the error type—high for critical issues like insufficient liquidity or contract revert, medium for configurable issues like slippage and gas, low for minor issues. The quick-action buttons simulate the application of recommended fixes, providing immediate feedback to the user. All failure data is stored locally using GM_setValue, tracking the error type, token pair, amount, and timestamp for historical analysis.

THE PANEL

The overlay panel is fully draggable via its title bar and remembers its position per-site using GM_setValue. It snaps to the nearest edge when dragged within 40px of any screen boundary. The panel includes clear sections for trade diagnostics (DEX name, chain, wallet address, gas price, current trade parameters), failure diagnosis (error message with severity color coding, suggestion), troubleshooting steps (numbered list of actionable recommendations), recommended actions (quick-action buttons tailored to the error type), failure history (recent failures with error types, token pairs, and timestamps), settings (auto-diagnose toggle, notification toggle, slippage override suggestion input, gas buffer suggestion input), and action buttons (Refresh, Save Settings, Copy Report, Clear History). The failure diagnosis section prominently displays the error with color coding—red for high severity, yellow for medium, green for low. Pressing Escape temporarily dismisses the panel until you navigate to a new DEX page or manually reactivate.

PLEASE NOTE

This extension requires the free BotGentz framework extension to be installed and active. You must also have a real EVM-compatible wallet extension (such as MetaMask, WalletConnect, Coinbase Wallet, or Rabby) already installed in your browser—the overlay uses your wallet's RPC provider for eth_getTransactionReceipt queries and transaction context. This tool is read-only—it does not send transactions; it only provides diagnostics and recommendations. The tool cannot detect failed trades that occur without an on-chain transaction; depends on accurate transaction receipt parsing which may vary by node; cannot diagnose failures that occur off-chain or in the wallet UI; does not support non-EVM chains where transaction receipts differ; cannot detect failures that are not displayed on the page; cannot recover from failed trades automatically; does not support trades that require multiple steps or approvals; and cannot diagnose failures caused by contract logic that does not emit standard error messages. No private keys, wallet balances, browsing history, or trade data are ever collected, transmitted, or stored outside your local browser—all data is stored locally using GM_setValue. This tool provides diagnostics only—it cannot guarantee trade success. Always verify your trade parameters and settings before attempting trades.