Solana Validator Stake Checker CLI — Track Decentralization from Your Terminal

Source: Dev.to

Overview

Solana Validator Stake Checker is a pure‑stdlib Python CLI that queries the Solana mainnet RPC to display validator stake distributions, the Nakamoto coefficient, and details for individual validators. It requires no external dependencies, API keys, or installation steps beyond downloading the script.

Features

• Top Validators by Stake – ranked list showing vote account, commission, and active stake.
• Validator Lookup – inspect any validator by its vote account address.
• Nakamoto Coefficient – number of validators that control ≥ 33.3 % of total stake (a decentralization metric).
• JSON Mode – --json flag for easy piping into other tools.
• Zero Dependencies – pure Python standard library only.

Installation

Download the script

curl -L https://raw.githubusercontent.com/neuralmint/solana-stake-checker/main/solana_stake_checker.py -o solana_stake_checker.py

Or clone the repository

git clone https://github.com/neuralmint/solana-stake-checker.git
cd solana-stake-checker

Usage

Show help

python3 solana_stake_checker.py --help

Display the full validator ranking

python3 solana_stake_checker.py

Sample output

Rank Vote Account         Commission   Active Stake (SOL)
---------------------------------------------------------
1    CcaH…oTN1            7%                15,823,512.73
2    he1i…uBtk            0%                14,829,828.83
3    3N7s…iD5g            0%                13,344,370.46
4    4D9R…7jFM            0%                12,931,831.43
...

Total Network Stake: 427,731,796.78 SOL
Nakamoto Coefficient (33.3% stake): 19

Lookup a specific validator

python3 solana_stake_checker.py --lookup CcaHc2L43ZWjwCHART3oZoJvHLAe9hzT2DJNUpBzoTN1

Get the top N validators in JSON format

python3 solana_stake_checker.py --top 5 --json

{
  "total_stake_sol": 427731796.78,
  "nakomoto_coefficient": 19,
  "validators": [
    {
      "rank": 1,
      "vote_account": "CcaHc...oTN1",
      "commission": 7,
      "active_stake_sol": 15823512.73
    },
    ...
  ]
}

Show the top 25 validators (human‑readable)

python3 solana_stake_checker.py --top 25

How It Works

The tool contacts Solana’s public JSON‑RPC endpoint:

https://api.mainnet-beta.solana.com

using urllib.request from the standard library. It invokes two RPC methods:

• getVoteAccounts – returns the list of validators with their stake, commission, and vote account addresses.
• getEpochInfo – provides the current epoch context.

All formatting is performed client‑side with standard Python string formatting. No caching, databases, or external services are involved.

Technical Details

• Language: Python 3 (standard library only – urllib, json, argparse, sys).
• Dependencies: None.
• License: MIT – free to use, modify, and distribute.
• API: Solana Mainnet Beta public RPC endpoint.

Decentralization Metric

The Nakamoto coefficient is defined as the smallest number of validators whose combined stake exceeds 33.3 % of the total network stake—a threshold for Byzantine fault tolerance. For Solana, the current coefficient is 19, meaning the top 19 validators together control a supermajority of the stake. A higher coefficient indicates greater decentralization.

Running the tool regularly allows you to track how this metric evolves over time.

Related Tools (Neuralmint CLI Suite)

• Gas Fee Checker
• Rug Checker
• Portfolio Rebalance Calculator
• Wallet Tracker
• Multi‑Chain Balance Checker

These are also single‑file, zero‑dependency Python utilities for various crypto‑related tasks.

Support the Project

If you find this tool useful, consider sending a tip to the developer’s validator:

• SOL: 4TGyiYBjaYhFFPNYyCoJjf16ctUsWVBiMR1FXQxEfhWi
• ETH: 0xe07f177E0725c11EEc8BeA34C5b5193CaF2a1A6a