Wallet Network Mismatch Warning

WHAT IT DOES

Wallet Network Mismatch Warning detects your connected wallet's network and compares it against the expected network for the site you're on. It infers the expected network from the URL, page content, or a user-defined setting. When a mismatch is found, it displays a prominent warning overlay and a panel notification showing both networks. A single-click button lets you switch networks in your wallet using wallet_switchEthereumChain. The tool also shows a persistent status indicator—✅ Correct, ⚠️ Mismatch, or ❓ Unknown—so you always know your network status.

WHERE IT RUNS

This tool runs as a userscript inside the BotGentz extension on any website. It connects directly to your real EVM wallet via window.ethereum—no intermediate bridge. It works on any page with a wallet connection, including dApps, exchanges, and marketplaces.

HOW TO USE

Install the script and navigate to any page. Click "Connect Wallet" to link your EVM wallet. The tool will automatically detect the expected network from the URL or page content. If a mismatch is detected, a warning appears at the bottom of the screen. Click "Switch Network" on the overlay or in the panel to change networks in your wallet. You can also set a custom expected Chain ID in the panel settings, disable auto-detection, or turn off the overlay. The panel shows detailed network information and a manual check button.

TECHNICAL MECHANISM

The tool reads your wallet's current chain ID using eth_chainId and compares it to the expected chain ID. The expected chain is determined in three ways: (1) a user-defined setting in the panel, (2) auto-detection from the URL and page content (looking for terms like "ethereum", "optimism", "polygon", etc.), or (3) a fallback of 0 (unknown). When a mismatch is detected, it calls wallet_switchEthereumChain with the correct chain ID, allowing the user to switch networks with one click. The tool monitors chain changes in real-time and updates the status every 5 seconds. The overlay is a persistent floating element that can be dismissed but reappears on mismatch.

THE PANEL

The panel can be dragged anywhere on screen, snapped to the edge, resized, collapsed, and closed with Escape. It remembers its position per site and stays out of your way until you need it.

PLEASE NOTE

This tool requires the free BotGentz extension and a real EVM wallet extension (e.g., MetaMask) installed in your browser. It is EVM-only and works on Ethereum, Optimism, Arbitrum, Polygon, Base, and other EVM-compatible chains. It cannot detect networks that are not supported by your wallet. Auto-detection may not work on all sites; you can set a custom Chain ID in the panel. Sites change frequently; the script may need updating. No data is collected or stored beyond your own browser settings.