keys.h

Go to the documentation of this file.

// BSD 3-Clause License
// Copyright (c) 2024, 🍀☀🌕🌥 🌊
// See the LICENSE file in the project root for full license information.
 
#pragma once
 
#include <array>
#include <cstdint>
#include <string>
 
namespace kcenon::network::protocols::quic
{
 
// ============================================================================
// Constants
// ============================================================================
 
constexpr size_t aes_128_key_size = 16;
 
constexpr size_t aes_256_key_size = 32;
 
constexpr size_t aead_iv_size = 12;
 
constexpr size_t aead_tag_size = 16;
 
constexpr size_t secret_size = 32;
 
constexpr size_t hp_key_size = 16;
 
constexpr size_t hp_sample_size = 16;
 
// ============================================================================
// Encryption Levels
// ============================================================================
 
enum class encryption_level : uint8_t
{
    initial = 0,      
    handshake = 1,    
    zero_rtt = 2,     
    application = 3   
};
 
[[nodiscard]] auto encryption_level_to_string(encryption_level level) -> std::string;
 
[[nodiscard]] constexpr auto encryption_level_count() noexcept -> size_t
{
    return 4;
}
 
// ============================================================================
// Key Structures
// ============================================================================
 
struct quic_keys
{
    std::array<uint8_t, secret_size> secret{};
 
    std::array<uint8_t, aes_128_key_size> key{};
 
    std::array<uint8_t, aead_iv_size> iv{};
 
    std::array<uint8_t, hp_key_size> hp_key{};
 
    [[nodiscard]] auto is_valid() const noexcept -> bool;
 
    void clear() noexcept;
 
    [[nodiscard]] auto operator==(const quic_keys& other) const noexcept -> bool;
 
    [[nodiscard]] auto operator!=(const quic_keys& other) const noexcept -> bool;
};
 
struct key_pair
{
    quic_keys read;   
    quic_keys write;  
 
    [[nodiscard]] auto is_valid() const noexcept -> bool;
 
    void clear() noexcept;
};
 
} // namespace kcenon::network::protocols::quic