urtho / nakomoto-coefficient-calculator Goto Github PK

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.

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.

Golang

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.

1. Cosmos
2. Polygon
3. Binance 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

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

To add support for multiple other chains in /v1.