Gas Spike Warning Tool

WHAT IT DOES

The Gas Spike Warning Tool monitors the current network's gas price via window.ethereum and detects sudden gas price spikes—rapid increases of a user-defined percentage (e.g., 50% or more) within a short time window (e.g., 30 seconds). When a spike is detected, the tool sends immediate sound alerts (a series of rapid beeps) and desktop notifications to warn you before you submit a transaction at inflated prices. This helps you avoid paying excessive gas fees during periods of sudden network congestion or market volatility. The panel displays real-time gas price data with a status indicator, spike percentage, and a rolling history of recent gas prices, so you can see the spike in context.

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 Spike Warning Tool" from the tools menu.

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

5. Configure your spike detection settings: set the spike percentage threshold (e.g., 50%) and the spike detection window (e.g., 30 seconds).

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

7. When a spike is detected, 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 — rolling‑window percentage‑change detection with spike cooldown

This tool uses a rolling‑window analysis to detect gas price spikes in real time. It calls `eth_gasPrice` through your wallet provider at a configurable interval (default 5 seconds) and maintains a rolling history of recent gas prices (up to 20 entries). For each new reading, the tool compares the oldest price in the history window against the newest price, calculating the percentage change. If the increase exceeds the user-defined threshold (e.g., 50%) and the price change occurred within the configured time window (e.g., 30 seconds), a spike is flagged. To prevent repeated alerts during sustained high prices, the tool uses a cooldown period (60 seconds) that suppresses additional notifications after a spike is detected. Sound alerts are generated using the Web Audio API (a three‑beep pattern), and desktop notifications are sent via GM_notification or the Web Notification API. All detection parameters—spike percentage, detection window, and check interval—are user‑configurable and persist via GM_setValue.

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 "⚙️ Spike Warning" — 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 price movements—only detects spikes after they occur. It cannot distinguish between legitimate network congestion and malicious manipulation. It cannot detect spikes on networks that do not support eth_gasPrice or have low update frequency. 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, spike events) are collected; you can disable this in the extension settings at any time.