docs: update Potatium v0.6 architecture and PoP research

2026-10-25 11:45:32 +00:00
1 parent 75df8a5c0d
commit 862ccf1d03
@@ -18,7 +18,7 @@ Go, CometBFT BFT/P2P und **eigene Potatium-ABCI++-Applikation**, zunächst **ohn

 **Eine PoP-Mining-Runde hat drei zeitlich aufeinanderfolgende Aufgabenfenster.** Die Fenster sind **keine separaten Blockchain-Runden**; die Blockzahl pro Fenster ist noch offen. Jede zugelassene Miner-Identität kann **maximal ein gültiges Ticket in der Gesamtrunde** erhalten. Erfolg in einem Fenster: Ticket, sofortiger Stopp für diese Runde.

-**Fenster 1 immer kostenlos.** Solange noch kein gültiges Ticket angenommen wurde, können **Fenster 2 und 3 freiwillig** genutzt werden, jeweils erst nach bestätigter **fixer Grundgebühr plus progressiver Zusatzgebühr**. Höhere Kosten und abnehmender zusätzlicher Qualifikationsnutzen sollen Fenster 3 weniger attraktiv machen. Gebührenmaßstab: **finalisierte PoP-Mining-Gewinne des Miners/der zugeordneten Betreibergruppe im gleitenden Zeitraum der letzten ca. 90 Tage**, **nicht das aktuelle Wallet-Guthaben**. Kein lebenslang kumulierender Erfolgsbonus/-malus; ältere Gewinne fallen heraus. Gebühren für Zusatzfenster werden **verbrannt**. Normale Transaktionsgebühren sollen Validatoren finanzieren; genaue Verteilung weiter offen.
+**Fenster 1 immer kostenlos.** Solange noch kein gültiges Ticket angenommen wurde, können **Fenster 2 und 3 freiwillig** genutzt werden, jeweils erst nach bestätigter **fixer Grundgebühr plus progressiver Zusatzgebühr**. Höhere Kosten und abnehmender zusätzlicher Qualifikationsnutzen sollen Fenster 3 weniger attraktiv machen. Gebührenmaßstab: **finalisierte PoP-Mining-Gewinne des Miners/der zugeordneten Betreibergruppe im gleitenden Zeitraum der letzten ca. 90 Tage**, **nicht das aktuelle Wallet-Guthaben**. Kein lebenslang kumulierender Erfolgsbonus/-malus; ältere Gewinne fallen heraus. Gebühren für Zusatzfenster und Worker werden **zu 100 % dem On-chain-Fonds gutgeschrieben; 0 % Burn**. Normale Transaktionsgebühren sollen Validatoren finanzieren; genaue Verteilung weiter offen.

 Leichte echte kryptografische Arbeit (SHA-256 als Kandidat) mit **begrenztem pro-Identität-Nonce-Raum** und erst zum Fensterstart freigeschalteter Herausforderung. GPU/ASIC-/CPU-Wettrennen vermeiden; stärkere CPUs können schneller rechtzeitig fertig werden, vollständige Hardware-Gleichheit nicht behaupten. Pi-4-Benchmarks und Simulationen mit 5/10/20/50 Minern vor Festlegung der Schwierigkeit/Kosten. Begrenzter Nonce-Raum garantiert **keine** reale Arbeitszeit; erfolglose Versuche sind nicht beweisbar.

@@ -39,3 +39,8 @@ Keine privaten Schlüssel, Seeds, Tokens, Passwörter, `data/`, Binaries, echte
 ## Reihenfolge

 M1: offenen Parameterkatalog + Simulation/Fairness/Pi-4-Benchmark + ADR. M2: Ledger/Keys/Accounts/Tx/Genesis mit Tests und **parallel funktionale Web-Wallet**, sobald Tx-/Signaturschnittstelle feststeht. M3: CometBFT anbinden, 1 dann 4 Validatoren mit Synchronisation/Ausfällen. M4: drei PoP-Fenster, Identity-Registry, Kosten/Autorisierung, Burn, Proof, Ticketcommit, RNG/Mint mit harten Negativtests. M5: Wallet fertig, Explorer/Status, ARM64-Builds/Pi-Vergleich. M6: Mehrhost-Privat-Testnet, Backup/Recovery, Doku, Release. Fokus: wartbares, lehrreiches Hobbyprojekt statt öffentlichem Mainnet.
