#pragma once #include "evo/network/session_control.hpp" #include #include #include #include #include #include // Production session grants v1 (ADR-0091, schemas/network/session-grant-v1.md): a fixed // 160-byte record ("EVO-GRANT" marker, version, environment, issuer key id, claims) // signed with ECDSA P-256/SHA-256 through Mbed TLS PSA. Regions hold only public keys, // so a compromised region cannot mint grants. The signed environment byte must match // the verifier's environment: a dev-signed grant never verifies in stage or World0, and // M9 dev grants (a different marker and length) never verify here. Grant bytes and keys // have no log form. namespace evo::network { inline constexpr std::size_t session_grant_bytes = 160; inline constexpr std::size_t grant_private_key_bytes = 32; // P-256 scalar. inline constexpr std::size_t grant_public_key_bytes = 65; // Uncompressed point. using SessionGrant = std::array; using GrantPublicKey = std::array; enum class SessionGrantError : std::uint8_t { invalid_key, duplicate_key, too_many_keys, invalid_claims, malformed, wrong_marker, unsupported_version, wrong_environment, unknown_key, bad_signature, crypto }; // Issuer-side signing key (PSA, non-exportable private part). Move-only. class GrantSigningKey { public: [[nodiscard]] static std::expected generate(DeploymentEnvironment environment, std::uint32_t key_id); [[nodiscard]] static std::expected import(DeploymentEnvironment environment, std::uint32_t key_id, std::span private_key); GrantSigningKey(GrantSigningKey&& other) noexcept; GrantSigningKey& operator=(GrantSigningKey&& other) noexcept; GrantSigningKey(const GrantSigningKey&) = delete; GrantSigningKey& operator=(const GrantSigningKey&) = delete; ~GrantSigningKey(); // Structural checks only (nonzero ids, serial and scope, ordered times). [[nodiscard]] std::expected sign(const GrantClaims& claims) const; [[nodiscard]] std::expected public_key() const; [[nodiscard]] DeploymentEnvironment environment() const noexcept { return environment_; } [[nodiscard]] std::uint32_t key_id() const noexcept { return key_id_; } private: GrantSigningKey(DeploymentEnvironment environment, std::uint32_t key_id, std::uint32_t key) : environment_{environment}, key_id_{key_id}, key_{key} {} DeploymentEnvironment environment_; std::uint32_t key_id_; std::uint32_t key_; // PSA key id; zero when moved-from. }; // Region-side verifier for one environment with up to 8 issuer public keys (rotation). class GrantVerifier { public: static constexpr std::size_t max_keys = 8; [[nodiscard]] static std::expected create(DeploymentEnvironment environment); GrantVerifier(GrantVerifier&& other) noexcept; GrantVerifier& operator=(GrantVerifier&& other) noexcept; GrantVerifier(const GrantVerifier&) = delete; GrantVerifier& operator=(const GrantVerifier&) = delete; ~GrantVerifier(); [[nodiscard]] std::expected add_key(std::uint32_t key_id, std::span public_key); // Signature first: no claim byte is trusted before it verifies. [[nodiscard]] std::expected verify(std::span grant) const; private: struct Key { std::uint32_t key_id{}, key{}; }; explicit GrantVerifier(DeploymentEnvironment environment) : environment_{environment} {} void destroy() noexcept; DeploymentEnvironment environment_; std::vector keys_; }; // Cryptographically random bytes (PSA); used for account and grant ids. [[nodiscard]] std::expected random_bytes(std::span out); [[nodiscard]] std::expected generate_account_id(); } // namespace evo::network