README.md

The Beacon Chain Dynamics at Merge: Evaluating Consensus Decentralization and Security Via Validator Life Cyle Visualzations

How to run code

After cloned the repo, create a new directory named data by

mkdir data

Then, go to this kaggle dataset to download data files into the data directory.

After that, install the dependencies (make sure you have the Python environment)

pip install -r requirements.txt

Then you should be able to directly run code by

python xxx.py

Table of Code Files

File Name	Description	location in the GitHub Repository
data.py	Query data from the source	https://github.com/SciEcon/beacon-chain-merge/blob/master/data.py
analyze.py	Process Data for Visualization	https://github.com/SciEcon/beacon-chain-merge/blob/master/analyze.py
plot.py	Produce Visualization	https://github.com/SciEcon/beacon-chain-merge/blob/master/plot.py

Table of Data Files on Kaggle

Description	File Name
Validator data in the Beacon Chain	validators.json
Recorded the status of validators by day	status.csv
The daily blockrate	blocktime.csv
Auxiliary or temp files	*.pkl