Swap Route Plain-English Explainer

WHAT IT DOES

Swap Route Plain-English Explainer is a read-only tool that decodes swap transactions and generates AI-powered plain-language explanations of what the transaction does. It reads swap transaction calldata, token addresses, token symbols, token decimals, swap amounts, route path, pool addresses, router contract, aggregator contract (if used), slippage parameters, deadline, gas price, estimated output amounts, protocol fees, route complexity, and intermediate tokens. The tool then presents this data alongside an AI-generated explanation in plain English, describing what tokens are being swapped, the route taken, expected output, fees, and risks — helping you understand exactly what a swap transaction will do before you sign it.

HOW TO USE

Connect your wallet using the BGWallet bridge and select your target network. Enter the transaction hash of the swap you want to understand. Click "Explain swap" to read on-chain transaction data. The tool displays an AI-generated explanation in plain English, describing the tokens being swapped, the route taken through liquidity pools or aggregators, the expected output amount, protocol fees, slippage parameters, and deadline. The explanation also highlights any risks such as multi-hop complexity or high slippage. 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 transaction data. No hardcoded contract addresses are used — you are always in control of which contract you trust. When analyzing a swap transaction, the tool decodes the transaction calldata to identify the function called (e.g., swapExactTokensForTokens, swapTokensForExactTokens), extracts token addresses from the calldata and resolves them to symbols using the token contract's symbol() and decimals() functions, reads swap amounts from the calldata, extracts the route path from the calldata (an array of token addresses representing the swap path), identifies pool addresses by reading the router or factory contracts, identifies router or aggregator contracts by checking the transaction's target address, reads slippage parameters (e.g., amountOutMin or amountInMax), reads deadline parameters from the calldata, reads gas price from the transaction object, estimates output amounts by simulating the swap using the router's getAmountsOut() or getAmountsIn() functions, reads protocol fees from the router or aggregator configuration, determines route complexity by counting the number of hops, and identifies intermediate tokens by analyzing the path. 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 swap in plain English, including what tokens are being swapped, the route taken, expected output, fees, and risks — while stating plainly that it cannot predict actual swap output due to slippage and market movement between read and execution, cannot detect mempool conditions or front-running risks, and cannot guarantee that the route will be optimal or that the swap will succeed. The AI response is capped at 1,024 tokens to ensure concise, focused explanations. All computed values are guarded against negative numbers — if a swap amount or estimated output appears invalid, the tool flags it rather than displaying nonsensical values.

WHAT IT CANNOT SEE

This tool cannot predict actual swap output due to slippage and market movement between read and execution. It cannot detect mempool conditions or front-running risks. It cannot guarantee that the route will be optimal or that the swap will succeed. It cannot detect off-chain liquidity changes or price manipulation. The AI explanation is generated from on-chain data only and cannot detect mempool conditions, front-running, sandwich attacks, or off-chain liquidity changes. It cannot predict whether a swap will be front-run or experience significant slippage after the transaction is submitted. The tool does not continuously monitor swap transactions; each analysis is a snapshot at the time of the lookup. It cannot detect delayed execution, mempool congestion, or off-chain factors. 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 swap execution or protection against slippage.

PLEASE NOTE

Swap Route Plain-English 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. Swap transactions carry significant risk including slippage, front-running, and unexpected price movements. Use this tool as a guide only; always cross-check with independent sources and verify transaction details manually for critical decisions. This is experimental software; use at your own risk.