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.