Move lockdrop calculations to a module and add a experimentation notebook #2

Merged
nabarun merged 12 commits from pm-experimental-noteboook into main 2025-08-13 11:56:53 +00:00
Showing only changes of commit 792d97c39b - Show all commits

View File

@ -1,5 +1,22 @@
# lockdrop-simulation
## Overview
This repository provides two main ways to work with lockdrop calculations:
### Interactive Experimentation
For independent experimentation with lockdrop allocation scenarios, see [EXPERIMENT.md](./EXPERIMENT.md). This allows you to:
- Experiment with different participation distributions using an interactive Jupyter notebook
- Test various scenarios (balanced, five-year focused, short-term focused, etc.)
- Export timestamped results for analysis
### Full Simulation & Validation
Continue reading below for the complete simulation workflow that validates token distribution against a live zenithd node.
---
## Approach
The lockdrop simulation validates the Zenith Network's token distribution mechanism by creating a realistic test environment without requiring real Ethereum data or live participants.
@ -319,11 +336,3 @@ deactivate
# Remove virtual environment directory
rm -rf venv
```
## Interactive Experimentation
For independent experimentation with lockdrop allocation scenarios without running the full simulation, see [EXPERIMENT.md](./EXPERIMENT.md). This allows you to:
- Experiment with different participation distributions using an interactive Jupyter notebook
- Test various scenarios (balanced, five-year focused, short-term focused, etc.)
- Export timestamped results for analysis