Gas Token Balance Reminder

WHAT IT DOES

Gas Token Balance Reminder watches the current page for the user's wallet address, reads the native gas token balance (ETH, MATIC, etc.) from the blockchain via eth_getBalance at regular intervals, and triggers a reminder notification when the balance falls below a user-defined threshold, with options to display the current gas price and estimated transaction costs. It helps you avoid failed transactions due to insufficient gas.

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 native gas tokens are used. The tool integrates seamlessly into your workflow, appearing as a draggable panel that stays accessible as you interact with dApps.

HOW TO USE

Connect your wallet using the "Connect Wallet" button. Configure your settings: set the minimum balance threshold that triggers an alert, choose the refresh interval, toggle transaction cost estimates on or off, and toggle desktop notifications on or off. The panel displays your current gas token balance, network, and estimated gas costs for common operations (transfer, swap, mint, approve, deposit). When your balance falls below the threshold, you'll receive a desktop notification and the panel will show a warning. Use "Check Now" for an immediate balance check, or "Stop Monitoring" to disconnect.

TECHNICAL OPERATION

Gas Token Balance Reminder uses raw JSON-RPC calls via window.ethereum.request() to interact with the blockchain. It reads the native gas token balance using eth_getBalance with the connected wallet address. It reads the current gas price using eth_gasPrice. The tool detects the current chain ID via eth_chainId to display the correct gas token symbol (ETH, MATIC, BNB, AVAX, etc.) and network name. The estimated transaction costs are calculated using standard gas limits for common operations (transfer: 21,000, swap: 100,000, mint: 80,000, approve: 46,000, deposit: 65,000) multiplied by the current gas price. The tool checks the balance at the user-defined interval and triggers a desktop notification when the balance falls below the threshold. It also tracks the low balance state to avoid repeated notifications.

THE PANEL

The Gas Token Balance Reminder 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 gas token balance if the wallet is not connected, cannot predict future gas prices or transaction costs, cannot detect gas token balances on other chains, and cannot prevent transactions from failing due to insufficient gas. No private keys are stored or transmitted—all data is read-only from the blockchain. Always ensure you have sufficient gas tokens before submitting transactions.