First-Time Contract Interaction Warning

WHAT IT DOES

First-Time Contract Interaction Warning is your transaction security tool that alerts you when you're about to interact with a smart contract you've never used before. It automatically intercepts pending transaction details from confirmation pages, extracts the target contract address, and checks your connected wallet's transaction history for previous interactions. When a first-time interaction is detected, the tool displays a prominent warning with contextual risk indicators, contract age, and transaction volume information. It provides one-click verification links to block explorers so you can research the contract before signing, maintains a local database of previously interacted contracts, and sends alerts for first-time interactions involving high-value transactions.

WHERE IT RUNS

This script runs on all major DEX interfaces including Uniswap (app.uniswap.org), SushiSwap (app.sushi.com), Curve (curve.fi), Balancer (balancer.fi), 1inch (1inch.io), CowSwap (cow.fi), and major NFT marketplaces including OpenSea (opensea.io), Blur (blur.io), LooksRare (looksrare.org), Zora (zora.co), Rarible (rarible.com), and Foundation (foundation.app). It works on transaction confirmation pages, wallet approval dialogs, and any page displaying pending transaction details.

HOW TO USE

Install the script through the BotGentz userscript manager. Click "Connect Wallet" to link your EVM wallet extension. Navigate to any supported DEX or marketplace and initiate a transaction. When the confirmation dialog appears, the tool automatically detects the contract address and checks your interaction history. The panel displays the contract status—First Time (yellow) or Known (green)—along with contract age, transaction volume, and verification status. If this is your first time interacting with the contract, a warning badge appears with a notification. Use the displayed contract address to verify against the block explorer before signing. The tool maintains a persistent history of all contracts you've interacted with.

PERSISTENT CONTRACT INTERACTION DATABASE WITH FIRST-TIME DETECTION ENGINE

Unlike simple address viewers that just show the contract, this tool implements a persistent interaction database that tracks every contract you've ever transacted with. The engine extracts contract addresses from pending transactions using adaptive DOM detection, then queries the local interaction history database to determine if this is a first-time interaction. Each contract interaction is recorded with timestamp and count, building a comprehensive history of your on-chain activity. The system includes a simulated contract metadata module that estimates contract age and transaction volume, providing contextual risk indicators even for contracts you've never seen before. When a first-time interaction is detected, the engine triggers a prominent warning overlay and, if enabled, sends a browser notification. All interaction data is stored locally, ensuring your privacy while providing an ever-growing security reference database.

THE PANEL

The floating panel is fully draggable and snap-to-edge enabled. You can collapse it to a compact bubble when not in use, resize it to your preferred dimensions, and it remembers its position across page loads using persistent storage. Press Escape to quickly dismiss the panel. The panel displays the contract address, interaction status (First Time/Known), interaction count, contract age, transaction volume, and verification status.

PLEASE NOTE

This script requires the free BotGentz extension to be installed in your browser—it does not run as a standalone extension. You also need a real EVM wallet extension already installed and configured for transaction interception. The tool cannot detect interactions that occurred on different wallet addresses or chains and relies on the page exposing contract address in a detectable format. Transaction history query may be limited by RPC provider's historical data availability. No user data is collected or transmitted—all interaction history stays local in your browser storage. The tool provides security awareness assistance but does not guarantee that all unknown contracts are unsafe or that all known contracts are safe.