solana-vigil

Solana validator health in 60 seconds: score, leader duties, rewards, disk forecast, Prometheus. One static binary, read-only, never touches your keys.

What is solana-vigil?

Solana validator health in 60 seconds: score, leader duties, rewards, disk forecast, Prometheus. One static binary, read-only, never touches your keys.

Overview of solana-vigil

What it is

Vigil is a read-only, Alpenglow-aware Solana validator operations tool for Linux. It combines checks that operators normally glue together: vote-account VAT runway, BLS registration, delinquency, identity consistency, leader production, per-slot missed duties, Prometheus metrics, Linux host audits, actionable alerts, and advisory maintenance planning. Vigil never asks for a seed phrase, private key, or keypair file. It never signs or sends a transaction, changes host settings, restarts a validator, or switches identities. It is built to run directly on Linux Solana mainnet-beta validator servers.

Key features

  • Read-only by construction: no key loading, signing, transaction, failover, or host-mutation code paths.
  • One static binary using Go's standard library only; CGO_ENABLED=0 produces a static Linux executable.
  • Honest uncertainty: missing RPC fields and failed observations become unknown, never a fabricated healthy value.
  • Built-in alert storm prevention: sustained-failure thresholds, stable recoveries, deduplication, severity escalation, retry-on-delivery-failure, and repeat intervals.
  • No secret configuration: webhook URLs, Telegram tokens, and PagerDuty routing keys come from environment variables.
  • Small footprint: one binary, no database, no required cloud service, no telemetry, and no vendor lock-in.
  • Includes commands: vigil init, vigil check, vigil watch, vigil test-alert, vigil export, vigil audit, vigil report, vigil plan-restart, vigil score, vigil disk, vigil keys, vigil duties, vigil rewards, vigil fleet.

Use cases

  • Monitoring Solana mainnet-beta validator health with a single binary.
  • Checking vote-account VAT runway, BLS registration, delinquency, identity consistency, and leader production.
  • Continuous monitoring with per-slot missed-leader detection and alerts to Slack, Discord, Telegram, PagerDuty, or generic webhooks.
  • Exporting Prometheus metrics with health and readiness endpoints.
  • Performing read-only Linux host audits (CPU, memory, sysctl, time, NIC, process-limit, voting-mode) with baseline drift detection.
  • Generating self-contained HTML, JSON, or terminal reports.
  • Planning advisory leader-free slot windows for restarts (never performs a restart).
  • Scoring validator health from 0-100 with per-cell detail and fix instructions.
  • Forecasting disk space days-to-full from observed growth slope.

Getting started

bashcurl -fsSL https://raw.githubusercontent.com/ValidatorStack/solana-vigil/main/install.sh | sudo bashvigil initvigil check --config vigil.jsonvigil watch --config vigil.jsonFor automation:bashvigil init --non-interactive --vote-account --local-rpc http://127.0.0.1:8899 --output vigil.json

License and pricing

License: MIT. Pricing type: open source.

Based on the project's public README and repository metadata.

Add this badge to your README

Featured on YunoDB Badge styles & help

Maintain this project? Show that it is featured on YunoDB.

Markdown[![Featured on YunoDB](https://yunodb.com/badge/validatorstacksolana-vigil.svg)](https://yunodb.com/tools/validatorstacksolana-vigil?utm_source=github&utm_medium=badge)
HTML<a href="https://yunodb.com/tools/validatorstacksolana-vigil?utm_source=github&utm_medium=badge"><img src="https://yunodb.com/badge/validatorstacksolana-vigil.svg" alt="Featured on YunoDB" height="20"></a>