Provably-Fair Backgammon Verifier

This repository provides all the client-side tools players need to independently verify every dice roll in our Backgammon game.
The C++ game server (private repo) publishes a JSON report at the end of each match; everything here is used to confirm that report.

Backgammon - Fair Board Games

What’s inside

Path	Description
pkg/verifier	Pure-Go library that reproduces the dice stream from a JSON report and returns true/false.
cmd/verifier	Tiny command-line wrapper around the library.
cmd/wasm	Same code compiled to WebAssembly and exported as a single JS function verify(json).
web/	Minimal HTML page that loads verifier.wasm and lets a player paste a report to get an immediate ✅ / ❌ result.

Quick start

1. Build the CLI

go run ./cmd/verifier < report.json   # prints VERIFIED ✅ or error

2. Build the browser demo

# Compile to WASM
GOOS=js GOARCH=wasm go build -o web/verifier.wasm ./cmd/wasm

# Copy the Go runtime
cp $(go env GOROOT)/misc/wasm/wasm_exec.js web/

# Open web/index.html (or drop the folder into your game's WebView)

The verifier reproduces every roll with HMAC-SHA256(serverSeed, combinedSeed || nonce_be) and checks it against the rolls array.