🥔 Potatium (PTM)
Eine eigenständige Hobby-Blockchain mit Proof of Potato.
Ressourcenarm · Raspberry-Pi-tauglich · lokal kontrollierte Web-Wallet · privates Testnetz
> **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.
## Was ist Potatium?
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.
- **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.
## Proof of Potato: aktueller Produktentwurf
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.
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 # Nur statische lokale Web-Wallet-Vorschau
```
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-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).