Files
aevolution/include/evo/network/session_protocol.hpp
T
dingoandClaude Opus 5.5 7956143cd8
Foundation / checks (deploy) (push) Successful in 5s
Foundation / checks (ecs) (push) Successful in 3m13s
Foundation / checks (client) (push) Successful in 12m12s
Foundation / checks (network) (push) Successful in 8m56s
Foundation / checks (tsan) (push) Successful in 7m42s
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 19m14s
Foundation / checks (checks) (push) Canceled after 31m28s
Add M10.3b session login over QUIC
Session protocol v1 session messages (Hello with grant, Welcome, Refresh,
RefreshResult, Close with reasons) on the QUIC reliable stream. RegionSessions
verifies grants with the issuer public keys and admits them through SessionControl:
a newer grant closes the account's old connection as superseded, expiry and epoch
advances close sessions, every close is announced and flushed. RegionSessionClient
logs in, refreshes in place and reports why a session ended. ADR-0091.

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

86 lines
3.2 KiB
C++

#pragma once
#include <array>
#include <cstddef>
#include <cstdint>
#include <expected>
#include <span>
#include <variant>
#include <vector>
// M10 session protocol v1, session part (ADR-0091, schemas/network/session-v1.md).
// Messages travel on the QUIC reliable stream (one message per framed QUIC message).
// Each starts with an 8-byte header: magic "EVSN", version u16, type u8, flags u8 (0);
// every payload has a fixed size and explicit little-endian fields. Grants are opaque
// 160-byte credentials here. Later M10 segments add message types under a new version.
namespace evo::network {
inline constexpr std::uint32_t session_magic = 0x4E535645; // Bytes "EVSN".
inline constexpr std::uint16_t session_protocol_version = 1;
inline constexpr std::size_t session_header_bytes = 8;
inline constexpr std::size_t session_grant_wire_bytes = 160;
enum class SessionMessageType : std::uint8_t {
hello = 1, // Client -> server: grant.
welcome, // Server -> client.
refresh, // Client -> server: newer grant for the open session.
refresh_result, // Server -> client.
close // Either way, then the sender closes the connection.
};
// Wire values 1..13. `connection_lost` is local only (the transport ended without a Close).
enum class SessionCloseReason : std::uint8_t {
client_closed = 1,
superseded, // A newer grant for the same account opened another session.
expired,
stale_epoch,
unauthenticated,
wrong_scope, // Environment, world or region.
stale_grant, // Replayed or older than a grant already presented.
rate_limited,
capacity,
protocol,
timeout, // No Hello before the deadline.
unsupported_version,
shutdown,
connection_lost = 255
};
enum class SessionCodecError : std::uint8_t {
truncated,
bad_magic,
unsupported_version,
unknown_type,
reserved_flags,
wrong_length,
invalid_value
};
using WireGrant = std::array<std::uint8_t, session_grant_wire_bytes>;
struct SessionHello {
std::uint32_t required_features{}; // Must be zero in v1.
WireGrant grant{};
};
struct SessionWelcome {
std::uint64_t session{}, epoch{}, world{}, frame{}, region{}, expires_at{};
std::uint64_t server_seconds{}; // Server wall clock at Welcome, for refresh timing.
friend bool operator==(const SessionWelcome&, const SessionWelcome&) = default;
};
struct SessionRefresh {
WireGrant grant{};
};
// accepted: 0 and the new expiry. Otherwise a refusal reason (stale_grant,
// unauthenticated, wrong_scope, expired, rate_limited); the session keeps its expiry.
struct SessionRefreshResult {
std::uint8_t status{};
std::uint64_t expires_at{};
friend bool operator==(const SessionRefreshResult&, const SessionRefreshResult&) = default;
};
struct SessionClose {
SessionCloseReason reason{};
};
using SessionMessage =
std::variant<SessionHello, SessionWelcome, SessionRefresh, SessionRefreshResult, SessionClose>;
[[nodiscard]] std::vector<std::uint8_t> encode_session(const SessionMessage& message);
// Exactly one message; any other length for its type rejects.
[[nodiscard]] std::expected<SessionMessage, SessionCodecError>
decode_session(std::span<const std::uint8_t> bytes);
} // namespace evo::network