Initial commit: Potatium

2026-10-24 21:01:13 +00:00
commit e2d0be22fd
@@ -0,0 +1,43 @@
+# 🥔 Potatium (PTM)
+
+**Eigenständige Hobby-Blockchain mit ressourcenschonender Proof-of-Potato-Lotterie.**
+
+Status **Projektgerüst / vor der Protokollimplementierung**. Dies ist ausdrücklich noch keine einsatzfähige Kryptowährung! Die enthaltene Weboberfläche ist ein **nichtfunktionaler Wallet-Entwurf**, keine Wallet zum Verwahren echter Werte.
+
+## Schnelleinstieg
+
+1. **`START_HIER.md`** lesen. Zielsystem: Ubuntu Server **26.04 LTS** als unprivilegierter Proxmox-LXC.
+2. `sudo bash scripts/setup_ubuntu26.sh` installiert Basispakete und eine per SHA-256 geprüfte Go-Version.
+3. `bash scripts/bootstrap_workdir.sh` ergänzt fehlende Verzeichnisse, ohne Dateien zu überschreiben.
+4. `bash scripts/doctor.sh` prüft Installation und Starter-Build.
+5. VS Code via Remote-SSH öffnen und `handoff/STARTPROMPT_VSCODE_CODEX.md` in Codex verwenden.
+
+## Geplante Programme
+
+- `potatiumd`: Blockchain-Node, später CometBFT/ABCI++-Anwendung und HTTP/RPC.
+- `potatium-miner`: eigenständiger, sparsamer Miner für PCs und Raspberry Pis.
+- `potatium-cli`: Wallet-/Netzwerk-CLI.
+- `web/wallet`: **Web-Wallet ab MVP**, mit Erstellen/Import, Guthaben, Empfangen, Senden, Historie und Sperren/Entsperren.
+
+## Was aktuell schon läuft?
+
+Das Starterprojekt enthält einen kleinen lokalen **UI-Vorschau-Server**, aber **keine Blockchain**, keine Schlüsselverwaltung und keine echte Transaktion:
+
+```bash
+go test ./...
+go run ./cmd/potatiumd -web-dir web/wallet -listen 127.0.0.1:8080
+```
+
+Aufruf lokal `http://127.0.0.1:8080`; bei Remote-SSH Port 8080 in VS Code weiterleiten.
+
+## Arbeitsgrundlage
+
+- `AGENTS.md`: bindende Projektregeln für Codex.
+- `docs/PROJEKTPLAN.md`: ausführliche technische Übergabe.
+- `docs/ARCHITEKTUR.md`: Komponentengrenzen.
+- `docs/PROTOKOLL_ENTWURF.md`: bestätigte und offene Protokollregeln.
+- `docs/WEB_WALLET.md`: MVP-/Sicherheitsanforderungen.
+- `docs/ROADMAP.md`: inkrementelle Meilensteine.
+- `handoff/CHATGPT_PROJEKTANWEISUNGEN.md`: ChatGPT-Projektanweisungen, **unter 8.000 Zeichen**.
+
+**Kein Finanzprodukt / kein Mainnet:** Alles zunächst nur Testnet und wertlose Test-PTM. Niemals produktive Schlüssel in Git oder im Chat ablegen.