randomp2p

Vertrauensloser Multiplayer-Münzwurf – P2P im Browser, keine Server, kein Trust.

Zwei bis N Spieler verbinden sich via WebRTC (simple-peer) und führen ein kryptografisches Commit-Reveal-Protokoll aus, um einen garantiert fairen Münzwurf zu erhalten. Solange ein Teilnehmer ehrlich ist, ist das Ergebnis zufällig und manipulationssicher.

Features

P2P – Kein Server, kein Account, keine zentrale Instanz
Trustless – Commit-Reveal-Protokoll mit SHA-256-Bindung, jeder verifiziert
QR-Bootstrapping – SDP-Offers/Answers werden als QR-Codes ausgetauscht
Multiplayer (2–n) – Beliebig viele Teilnehmer in einer Runde
Coin-Animation – 3D-Münzwurf via CSS
100% Vanilla JS – Keine Build-Tools, kein npm, keine Abhängigkeiten außer CDN-Libs

Quick Start

git clone <repo-url>
cd randomp2p
python3 -m http.server 8080

Dann auf zwei (oder mehr) Geräten http://localhost:8080 öffnen.

WebRTC + Kamera (getUserMedia) + Web Crypto API brauchen einen sicheren Kontext. Lokal via localhost funktioniert das. Für andere Geräte im selben Netzwerk die lokale IP verwenden.

Spielanleitung

Host

"Raum erstellen" – QR-Code mit SDP Offer wird angezeigt
"Antwort-QR scannen" – Kamera startet, scannt die Antwort-QRs der Beitreter
Jeder neue Spieler erscheint in der Liste
"Münzwurf starten" – Übergang in den Spiel-Screen
"Münzwurf starten" – Protokoll beginnt (Commit → Reveal → Ergebnis)

Beitreter

"Raum beitreten" – Kamera startet
QR des Hosts scannen
Antwort-QR zeigen – Host scannt diesen QR
Verbindung steht, warten auf Start
Protokoll läuft automatisch durch – Ergebnis erscheint

Protokoll-Phasen

Phase	Beschreibung
Commit	Jeder Spieler generiert 32 Zufallsbytes und sendet den SHA-256-Hash an alle
Warten	Sammle Commits aller Teilnehmer
Reveal	Jeder sendet die rohen Zufallsbytes an alle
Verify	Jeder prüft: SHA-256(received) == stored_commit
Result	XOR aller Secrets → Parity (0=Kopf, 1=Zahl)

Architektur

randomp2p/
├── index.html      – 5 Screens + CDN-Libs
├── style.css       – Dark-Theme, Coin-Animation
├── crypto.js       – SHA-256, Zufallsbytes, XOR-Combine
├── p2p.js          – MeshNet: simple-peer, QR-Signaling, Datenkanal
├── protocol.js     – Commit-Reveal State Machine
└── app.js          – UI-Routing, Kamera/QR-Scan, Verkabelung

Abhängigkeiten (CDN)

Library	Zweck
simple-peer	WebRTC-Datenkanäle
qrcodejs	QR-Code-Generierung
jsQR	QR-Code-Scanning per Kamera

Netzwerk-Topologie

Best Case (gleiches WiFi): QR-SDP-Austausch zwischen Host und jedem Peer. Host teilt IP-Liste → potentiell volles Mesh über signal_relay.

Worst Case (NAT/Internet): Stern-Topologie über den Host. Protokoll funktioniert trotzdem – die Fairness ist nicht von der Topologie abhängig.

Warum ist das fair?

Das Commit-Reveal-Protokoll garantiert:

Keine späte Manipulation: Der SHA-256-Commit bindet jeden Spieler vor dem Reveal an sein Secret (Preimage-Resistenz)
Keine Absprache nötig: Solange ein Teilnehmer ehrlich Zufallsbytes beisteuert, ist das XOR-Ergebnis zufällig
Volle Transparenz: Jeder Teilnehmer rechnet lokal alle Prüfungen und das Endergebnis

Mathematisch: result = S_1 ⊕ S_2 ⊕ ... ⊕ S_n. Wenn S_k echt zufällig und vor S_1..S_{k-1}, S_{k+1}..S_n festgelegt wurde, ist result zufällig – unabhängig von allen anderen Secrets.

IPFS-Deployment

ipfs add -r .
# → CID notieren, über IPFS-Gateway aufrufbar
# → Gateway-URL als QR-Code in die App einbauen

Ausblick / TODOs

Volles Mesh: Peers verbinden sich direkt via relayed signaling
Timeout + Reconnect bei Verbindungsabbruch
Raum-Code als Alternative zum QR-Scan
TURN-Server-Konfiguration für NAT-Traversal
Mehrere Runden mit Historie
PWA-Manifest + ServiceWorker für IPFS-Distribution

Lizenz

MIT

4.2 KiB Raw Blame History Unescape Escape