status-im
/
snt-distribution
mirror of https://github.com/status-im/snt-distribution.git
2
0
Fork 0
Code Issues Projects Releases Wiki Activity
A page that graphs the distribution of the SNT token
14 Commits 1 Branch 0 Tags 12 MiB
Python 85.5%
HTML 7.5%
TeX 7%
Go to file
Corey 872027c43c update with current holder data, redrew plots 2022-09-01 14:53:05 -04:00
archetypes some changes 2020-10-12 15:56:56 -04:00
content added some plots on initial article, theme alter 2020-10-15 09:02:34 -04:00
data_csv update with current holder data, redrew plots 2022-09-01 14:53:05 -04:00
static update with current holder data, redrew plots 2022-09-01 14:53:05 -04:00
themes some changes 2020-10-12 15:56:26 -04:00
.gitmodules some changes 2020-10-12 15:56:26 -04:00
.hugo_build.lock update with current holder data, redrew plots 2022-09-01 14:53:05 -04:00
README.md added READMEs, restructure a few things 2020-10-15 12:04:30 -04:00
config.toml added some plots on initial article, theme alter 2020-10-15 09:02:34 -04:00
munge_and_generate_plots.py added some plots on initial article, theme alter 2020-10-15 09:02:34 -04:00
requirements.txt spell files right 2020-10-14 16:40:31 -04:00

README.md

SNT Distribution Analysis Repo

🔴🔴🔴

DISCLAIMER: This repository is based on open source data and is not a complete identification of addresses and distribution. It serves as a best effort based on community gathered (and hoepfully reviewed) data. The blockchain data is simple, its identification and labeling is not, and is subject to being incorrect. Please report any incorrectness if you see it so that we can make the picture of the distribution more aligned with the reality.

🔴🔴🔴

The purpose of this repository is to hold relevant information about the SNT token and its distribution among it's holders. It will also provide informational visualizations of the distribution across various identifiable user groups, as well as analysis articles that snapshot analysis at a given time.

The datasets are held in the data_csv folder which contain the following updatable updatable files:

  • holders.csv - A file that snapshots holder account data. This file can be downloaded from Etherscan for up to 100,000 holders.
  • utility.csv - A file that identifies various Status Network related smart contracts.
  • exchanges.csv - A comma seperated value file that identifies various exchange addresses that may or may not store the SNT ERC20 token.

Each of the following files has a specific format that will be enforced by the updating review process. This is to ensure auto-generated plots and derivative datasets are formed properly. The respetive formats will be detailed in the data_csv directory.

Data munging, derivative datasets, and vega-lite visualization files are generated via the munge_and_generate_plots.py python script. Any time the above datasets are altered, this file needs to be run on the local machine before submitting a PR so that all derivative material is updated accordingly. This process will eventually be automated somehow, but for now it's still manual.

Updating the base dataset

If you have information you'd like to add to the base dataset which derives all plots and analysis, please follow the guide in the data_csv directory.

Add a new plot based on the base dataset

If you would like to see a visualization that does not exist yet based on the available data, please follow the guide in the plots directory.

TODO

Backend

  • automate python script execution (or create seperate build process to create derivative material)
  • abstract plot creation process and store in seperate directory
  • abstract away utility functions used in python script
  • re-format theme to be main visualization dashboard with associated research articles as secondary
  • host on github pages to subdomain of Status.im
  • add guide on creating an article and using Hugo/Distill
  • add README for plot folder
  • add README for data folder

Content

  • create main SNT visualization dashboard
  • finish initial SNT Distribution Analsys draft article

Plots

  • all holders - stale funds vs current
  • community - order of magnitude plot
  • exchanges - change exchange bar to treemap
  • status - treemap of distribution across Status