Contract Address Verifier Overlay

WHAT IT DOES

Contract Address Verifier Overlay watches the current page for smart contract addresses, reads the contract bytecode and source code verification status from the blockchain via eth_getCode, and displays an overlay with verification information including whether the contract is verified on Etherscan or similar explorers, the compiler version, and a warning if the contract appears to be unaudited or suspicious. It helps you quickly assess the trustworthiness of contract addresses before interacting with them.

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 contract addresses are used. The tool integrates seamlessly into your workflow, appearing as a draggable panel that stays accessible as you evaluate contract addresses.

HOW TO USE

Enter a contract address in the "Contract Verification" section and click "Verify Contract". The tool checks the bytecode to confirm it's a contract and queries the block explorer API (Etherscan, Polygonscan, etc.) for verification status. The panel displays the contract name, compiler version, verification status, and bytecode size. If the contract is not verified, a warning is displayed. Click "Connect Wallet" to connect your real wallet extension and auto-detect the current network. Use "Clear Cache" to reset cached verification results, or enable auto-check and warnings in the settings. The panel shows the verification result with a direct link to the block explorer.

TECHNICAL OPERATION

Contract Address Verifier Overlay uses raw JSON-RPC calls via window.ethereum.request() to interact with the blockchain. It reads the contract bytecode using eth_getCode to determine if the address is a contract and to check the bytecode size. The tool queries block explorer APIs (Etherscan, BscScan, Polygonscan, Arbiscan, etc.) using GM_xmlhttpRequest, with support for API keys to increase rate limits. It parses the API response to extract verification information including contract name, compiler version, and source code availability. The tool caches verification results in memory to avoid repeated API calls. It auto-detects the current chain ID via eth_chainId to use the correct explorer. When warnings are enabled, the tool displays a prominent warning for unverified contracts with a security advisory.

THE PANEL

The Contract Address Verifier Overlay 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 verify contracts that are not deployed on the current chain, cannot check verification status if the block explorer API is unavailable or rate-limited, cannot detect if the contract is malicious even if verified, and cannot check contracts that are not yet deployed. No private keys are stored or transmitted—all verification is read-only. Always use caution when interacting with unverified contracts and verify the contract address from multiple sources.