# 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.