+
+
+## Aktualisierung 25.10.2026 · ADR 0008 und Forschung
+
+**Neuere Entscheidung hat Vorrang:** Kein verpflichtender `potatium-network`-Registrierungsserver. Hub synchronisiert per lokaler Chain-ID/Genesis/CometBFT-Peers; Mining-Zulassung ausschließlich per On-chain-Registry und signierter Admin-Freigabe/Sperre. Separater Network Admin ab erstem lauffähigem Devnet: lesende globale Supply-/Burn-/Fonds-/Parameter-/Identitäts-/Validatoransichten, keine Fake-Werte. Der vorhandene Homelab-Installationsplan ist `docs/INSTALLATIONSPLAN_HOMELAB.md`. Gebührenhöhe/Emission/Maximalworker und Fondsausgaben bleiben offen. 36-Läufe-Simulation ist lediglich Forschung: `docs/POP_DYNAMIK_FONDS_AUSWERTUNG_2026-10-25.md`.
@@ -0,0 +1,13 @@
+> **HISTORISCHER STAND v0.5:** Die damals verpflichtende zentrale `potatium-network`-Anmeldung wurde durch ADR 0008 verworfen. Aktuell gilt `docs/NETWORK_ZUGANG_UND_IDENTITAETEN.md`. Die 100-%-Fondsentscheidung bleibt gültig.
+
+# Repo-Update v0.5: Gesamtinfrastruktur und erste Cockpits
+
+Stand 25.10.2026, ausgehend vom unveränderten Referenzstand v0.4.0. Keine Go-/ABCI++-/Web-Implementierung. Nur Planung, README, AGENTS und ADR 0006.
+
+Akzeptierte Betriebsentscheidung: Projektbetreiber betreibt initial Validatoren; alle Full Nodes halten ihren eigenen Chain-/App-State; kein zentraler Coin-Server. Potatium Hub und separater read-only Network Admin mit **echtem Status** ab erstem lauffähigem Devnet, bei zunächst fehlender Chain nur ehrliche Fehlerzustände. Cluster-Ansicht eigener Hubs/Worker und Betreiber-Admin sind weiterhin verschiedene Rollen. Docker optional später, kein Docker-in-LXC. Alte Gebühren-Burn-Regel nicht still geändert, Verwendung wird nach Forschung bewusst zu entscheiden sein.
+
+**Nach Anwendung:** `git diff --check`, `git diff`, `go test ./...`, `go vet ./...`, Tests nur als tatsächlich ausgeführt angeben. Vor Protokoll-/Wallet-/API-Implementierung Versionen, konkrete Signaturen, Monitoring-Auth und Datenbank festlegen. Keine Geheimnisse/Chain-State committen.
+
+## Integrierte finale Entscheidung: Network Services und On-chain-Fonds
+
+Die zunächst rein lesende Admin-Infrastruktur wird durch einen separaten Betreiber-Service `potatium-network` ergänzt: verifizierter Bootstrap, Operator-Registrierungsanträge, Inventar und signierte Heartbeats mit **eigener Off-chain DB**. Registrierung muss durch **gesonderte signierte On-chain-Admin-Aktion** finalisiert werden. Es handelt sich nicht um eine zentrale Chain-/Guthaben-Datenbank. Hub-P2P-/Walletbetrieb wird nicht vom zentralen Service je Block autorisiert. Gebührenverwendung ist nun beschlossen: **100 % PoP-/Worker-Gebühren an On-chain-Fonds, 0 % Burn**; Tx-Gebühren und Fonds-Ausgaben weiterhin offen. Siehe ADR 0007 und `docs/NETWORK_SERVICES_UND_ONBOARDING.md`.
@@ -0,0 +1,9 @@
+# Dokumentations- und Forschungsupdate v0.6 (25.10.2026)
+
+Ziel: Auswertung der 36 PoP-Dynamik-/Fonds-Läufe nachvollziehbar sichern; die inzwischen verworfene Pflicht zu zentralen Network Services/Registrierungsportal konsistent aus den *aktuellen* Handlungsanweisungen ersetzen; Infrastrukturplan und frühe Netzwerk-Admin-Identitätsverwaltung als feste Produktplanung integrieren.
+
+**Produktentscheidungen:** (1) keine zentrale Registrierung für P2P, (2) PoP-Registry on-chain mit signierter Freigabe/Sperre, (3) Network Admin und Hub-Cockpit ab erstem Devnet mit echten Daten, (4) 100 % PoP-/Workergebühren an Fonds, 0 % Burn dieser Gebühren. **Nicht entschieden:** Gebührenskalierung 1×/3×/5×, 1 PTM/Runde, 720 Runden/Tag, 10-Worker-Kappe, periodische Fonds-Ausschüttung oder zukünftige Finanzierungsmodelle.
+
+**Implementierungsstatus:** Nur Markdown-/CSV-Dokumentation und Python-Monte-Carlo-Simulation mit Tests; keine Blockchain, Wallet, Identitätsfreigabe oder CometBFT-Integration funktionsfähig.
+
+**Verifikation:** `python3 -m unittest discover -s tests -p 'test_pop_dynamic.py' -v`, `go test ./...`, `go vet ./...`, `git diff --check`; der sichere Update-Plan prüft SHA256-Basisstände und bricht bei geänderten lokalen Dateien ab. Siehe Paket-README. Ohne Zugriff auf das echte Gitea-Repo keine Aussage zum dortigen Git-/Implementierungsstand.
@@ -12,7 +12,7 @@ Du bist technischer Architekt, leitender Go-Entwickler und Reviewer für **Potat

 - Pro Mining-**Runde** genau drei nacheinander freigeschaltete **Fenster** (nicht 3 Blockchain-Runden); je zugelassene Mining-Identität maximal **ein** Ticket je Gesamtrunde.
 - Fenster 1 kostenlos; Fenster 2 und 3 freiwillig solange noch kein Ticket angenommen wurde, mit **fixer plus progressiver Gebühr**. Progressionsbasis = zugeordnete PoP-Gewinne der zurückliegenden **ca. 90 Tage**, **nicht** aktuelles Wallet-Guthaben; kein lebenslanger Malus.
