michael/potatium
1
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: add PTM ecosystem vision and README roadmap

Browse Source
This commit is contained in:
Michael Böhmländer committed 2026-10-25 07:45:24 +00:00
1 parent 7397045a54
commit 75df8a5c0d
10 files changed
+268 -21
Download Patch File Download Diff File Expand all files Collapse all files

No files matched your search

README.md
+58 -20
View File
@@ -1,36 +1,74 @@
# 🥔 Potatium (PTM)
<p align="center">
<img src="assets/logo/potatium-ptm-logo.png" alt="Potatium PTM Logo: goldenes geometrisches P auf Schwarz" width="180" />
</p>
**Eigene Hobby-Layer-1 mit sparsamer Mining-Lotterie „Proof of Potato“.** Das goldene abstrakte PTM-Logo liegt unter `assets/logo/potatium-ptm-logo.png`.
<h1 align="center">🥔 Potatium (PTM)</h1>
**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.
<p align="center"><strong>Eine eigenständige Hobby-Blockchain mit Proof of Potato.</strong><br />
Ressourcenarm · Raspberry-Pi-tauglich · lokal kontrollierte Web-Wallet · privates Testnetz</p>
## 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).