Gas Price Alert Tool

WHAT IT DOES

The Gas Price Alert Tool monitors the current network's gas price via window.ethereum and displays real-time gas price data in a clean panel, with audible and desktop notifications when user-defined thresholds are breached. You set a low threshold (e.g., 20 Gwei) and a high threshold (e.g., 80 Gwei). When the gas price drops below the low threshold, the tool alerts you that conditions are favorable for submitting transactions. When it spikes above the high threshold, it warns you that gas is expensive and you may want to wait. The panel displays the current gas price in Gwei, the base fee for EIP-1559 networks, a status label with color coding, and a running history chart of recent gas prices—all helping you time your transactions to minimize fees.

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 planning your next on-chain transaction.

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 Alert Tool" 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, 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 EIP-1559 base fee 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 (window.ethereum) 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. When a threshold is crossed—particularly when the gas price moves from above the low threshold to below it, or from below the high threshold to above it—the tool triggers alerts. Sound alerts are generated using the Web Audio API (a short beep or two-tone pattern), 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 history is stored in memory and displayed as a running list of recent gas prices.

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 Alert" — 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, alert events) are collected; you can disable this in the extension settings at any time.