44 lines
2.1 KiB
Markdown
44 lines
2.1 KiB
Markdown
# 🥔 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.
|