Network Auto-Switcher for Site

WHAT IT DOES

Network Auto-Switcher for Site watches the current page for the required blockchain network, reads the currently connected network ID and chain ID from window.ethereum, and when the connected network does not match the required network for the site, triggers an automatic network switch request via wallet_switchEthereumChain, with fallback to adding the network via wallet_addEthereumChain if not available. It ensures you're always on the right network for the DApp you're using.

WHERE IT RUNS

This tool operates as a userscript within the BotGentz extension framework, running directly in your browser on any website. It works on any EVM-compatible blockchain page—Ethereum, Polygon, Arbitrum, Optimism, and more—where wallet interactions are used. The tool integrates seamlessly into your workflow, appearing as a draggable panel that stays accessible as you navigate between different blockchain applications.

HOW TO USE

Configure your target network settings in the "Network Configuration" section: enter the target chain ID (e.g., 1 for Ethereum Mainnet, 137 for Polygon), network name, native currency symbol, RPC URL, and block explorer URL. Toggle "Auto-switch when on wrong network" on or off. Click "Connect & Check Network" to connect your real wallet extension and check if you're on the correct network. If you're on the wrong network, click "Switch Now" to manually switch, or enable auto-switch for automatic switching. The panel displays your current network and the target network status.

TECHNICAL OPERATION

Network Auto-Switcher for Site uses raw JSON-RPC calls via window.ethereum.request() to interact with the wallet extension. It reads the current chain ID using eth_chainId and compares it to the user-configured target chain ID. When a mismatch is detected and auto-switch is enabled, the tool calls wallet_switchEthereumChain with the target chain ID. If the wallet returns error code 4902 (network not added), it falls back to wallet_addEthereumChain with the configured network parameters (chain name, native currency, RPC URLs, block explorer). The tool listens for chainChanged events and reloads the page when a switch occurs to ensure the DApp reflects the new network. The current network status is displayed in the panel with color-coded indicators.

THE PANEL

The Network Auto-Switcher for Site panel is fully draggable and remembers its position between sessions using GM_setValue. It snaps to the edge of the viewport for a clean interface and can be collapsed to a small icon when not in use. The panel is resizable to accommodate longer content. Press Escape to quickly close or collapse the panel. The design is optimized for productivity with a dark theme, clear visual hierarchy, and responsive controls that adapt to your workflow.

PLEASE NOTE

This tool requires the free BotGentz extension installed in your browser and a real EVM wallet extension (MetaMask, Rabby, etc.) already installed. EVM chains only—this does not work on non-EVM blockchains. The tool cannot switch networks if the wallet extension does not support the required JSON-RPC methods, cannot add a network if the RPC URL is invalid or unreachable, cannot detect the required network if the site does not expose it in the DOM, and cannot force the wallet to switch if the user rejects the request. No private keys are stored or transmitted—all switching happens through your wallet extension's native interface. Always verify the RPC URL and network parameters before enabling auto-switch.