potatium/README.md

🥔 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, Protokollentwurf und ADR 0003.

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 und die Zukunftsvision für das interne Ökosystem 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.

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 · Gesamthandbuch · Codex-Startprompt.