docs: add PTM ecosystem vision and README roadmap

This commit is contained in:
Michael Böhmländer committed 2026-10-25 07:45:24 +00:00
1 parent 7397045a54
commit 75df8a5c0d
10 files changed
+268 -21

No files matched your search

+45
View File
@@ -0,0 +1,45 @@
# Potatium: Offline-Langzeitsimulation v0.1
Diese Dateien sind eine **nicht konsenskritische Forschungs-Simulation** und aendern keine Blockchain-Funktionen.
## Installation im bestehenden Repo
Archiv so entpacken, dass `scripts/simulate_pop_longterm.py` und `tests/test_pop_longterm.py` neben den bisherigen Dateien liegen. Es werden keine bisherigen Dateien ersetzt.
```bash
cd /home/potatium/src/potatium
python3 -m unittest discover -s tests -p 'test_pop_longterm.py' -v
python3 scripts/simulate_pop_longterm.py --miners 20 --days 7 --rounds-per-day 72
```
## Aussagekraeftiger Vergleich
Die Ergebnisse werden standardmaessig ausserhalb des Git-Repositorys unter `~/potatium-simulation/` abgelegt.
```bash
python3 scripts/simulate_pop_longterm.py --miners 20 --days 180 --profile original --strategy mixed --fee-model original
python3 scripts/simulate_pop_longterm.py --miners 20 --days 180 --profile balanced --strategy mixed --fee-model mild
python3 scripts/simulate_pop_longterm.py --miners 20 --days 180 --profile balanced --strategy mixed --fee-model low
python3 scripts/simulate_pop_longterm.py --miners 50 --days 180 --profile balanced --strategy rational --fee-model mild
```
`original` = 70/70/70 Prozent je Fenster, `balanced` = 55/30/20 Prozent, `cautious` = 50/30/20 Prozent.
Gebuehrenmodelle: `original` = v0.2 Staffel; `mild` = Staffel nur 10% so stark; `low` = Staffel nur 1% so stark. Fixkosten bleiben 0.001 PTM fuer Fenster 2 und 0.003 PTM fuer Fenster 3.
Strategien: `free` = immer nur Fenster 1; `always` = Zusatzfenster nach Fehlschlag sofern bezahlbar; `rational` = einfache Kosten-Nutzen-Heuristik; `mixed` = ein Viertel `free`, Haelfte `rational`, ein Viertel `always`.
## Daten zum Teilen
`*.txt` enthaelt die Kernauswertung, `*.json` alle Simulationsdaten, `*_miners.csv` die individuellen Ergebnisse und `*_daily.csv` die Tagesentwicklung. Sende zunaechst die **TXT-Dateien**; fuer tiefergehende Auswertungen die JSON- oder CSV-Dateien.
## Wesentliche Modellgrenzen
- Ein registrierter Miner entspricht einer Identitaet; Sybil/Mehrgeraete ist nicht modelliert.
- Die Rechenraetsel sind Bernoulli-Wuerfe mit vorgegebenen Erfolgswahrscheinlichkeiten, keine echten Hashbenchmarks.
- Gleicher erwarteter Anteil pro Ticket; externe Zufallsbeacons und zensierende Validatoren fehlen.
- PTM-Auszahlungen werden als Guthaben verbucht, Fenster-Gebuehren werden verbrannt; kein Handel, keine Ueberweisungen, keine Stromkosten.
- Die 90-Tage-Basis ist **nur im Mining erworbener PTM-Ertrag** je registrierter Identitaet; Wallet-Transfer veraendert sie nicht.
- Der Strategiealgorithmus nutzt nur eine Heuristik, keine optimale oder strategisch stabile Spieltheorie.
- Float-Arithmetik **nur Simulation**, niemals On-chain.
- Alle Tarife, Wahrscheinlichkeiten, 2-Minuten-Runde, Emission und Grenzwerte sind unverbindliche Forschungsannahmen.