nakomoto-coefficient-calculator

nakomoto-coefficient-calculator copied to clipboard

Nakamoto Coefficient Calculator

AIM

The aim of this project is to calculate the nakamoto coefficients for various popular blockchains.

Nakamoto coefficient is a way to calculate the level of decentralization in a particular chain.

Read this amazing messari report on operational decentralization of Proof-of-stake networks.

Disclaimer

Please note that the values should be interpreted with context since the same objective treatment is applied for all the chains included here, ie, we simply calculate:

nakamoto-coefficient: no of validators controlling 33% of the total network stake

So, I would suggest users to understand the context, cross-verify and examine the results. For any feedback, please join this discord.

Programming Languages

Golang

Steps to run

1. Build docker image

docker build . --platform=linux/amd64 -t xenowits/nc-calc:v0.1.4

2. Run the image

docker run --rm \
-e "SOLANA_API_KEY=<YOUR_SOLANA_API_KEY_HERE>" \
-e "RATED_API_KEY=<YOUR_RATED_API_KEY_HERE>" \
-p 8080:8080 xenowits/nc-calc:v0.1.4

NOTE: You can get your API Key by signing up here.

Chains currently supported

1. Cosmos
2. Polygon
3. BNB Smart Chain
4. Osmosis Zone
5. Mina
6. Solana
7. Avalanche
8. Terra
9. Graph Protocol
10. Thorchain
11. Near
12. Juno
13. Regen Network
14. Agoric
15. Stargaze
16. Hedera
17. Sui
18. Pulsechain
19. Celestia
20. MultiversX
21. Polkadot
22. Aptos

Notes

The actual logic is present inside /core. A goroutine runs every 6 hours which updates the nakamoto coefficients for all the chains.

Future Work

To add support for multiple other chains in /v1.