# 🥔 Potatium (PTM)

**Eigene Hobby-Layer-1 mit sparsamer Mining-Lotterie „Proof of Potato“.** Das goldene abstrakte PTM-Logo liegt unter `assets/logo/potatium-ptm-logo.png`.

**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.

## Entwicklungsumgebung

- 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

## Neues Mining-Konzept v0.2

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.

## Bestandteile

- `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.

## Checks und Vorschau

```bash
cd /home/potatium/src/potatium
bash scripts/doctor.sh
make run-ui
```

`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.

**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`.