gas-sentinel

KO | EN

gitlite — search

#python #go #golang #android #nodejs #awesome #cli #kubernetes #vue #pytorch #security #ios #openai #open-source

(★ 15)

Gas fee monitor

gas-sentinel Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# ⛽ Gas Sentinel

```
  ██████╗  █████╗ ███████╗    ███████╗███████╗███╗   ██╗████████╗██╗███╗   ██╗███████╗██╗
 ██╔════╝ ██╔══██╗██╔════╝    ██╔════╝██╔════╝████╗  ██║╚══██╔══╝██║████╗  ██║██╔════╝██║
 ██║  ███╗███████║███████╗    ███████╗█████╗  ██╔██╗ ██║   ██║   ██║██╔██╗ ██║█████╗  ██║
 ██║   ██║██╔══██║╚════██║    ╚════██║██╔══╝  ██║╚██╗██║   ██║   ██║██║╚██╗██║██╔══╝  ██║
 ╚██████╔╝██║  ██║███████║    ███████║███████╗██║ ╚████║   ██║   ██║██║ ╚████║███████╗███████╗
  ╚═════╝ ╚═╝  ╚═╝╚══════╝    ╚══════╝╚══════╝╚═╝  ╚═══╝   ╚═╝   ╚═╝╚═╝  ╚═══╝╚══════╝╚══════╝
```

> Real-time Ethereum & L2 gas fee monitor with smart alerts — right in your terminal.