- Kosten von Fenster 3 höher bei sinkendem Grenznutzen; zusätzliche Gebühren werden verbrannt. Überweisungsgebühren sind separat für Validatoren vorgesehen, Verteilungsmechanik offen.
+- Kosten von Fenster 3 höher bei sinkendem Grenznutzen; zusätzliche PoP-/Worker-Gebühren gehen zu 100 % in den On-chain-Fonds; 0 % Burn dieser Gebühren. Überweisungsgebühren sind separat für Validatoren vorgesehen, Verteilungsmechanik offen.
 - Schwache Rechner/Pi 4 sollen begrenzte SHA-256-PoW-Aufgaben rechtzeitig bearbeiten können, harte Fairness- und Sybil-Grenzen dokumentieren. Für die Ziehung muss die Ticketliste vor Bekanntwerden des überprüfbaren künftigen Zufallswerts gebunden sein.
 - CometBFT/ABCI++ mit eigener Go-App ist Architekturpräferenz, **ohne Cosmos SDK**. Blockvalidator und Miner sind getrennt.
 - Web-Wallet mit echter Kontoerstellung/Import/verschlüsseltem Backup, Balance, Senden/Empfangen, Status, History, Lock/Unlock gehört **ab erstem funktionalem MVP** dazu. Bestehende UI ist nur statische Vorschau. Niemals Backend-/Minerzugriff auf private Browser-Wallet-Schlüssel.
@@ -31,3 +31,12 @@ Du bist technischer Architekt, leitender Go-Entwickler und Reviewer für **Potat
 ## Spätere Vision, vorerst ausdrücklich NICHT implementieren

 Nach stabilen M1–M6-Meilensteinen sind digitale Sammlerstücke, ein PTM-Marktplatz und eine interne Handelsplattform für fiktive Assets/Kurse/Portfolio sowie optional getrenntes Paper-Trading vorgesehen. Details: `docs/ZUKUNFT_OEKOSYSTEM.md` und ADR 0004. **Kein** Asset-/Börsen-/NFT-Code jetzt, keine neuen Dependencies deswegen und keine Veränderung beschlossener PoP-Regeln. Im aktuellen Schritt bei M1 und anschließend Ledger/Web-Wallet bleiben.
+
+## Neue zu berücksichtigende Architekturentscheidung (ADR 0005)
+
+Vor nächsten Designänderungen `docs/HUB_WORKER_CLUSTER.md`, `docs/WORKER_GEBUEHREN_FORSCHUNG.md` und `docs/decisions/0005-hub-worker-cluster-und-betreiber.md` lesen. Zwei geplante Pakete: voller eigenständiger Hub mit Browser-Wallet/Status/PoP/Cluster-Cockpit; Hub-gebundener Lightweight-Worker nur mit signierender Geräte-ID, **keine** Geld-Wallet. Betreiber-Identität aggregiert sämtliche Gewinne/Fees; genau ein gebührenfreier Hub-Mining-Platz je Betreiber; andere Hub-Miner zählen wirtschaftlich als Worker. Jedes zugelassene Mining-ID maximal 1 Ticket/Runde. Seed/Private Wallet Key nur im Browser. Gebühren vor Challenge; Staffelbeträge und Worker-Limit sind **Forschungsparameter, nicht zu implementieren**. Priorität Hub-/Cluster-Cockpit vor Admin-Web; Admin-CLI später bei Bedarf. Nichts aus den Docs als bereits implementiert ausgeben.
+
+
+## Aktualisierung 25.10.2026 · ADR 0008 und Forschung
+
+**Neuere Entscheidung hat Vorrang:** Kein verpflichtender `potatium-network`-Registrierungsserver. Hub synchronisiert per lokaler Chain-ID/Genesis/CometBFT-Peers; Mining-Zulassung ausschließlich per On-chain-Registry und signierter Admin-Freigabe/Sperre. Separater Network Admin ab erstem lauffähigem Devnet: lesende globale Supply-/Burn-/Fonds-/Parameter-/Identitäts-/Validatoransichten, keine Fake-Werte. Der vorhandene Homelab-Installationsplan ist `docs/INSTALLATIONSPLAN_HOMELAB.md`. Gebührenhöhe/Emission/Maximalworker und Fondsausgaben bleiben offen. 36-Läufe-Simulation ist lediglich Forschung: `docs/POP_DYNAMIK_FONDS_AUSWERTUNG_2026-10-25.md`.