docs: update Potatium v0.6 architecture and PoP research

This commit is contained in:
Michael Böhmländer committed 2026-10-25 11:45:32 +00:00
1 parent 75df8a5c0d
commit 862ccf1d03
34 files changed
+3257 -18

No files matched your search

+37 -2
View File
@@ -10,7 +10,7 @@
## M1: Konsens- und Coin-Regeln **zuerst**
- [x] Produktprinzip für **3 Mining-Fenster**, kostenloses Fenster 1, optionale fixe + progressive Zusatzgebühren für Fenster 2/3, 90-Tage-Mininggewinn als Basis, Burn, max. 1 Ticket dokumentiert (`ADR 0003`).
- [x] Produktprinzip für **3 Mining-Fenster**, kostenloses Fenster 1, optionale fixe + progressive Zusatzgebühren für Fenster 2/3, 90-Tage-Mininggewinn als Basis und max. 1 Ticket dokumentiert; **Gebührenverwendung durch ADR 0007 auf 100 % Fonds statt Burn geändert** (`ADR 0003`).
- [ ] Tokenomics mit Coinsupply, Genesis, Belohnung, Basis-Einheiten, Gebührensystem, Signatur-/Adressschema entscheiden.
- [ ] PoP-Runden/Fenster/Schwierigkeit/Nonce-Räume und Zahlungs-/Finalitätsbedingungen spezifizieren.
- [ ] Rein analytische, ausdrücklich nicht konsenskritische Simulation (5/10/20/50 Miner), Fairness- und Kostenvergleich.
@@ -36,7 +36,7 @@
## M5–M6: Bedienung und privates Mehrhost-Testnet
- [ ] UX, Explorer/Status, Dokumentation, Linux amd64/arm64-Releases, Sicherung/Recovery.
- [ ] Hosts über mehrere Geräte, Restart/Fault-Tests, Monitoring und Warnungen zur verbleibenden zentralen Registrierung.
- [ ] Hosts über mehrere Geräte, Restart/Fault-Tests, Monitoring und Ausfallprüfungen des optionalen Admin-Dienstes.
## F1–F4: Zukunftsvision, erst nach stabilem M6
@@ -50,3 +50,38 @@ Die folgenden Erweiterungen sind **als spätere Produktideen aufgenommen**, aber
**Abhängigkeit:** erst funktionsfähige Chain, sichere Web-Wallet, PoP, Mehrhost-Testnet und verifizierte Transaktionssignaturen. Vor jedem F-Schritt: neues ADR, Datenmodell, Sicherheits-/Risikobewertung und eigene Akzeptanztests. Kein Börsenlisting, keine Wert-/Gewinngarantie.
**Keine Implementierungs- oder Testergebnisse behaupten, die nicht tatsächlich ausgeführt wurden.**
## Ergänzende Arbeitspakete: Hub/Worker und Cluster (ADR 0005)
- [ ] **M1:** `operator_id`, Hub-/Worker-/Mining-Identitäten, Zweckreserve, Gebühren-Snapshot, 1 freier Hub-Mining-Platz/Operator und Mehridentitätsrisiken präzise spezifizieren; Worker-Preise/Obergrenze simulieren; Pi-4-Benchmark.
- [ ] **M2:** Vollständiger eigenständiger Hub inklusive **echter browserseitiger Wallet** und lokalem Status-Cockpit (keine serverseitigen Wallet-Keys), Devnet/Test-PTM.
- [ ] **M3:** Full-/Validator-Node-Status und sichere API, 1 dann 4 Validatoren. Worker sind keine Validatoren.
- [ ] **M4:** Hub-eigener PoP-Miner; Hub-gebundene Worker mit eindeutiger Registrierung, widerrufbarer Pairing-Autorisierung, Pre-Paid-Gebührenfreigabe, fristgerechten Proofs und 1 Ticket/ID/Runde.
- [ ] **M5:** Multi-Node-/Cluster-Ansicht für eigene Hubs/Worker, native amd64/arm64-Releases; optional später Docker, nicht im Entwicklungs-LXC.
- [ ] **M6:** Betreiber-/Worker-Recovery, Ausfall/Failover, Mehrhost, Registry-Audit und Admin-CLI/Web nach tatsächlichem Bedarf. Kein öffentlicher Adminzugang.
**Status:** Planung, nichts davon als implementiert markieren. Phase F1–F4 bleibt unverändert nach stabilem Testnet.
## Prioritätsanpassung v0.5: Infrastruktur und echte Cockpits ab Devnet (ADR 0006)
**Diese Aufgaben konkretisieren und priorisieren die Phasen M0–M6; sie ändern keine Emissions-, Mining- oder Gebührenwerte.**
- [ ] **M0/M1:** Systemrollen und klare Datenverantwortung dokumentieren, Protokoll von zentraler Admin/DB-Abhängigkeit freihalten. Read-only Network Admin und Teilnehmer-Hub-GUI als feste frühzeitige Lieferbestandteile festhalten. Bei Gerüstbetrieb ausschließlich „nicht verbunden“, keine simulierte Live-Chain.
- [ ] **M2, erstes lauffähiges Devnet:** Ein realer Validator/Go-App-Kern, eigenständiger synchronisierender Hub, Web-Wallet sobald sichere Transaktionsschnittstelle definiert, **lokales Hub-Status-Cockpit und separater read-only Network Admin** für Chain-ID, Blockhöhe, letzte Bestätigung, Sync/Fehleranzeige. Noch nicht implementiert.
- [ ] **M3:** Vier getrennte Validatoren und Netzwerkstatus in beiden Cockpits, AppHash-/Quorum-Überwachung, Restart-/Mehrprozess-Tests. Einheitliche echte Datenquellen und Stale/Offline-Erkennung.
- [ ] **M4:** Operator-/Mining-Registry, PoP, Gebührenreserve/Worker, Hub-Mining, sichere Pairing- und Fee-Freigabe, Monitoring aller echten Runden und Worker. Schreibende Admin-CLI nur mit Autorisierung.
- [ ] **M5/M6:** Multi-Hub-Clusteransicht und Mehrhost-Monitoring/Alerting vervollständigen, optionale Admin-Web-Schreibfunktionen *erst danach* nach Rechteprüfung. Native VM/Pi zuerst, Docker optional später. Sicherheits-, Backup-/Recovery-Tests.
Spezifikation: `docs/INFRASTRUKTUR_UND_DEPLOYMENT.md`, `docs/COCKPITS_UND_MONITORING.md`, ADR 0006. In der ursprünglichen M5-Phase ist der **Ausbau** von Status/Explorer gemeint, nicht erst der Start der Cockpits.
## Prioritätsanpassung v0.6: Vereinfachter Netzzugang, Identity Admin und Forschung (ADR 0008)
- [x] **M1 Forschung:** 36 Szenarien (1×/3×/5× Workergebühren, fix/dynamisch, Fonds halten/hypothetisch rückverteilen) in `docs/POP_DYNAMIK_FONDS_AUSWERTUNG_2026-10-25.md` dokumentiert. **Kein** Ergebnis als verbindliche Coin-/Gebührenregel kodiert.
- [ ] **M1:** On-chain-Identitäts-/Zulassungs- und Widerrufsmodell, Operator-/Node-/Mining-/Wallet-Schlüsseltrennung, Gebührenreserve und Fonds-Übertragungen in Integer-Basiseinheiten definieren. Bootstrap über überprüfbare lokale Chain-ID/Genesis/Peer-Liste, keine zentrale Benutzer-Registrierung.
- [ ] **M2:** Ein Validator mit Go-App, eigenständig synchronisierender Hub, funktionsfähige Web-Wallet und **read-only Network Admin ab dem ersten lauffähigen Devnet** mit echten Chain-/Validatorwerten und ehrlichem `nicht verfügbar` für künftige Statistiken. Alle Dienste initial gemeinsam auf `potatium-dev` in getrennten Prozessen möglich.
- [ ] **M3:** Vier separat konfigurierte Validatoren, AppHash-Tests, physische Hosttrennung später; Admin zeigt Peers/Quorum/Status.
- [ ] **M4:** On-chain-Operator-/Mining-Registry, manuell genehmigte signierte **Freigabe-/Sperraktionen im Admin** (getrennte Schlüssel/Signatur), Worker-Pairing, PoP und deterministische Fondsbuchung. Kein Backdoor-Guthaben, keine zentrale SQL-Freigabe.
- [ ] **M5/M6:** Native ARM64/AMD64-Distribution, Multi-Hub-Cluster, reale Pi-/Alt-PC-Mining-Last, optional geschützter `ptm-admin`-LXC und Heartbeat-Historie. Bootstrap-Fallback und Admin-Ausfall ohne Konsensabbruch testen.
- [ ] **M1 vor Tariffestlegung:** Pi-4-Hashmessungen, mindestens 10 Seeds und heterogene Betreiber-/Sybil-Szenarien, Definition zulässiger Fonds-Ausgaben. Erst danach neues Gebühren-/Emission-ADR.
Die frühere Pflicht-`potatium-network`-Registrierung nach ADR 0007 ist **durch ADR 0008 aufgehoben**. 100 % PoP-Fenster-/Workergebühren für den On-chain-Fonds bleiben beschlossen, 0 % Burn dieser Gebühren. Alle WebGUI-/Ledger-/Admin-Funktionen sind weiterhin **nicht implementiert**.