New Contract Interaction Alert

WHAT IT DOES

New Contract Interaction Alert watches the current Etherscan address page for the displayed wallet address, reads the wallet's recent transaction history via the Etherscan API, monitors for interactions with new or recently deployed smart contracts, analyzes transaction patterns to detect when a wallet first interacts with a newly created contract, and displays alerts with contract address, transaction details, and risk assessment when new contract interactions are detected. The tool extracts the wallet address from the page URL, fetches recent transaction history from the Etherscan API using the transaction list endpoint, stores historical transaction snapshots locally to detect new interactions, checks the age of each contract interacted with via the Etherscan contract creation API, calculates the contract age at the time of interaction, and determines if the interaction was with a contract deployed within the configured threshold. It then displays alerts with the contract address, creation date, age at interaction, transaction hash, and a risk assessment based on contract age.

WHERE IT RUNS

The tool runs as a panel inside your browser on Etherscan address pages at https://etherscan.io/address/*. It works on any wallet address page on Etherscan where transaction history is available through the Etherscan API. The tool connects to the Etherscan public API via GM_xmlhttpRequest to fetch transaction data and contract creation information. No data is sent to any external server beyond the API request; all data is read-only and processed locally. A real EVM wallet is optional — the tool will work without one, but may provide additional on-chain verification if available.

HOW TO USE

Install the BotGentz extension, navigate to any Etherscan address page, and open the New Contract Interaction Alert panel. Set your contract age threshold in days (default 7) — the tool will alert you when a wallet interacts with a contract deployed within this many days. Select your monitoring interval from the dropdown — 30, 60, 120, or 300 seconds. Choose your alert preference — Panel only, Browser notification, or Both. Click "Monitor Interactions" — the tool begins fetching transaction data from the Etherscan API at your chosen interval, stores historical transaction hashes locally, and compares each new fetch against the stored history. When a new transaction to a contract is detected, the tool checks the contract's creation date via the Etherscan contract creation API, calculates its age at the time of interaction, and triggers an alert if the age is within the configured threshold. The alert log maintains a history of recent alerts for review. Click "Refresh" to manually check for new interactions, or "Clear History" to reset the alert log.

MECHANISM — CONTRACT AGE DETECTION AND INTERACTION TRACKING

This tool uses a contract age detection and interaction tracking engine that combines transaction monitoring with contract creation date verification. The system extracts the wallet address from the page URL, then constructs the Etherscan API endpoint URL (https://api.etherscan.io/api?module=account&action=txlist&address={address}&sort=desc&offset=20). It uses GM_xmlhttpRequest with GET method to fetch the transaction list, which returns a JSON array containing up to 20 recent transactions with fields including hash, from, to, value, timeStamp, and gasUsed. The tool stores transaction hashes from each fetch in a local history object keyed by wallet address using GM_setValue to persist data across page reloads. On each monitoring cycle, the tool compares the current transaction list against the stored history, filtering out transactions already seen and identifying new transactions. For each new transaction where the to address is not the zero address or a known EOA pattern, the tool queries the Etherscan contract creation API (https://api.etherscan.io/api?module=contract&action=getcontractcreation&contractaddresses={contractAddress}) to retrieve the contract's deployment timestamp. It then calculates the contract's age in days using the current block timestamp and compares it against the configured threshold. Transactions with contracts younger than the threshold trigger alerts, while older contracts are flagged as lower risk.

THE PANEL

The BotGentz panel is fully draggable, allowing you to position it anywhere on your screen without obstructing the Etherscan interface. It includes per-site position memory, so the panel returns to your preferred location each time you visit an address page. Snap-to-edge functionality lets you dock the panel to any side of the browser window. The panel collapses to a compact icon when not in use and expands with a single click. You can resize it to your preferred dimensions, and pressing the Escape key instantly closes the panel. All interactions are smooth and intuitive, designed to work alongside your blockchain investigation workflow.

PLEASE NOTE

This tool requires the free BotGentz extension to function. A real EVM wallet extension is optional — the tool will work without one, but may provide additional on-chain verification if available. EVM chains only. This is a monitoring and alert tool only — it does not execute transaction-based actions automatically. The tool cannot guarantee that the API data includes all mempool transactions or pending interactions. It cannot determine contract creation date if the contract was deployed before the API data limit. It cannot read transaction history from wallets not visible on Etherscan. It cannot detect interactions with contracts not tracked on Etherscan. It cannot identify contracts created via factory patterns or proxies without manual verification. It cannot predict future contract interactions or assess contract security beyond age and verification status. It cannot read private wallet information or transaction intentions. All API data is fetched through public endpoints; no data is stored or transmitted beyond your browser. Websites change their layouts and content structures regularly; while we continuously update the extraction logic, some pages may require script updates. Always verify all contract details independently before making any decisions based on the alerts.