![Python](https://img.shields.io/badge/python-3.10+-blue?logo=python&logoColor=white)
![License](https://img.shields.io/badge/license-MIT-green)
![Version](https://img.shields.io/badge/version-1.0.0-orange)
![Chains](https://img.shields.io/badge/chains-ETH%20%7C%20POLY%20%7C%20ARB%20%7C%20BASE-purple)

## ✨ Features

- **Multi-chain** — Ethereum, Polygon, Arbitrum, and Base
- **No API key** — Uses free public RPC endpoints
- **Color-coded** — Green (< 20 gwei), Yellow (< 50), Red (≥ 50)
- **Watch mode** — Continuous polling with configurable interval
- **Smart alerts** — Get notified when gas drops below your threshold
- **EIP-1559** — Full base fee + priority fee breakdown
- **Beautiful output** — Powered by Rich terminal formatting

## 📦 Installation

```bash
# Clone and install
git clone https://github.com/anthropics/gas-sentinel.git
cd gas-sentinel
pip install -r requirements.txt

# Or install as a package
pip install .

# Or just run directly
python gas_sentinel.py
```

### Requirements

- Python 3.10+
- No API keys needed!

## 🚀 Usage

### Quick Check — Current Ethereum Gas

```bash
$ gas-sentinel

⛽ Gas Sentinel v1.0.0  •  Chains: Ethereum

⛽ Gas Prices
  ┌──────────┬──────────┬──────────────────────────────┐
  │ Tier     │     Gwei │ Visual                       │
  ├──────────┼──────────┼──────────────────────────────┤
  │ 🐢 Low   │    12.35 │ ████████████                 │
  │ 🚶 Medium│    18.72 │ ██████████████████           │
  │ 🚀 High  │    31.50 │ ████████████████████████████ │
  │ ⚡ Prio  │    28.40 │ ██████████████████████████   │
  ├──────────┼──────────┼──────────────────────────────┤
  │ 📦 Base  │    11.20 │                              │
  └──────────┴──────────┴──────────────────────────────┘
    Updated 14:32:07 UTC  •  Chain ID 1
```

### Watch Mode — Continuous Monitoring

```bash
# Default: refresh every 15 seconds
$ gas-sentinel --watch

# Custom interval (30 seconds)
$ gas-sentinel --watch --interval 30

# Short form
$ gas-sentinel -w -i 10
```

```
  ⛽ Gas Sentinel v1.0.0  •  Polling every 15s  •  2024-01-15 14:32:07 UTC

⛽ Ethereum Gas Prices
  ┌──────────┬──────────┬──────────────────────────────┐
  │ Tier     │     Gwei │ Visual                       │
  ├──────────┼──────────┼──────────────────────────────┤
  │ 🐢 Low   │     8.42 │ ████████                     │  ← green (< 20 gwei)
  │ 🚶 Medium│    14.61 │ ██████████████               │  ← green (< 20 gwei)
  │ 🚀 High  │    42.30 │ █████████████████████████████│  ← yellow (< 50 gwei)
  │ ⚡ Prio  │    38.10 │ ████████████████████████████ │  ← yellow (< 50 gwei)
  ├──────────┼──────────┼──────────────────────────────┤
  │ 📦 Base  │     7.80 │                              │
  └──────────┴──────────┴──────────────────────────────┘

Next update in 15s... (Ctrl+C to quit)
```

### Smart Alerts — Notify on Low Gas

```bash
# Alert when gas drops below 15 gwei
$ gas-sentinel --alert 15

# Combine with watch mode
$ gas-sentinel --watch --alert 10

# Watch Polygon with alert
$ gas-sentinel -w --chain polygon --alert 30
```

When gas drops below your threshold, you'll see:

```
  ╔══════════════════════════════════════════╗
  ║                                        ║
  ║    🔔 GAS ALERT!  LOW PRICES! 🔔       ║
  ║                                        ║
  ║    ETHEREUM gas is at 9.42 gwei         ║
  ║    Threshold: 15.0 gwei                 ║
  ║                                        ║
  ╚══════════════════════════════════════════╝
```

### Multi-Chain Monitoring

```bash
# Check Polygon
$ gas-sentinel --chain polygon

# Check multiple chains
$ gas-sentinel --chain ethereum polygon arbitrum

# Check ALL chains at once
$ gas-sentinel --all

# Watch all chains with alerts
$ gas-sentinel --all --watch --alert 20
```

## 🔗 Supported Chains

| Chain     | Token | Type          | Endpoint                    |
|-----------|-------|---------------|-----------------------------|
| Ethereum  | ETH   | L1 (EIP-1559) | publicnode.com              |
| Polygon   | POL   | L1 (EIP-1559) | publicnode.com              |
| Arbitrum  | ETH   | L2 Rollup     | publicnode.com              |
| Base      | ETH   | L2 Rollup     | publicnode.com              |

All endpoints are **free** and require **no API key**.

## 🎨 Color Thresholds

| Color  | Range          | Meaning         |
|--------|----------------|-----------------|
| 🟢 Green  | < 20 gwei  | Great time to transact |
| 🟡 Yellow | 20–49 gwei | Average prices        |
| 🔴 Red    | ≥ 50 gwei  | High congestion       |

## 📋 Command Reference

```
Usage: gas-sentinel [OPTIONS]

Options:
  --version            Show version
  --chain, -c CHAIN    Chain(s): ethereum, polygon, arbitrum, base
  --all, -a            Monitor all chains
  --watch, -w          Continuous watch mode
  --interval, -i SEC   Poll interval in seconds (default: 15)
  --alert GWEI         Alert threshold in gwei
  -h, --help           Show help
```

## 🏗️ Project Structure

```
gas-sentinel/
├── gas_sentinel.py    # Main CLI application
├── pyproject.toml     # Package metadata & build config
├── requirements.txt   # Runtime dependencies
├── LICENSE            # MIT License
└── README.md          # This file
```

## 🤝 Contributing

1. Fork the repository
2. Create a feature branch (`git checkout -b feature/awesome`)
3. Commit changes (`git commit -m 'Add awesome feature'`)
4. Push to branch (`git push origin feature/awesome`)
5. Open a Pull Request

## 📄 License

MIT — see [LICENSE](LICENSE) for details.

---

<p align="center">
  Built with ❤️ using <a href="https://github.com/encode/httpx">httpx</a> and <a href="https://github.com/Textualize/rich">Rich</a>
</p>

gas-sentinel

gas-sentinel Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

gas-sentinel

gas-sentinel Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README