Files
aevolution/docs/networking/M10_CLIENT_SESSIONS.md
T
dingoandClaude Opus 5.5 dabeee8e8b
Foundation / checks (deploy) (push) Successful in 3m20s
Foundation / checks (ecs) (push) Successful in 2m0s
Foundation / checks (client) (push) Failing after 12m9s
Foundation / checks (network) (push) Successful in 13m2s
Foundation / checks (tsan) (push) Successful in 8m7s
Foundation / checks (checks) (push) Successful in 32m1s
Foundation / checks (postgres) (push) Successful in 42m43s
Foundation / postgres-tools (push) Skipped
Foundation / server-image (push) Skipped
Foundation / image (push) Skipped
Add M10.8c-2 client handoff switch and evo-server handoff configuration
ADR-0096. The engineering client follows a HandoffOffer into the next region
with its ticket (no grant, no pause, the view kept) and a Redirect to the
probe's owner, picking grants by region claim in rising serial order.
evo-server gains --m10-area, --m10-handoff-key and --m10-neighbour (dev
only), wiring the PostgreSQL probe and handoff ledgers; the probe tool writes
multi-region bundles and reports handoffs and redirects.

Refreshes the dev session window.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-06 21:56:42 -04:00

64 lines
3.1 KiB
Markdown

# Engineering client over M10 sessions (M10.5c)
Decisions: ADR-0091 (grants, bundles, grant lifetime), ADR-0092 (intentions), ADR-0093
(snapshots, interest, client behaviour), ADR-0087 (dev route). **evolution-dev only.**
## Operator: issue a grant bundle
On a machine that holds the dev issuer key (never give the key to testers):
```sh
evo-session-probe grants --issuer-key issuer.key --world 100 --frame 9 --region 1 \
--account <32 hex digits, one per tester> --count 16 --lifetime 3600 --out tester.grants
```
The file is created new and owner-only; it holds 16 single-use grants, valid together for
the lifetime. A lifetime above 300 s needs the region to run with
`--m10-max-grant-lifetime` at least that long (dev only); otherwise every grant is refused.
Issue a new bundle (same account; newer serials are automatic) when one runs out or
expires. Give the tester the bundle and the public dev CA (`dev-ca.pem`).
## Tester: connect
Run `evo-client`, choose **Connect to a dev region** and fill in the endpoint (default
`void.aeternalisgames.com:7400`, UDP; reachable only from 172.10.1.0/24), the server name
on the dev certificate, `dev-ca.pem` and the bundle. Or:
```sh
evo-client --connect void.aeternalisgames.com:7400 --server-name NAME --ca dev-ca.pem \
--grants tester.grants
```
- The view follows the region's default view until you pan or zoom; then the 15 x 15
cells around the camera centre are replicated (radius 7).
- W A S D send movement intentions. They move your probe marker (amber square; others
are blue), an engineering experiment, not an organism (ADR-0094). It is predicted
locally and corrected by the server; the camera follows it until you pan or zoom.
The Session panel lists each intention as sent, admitted, rejected, simulated (final;
intentions are never durable) or unknown, plus the prediction figures. Other players'
markers are shown a few ticks in the past, interpolated (ADR-0095); grey means stale.
- If the connection is lost, the last view stays on screen, frozen and labelled STALE,
until the reconnect brings a fresh view. Nothing you press is sent meanwhile.
- Each reconnect uses the next grant. A second client with a bundle for the same account
takes the session over; the first stops (do not share bundles).
- A server on an older session protocol (v1-v3) refuses the client
(`unsupported_version`): deploy a v4 server first.
## Two regions (M10.8, ADR-0096, EXPERIMENT)
Regions with adjacent areas hand a probe over when it walks across the edge. The client
follows on its own: the view stays on screen, no grant is used, and the Session panel
counts the crossings. Each region needs:
- `--m10-area X0,Y0,X1,Y1` (its cells);
- `--m10-handoff-key issuer.key` (a pair from `evo-session-probe keys`);
- one `--m10-neighbour REGION=X0,Y0,X1,Y1=HOST:PORT=SERVER_NAME=neighbour.pub` per
neighbour.
All of them need schema v13. Issue bundles with one `--region` per region:
```sh
evo-session-probe grants --issuer-key issuer.key --world 100 --frame 9 --region 1 --region 2 --account <hex> --count 8 --lifetime 3600 --out tester.grants
```
A login at a region that does not own the probe is redirected to the one that does.