Files
potatium/docs/POP_GEBUEHREN_VERTEILUNG_FORSCHUNG.md
T

69 lines
4.0 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# PoP-Gebührenverteilung: Forschungsanalyse
**Kein Konsens-Code. Keine neuen beschlossenen Coinparameter.** Das Skript benutzt `float` nur für die Offline-Modellrechnung. In der Blockchain sind ausschließlich deterministische ganzzahlige Basiseinheiten vorgesehen.
## Motivation
Die bisherige PoP-Cluster-Simulation zieht Worker- und Fenster-Gebühren vom Betreiber-Wallet ab und **verbrennt** sie. Die Gebühren begrenzen die wirtschaftliche Attraktivität zusätzlicher Mining-IDs, aber ein hoher Burn entzieht der späteren geschlossenen Sammler-/Marktplatz-Ökonomie Coins.
Gebührenhöhe und Gebührenziel sind daher **getrennte Designentscheidungen**:
- Gebühr: wie stark kostet zusätzlicher Worker bzw. Fenster 2/3?
- Ziel: Verbrennung, Validatoren, gesonderter Ökosystem-Fonds oder Mischung?
- Empfängeridentität: Validator und Betreiber können in der Praxis dieselbe Person sein. Dadurch verändern sich ökonomische Anreize und möglicherweise die Mining-Strategie.
## Off-chain-Forschungsprofile
| Name | Burn | Validatoren | Fonds |
|---|---:|---:|---:|
| `burn_100` | 100 % | 0 | 0 |
| `validators_100` | 0 | 100 % | 0 |
| `treasury_100` | 0 | 0 | 100 % |
| `validators_80_treasury_20` | 0 | 80 % | 20 % |
| `validators_70_treasury_25_burn_5` | 5 % | 70 % | 25 % |
| `worker_treasury_window_validators` | 0 | Fenster-Gebühren | Worker-Gebühren |
Die vier Validatoren sind in diesem Skript **separate, gleichberechtigte Empfängerkonten**, keine Mining-Betreiber. Es gibt keine privaten Schlüssel und keine automatischen Auszahlungen. Das Community-Fonds-Guthaben gilt im Modell als vorerst reserviert. Der Gini-Koeffizient umfasst nur Mining-Betreiber und darf **nicht** zur Gesamtverteilung inklusive Validatoren/Fonds umgedeutet werden.
## Installation und Ausführung
Dieses Paket fügt `scripts/analyze_pop_fee_flows.py` und `tests/test_pop_fee_flows.py` neu hinzu und **ändert die bestehende Cluster-Simulation nicht**.
```bash
cd ~/src/potatium
python3 -m unittest discover -s tests -p 'test_pop_fee_flows.py' -v
python3 scripts/analyze_pop_fee_flows.py \
--input ~/potatium-simulation.zip \
--out ~/potatium-fee-analysis
```
Die bisherige ZIP kann alternativ auch als Dateiverzeichnis eingelesen werden: `--input ~/potatium-simulation`.
Eigene prozentuale Verteilung für Worker- und Fenster-Gebühren (Reihenfolge **Burn, Validatoren, Fonds**, Summe 100):
```bash
python3 scripts/analyze_pop_fee_flows.py \
--input ~/potatium-simulation.zip \
--custom-worker 0,50,50 --custom-window 0,90,10
```
Die Ausgabe liegt in `~/potatium-fee-analysis/potatium-fee-analysis.zip` und kann in den Chat hochgeladen werden.
## Rechnung und Invariante
`gesamt_vorher = Genesis + Minting`, `gesamt_nachher = gesamt_vorher - Burn`.
`gesamt_nachher = Miner-Wallets + Validator-Konten + Treasury-Konto`.
Alle vorgegebenen Gebühren bleiben **vollständig vom Miner bezahlt**. Deshalb bleiben bei gleicher Ausgangssimulation die Mining-Ergebnisse und das Netto-Guthaben des Miners gleich, ob eine Gebühr verbrannt oder an externe Empfänger gezahlt wird.
**Diese Analyse rechnet Einnahmen nur buchhalterisch um**. Sie ist keine neue Simulation, wie sich Empfänger später verhalten und die erhaltenen PTM ausgeben. Bei Rückflüssen an Miner, gleichzeitig validatorenden Minern, gedeckelten Guthaben, Fonds-Ausschüttungen und Ein-/Ausstieg von Betreibern muss die eigentliche Mining-Simulation erweitert und erneut ausgeführt werden.
## Nächste Prüfung
- Original-Gebühren ×1 / ×3 / ×5 mit echten konkurrierenden Betreiber-Clustergrößen und mindestens zehn Seeds vergleichen.
- Auszahlung an Validatoren mit **Überlappung von Validator- und Miner-Rollen** modellieren, inklusive Rückflüssen ins Miningbudget.
- Fonds mit transparentem Mandat und Auszahlungsregeln simulieren; Nichtnutzung parkt Coins faktisch.
- Regeln zu Gebührenbelastung, progressiven 90-Tage-Erfolgen und maximal erlaubter Mining-Kapazität getrennt festlegen.
- Protokoll-ADR erst nach ökonomischer sowie Sicherheitsprüfung erstellen; derzeit nur Forschung.