diff --git a/AGENTS.md b/AGENTS.md index c703b36..427aed7 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -10,3 +10,7 @@ 8. **Tests:** Go `gofmt`, `go test ./...`, `go vet ./...`; passende Integrationstests, fuzzer/race tests. Für PoP Simulation und Pi 4 / Office-PC Benchmark, Fairness, Gebühren-Erwartungswerte, abweichenden Codepfad, Replay, Burn und Restart. Tests und Resultate **nie erfinden**. 9. **Sicherheit:** keine öffentlich gebundenen Test-APIs (nur `127.0.0.1`/SSH-Forward), keine echten Schlüssel/Tokens/Datenbank-/Wallet-Dateien in Git. Keine unverhältnismäßigen Dependencies, keine destruktiven Befehle ohne Backup. Entgeltliche Chance auf Lotteriegewinn birgt Rechtsrisiko; bis auf Weiteres **wertlose private Test-PTM**. 10. **Lieferstil:** Vor jeder größeren Änderung kurze Planung + Akzeptanzkriterien; danach Dateien/Änderungen, was real läuft, Testbefehle mit Ergebnissen, Grenzen und nächsten kleinen Schritt angeben. ADR für wesentliche Entscheidungen. + +## Zukunftsvision F1–F4 (25.10.2026) + +Geplante **spätere** PTM-Nutzungen sind digitale Sammlerstücke, ein interner PTM-Marktplatz und eine Handelsplattform für fiktive interne Assets mit Orderbuch, Kursen und Portfolio, optional mit **strikt getrenntem** Paper-Trading. Sie sind **noch nicht implementiert** und erfordern nach M6 eigene ADRs, sichere Eigentums-/Handelsabwicklung und klare Kennzeichnung interner vs. simulierter Kurse. **Nicht** auf Initiative von Codex vorziehen, keine Cosmos-/NFT-/DEX-Frameworks ungefragt integrieren, keine echten Preise oder Volumina erfinden. Sammlerstücke/Assetbesitz dürfen PoP-Chancen nicht erhöhen. Maßgeblich: `docs/ZUKUNFT_OEKOSYSTEM.md`, `docs/decisions/0004-zukunftsvision-internes-oekosystem.md`. diff --git a/README.md b/README.md index 876e0fc..9e1366c 100644 --- a/README.md +++ b/README.md @@ -1,36 +1,74 @@ -# 🥔 Potatium (PTM) +

+ Potatium PTM Logo: goldenes geometrisches P auf Schwarz +

-**Eigene Hobby-Layer-1 mit sparsamer Mining-Lotterie „Proof of Potato“.** Das goldene abstrakte PTM-Logo liegt unter `assets/logo/potatium-ptm-logo.png`. +

🥔 Potatium (PTM)

-**Stand 25.10.2026: nur Go-Projektgerüst und statische Web-Wallet-Vorschau; keine echte Blockchain, kein Minting und keine funktionale Wallet.** Vorerst ausschließlich privates Testnetz mit wertlosen Test-PTM. +

Eine eigenständige Hobby-Blockchain mit Proof of Potato.
+Ressourcenarm · Raspberry-Pi-tauglich · lokal kontrollierte Web-Wallet · privates Testnetz

