Note: This is an early-stage research project maintained alongside academic work and side projects; the goal is transparent documentation and reproducibility, not a peer-reviewed claim at this stage.
This repository contains data and code for a site-level ("site×grid") baseline assessment of Bitcoin mining electricity use and location-based Scope 2 emissions, plus an auditable extension: a conservative Net Impact Score (NIS) framework.
- Unit of analysis: mining site paired with its electricity accounting zone
- Emissions boundary: location-based Scope 2 (annual average intensity by official zone)
- Outputs: site-level and operator-level annual MWh and tCO₂ (plus zone summaries)
NIS assigns credits only when backed by publicly auditable evidence (e.g., time-stamped curtailed MWh tied to program settlements; hourly time-matched clean procurement in the same zone).
If evidence is missing, credits default to zero.
NIS does not replace the baseline. It is a layered framework designed to evolve with disclosures.
data/processed/v0.1/- baseline snapshot (site table + operator/zone rollups + data dictionary)
data/wip/- intermediate tables (may contain temporary columns / fixes)
docs/- methodology notes, assumptions, changelog (recommended)paper/- draft manuscript (optional; clearly labeled not peer-reviewed)notebooks/- exploratory notebooks (clearly labeled if WIP)
- Install dependencies (Python ≥3.10):
pandas,numpy,matplotlib - Run:
python scripts/build_operator_tables.py(or open the replication notebook if provided) - Outputs are regenerated from the site-level CSV.
Please cite this repository using the commit hash and access date.
A CITATION.cff will be provided when the first snapshot release is tagged.
- Author: Paul Engerran
- Issues & suggestions: please open a GitHub issue with sources/links.