potatium/docs/WEB_WALLET.md

Potatium Web-Wallet: Mindestumfang ab dem ersten funktionalen MVP

Vorhandene Dateien in web/wallet/ sind nur eine deaktivierte UI-Vorschau. Keine Schlüsselerzeugung, keine echten Daten oder Transaktionen vortäuschen.

Pflichtfunktionen

• Im Browser Wallet kryptografisch sicher erstellen und importieren, verschlüsselt exportieren und durch Wiederherstellung testen.
• Adresse/Kopieren, Balance aus echter verbundener Node, PTM senden mit Betrag/Empfänger/Fee/Bestätigung, empfangen, History und Transaktionsstatus.
• Wallet sperren/entsperren, verständliche Offline- und Fehlermeldungen, Netzwerkstatus.
• Private Keys, Seed-Phrases und Passwörter niemals ans Backend, an Miner oder in Logs/Telemetrie/Repo; Schlüsselmaterial nur im Browser, sichere gepinnte Bibliotheken, klar definierte Signing-Bytes.
• Verschlüsselter Storage, starke KDF, CSP, lokale HTTP-Vorschau nur 127.0.0.1/SSH-Forwarding, später HTTPS; Backup- und XSS-Tests.

Zusatzfenster und Gebühren (PoP v0.2)

• Miner startet immer ohne PTM mit kostenlosem Fenster 1.
• Die Web-Wallet kann (nach Festlegung des Protokolls) optional erlauben, für Fenster 2/3 eine eng begrenzte Gebühr zu bezahlen. Fixpreis und progressive Gebühr anhand der aus dem finalisierten Chain-State berechneten Mining-Gewinne der letzten ca. 90 Tage der zugeordneten Identität/Gruppe anzeigen. Die Zahlung wird verbrannt.
• Nutzer sieht vor Autorisierung den konkreten Preis je Zusatzfenster, die maximale mögliche Gesamtausgabe, Gebührenrisiken und den Unterschied zwischen Qualifikations- und tatsächlicher Gewinnchance.
• Gebühr nur nach explizit signierter Freigabe für Chain-ID, Miner-ID, Runde, Fenster, Betrag, Ablauf und Nonce. Ggf. später vorsichtig modellierbares widerrufbares Budget statt unbeschränkter Dauerfreigabe. Miner benötigt keine Wallet-Secrets.
• Vor finaler Gebühren-/Signaturspezifikation alle Zahlungs-Aktionen deaktiviert lassen. Keine automatische Abbuchung nur wegen „Mining aktiviert“.
• Bestätigte Zahlung vor Fenster-Freigabe; Fehlschlag führt nicht zur Erstattung. Nach erfolgreichem Proof oder Fristende keine weitere Freigabe.

Sicherheitstests

Replay über Runden, falsche Chain-ID, abgelaufene Autorisierung, negative/überlaufende Beträge, divergierende Fee-Snapshots, manipulierte Fees/Proofs, Backup-/Recovery-Fehler und Offline-Stati. Browser-/Go-Kompatibilität der gewählten Signatursuite erst nach ADR garantieren.