-## Entwicklungsumgebung +> **Projektstatus, 25.10.2026:** Entwicklungsgerüst und statische Web-Wallet-Vorschau vorhanden. Eine funktionsfähige Chain, echte PTM-Transaktionen, PoP-Mining, Sammlerstücke oder eine Börse sind **noch nicht implementiert**. Kein Anlageprodukt, kein Kursversprechen. Ausschließlich private, nicht einlösbare Test-PTM. -- Ubuntu **26.04 LTS** als unprivilegierter Proxmox-LXC `potatium-dev` -- Benutzer `potatium`, Workspace **`/home/potatium/src/potatium`** -- Go, Git-Monorepo auf privatem Gitea, VS Code per Remote-SSH mit OpenAI Codex -- Zunächst kein Docker-in-LXC und keine PostgreSQL-Pflicht +## Was ist Potatium? -## Neues Mining-Konzept v0.2 +Potatium soll eine **eigene Layer-1-Blockchain in Go** werden, kein ERC-20-Token. Ein kleines privates Netzwerk aus alten PCs und Raspberry Pis betreibt die Chain. Vorgesehen sind **CometBFT / ABCI++** mit einer eigenen deterministischen Anwendung, zunächst ohne Cosmos SDK; die tatsächlichen Versionen und Architekturdetails werden vor Implementierung geprüft. -Je **einer Mining-Runde** gibt es **drei aufeinanderfolgende Aufgabenfenster**. Das erste ist kostenlos; Fenster 2 und 3 können solange kein Ticket vorliegt freiwillig gegen **fixe und progressive** Kosten benutzt werden. Grundlage der Progression sind die **PoP-Mining-Gewinne der letzten ca. 90 Tage** je registrierter Identität/Betreibergruppe, nicht das Wallet-Guthaben. Gebühren zusätzlicher Fenster werden **verbrannt**. Nach einem erfolgreichen Proof erhält die Identität maximal **ein Ticket** für die spätere, überprüfbare Gewinnziehung. **Alle konkreten Zahlen bleiben bis zu Simulation und Pi-Benchmark offen.** Mehr: `docs/PROTOKOLL_ENTWURF.md`, `docs/POP_FAIRNESS_UND_GEBUEHREN.md`, ADR 0003. +- **PTM:** Coin für Überweisungen, Mining-Belohnungen und später interne Anwendungen. +- **Proof of Potato (PoP):** Miner lösen leichte, begrenzte Rechenaufgaben. Validatoren produzieren und bestätigen die Blockchain-Blöcke, PoP-Miner nicht. +- **Web-Wallet ab funktionalem MVP:** Schlüssel und Signaturen bleiben im Browser; die API bekommt niemals Seed oder Private Key. +- **Keine reale Wertzusage:** PTM ist ein Hobby-/Testnet-Coin ohne garantierte Einlösung in Geld oder andere Kryptowährungen. -## Bestandteile +## Proof of Potato: aktueller Produktentwurf -- `cmd/potatiumd`, `cmd/potatium-miner`, `cmd/potatium-cli`: geplante ausführbare Go-Programme; bisher teils nur Gerüste. -- `internal/`: Zustandslogik, Kryptografie, Registrierung, Proof, Lottery, Persistenz und API. -- `web/wallet`: **statische Webvorschau**, keine Keys/realen Kontostände; echte Web-Wallet bleibt Pflicht **ab funktionalem MVP**. -- `docs/`: Gesamthandbuch, Projektplan, Protokoll, Roadmap, ADRs. -- `AGENTS.md`: bindender Arbeitskontext für Codex. +Eine Mining-Runde enthält **drei aufeinanderfolgende Aufgabenfenster**. Fenster 1 ist für zugelassene Miner kostenlos. Wer noch kein gültiges Ticket hat, kann Fenster 2 und 3 gegen **fixe und progressive Gebühren** freischalten. Maßstab für die Progression sind zurechenbare **PoP-Gewinne eines gleitenden Zeitraums von ungefähr 90 Tagen**, nicht die aktuelle Wallet-Balance. Gebühren der Zusatzfenster werden verbrannt. Pro freigegebener Mining-Identität wird **höchstens ein Ticket je Gesamtrunde** akzeptiert. Nach Abschluss bestimmt eine später überprüfbare Zufallsquelle den Gewinner. -## Checks und Vorschau +Die exakten Gebühren, Erfolgswahrscheinlichkeiten, Fensterlängen, Emissionsregeln und Coinparameter sind **noch nicht beschlossen**. Simulationen wie „Balanced + Low“ sind ausschließlich Forschungsmodelle. Details: [PoP-Fairness und Gebühren](docs/POP_FAIRNESS_UND_GEBUEHREN.md), [Protokollentwurf](docs/PROTOKOLL_ENTWURF.md) und [ADR 0003](docs/decisions/0003-pop-fenster-und-gebuehren.md). + +## Roadmap + +Die Statusangaben trennen **bereitgestellte Gerüste**, **offene Entscheidungen** und **noch nicht begonnene Funktionen**. Ein erfolgreiches `go test` für das Gerüst beweist keine funktionierende Blockchain. + +| Phase | Ziel | Status | +|:--|:--|:--| +| **M0 · Entwicklungsbasis** | Ubuntu-LXC, Go, Git, VS Code, Node-/Miner-/Wallet-Gerüste | 🟡 Gerüst vorhanden; Git-/Remote-Stand separat verifizieren | +| **M1 · Protokoll und Ökonomie** | Coin-/Transaktionsregeln, PoP-Gebühren, Simulationen, Pi-4-Benchmark, ADRs | 🟡 In Planung und Forschung | +| **M2 · Chain-Kern + echte Web-Wallet** | Konten, Signaturen, Transfers, persistenter State; Wallet lokal erstellen/importieren, senden/empfangen | ⬜ Offen | +| **M3 · Konsensnetz** | CometBFT, zunächst 1, dann 4 Validatoren, Synchronisation und Ausfalltests | ⬜ Offen | +| **M4 · Proof of Potato** | Registry, 3 Fenster, Gebühren/Burn, Tickets, überprüfbare Ziehung, Reward, Negativtests | ⬜ Offen | +| **M5 · Bedienung & Hardware** | Wallet fertigstellen, Status/Explorer, Linux amd64/arm64, Raspberry-Pi-Benchmarks | ⬜ Offen | +| **M6 · Privates Testnet** | Mehrhost-Betrieb, Recovery, Sicherheit, Dokumentation, Test-Releases | ⬜ Offen | +| **F1 · Digitale Sammlerstücke** | Einzigartige/limitierte interne Gegenstände, Ownership, Sammlung in der Wallet | 💡 Zukunftsidee | +| **F2 · PTM-Marktplatz** | Sammlerstücke in PTM anbieten, kaufen und zwischen Nutzern übertragen | 💡 Zukunftsidee | +| **F3 · Interne Asset-Börse** | Fiktive, interne Assets in PTM handeln; Orderbuch, Kurse, Charts, Historie, Portfolio | 💡 Zukunftsidee | +| **F4 · Börsenlabor** | Optional getrennter Paper-Trading-Modus, Indikatoren, Auswertungen und Szenarien | 💡 Zukunftsidee | + +**Die Zukunftsphasen F1–F4 beginnen ausdrücklich erst, wenn die Kern-Chain inklusive Wallet und privatem Testnet zuverlässig funktioniert.** Es gibt keinen beschlossenen Termin und keine Implementierungszusage. Die vollständige [Roadmap](docs/ROADMAP.md) und die [Zukunftsvision für das interne Ökosystem](docs/ZUKUNFT_OEKOSYSTEM.md) beschreiben die Abhängigkeiten und offenen Fragen. + +## Später: Was kann man mit PTM anfangen? + +Die Coin-Nutzung soll langfristig **über Mining-Gebühren hinausgehen**. Vorgesehen sind als mögliche spätere Erweiterungen digitale Kartoffel-Sammlerstücke und ein interner Marktplatz mit PTM als Zahlungsmittel. Danach könnte eine kleine **interne Handelsplattform** entstehen, auf der man fiktive Assets handeln und Kursentwicklungen, Orders, Handelsvolumen und Portfolios verfolgen kann, ohne dass PTM in Euro oder externe Kryptowährungen umtauschbar sein muss. + +Interne Marktpreise wären **PTM-Preise aus tatsächlich abgeschlossenen internen Trades**, keine behaupteten Euro-Werte. Ein möglicher Lern-/Paper-Trading-Modus wäre klar von echter interner PTM-Buchführung getrennt. Keine Sammlerstücke, Assets oder gekauften Funktionen sollen zusätzliche PoP-Lose oder unbegrenzte Mining-Vorteile verschaffen. + +## Repository und Entwicklung + +| Pfad | Zweck | +|:--|:--| +| `cmd/potatiumd`, `cmd/potatium-miner`, `cmd/potatium-cli` | Geplante Go-Programme, derzeit Gerüste | +| `internal/` | Künftige App-, Ledger-, Mining- und Konsenslogik | +| `web/wallet/` | Derzeit **statische UI-Vorschau**, keine funktionale Wallet | +| `docs/` | Protokoll, Projektplan, Roadmap, Zukunftsvision und Entscheidungen | +| `assets/logo/potatium-ptm-logo.png` | **Ausgewähltes unverändertes Projektlogo** | +| `AGENTS.md` | Arbeitsregeln für Codex | + +Entwicklungsumgebung: unprivilegierter Ubuntu-26.04-LXC `potatium-dev`, Benutzer `potatium`, Repository unter `/home/potatium/src/potatium`, VS Code via Remote-SSH und Codex. Testserver ausschließlich auf `127.0.0.1`. ```bash cd /home/potatium/src/potatium bash scripts/doctor.sh -make run-ui +make run-ui # Nur statische lokale Web-Wallet-Vorschau ``` -`make run-ui` bindet nur an `127.0.0.1:8080`; im VS-Code-Remote-Portforwarding öffnen. Keine echten Wallet-Schlüssel oder Coins verwenden. +Nicht mit echten Schlüsseln oder Guthaben experimentieren. `data/`, Seeds, Passwörter, Zugangsdaten und generierte Binaries gehören nicht in Git. -**Nächster Schritt:** M1-Parameter (Coin/Signatur/PoP-Fees) per Simulation und ADR bestätigen, danach Ledger/Web-Wallet beginnen. Startprompt: `handoff/STARTPROMPT_VSCODE_CODEX.md`. +**Nächster Schritt:** M1-Protokollparameter sauber festlegen und PoP-Simulation mit Raspberry-Pi-Messungen abgleichen, bevor konsenskritischer Code entsteht. [Projektplan](docs/PROJEKTPLAN.md) · [Gesamthandbuch](docs/GESAMTHANDBUCH.md) · [Codex-Startprompt](handoff/STARTPROMPT_VSCODE_CODEX.md). diff --git a/docs/GESAMTHANDBUCH.md b/docs/GESAMTHANDBUCH.md index 6cff259..bf05647 100644 --- a/docs/GESAMTHANDBUCH.md +++ b/docs/GESAMTHANDBUCH.md @@ -87,3 +87,9 @@ Coin-Menge, Genesis-Verteilung, kleinste Einheit/Dezimalstellen, Belohnung, Halb ## 9. Nicht vorspiegeln Ein sauberes Go-Gerüst und eine HTML-Oberfläche sind **noch keine nutzbare Blockchain oder Wallet**. Der neue Gebührenentwurf ist **dokumentiert und simulationsbedürftig**, nicht implementiert. + +## 10. Langfristige PTM-Nutzung: Sammlerstücke und virtuelle Handelsplätze (Vision) + +Die im Oktober 2026 ergänzte Vision sieht **nach stabiler Kern-Chain und Web-Wallet** digitale Sammelobjekte (F1), einen in PTM abgewickelten internen Marktplatz (F2), eine Handelsoberfläche für fiktive interne Assets mit Orderbuch, Kursen, Charts und Portfolios (F3) und optional einen strikt getrennten Paper-Trading-Modus (F4) vor. Diese Szenarien sollen PTM einen internen Nutzwert geben. Sie begründen **keinen externen Euro-Kurs**, keine Börsenlistung und keine Anlage- oder Renditeaussage. + +Asset-Kauf, Sammelgegenstände oder Bestandshöhen dürfen die PoP-Lotterie nicht zusätzlich bevorteilen. Die technischen Details (Assetmodell, Emission, Marktdaten, atomare Trades, Ordermatching, Gebühren und Schutz gegen Wash Trading) sind absichtlich offen. Keine Funktionen sind implementiert. Maßgeblich: `docs/ZUKUNFT_OEKOSYSTEM.md`, `docs/ROADMAP.md` und ADR 0004. Die Arbeiten an M1–M6 behalten Vorrang. diff --git a/docs/POP_LANGZEIT_SIMULATION.md b/docs/POP_LANGZEIT_SIMULATION.md new file mode 100644 index 0000000..184dadb --- /dev/null +++ b/docs/POP_LANGZEIT_SIMULATION.md @@ -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. diff --git a/docs/PROJEKTPLAN.md b/docs/PROJEKTPLAN.md index 56f0709..c2c5324 100644 --- a/docs/PROJEKTPLAN.md +++ b/docs/PROJEKTPLAN.md @@ -51,3 +51,9 @@ Die **Schwelle, Nonce-Raum, Rundendauer, Fensterlängen, Gebührenhöhe, PTM-Emi 5. **M5–M6:** Pi-/Office-PC-Builds, Web-Wallet vervollständigen, private Mehrhost-Tests, Doku/Release. Jeder Schritt: erst Akzeptanzkriterien, dann kleinste sinnvolle Implementierung, Tests inkl. `gofmt`, `go test ./...`, `go vet ./...`, kurze Dokumentation und Git-Review. Keinen Fortschritt erfinden. + +## Zukunftsperspektive nach dem privaten Testnet (neue Produktvision, kein aktueller Arbeitsauftrag) + +Erst **nach M6** dürfen wir getrennte Erweiterungsphasen erwägen: **F1 digitale Sammlerstücke**, **F2 interner PTM-Marktplatz**, **F3 Handelsplattform für fiktive interne Assets mit PTM-Orderbuch, Kursen und Portfolio**, optional **F4 separat gekennzeichnetes Paper-Trading/Börsenlabor**. Diese Phasen sollen PTM als geschlossene interne Währung einen zusätzlichen spielerischen Nutzwert geben, nicht einen angeblichen Fiat-Kurs oder einen Mining-Vorteil erzeugen. Keine implizite Echtgeld-Einlösung, Börsennotierung oder Renditeversprechen. + +**Verbindliche Projektgrenze:** Kein F1–F4-Code vor funktionierender Chain, sicherer Wallet und bestandenem Mehrhost-Testnet. Eigentum/Transaktionen müssen kryptografisch überprüfbar sein, Sammlerbesitz beeinflusst die PoP-Lotterie nicht. Für Asset-Minting, sichere Marktorders, Matching, Gebühren und Rechtliches sind vor Implementierung gesonderte Entscheidungen und ADRs nötig. Details in `docs/ZUKUNFT_OEKOSYSTEM.md` und `docs/decisions/0004-zukunftsvision-internes-oekosystem.md`. diff --git a/docs/ROADMAP.md b/docs/ROADMAP.md index 0639e0b..8207001 100644 --- a/docs/ROADMAP.md +++ b/docs/ROADMAP.md @@ -1,4 +1,4 @@ -# Potatium-Roadmap: aktueller Plan v0.2 (25.10.2026) +# Potatium-Roadmap: Kernphasen M0–M6 und Zukunftsvision (25.10.2026) **Status der Umsetzung:** Starter-Scaffold vorhanden, Blockchain/PoP/Web-Wallet noch **nicht** funktionsfähig. Lokale `doctor.sh`-Prüfung auf dem Benutzer-LXC wurde am 24.10.2026 berichtet; aktuelle Git-Commits und Änderungen aus Codex hier nicht einsehbar. Haken nur bei nachgewiesenen Ergebnissen setzen. @@ -38,4 +38,15 @@ - [ ] 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. +## F1–F4: Zukunftsvision, erst nach stabilem M6 + +Die folgenden Erweiterungen sind **als spätere Produktideen aufgenommen**, aber weder terminiert noch implementiert. Sie verändern keine geltenden PoP-/Ledger-Regeln. Details und offene Entscheidungen: [`ZUKUNFT_OEKOSYSTEM.md`](ZUKUNFT_OEKOSYSTEM.md), [`ADR 0004`](decisions/0004-zukunftsvision-internes-oekosystem.md). + +- [ ] **F1 · Sammlerstücke:** Einzigartige/limitierte interne Kartoffel-Objekte, verifizierbares Eigentum, Ausstellungs- und Transferregeln, Wallet-Galerie. Keine Mining-Vorteile. +- [ ] **F2 · PTM-Marktplatz:** Angebote/Käufe/Verkäufe digitaler Sammlerstücke in PTM, sichere atomare Abwicklung, Gebühren/History, Schutz vor manipulierten Angeboten. +- [ ] **F3 · Interne Asset-Börse:** Handel fiktiver interner Assets gegen PTM mit Orderbuch, PTM-Kursen, Kursverläufen, Volumen und Portfolio; keinerlei Euro-/Krypto-Umtauschpflicht und keine erfundenen Marktdaten. +- [ ] **F4 · Börsenlabor:** Optionales Paper-Trading mit klar getrennten Testbeständen und als Simulation gekennzeichneten Kursen. + +**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.** diff --git a/docs/ZUKUNFT_OEKOSYSTEM.md b/docs/ZUKUNFT_OEKOSYSTEM.md new file mode 100644 index 0000000..bd484ce --- /dev/null +++ b/docs/ZUKUNFT_OEKOSYSTEM.md @@ -0,0 +1,77 @@ +# Potatium: Zukunftsvision für Sammlerstücke, Marktplatz und interne Börse + +**Stand:** 25.10.2026 · **Status:** akzeptierte langfristige Produktvision, **keine implementierte Funktion und keine festgelegten Protokollregeln**. Sie erweitert das Projektziel, verschiebt aber **keinen** der Meilensteine M1–M6. Vor einer Umsetzung eigene ADRs und Akzeptanzkriterien erstellen. + +## 1. Warum PTM überhaupt verdienen? + +Eine reine Mining-Lotterie, deren Coins ausschließlich für weitere Mining-Fenster verwendet werden können, bietet zu wenig eigenständigen Nutzen. Langfristig soll PTM als **interne Währung** für digitale, von der Community verwendbare Gegenstände und Dienste dienen. PTM bleibt zunächst ein geschlossener, nicht gegen Euro oder externe Kryptowährungen einlösbarer Hobby-/Testnet-Coin ohne Wert- oder Renditeversprechen. + +Erzeugung durch PoP, Transfer zwischen Wallets und spätere Ausgaben/Handel mit Sammlerstücken bilden zusammen ein denkbares Ökosystem. Ein interner Markt schafft **nicht automatisch** einen externen Geldwert, Preisstabilität oder wirtschaftlichen Anreiz für alle. + +## 2. Stufen und bewusst harte Voraussetzungen + +### F1: Digitale Sammlerstücke + +**Start erst nach M6: stabile Chain, funktionale Web-Wallet, geprüftes Signatur- und Gebührenformat, robustes Mehrhost-Testnet.** + +- Digitale Kartoffel-Objekte, Trophäen, Serien oder rein kosmetische Profilabzeichen, die einem Chain-Konto zugeordnet sind. +- Klare Definition: Unikat oder limitierte Edition, Herausgeber, Gesamtmenge, Metadaten/Version, Transferierbarkeit, gegebenenfalls Burn. +- Anzeige von Eigentum und Historie in der Web-Wallet; keine bloßen Datenbank-Behauptungen bei fehlender Chain-Verbindung. +- **Keine** Vorteile beim PoP-Mining durch Besitz, Seltenheit oder Kaufpreis eines Gegenstands. +- Vorab zu entscheiden: Darstellung von Bildern und Metadaten (on-chain vs. gehashte externe Inhalte), unveränderliche Referenzen, Moderation, Rechte und Speicherlimits. + +**Noch nicht beschlossen:** eigenständiger Token-/NFT-Standard, Asset-Datenmodell, Ausgabe-/Mintrechte, Metadatenlagerung und Gebühren. + +### F2: Geschlossener PTM-Marktplatz + +- Nutzer können freigegebene Sammlerstücke zu einem **in PTM ausgewiesenen** Preis anbieten und innerhalb des privaten Netzwerks kaufen/verkaufen. +- Käufer erhält den Gegenstand und Verkäufer PTM **atomar oder gleichwertig manipulationssicher**. Keine Zahlung ohne Eigentumsübertragung. +- Order-/Angebotslebenszyklus: Anlegen, Gültigkeitsdauer, Ändern/Abbrechen, Reservierung, Abschluss, Gebühren, Historie und nachvollziehbare Fehlschläge. +- Wallet unterschreibt Transaktionen lokal; Backend, Miner und Marktplatz dürfen keine Seeds oder Private Keys erhalten. +- Erst bei belastbarem Modell entscheiden, ob Angebote direkt on-chain liegen oder ein Off-chain-Index/Matcher auf **verifizierbarem On-chain-Settlement** aufbaut. +- Schutz vor Replay, Double-Spend, unautorisiertem Minting, Self-Trading/Wash-Trading und gefälschten Besitznachweisen; ggf. Regeln für nicht transferierbare Sammlerstücke. + +**Noch nicht beschlossen:** Handelsgebühren, Ordermatching, Listingrechte, Asset-Standards, Gebührenverwendung sowie off-chain/on-chain Datenarchitektur. + +### F3: Interne Börsenoberfläche für spielerische Assets + +Nutzeridee: Eine Oberfläche mit **Anlage-/Trading-Gefühl wie eine Börse**, aber innerhalb des geschlossenen Potatium-Systems. Beispielsweise können verschiedene intern definierte fiktive Asset-Klassen oder Editionen in PTM notiert und gehandelt werden. + +- Beobachtung: **Kurse in PTM**, Charts/Verlauf, Orderbuch, Bid/Ask, abgeschlossene Trades, Volumen, Portfolio, realisierte/unrealisierte Veränderungen. +- Handel von echten *internen* Assets nur, wenn Besitz, Emission, Limits, Ordermatching und Settlement sicher definiert sind. +- **Kein** implizites Versprechen: Assets sind keine Aktien, keine Ansprüche auf reale Unternehmen, keine Rendite oder Auszahlung in Euro. +- Marktdaten nur aus nachvollziehbaren Handelsereignissen. Ohne Trades keine erfundenen Kurse, Volumina oder OHLC-Kerzen. Markiere fehlende Liquidität, letzte Ausführung und illiquide Spreads deutlich. +- Gegen künstliches Handelsvolumen, Preismanipulation, Eigenhandel und irreführende historische Kursreihen sind erst Regeln und Tests zu entwickeln. +- Vorab entscheiden: Fungibilität/Teilmengen, limitierte Emission, Mint-/Burnrechte, Preis-/Mengenbasiswerte (Integer on-chain), Matching (Preis-/Zeitpriorität oder anderes Verfahren), Stornos, Marktpausen, Gebühren und Audit. + +### F4: Optionales Börsenlabor (Paper Trading) + +- **Streng separat** von realen internen PTM-Guthaben, Sammlerstücken und dem Konsenszustand. +- Simulierte Orders, Übungsportfolios, Risiko-/Performance-Auswertung, Lerncharts und hypothetische Kursbewegungen. +- Künstliche Daten und simulated P&L **überall explizit als Simulation kennzeichnen**. Keine Vermischung mit realen internen Handelsvolumina oder Wallet-Salden. +- Eine mögliche spätere Börsenoberfläche kann sowohl interne PTM-Assets als auch das klar getrennte Lernlabor anbieten. + +## 3. Schnittstellen und Grenzen + +- Die Markt-/Sammlerwelt ist **nachgelagert**. Keine vorgezogene Änderung am Validator-Konsens oder an PoP-Gebühren. +- Ein Sammlerstück, ein Profil oder das Halten von Assets darf **keine** zusätzlichen PoP-Lose erzeugen. Die drei Mining-Fenster bleiben unabhängig von Sammlerbesitz. +- Fortschritt in einer Sammlerwelt ersetzt **nicht** die identitätsgebundene 90-Tage-Gebührenbemessung für Zusatzfenster. +- Web-Wallet ist das gemeinsame Nutzerfrontend. Eine Börsenansicht ist später ein zusätzlicher Bereich, nicht die Voraussetzung für ein funktionales Wallet-MVP. +- Separate Berechtigung zum Asset-Erstellen; keine beliebige Coin-Inflation oder versteckte Emission durch Marktaktionen. +- Jeder neue Assettyp, jede Börsenlogik und jede neue Transaktionsart benötigt ein ADR sowie Negativ-/Sicherheitstests. + +## 4. Offene Produkt- und Regulierungsfragen + +1. Was kann jeder selbst erstellen und was wird kuratiert/limitiert? +2. Welche digitale Nützlichkeit bietet ein Sammlerstück, **ohne Pay-to-Win** zu werden? +3. Wo liegen Bilder und Metadaten, und wie bleiben sie langfristig abrufbar? +4. Werden Preise ausschließlich durch Nutzerorders gebildet, und wie zeigen wir Märkte ohne Liquidität korrekt? +5. Wie verhindern wir Missbrauch durch mehrere Identitäten, Wash Trades und manipulierte Rankings? +6. Welche Marktgebühren fließen an Validatoren, werden verbrannt oder bleiben beim Anbieter? **Noch offen.** +7. Welche rechtlichen Anforderungen entstehen, wenn PTM oder interne Assets doch einen realen Gegenwert bekommen? Vor solchen Änderungen gesonderte Prüfung, keinerlei Listungs-, Wert- oder Renditeversprechen. + +## 5. Abnahmekriterien für eine spätere Freigabe + +**F1:** Erzeugung, Einzigartigkeit, Besitznachweis, Transfer und Recovery mit deterministischen Tests. **F2:** atomare Zuordnung von Asset und PTM samt Manipulations-/Replay-Tests. **F3:** nachprüfbare Preise, Orders, Matching, Portfolio-Berechnungen und ehrliche Anzeigen ohne Trades. **F4:** technisch und optisch eindeutige Trennung von Simulation und echtem internem Ledger. + +**Keine dieser Phasen ist begonnen.** Über die Reihenfolge nach M6 wird neu entschieden, sobald die technische und wirtschaftliche Basis dafür tragfähig ist. diff --git a/docs/decisions/0004-zukunftsvision-internes-oekosystem.md b/docs/decisions/0004-zukunftsvision-internes-oekosystem.md new file mode 100644 index 0000000..82fe752 --- /dev/null +++ b/docs/decisions/0004-zukunftsvision-internes-oekosystem.md @@ -0,0 +1,38 @@ +# ADR 0004: PTM-Sammlerstücke, interner Marktplatz und Börsenlabor als Zukunftsvision + +**Status:** Accepted als **Produktvision**; technische Architektur, Tokenomics und Implementierung **nicht entschieden**. +**Datum:** 25.10.2026 +**Gültigkeit:** Erweiterung nach M6, keine Änderung an bestehenden M1–M6-Entscheidungen und ADR 0003. + +## Kontext + +Eine Hobby-Blockchain, deren Coin lediglich für neue Mining-Chancen verwendet wird, hat wenig eigenständigen internen Nutzen. Der Nutzer möchte daher **später** digitale Sammlerstücke, einen PTM-Marktplatz und eventuell eine an eine Börse angelehnte interne Handelsplattform mit Assets, Kursen und Kursentwicklungen. Potatium bleibt vorerst ein geschlossenes Hobby-/Testnet ohne vorausgesetzte Tauschbarkeit gegen externe Kryptowährungen oder Geld. + +## Entscheidung (ausschließlich Produktziel) + +1. **F1:** Sammlerstücke als eigene überprüfbare interne digitale Objekte mit Ownership, Editionen und Wallet-Anzeige untersuchen. +2. **F2:** Späterer geschlossener Marktplatz zum Anbieten, Kaufen und Tauschen dieser Gegenstände in PTM; atomare, sichere Abwicklung anstreben. +3. **F3:** Interne fiktive Assets zu PTM-Preisen handelbar machen; Kurse, Orderbuch, Charts, Trades, Portfolio und Volumen transparent aus tatsächlichen internen Geschäften ableiten. +4. **F4 optional:** Ein separater Paper-Trading-/Lernmodus kann künstliche Orders und Assets simulieren, darf aber nie als echte PTM-Chain-Transaktion erscheinen. +5. Kein Sammelobjekt, kein Kauf und kein Assetbesitz erzeugt ein zusätzliches PoP-Ticket oder erhöht die Mining-Qualifikationschance. +6. **Nur langfristige Roadmap:** keine Umsetzung vor robuster Chain, richtiger Wallet, PoP und privatem Mehrhost-Testnet. Für jede Folgephase neues ADR mit Security, Emission und Gebührenentscheidungen. + +## Alternativen + +- PTM ausschließlich fürs Mining verwenden: zu wenig unabhängiger Nutzwert. +- Externe Krypto-/Fiat-Börsenintegration: nicht Bestandteil der jetzigen Hobby-Ziele, deutlich höhere regulatorische und sicherheitstechnische Anforderungen. +- Sofort einen NFT-/DEX-Stack einbauen: erhöht Architektur-, Sicherheits- und Wartungslast vor funktionierendem Basisprotokoll. +- Künstliche Kurse ohne echte Trades als reale Märkte ausgeben: irreführend und ausgeschlossen; eine ausdrücklich als Simulation deklarierte Übung ist möglich. + +## Konsequenzen und noch offene Entscheidungen + +- Eine mögliche Asset-/Marktschicht baut **später** auf denselben sicheren Account-/Transaktionsprinzipien auf, ersetzt sie nicht. +- Ownership, limitierte Emission, Daten-/Bilderhaltung, Name/Ticker, Indexierung, atomare Transfers, Matching, Gebühren, illiquide Märkte und Missbrauchsschutz sind **offen**. +- Ein intern vereinbarter PTM-Preis schafft **keinen garantierten externen Geldwert**. Vor jeder realwertbezogenen/öffentlichen Nutzung müssen Rechte, Steuern, Finanz-/Glücksspielrecht und Betreiberpflichten erneut geprüft werden. +- Das Logo `assets/logo/potatium-ptm-logo.png` wird unverändert weiterverwendet. + +## Referenzen + +- `docs/ZUKUNFT_OEKOSYSTEM.md` +- `docs/ROADMAP.md` +- `docs/decisions/0003-pop-fenster-und-gebuehren.md` diff --git a/handoff/REPO_UPDATE_V03.md b/handoff/REPO_UPDATE_V03.md new file mode 100644 index 0000000..f21bb68 --- /dev/null +++ b/handoff/REPO_UPDATE_V03.md @@ -0,0 +1,18 @@ +# Repo-Update v0.3: README-Roadmap und langfristiges PTM-Ökosystem + +Aktualisiert die Dokumentation von v0.2, ohne Go-Code, Mining, Wallet-Vorschau oder Logo auszutauschen. Gilt als Ergänzung zur bestehenden PoP-v0.2-Spezifikation. + +## Inhalt + +- `README.md`: zentriertes **originales** Logo als relativer Repo-Pfad, Git-/Gitea-freundliche öffentliche Projektübersicht, Roadmap M0–M6/F1–F4 und realistischer Status. +- `docs/ZUKUNFT_OEKOSYSTEM.md`: neue Produktvision mit F1 Sammlerstücken, F2 internem PTM-Marktplatz, F3 börsenartigem Handel fiktiver Assets und F4 optionalem Paper Trading. +- `docs/decisions/0004-zukunftsvision-internes-oekosystem.md`: akzeptierte Vision, aber keine konkrete Asset-/Börsenimplementierung. +- `docs/ROADMAP.md`, `docs/PROJEKTPLAN.md`, `docs/GESAMTHANDBUCH.md`: Abhängigkeiten und Zukunftsstufen aufgenommen. +- `AGENTS.md` und `handoff/STARTPROMPT_VSCODE_CODEX.md`: Codex soll Zukunftsfunktionen **nicht** vorziehen. + +## Sicherheitsregeln + +- Kein bestehender Quellcode geändert, keine Dateien gelöscht, Logo-Bilddatei bleibt unverändert. +- Update-Skript zeigt im Standardfall eine Vorschau. Nur `--apply` schreibt, nach Check der erwarteten v0.2-Hashes und Backup. +- Geänderte oder konkurrierende Repo-Dateien brechen vor Änderung mit `CONFLICT` ab: manuell zusammenführen. +- Das echte private Gitea-Remote und aktuelle Codex-Commits sind nicht Teil des hier verfügbaren Referenz-Repositories. Ein lokaler Commit/Push ist deshalb Nutzeraufgabe. diff --git a/handoff/STARTPROMPT_VSCODE_CODEX.md b/handoff/STARTPROMPT_VSCODE_CODEX.md index 972d386..a07d657 100644 --- a/handoff/STARTPROMPT_VSCODE_CODEX.md +++ b/handoff/STARTPROMPT_VSCODE_CODEX.md @@ -27,3 +27,7 @@ Du bist technischer Architekt, leitender Go-Entwickler und Reviewer für **Potat 6. Schließe mit: geänderte Dateien, echte Tests und Resultate, offene Sicherheits-/Rechtsrisiken, drei konkrete nächste Entscheidungen. Keine Phase als fertig erklären, wenn nur ein Mock existiert. --- + +## 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.