1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
|
# Testing
## Automated suite
```sh
cargo test
```
The suite is deterministic and headless: no network, no PTY, no sleeps, no
shared global database. Each test owns its state.
| File | Covers |
| --- | --- |
| `tests/client_core.rs` | Client command/game flows via a headless screen applying logical effects. |
| `tests/client_ui.rs` | Help, history, completion, bet parsing, display width, cursor math. |
| `tests/blackjack.rs` | Card totals, naturals, hit/stand/double, dealer bust, S17, state parsing. |
| `tests/crash.rs` | Multiplier curve, payout floor, crash-point distribution, house edge, cap. |
| `tests/protocol.rs` | Newline buffering and timeout/error classification. |
| `tests/roulette.rs` | European wheel, split-bet payouts, zero handling, result parser. |
| `tests/server_core.rs` | Handler, bcrypt migration, SQL injection, transaction rollback, `plays` audit, sessions. |
| `tests/server_setup.rs` | `--init` identity generation, PKCS#12 loadability, overwrite refusal. |
| `tests/slots.rs` | Server slots payout rules and overflow handling. |
| `tests/storage.rs` | Client/server SQLite storage helpers. |
| `tests/tofu.rs` | SPKI fingerprint and TOFU decisions. |
`tests/tofu.rs` and `tests/server_setup.rs` shell out to `openssl`, so run them
on a machine where the `openssl` CLI is available.
## Development resets
The server creates `server.db` in its working directory; the client creates
`client.db` for host trust and stored credentials. While the software is in
testing, delete both after a schema or trust change:
```sh
rm -f server.db client.db
```
The audit schema is not auto-migrated from the pre-2.0 slots-only `plays`
table. Starting against an old database will fail until it is removed.
## Manual TUI checklist
There is no CI. Run this on Linux and on a Windows VM before a release.
Use an 80-column terminal because several output lines are width-sensitive.
1. Run `cargo run --bin server -- --init` once, then start the server with a
valid `identity.p12` and start the client.
2. First contact prints three lines and the 64-character fingerprint does not
wrap at 80 columns. `Connected to ...` shows a one-decimal ping.
3. `register` / `login`: backspace removes one `*` per key, Esc cancels the
prompt, Ctrl+C exits and restores the terminal.
4. `help` fits 80 columns. Tab completion wraps within 76 columns and the
cursor stays visible.
5. `play slots 50` shows a 5x3 grid, the `Pays bet x symbol x shape` lines, and
the fetched balance.
6. Space shows `Spinning...`, then the 3 rows, win text, winning-line list, and
new balance inside the same 10-line board. Winning symbols appear as
yellow/bold `{ X }` cells; the `Winning lines:` list names the payline
(e.g. `4 (V)`). The controls line is never overwritten. Slots rules and RTP:
`docs/SLOTS.md`.
7. `+` / `=` / `-` after a spin changes only the bet; no stale grid or result
lines appear.
8. `q` clears the board. Ctrl+C in a game clears the board and exits.
9. `info`, `ping`, `send hello`, and `hosts` print readable output; the host
fingerprint fits 80 columns.
10. Windows: repeat 2-9 and confirm keys are not duplicated or printed twice.
## Manual roulette checklist
1. `play roulette` shows the balance, chip size, empty bets, and controls.
2. `R`/`B`/`E`/`O` add one chip; digits + Enter add a number; `C` clears;
`+`/`=`/`-` change the chip size.
3. Space scrolls the wheel under a fixed ball marker and ends on the winning
number.
4. Check a split result:
- `17 black odd`: black+odd pay, red+even lose, straight 17 pays 36x.
- `0`: all outside bets lose; a straight 0 pays 36x.
5. Numbers are color-coded: red numbers red, 0 green, black default. Check the
bets line, the rolling strip, and the winning number.
6. The result board shows the winning number/color/parity, the payout, and the
new balance. The next spin reuses the placed bets.
## Manual blackjack checklist
1. `play blackjack` shows the ready board; Space deals.
2. The dealer's hole card is hidden while it is the player's turn. H/S/D work;
D is only offered on the first two cards and reserves the extra bet.
3. Stand and check the dealer stands on all 17s. Check a dealer bust pays the
player, and a natural blackjack pays 3:2.
4. Q during a hand forfeits the reserved bet (it is **not** refunded); Q after
a hand just leaves. Disconnecting mid-hand also forfeits it.
5. Check the audit row: `game_type = blackjack`, the total bet (including a
double), winnings, and the final cards/result in `details`. A forfeit has
`result = forfeit`, `winnings = 0`.
## Manual crash checklist
1. `play crash` shows the ready board with a 1.00x multiplier; Space starts and
reserves the bet.
2. The multiplier rises smoothly with no network traffic. Cash out with C and
confirm the board shows the cashout multiplier, the payout and the new
balance.
3. On another round, press nothing. The board must switch to `CRASHED at Xx`
by itself when the crash point is reached, and the bet must be lost.
4. Press C just as a round crashes. Either it pays or the crashed result wins;
a late cashout must never show an error over a finished round.
5. Q during a live round forfeits the bet; Q when idle just leaves.
6. Check the audit rows: one per round, `game_type = crash`, the reserved bet,
the payout, and `crash_point`/`multiplier`/`result` in `details`.
7. Confirm the crash point is absent from the `CRASH_START` line (it must only
appear once the round is over).
## Manual restart check
1. Start a blackjack hand (or a crash round) and confirm `pending_plays` has one
row while the round is live.
2. `kill -9` the server, then start it again on the same database. The log must
say `Settled 1 orphaned reservation(s) as abandoned after a restart`.
3. Confirm the balance did not change, `pending_plays` is empty, and `plays` has
one row with `winnings = 0`, `details.result = "abandoned"` and
`details.reason = "server_restart"`.
## Manual server checks
- Register, log out, log in again (bcrypt path).
- Log in with a pre-0.3 user row (legacy SHA-256) and confirm it still works;
the row is upgraded to bcrypt.
- Spin several times and confirm `plays` grows by one row per spin while
`users.balance` changes by `winnings - bet`.
|
