# 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; the Session panel lists each as sent, admitted, rejected, simulated (final; intentions are never durable) or unknown. - 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 still on session protocol v1 refuses the client (`unsupported_version`): deploy the v2 server first.