diff --git a/README.md b/README.md
index ee0251d..5e64b04 100644
--- a/README.md
+++ b/README.md
@@ -7,10 +7,18 @@ outcomes any player can verify on their own phone.
## What it is
Three shared crash games — a rocket fighting gravity, a decaying orbit, and a
-stacking tower — running on a five-minute heartbeat, plus instant scratch
-tickets to play between rounds. Identity is a keypair your browser generates;
+stacking tower — plus instant scratch tickets to play between rounds. Set an
+auto cash-out target before the round and it closes at exactly your number, or
+ride it and tap out by hand. Identity is a keypair your browser generates;
there is no account, no email, and no password.
+The house edge is **1%** on everything. That is better than essentially
+anything commercial, and it is deliberate: this is a game among friends, not a
+revenue stream.
+
+Everything is API-first — the browser client uses the same endpoints anyone
+else can. Write a bot in twenty lines; see [docs/API.md](docs/API.md).
+
Everything runs on one machine: one Go binary with the client embedded,
PostgreSQL, and Redis.
@@ -77,7 +85,7 @@ One binary, with enforced internal boundaries:
| `pkg/ledger` | Append-only double-entry accounting |
| `pkg/scratch` | Scratch tickets and their published odds |
| `pkg/identity` | Keypair sign-in via signed challenge |
-| `pkg/room` | Round lifecycle and live broadcast |
+| `pkg/room` | Round lifecycle, auto cash-out, live broadcast |
Nine services on one machine would buy latency and 3am debugging, so this is
one process. Modules talk through interfaces only; extracting one into its own
@@ -101,6 +109,20 @@ The multiplier follows `m(t) = 1/(1 - t/T)²`, which diverges at exactly 60
seconds. No round can run longer, however extreme the crash point, and the
climb visibly accelerates as it goes — which is where the tension comes from.
+## Testing
+
+```bash
+make test # unit and integration
+make test-race # under the race detector
+make cover # coverage per package
+make db-reset # wipe the ledger; it is append-only and accumulates
+```
+
+Coverage sits around 85%, and the tests found and pinned three real money
+bugs: a posting set that minted 18 quintillion millisatoshis by wrapping the
+zero-sum check, a crash point that overflowed negative at the rarest seed, and
+scratch tables that advertised 98% while paying 56%.
+
## Status
Built and tested:
@@ -109,7 +131,9 @@ Built and tested:
- three crash games with live multiplayer rounds
- two scratch tickets with verified-honest odds
- keypair identity, peer-to-peer transfers, transaction history
+- auto cash-out targets that pay your exact number
- in-browser verifier
+- a documented public API, good enough to write bots against
Not yet built:
diff --git a/cmd/arcade/e2e_test.go b/cmd/arcade/e2e_test.go
index a0f95c4..18406cd 100644
--- a/cmd/arcade/e2e_test.go
+++ b/cmd/arcade/e2e_test.go
@@ -278,3 +278,67 @@ func itoa(v int64) string {
}
return string(buf[i:])
}
+
+// An auto cash-out target must be accepted by the API and reflected in the
+// round, and an invalid one must be refused before any money moves.
+func TestAutoCashOutThroughTheAPI(t *testing.T) {
+ c := newClient(t)
+ c.signIn("autoplayer")
+ start := c.fund(50_000_000)
+
+ var out map[string]any
+ // A target at or below 1.00 is meaningless and must be rejected.
+ code := c.do("POST", "/api/bet", map[string]any{
+ "game": "rocket", "stake_msat": 1_000_000, "auto_cashout": 1.0,
+ }, &out)
+ if code == 200 {
+ t.Fatal("a 1.00x auto cash-out target was accepted")
+ }
+
+ // An absurd target must be refused rather than overflowing the conversion.
+ code = c.do("POST", "/api/bet", map[string]any{
+ "game": "rocket", "stake_msat": 1_000_000, "auto_cashout": 1e12,
+ }, &out)
+ if code == 200 {
+ t.Fatal("an absurd auto cash-out target was accepted")
+ }
+
+ // Neither rejection may have moved money.
+ var bal struct {
+ BalanceMsat int64 `json:"balance_msat"`
+ }
+ c.do("GET", "/api/balance", nil, &bal)
+ if bal.BalanceMsat != start {
+ t.Fatalf("balance = %d after rejected bets, want %d", bal.BalanceMsat, start)
+ }
+
+ // A sensible target should be accepted during a betting window.
+ deadline := time.Now().Add(90 * time.Second)
+ placed := false
+ for time.Now().Before(deadline) && !placed {
+ var games struct {
+ Rooms []struct {
+ Game string `json:"game"`
+ State string `json:"state"`
+ } `json:"rooms"`
+ }
+ c.do("GET", "/api/games", nil, &games)
+ for _, rm := range games.Rooms {
+ if rm.Game == "rocket" && rm.State == "betting_open" {
+ var res map[string]any
+ if code := c.do("POST", "/api/bet", map[string]any{
+ "game": "rocket", "stake_msat": 1_000_000,
+ "auto_cashout": 2.5, "nickname": "autoplayer",
+ }, &res); code == 200 {
+ placed = true
+ }
+ }
+ }
+ if !placed {
+ time.Sleep(400 * time.Millisecond)
+ }
+ }
+ if !placed {
+ t.Fatal("could not place an auto cash-out bet within 90s")
+ }
+}
diff --git a/cmd/arcade/main.go b/cmd/arcade/main.go
index 2eda82e..3621b31 100644
--- a/cmd/arcade/main.go
+++ b/cmd/arcade/main.go
@@ -21,6 +21,7 @@ import (
"github.com/coder/websocket"
"github.com/coder/websocket/wsjson"
"github.com/drjones/quantum-arcade/pkg/fair"
+ "github.com/drjones/quantum-arcade/pkg/fixed"
"github.com/drjones/quantum-arcade/pkg/identity"
"github.com/drjones/quantum-arcade/pkg/ledger"
"github.com/drjones/quantum-arcade/pkg/room"
@@ -31,6 +32,10 @@ import (
//go:embed static
var staticFiles embed.FS
+// maxAutoCashOut bounds the target a client may request, keeping the
+// conversion to fixed-point well inside the representable range.
+const maxAutoCashOut = 1_000_000
+
// Games offered as shared rounds. They share one engine and differ in how the
// client renders the climb.
var games = []string{"rocket", "orbital", "tower"}
@@ -361,6 +366,9 @@ func (s *server) handleBet(w http.ResponseWriter, r *http.Request) {
Game string `json:"game"`
StakeMsat int64 `json:"stake_msat"`
Nickname string `json:"nickname"`
+ // AutoCashOut is an optional target multiplier, e.g. 2.5 for 2.50x.
+ // Zero or absent means no target.
+ AutoCashOut float64 `json:"auto_cashout"`
}
if err := json.NewDecoder(r.Body).Decode(&req); err != nil {
writeErr(w, http.StatusBadRequest, "malformed request")
@@ -371,7 +379,18 @@ func (s *server) handleBet(w http.ResponseWriter, r *http.Request) {
writeErr(w, http.StatusNotFound, "no such game")
return
}
- if err := rm.PlaceBet(r.Context(), id, pk, req.Nickname, req.StakeMsat); err != nil {
+ // Convert the target to fixed-point at the boundary; everything past this
+ // point is integer arithmetic.
+ var target fixed.F
+ if req.AutoCashOut > 0 {
+ if req.AutoCashOut > float64(maxAutoCashOut) {
+ writeErr(w, http.StatusBadRequest, "auto cash-out target is too large")
+ return
+ }
+ target = fixed.F(req.AutoCashOut * float64(fixed.One))
+ }
+
+ if err := rm.PlaceBet(r.Context(), id, pk, req.Nickname, req.StakeMsat, target); err != nil {
writeErr(w, http.StatusBadRequest, err.Error())
return
}
diff --git a/cmd/arcade/static/app.js b/cmd/arcade/static/app.js
index cadaa6e..d84c499 100644
--- a/cmd/arcade/static/app.js
+++ b/cmd/arcade/static/app.js
@@ -115,6 +115,17 @@ function setBalance(msat) {
$('balance').textContent = sats(msat);
}
+/* Reads the auto cash-out box. Returns 0 when empty or invalid, which the
+ * server treats as "no target". */
+function autoTarget() {
+ const v = parseFloat($('auto-target').value);
+ return Number.isFinite(v) && v > 1 ? v : 0;
+}
+
+function refreshAutoRow() {
+ $('autorow').classList.toggle('armed', autoTarget() > 0);
+}
+
/* ---------------- crash room ---------------- */
function connect(game) {
@@ -145,7 +156,9 @@ function onSnapshot(s) {
switch (s.state) {
case 'betting_open':
$('state').textContent = `betting closes in ${Math.max(0, s.next_phase_in_seconds).toFixed(0)}s`;
- action.textContent = myBet ? 'You are in — good luck' : 'Place bet';
+ action.textContent = myBet
+ ? (autoTarget() ? `In — auto out at ${autoTarget().toFixed(2)}×` : 'In — good luck')
+ : 'Place bet';
action.className = 'primary big';
action.disabled = !!myBet;
break;
@@ -189,7 +202,7 @@ function renderPlayers(players) {
clear(wrap);
for (const p of players || []) {
const amount = p.cashed_out
- ? '↑ ' + parseFloat(p.cashed_out).toFixed(2) + '×'
+ ? (p.auto ? '⚡ ' : '↑ ') + parseFloat(p.cashed_out).toFixed(2) + '×'
: sats(p.stake_msat) + ' sats';
wrap.appendChild(el('div', { class: 'player' + (p.cashed_out ? ' out' : '') },
el('span', { class: 'who', text: p.nickname || 'anon' }),
@@ -205,6 +218,7 @@ async function onAction() {
if (snapshot.state === 'betting_open' && !myBet) {
const r = await api('POST', '/api/bet', {
game: currentGame, stake_msat: stake, nickname,
+ auto_cashout: autoTarget(),
});
setBalance(r.balance_msat);
myBet = 'in';
@@ -250,11 +264,23 @@ function draw(s) {
const crashed = s.state === 'settled';
const progress = Math.min(1, Math.log(m) / Math.log(12));
- // Starfield drifts downward as you climb.
- ctx.fillStyle = '#ffffff';
+ // Scrolling grid: a horizon that rushes past as the multiplier climbs.
+ ctx.strokeStyle = '#0a7a5233';
+ ctx.lineWidth = 1;
+ const spacing = 34;
+ const offset = (progress * 260) % spacing;
+ for (let x = 0; x <= w; x += spacing) {
+ ctx.beginPath(); ctx.moveTo(x, 0); ctx.lineTo(x, h); ctx.stroke();
+ }
+ for (let y = -spacing + offset; y <= h; y += spacing) {
+ ctx.beginPath(); ctx.moveTo(0, y); ctx.lineTo(w, y); ctx.stroke();
+ }
+
+ // Sparse drifting particles, phosphor green.
+ ctx.fillStyle = '#00ff9c';
for (const st of stars) {
const y = (st.y + progress * 0.9) % 1;
- ctx.globalAlpha = 0.10 + st.r * 0.16;
+ ctx.globalAlpha = 0.12 + st.r * 0.18;
ctx.fillRect(st.x * w, y * h, st.r, st.r);
}
ctx.globalAlpha = 1;
@@ -267,13 +293,13 @@ function draw(s) {
function drawRocket(w, h, p, crashed) {
const x = w * 0.5;
const y = h * (0.88 - p * 0.66);
- const accent = crashed ? '#ff4d6d' : '#38f2e4';
+ const accent = crashed ? '#ff3355' : '#00ff9c';
// Exhaust plume: longer and more agitated as the climb steepens.
const plume = 26 + p * 60;
const g = ctx.createLinearGradient(x, y, x, y + plume);
- g.addColorStop(0, crashed ? '#ff4d6daa' : '#38f2e4cc');
- g.addColorStop(1, '#38f2e400');
+ g.addColorStop(0, crashed ? '#ff3355aa' : '#00ff9ccc');
+ g.addColorStop(1, '#00ff9c00');
ctx.fillStyle = g;
ctx.beginPath();
ctx.moveTo(x - 7, y + 8);
@@ -291,7 +317,7 @@ function drawRocket(w, h, p, crashed) {
ctx.fill();
if (crashed) {
- ctx.strokeStyle = '#ff4d6d88';
+ ctx.strokeStyle = '#ff335588';
ctx.lineWidth = 2;
for (let i = 0; i < 9; i++) {
const a = (i / 9) * Math.PI * 2;
@@ -306,17 +332,17 @@ function drawRocket(w, h, p, crashed) {
function drawOrbital(w, h, p, crashed) {
const cx = w / 2, cy = h / 2;
const planet = Math.min(w, h) * 0.16;
- ctx.fillStyle = '#1d2757';
+ ctx.fillStyle = '#00291c';
ctx.beginPath(); ctx.arc(cx, cy, planet, 0, Math.PI * 2); ctx.fill();
const orbit = planet + 12 + (1 - p) * Math.min(w, h) * 0.26;
- ctx.strokeStyle = crashed ? '#ff4d6d55' : '#38f2e455';
+ ctx.strokeStyle = crashed ? '#ff335555' : '#00ff9c55';
ctx.lineWidth = 1;
ctx.beginPath(); ctx.arc(cx, cy, orbit, 0, Math.PI * 2); ctx.stroke();
const a = p * Math.PI * 9;
const x = cx + Math.cos(a) * orbit, y = cy + Math.sin(a) * orbit;
- ctx.fillStyle = crashed ? '#ff4d6d' : '#38f2e4';
+ ctx.fillStyle = crashed ? '#ff3355' : '#00ff9c';
ctx.beginPath(); ctx.arc(x, y, 5, 0, Math.PI * 2); ctx.fill();
}
@@ -327,8 +353,8 @@ function drawTower(w, h, p, crashed) {
const sway = Math.sin(i * 0.7 + p * 6) * (i / blocks) * 22 * (crashed ? 3 : 1);
const y = h * 0.9 - (i + 1) * bh;
ctx.fillStyle = i === blocks - 1
- ? (crashed ? '#ff4d6d' : '#38f2e4')
- : `hsl(${230 + i * 4} 45% ${22 + i}%)`;
+ ? (crashed ? '#ff3355' : '#00ff9c')
+ : `hsl(${160 - i} 90% ${12 + i}%)`;
ctx.fillRect(w / 2 - bw / 2 + sway, y, bw, bh - 2);
}
}
@@ -618,6 +644,7 @@ async function init() {
(t.onclick = () => selectTab(t.dataset.view)));
document.querySelectorAll('.chip').forEach((c) =>
(c.onclick = () => setStake(Number(c.dataset.stake))));
+ $('auto-target').oninput = refreshAutoRow;
const pick = $('gamepick');
[['rocket', 'Rocket'], ['orbital', 'Orbital'], ['tower', 'Tower']].forEach(([id, label]) => {
diff --git a/cmd/arcade/static/index.html b/cmd/arcade/static/index.html
index f9cb98b..09c6199 100644
--- a/cmd/arcade/static/index.html
+++ b/cmd/arcade/static/index.html
@@ -3,7 +3,7 @@
-Quantum Arcade
+QUANTUM ARCADE
@@ -11,15 +11,13 @@