Files
aevolution/schemas/network/session-grant-v1.md
T
dingoandClaude Opus 5.5 01b4b06a09
Foundation / checks (deploy) (push) Successful in 5s
Foundation / checks (ecs) (push) Successful in 1m47s
Foundation / checks (client) (push) Failing after 9m42s
Foundation / checks (network) (push) Successful in 8m49s
Foundation / postgres-tools (push) Canceled after 0s
Foundation / server-image (push) Canceled after 0s
Foundation / image (push) Canceled after 0s
Foundation / checks (postgres) (push) Canceled after 8m13s
Foundation / checks (tsan) (push) Canceled after 7m13s
Foundation / checks (checks) (push) Canceled after 17m58s
Add M10.3a account-bound session grants and region session control
Provider-independent 128-bit AccountIds; ECDSA P-256 session grants v1 signed by
issuer keys and verified by regions with public keys only, the environment byte
signed so dev grants never verify in stage or World0. Per-account serials make the
newest grant win: replay and older stolen grants are refused, a newer grant replaces
the account's session, and refresh renews in place. Attempt rates and capacities
are bounded. The evo_identity library provides the provider, account directory and
grant issuer interfaces with a dev-only test provider. ADR-0091.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-03 20:54:04 -04:00

1.4 KiB

Session grant, version 1

Production session grant for M10 (ADR-0091). Implemented by GrantSigningKey::sign and GrantVerifier::verify (include/evo/network/session_grant.hpp). Fixed length 160 bytes; integers little-endian. Any other length, marker, version, reserved value or environment is refused. Grants are credentials: never log, persist or display them.

Offset Size Field Rule
0 16 marker EVO-GRANT followed by 7 zero bytes
16 2 version 1
18 1 environment 1 dev, 2 stage, 3 World0; must equal the verifier's
19 1 reserved 0
20 4 key_id issuer key id, nonzero; selects the verifying public key
24 8 grant_id random, nonzero
32 16 account AccountId, not all zero
48 8 serial per-account, strictly increasing, nonzero
56 8 world nonzero
64 8 frame nonzero
72 8 region nonzero
80 8 issued_at seconds, issuer clock; non-decreasing per account
88 8 expires_at seconds; greater than issued_at
96 64 signature ECDSA P-256, SHA-256 over bytes 0..95, raw r || s

Verification order: length, key id lookup, signature, marker, version and reserved, environment, claim structure. Regions then apply scope, lifetime (at most their maximum, 300 s by default), clock skew, expiry and the serial rule (ADR-0091). A change to any field or rule is a new version.