ENS Ledger Analysis

Analysis scripts and reports for the ENS DAO ledger.

We use pandas and seaborn to examine the raw csv data downloaded from https://ens-ledger.app/

Project structure

• data/ – source CSVs (e.g., 281125-big_picture_ledger.csv)
• analysis/ – reusable helpers (data_loading.py, plots.py, reporting.py)
• plots/ – generated figures
• report/ – generated Markdown reports
• Entry points: analyze_ledger.py, analyze_wallets.py, verify_recipients.py

Setup (Poetry)

poetry install

Usage

From the repo root:

# Full analysis: loads data, regenerates all plots to plots/, writes report/ledger_overview.md
poetry run python analyze_ledger.py

# Wallet-focused summary: writes report/wallets_report.md
poetry run python analyze_wallets.py

# Recipient verification: writes report/recipients_report.md
poetry run python verify_recipients.py

Outputs

• Plots: plots/*.png
• Reports: report/ledger_overview.md, report/wallets_report.md, report/recipients_report.md