Solarpunk Bitcoin: Energy-Backed Cryptocurrency Research & Development
Academic research on renewable energy as a fundamental anchor for cryptocurrency value, with practical derivatives pricing framework for energy-backed assets.
📚 Research Papers
- CEIR-Trifecta.md – Core empirical work: "When Does Energy Cost Anchor Cryptocurrency Value?" Triple natural experiment design (China mining ban 2021, Ethereum merge 2022, Russia sanctions 2025)
- Quasi-SD-CEIR.md – Framework extension: Supply-demand dynamics with sentiment analysis and hidden Markov regimes
- Final-Iteration.md – SolarPunkCoin concept: Renewable-energy-backed stablecoin addressing 10 cryptocurrency failure modes
- Empirical-Milestone.md – Spring 2025 research proposal for Yuan Ze University
🔧 Energy Derivatives Framework
Production-ready Python package for pricing European-style options on renewable energy-backed assets.
Quick start:
cd energy_derivatives
pip install -r requirements.txt
jupyter notebook notebooks/main.ipynb
Core modules:
binomial.py– Binomial tree pricing with convergence analysismonte_carlo.py– Monte Carlo simulation with confidence intervalssensitivities.py– Greeks computation (delta, gamma, vega, theta, rho)plots.py– Publication-quality visualizationsdata_loader.py– Energy data calibration
Details: ~2,300 lines of production code, full documentation, Jupyter notebook with 10-section walkthrough.
�� Empirical Data & Analysis
empirical/ contains CEIR computation pipeline:
- Bitcoin/Ethereum energy consumption (TWh/year from Digiconomist)
- Mining distribution (geographic concentration)
- Electricity prices (regional, time-varying)
- Macro controls (S&P 500, VIX, gold)
- Analysis scripts (
gecko.py,CEIR.py,Regression.py)
📖 Project Structure
solarpunk-coin/
├── README.md # This file
├── CEIR-Trifecta.md # Main research paper
├── Quasi-SD-CEIR.md # Supply-demand extension
├── Final-Iteration.md # SolarPunkCoin vision
├── Empirical-Milestone.md # Research roadmap
│
├── energy_derivatives/ # Derivatives pricing package
│ ├── src/ # Core modules
│ │ ├── binomial.py
│ │ ├── monte_carlo.py
│ │ ├── sensitivities.py
│ │ ├── plots.py
│ │ └── data_loader.py
│ ├── notebooks/
│ │ └── main.ipynb # Full demonstration
│ └── requirements.txt
│
├── empirical/ # CEIR data & scripts
│ ├── gecko.py # Data collection
│ ├── CEIR.py # CEIR calculations
│ ├── Regression.py # Analysis
│ └── data/ # CSV files
│
└── examples/
└── presentation_colab.ipynb # Solar energy demo
🎯 Key Features
✅ Rigorous Theory: Risk-neutral valuation, geometric Brownian motion, arbitrage-free pricing
✅ Two Methods: Binomial tree (exact) + Monte Carlo (distribution analysis)
✅ Complete Greeks: All 5 sensitivities via finite differences
✅ Real Data: Calibrated to Bitcoin CEIR (2018–2025)
✅ Multi-Location: Taiwan, Arizona, Spain solar data comparison
✅ Production Code: Type hints, comprehensive docstrings, error handling
🚀 Usage
Python API:
from energy_derivatives.binomial import BinomialTree
from energy_derivatives.data_loader import load_parameters
params = load_parameters(data_dir='empirical')
price = BinomialTree(**params, N=400).price()
Jupyter Notebook:
cd energy_derivatives
jupyter notebook notebooks/main.ipynb
See notebooks/main.ipynb for complete 10-section demo with explanations.
📝 Author
Spectating101 (s1133958@mail.yzu.edu.tw)
Yuan Ze University
📄 License
MIT
Status: Research papers completed (peer review in progress). Derivatives framework complete and submission-ready.
Metadata
Release files for spk-derivatives 0.2.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| spk_derivatives-0.2.0.tar.gz | 50.2 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| spk_derivatives-0.2.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 96.2 kB
Release files / spk_derivatives-0.2.0.tar.gz
| Download URL | spk_derivatives-0.2.0.tar.gz |
|---|---|
| Size | 50.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
3c4e7b8fa1eee67ff96b46f9c847dd97bfd105f8bf2431749ca4b64691e06250
|
|
BLAKE2b-256 checksum How to use checksums |
ab0a3ec9386b37f9a01ba19919299222c9b292d9cfe62521753e75c2f4f5410d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Dec 8, 2025.
Transparency logRelease files / spk_derivatives-0.2.0-py3-none-any.whl
| Download URL | spk_derivatives-0.2.0-py3-none-any.whl |
|---|---|
| Size | 46.0 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
c87f60a20c58c81fe9f791157f7fd0666c0909e7791dac31897f911379ad6025
|
|
BLAKE2b-256 checksum How to use checksums |
53a01fe4be7584f5212d41a1956413c5ae1aef7ffb44ea339a3337b7c2d45032
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Dec 8, 2025.
Transparency log