SV Sovereignty
v2.1.0 — multi-save · daemon · audit viewer (attested binaries)

Sovereignty a board game about keeping your word.

Roll, trade, promise, betray. 2-4 players, 30 minutes, no screens required. The console keeps score — you keep your word. Optionally anchor results on the XRPL Testnet.

Install

pipx install sovereignty-game

Tutorial

sov tutorial

Play

sov new -p Alice -p Bob -p Carol

What's new in v2.0.0

Three things to know about the v2 release.

Hardened proof format

The round-proof envelope now signs the full game context (game_id, round, ruleset, rng_seed, timestamp, players, state) — not just the player coins. Any tampering with envelope metadata invalidates the proof. v1 proofs are no longer accepted.

Production-quality polish

Atomic writes everywhere (no half-written save files), structured logging for operators, --json output mode on diagnostic commands, and supply-chain attestation on released binaries.

Beginner-friendlier

Install in 30 seconds with pipx install sovereignty-game, walk through the rules in 60 seconds with sov tutorial, and share scenario codes with friends.

Migrating from v1? See the migration guide. Or read the full release notes.

What makes it different

Reputation that you say out loud, not jargon you have to learn. Three mechanics carry the whole game.

Promises you say out loud

Say "I promise..." at the table. Keep it: +1 reputation. Break it: -2 reputation. No app reminders — the table holds you to it.

Treaties with real stakes

Put your coins where your mouth is. Binding agreements with escrowed stakes — promises with teeth, judged by the room.

Proofs anyone can verify

Every round produces a SHA-256 fingerprint. Optionally anchor it on the XRPL Testnet — a public wall nobody can erase.

Pick your depth

Three tiers. Start at Campfire on game night one — add complexity only when the table is ready.

Tier
Name
What it adds
1
Campfire
Coins, reputation, promises, IOUs
2
Town Hall
Shared market, resource scarcity, dynamic pricing
3
Treaty Table
Binding treaties with escrow stakes

Get playing in 60 seconds

Install

pipx install sovereignty-game
# or: uv tool install sovereignty-game

Quick start

sov tutorial           # learn in 60 seconds
sov new -p Alice -p Bob # start a game
sov turn               # roll, land, resolve
sov end-round          # generate proof

Desktop app (v2.1, dev preview)

npm --prefix app run tauri dev
# Audit Viewer + Game Shell — runs from source.
# Signed binaries ship via Wave 11.

Diary Mode — optional, educational

Skip this on game night one. When you're curious how cryptographic proof works, the console can anchor each round to a public ledger — for free, with play-money tokens.

Wallet

Create a free XRPL Testnet wallet. Test XRP has no value — it's play money.

Anchor

Post your round proof hash to the ledger. Think of it as writing the score on a wall nobody can erase.

Verify

Anyone can check the proof against the on-chain record. Trust but verify.