# 🥔 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.