Wallet Watchlist Alert Tool

WHAT IT DOES

Wallet Watchlist Alert Tool watches wallet addresses or ENS names specified by the user, reads their native token balances and ERC-20 token balances from the blockchain via eth_call at regular intervals, and triggers alerts (desktop notifications and panel flashes) when any watched wallet's balance changes significantly or crosses user-defined thresholds. It keeps you informed about important wallet activity without constantly checking block explorers.

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 addresses and tokens exist. The tool integrates seamlessly into your workflow, appearing as a draggable panel that stays accessible as you monitor wallets.

HOW TO USE

Add the wallet addresses or ENS names you want to monitor in the "Watchlist Setup" section (comma-separated). Optionally, add ERC-20 token addresses to track token balances as well. Configure your alert settings: set the percentage change threshold that triggers an alert, choose the refresh interval, select your preferred alert type (Both, Desktop Notification Only, or Flash Only), and toggle desktop notifications on or off. Click "Start Monitoring" to connect your real wallet extension, which will begin checking balances at your specified interval. The panel displays current balances for all watched addresses and tokens. Use "Refresh Now" for an immediate update, "Clear History" to reset balance tracking, or "Stop Monitoring" to disconnect.

TECHNICAL OPERATION

Wallet Watchlist Alert Tool uses raw JSON-RPC calls via window.ethereum.request() to interact with the blockchain—no external library required for basic operations. It loads ethers at runtime using a simple script tag injection for ABI encoding and contract interactions. The tool resolves ENS names to addresses using the ENS resolver when provided. It reads native token balances using provider.getBalance and ERC-20 token balances using the balanceOf view function on each token contract. The tool stores previous balances in memory and calculates the percentage change for each monitored address. When the change exceeds the user-defined threshold, it triggers alerts via GM_notification and P.flash. The tool uses setInterval for automatic refreshes based on the user-defined interval.

THE PANEL

The Wallet Watchlist Alert Tool 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 read balances if the blockchain RPC is unavailable, cannot detect off-chain wallet activity, cannot resolve ENS names if the ENS resolver is not accessible, and cannot detect token balances for tokens that do not expose the required view functions. No private keys are stored or transmitted—all data is read-only from the blockchain. Always verify the watchlist addresses before starting monitoring.