Gas Price Threshold Notifier

WHAT IT DOES

The Gas Price Threshold Notifier monitors the current network's gas price via window.ethereum and sends desktop and sound notifications when the gas price crosses user-defined low or high thresholds. You set a low threshold (e.g., 20 Gwei) and a high threshold (e.g., 80 Gwei). When gas drops below the low threshold, you receive a "Gas Price Low!" notification—letting you know it's a good time to submit transactions. When gas spikes above the high threshold, you receive a "Gas Price High!" warning, helping you avoid expensive transaction fees. The tool displays real-time gas price data in the panel with a status indicator, a running history of recent gas prices, and alert count tracking—all without submitting any transactions or touching your funds.

WHERE IT RUNS

It runs as a draggable overlay panel inside the BotGentz extension on any website. It does not require specific page DOM content—it connects directly to your wallet provider and reads real-time network data via RPC calls. This means you can use it while browsing any dApp, DEX, NFT marketplace, or even a regular web page while monitoring network conditions.

HOW TO USE

1. Install the free BotGentz extension and ensure you have an EVM‑compatible wallet extension installed (e.g., MetaMask, Rabby, Trust Wallet).

2. Navigate to any page (the tool works everywhere).

3. Click the BotGentz icon and select "Gas Price Threshold Notifier" from the tools menu.

4. The panel opens. Click "Start Monitoring" to connect your wallet and begin fetching gas prices.

5. Configure your thresholds in the settings: set a low threshold (e.g., 20 Gwei) and a high threshold (e.g., 80 Gwei).

6. The panel displays the current gas price, status, thresholds, and a history chart.

7. When thresholds are breached, you'll hear a sound alert (if enabled) and receive a desktop notification (if enabled).

8. Use the "Check Now" button to manually fetch the current gas price.

9. Drag the panel to reposition it, resize it, collapse it, or press Escape to close.

THE ACTUAL MECHANISM — eth_gasPrice polling with threshold-crossing detection

This tool uses a simple but effective polling mechanism to monitor gas prices in real time. It calls the `eth_gasPrice` JSON-RPC method through your wallet provider at a configurable interval (default 10 seconds). The response returns the current gas price in wei, which is then converted to Gwei for display and threshold comparison. For EIP-1559 networks, the tool also calls `eth_getBlockByNumber` to retrieve the latest block's `baseFeePerGas`, providing additional insight into the network's current fee market. The tool compares the fetched gas price against the user-defined low and high thresholds. It triggers notifications only when the gas price crosses from above the low threshold to below it (low alert), or from below the high threshold to above it (high alert)—preventing repeated notifications during sustained conditions. Sound alerts are generated using the Web Audio API (a single beep for low alerts, a two-tone pattern for high alerts), and desktop notifications are sent via GM_notification or the Web Notification API. All alerts are subject to a configurable cooldown period to avoid notification spam.

THE PANEL

The panel is fully draggable by its title bar and snaps to the nearest edge of the viewport when released. You can resize it horizontally by dragging the left or right border; the height expands to fit content up to a maximum, with scrolling inside the history list. A collapse button minimizes the panel to a small floating chip showing "⚙️ Gas Notifier" — click it to expand back. Press Escape at any time to close the panel entirely. The panel remembers its last position, size, and expansion state per domain via localStorage.

PLEASE NOTE

- This tool requires the free BotGentz extension and a real EVM wallet extension (e.g., MetaMask) already installed in your browser. It does not include a wallet—it connects to the one you already have.

- This tool works only on EVM‑compatible chains that support the `eth_gasPrice` RPC method through the connected wallet provider.

- The tool cannot predict future gas prices or block congestion. It cannot read gas prices from networks that do not support eth_gasPrice. It cannot provide accurate fee estimates for complex transactions without the transaction details. It cannot send notifications if the browser or system blocks them.

- No private keys, seed phrases, or sensitive data are ever read, stored, or transmitted. The tool only reads public network data through your wallet provider. Only anonymized usage metrics (panel open/close, notification events) are collected; you can disable this in the extension settings at any time.