Skip to main content

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 analysis
  • monte_carlo.py – Monte Carlo simulation with confidence intervals
  • sensitivities.py – Greeks computation (delta, gamma, vega, theta, rho)
  • plots.py – Publication-quality visualizations
  • data_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)

Source distribution for spk-derivatives 0.2.0
File Size Uploaded
spk_derivatives-0.2.0.tar.gz 50.2 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for spk-derivatives 0.2.0
File Interpreter ABI Platform
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 log

Release 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

Release history Release notifications | RSS feed

This release

0.2.0 This release

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page