tlstypes.h

Go to the documentation of this file.

/* 2020-2026 Quantum Resistant Cryptographic Solutions Corporation
 * All Rights Reserved.
 *
 * NOTICE:
 * This software and all accompanying materials are the exclusive property of
 * Quantum Resistant Cryptographic Solutions Corporation (QRCS). The intellectual
 * and technical concepts contained herein are proprietary to QRCS and are
 * protected under applicable Canadian, U.S., and international copyright,
 * patent, and trade secret laws.
 *
 * CRYPTOGRAPHIC ALGORITHMS AND IMPLEMENTATIONS:
 * - This software includes implementations of cryptographic primitives and
 *   algorithms that are standardized or in the public domain, such as AES
 *   and SHA-3, which are not proprietary to QRCS.
 * - This software also includes cryptographic primitives, constructions, and
 *   algorithms designed by QRCS, including but not limited to RCS, SCB, CSX, QMAC, and
 *   related components, which are proprietary to QRCS.
 * - All source code, implementations, protocol compositions, optimizations,
 *   parameter selections, and engineering work contained in this software are
 *   original works of QRCS and are protected under this license.
 *
 * LICENSE AND USE RESTRICTIONS:
 * - This software is licensed under the Quantum Resistant Cryptographic Solutions
 *   Public Research and Evaluation License (QRCS-PREL), 2025-2026.
 * - Permission is granted solely for non-commercial evaluation, academic research,
 *   cryptographic analysis, interoperability testing, and feasibility assessment.
 * - Commercial use, production deployment, commercial redistribution, or
 *   integration into products or services is strictly prohibited without a
 *   separate written license agreement executed with QRCS.
 * - Licensing and authorized distribution are solely at the discretion of QRCS.
 *
 * EXPERIMENTAL CRYPTOGRAPHY NOTICE:
 * Portions of this software may include experimental, novel, or evolving
 * cryptographic designs. Use of this software is entirely at the user's risk.
 *
 * DISCLAIMER:
 * THIS SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 * IMPLIED, INCLUDING BUT NOT LIMITED TO WARRANTIES OF MERCHANTABILITY, FITNESS
 * FOR A PARTICULAR PURPOSE, SECURITY, OR NON-INFRINGEMENT. QRCS DISCLAIMS ALL
 * LIABILITY FOR ANY DIRECT, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL DAMAGES
 * ARISING FROM THE USE OR MISUSE OF THIS SOFTWARE.
 *
 * FULL LICENSE:
 * This software is subject to the Quantum Resistant Cryptographic Solutions
 * Public Research and Evaluation License (QRCS-PREL), 2025-2026. The complete license terms
 * are provided in the accompanying LICENSE file or at https://www.qrcscorp.ca.
 *
 * Written by: John G. Underhill
 * Contact: contact@qrcscorp.ca
 */
 
#ifndef QSC_TLS_TYPES_H
#define QSC_TLS_TYPES_H
 
#include "qsccommon.h"
 
QSC_CPLUSPLUS_ENABLED_START


typedef enum qsc_tls_hash_algorithm
{
    qsc_tls_hash_none = 0,     
    qsc_tls_hash_sha256 = 1, 
    qsc_tls_hash_sha384 = 2, 
    qsc_tls_hash_sha512 = 3      
} qsc_tls_hash_algorithm;

typedef enum qsc_tls_record_content_type
{
    qsc_tls_record_content_invalid = 0,               
    qsc_tls_record_content_change_cipher_spec = 20, 
    qsc_tls_record_content_alert = 21,              
    qsc_tls_record_content_handshake = 22,          
    qsc_tls_record_content_application_data = 23 
} qsc_tls_record_content_type;

typedef enum qsc_tls_alert_description
{
    qsc_tls_alert_close_notify = 0,                           
    qsc_tls_alert_unexpected_message = 10,                  
    qsc_tls_alert_bad_record_mac = 20,                      
    qsc_tls_alert_record_overflow = 22,                        
    qsc_tls_alert_handshake_failure = 40,                    
    qsc_tls_alert_bad_certificate = 42,                        
    qsc_tls_alert_unsupported_certificate = 43,                
    qsc_tls_alert_certificate_revoked = 44,                    
    qsc_tls_alert_certificate_expired = 45,                    
    qsc_tls_alert_certificate_unknown = 46,                    
    qsc_tls_alert_illegal_parameter = 47,                    
    qsc_tls_alert_unknown_ca = 48,                          
    qsc_tls_alert_access_denied = 49,                        
    qsc_tls_alert_decode_error = 50,                      
    qsc_tls_alert_decrypt_error = 51,                        
    qsc_tls_alert_protocol_version = 70,                  
    qsc_tls_alert_insufficient_security = 71,                
    qsc_tls_alert_internal_error = 80,                      
    qsc_tls_alert_inappropriate_fallback = 86,              
    qsc_tls_alert_user_canceled = 90,                        
    qsc_tls_alert_missing_extension = 109,                   
    qsc_tls_alert_unsupported_extension = 110,               
    qsc_tls_alert_unrecognized_name = 112,                   
    qsc_tls_alert_bad_certificate_status_response = 113,   
    qsc_tls_alert_unknown_psk_identity = 115,             
    qsc_tls_alert_certificate_required = 116,             
    qsc_tls_alert_no_application_protocol = 120                
} qsc_tls_alert_description;

typedef enum qsc_tls_cipher_suite
{
    qsc_tls_cipher_suite_none = 0,                             
    qsc_tls_cipher_suite_tls_aes_128_gcm_sha256 = 0x1301,        
    qsc_tls_cipher_suite_tls_aes_256_gcm_sha384 = 0x1302,        
    qsc_tls_cipher_suite_tls_chacha20_poly1305_sha256 = 0x1303 
} qsc_tls_cipher_suite;

typedef enum qsc_tls_extension_type
{
    qsc_tls_extension_server_name = 0,                             
    qsc_tls_extension_pre_shared_key = 41,                          
    qsc_tls_extension_early_data = 42,                              
    qsc_tls_extension_supported_groups = 10,                      
    qsc_tls_extension_signature_algorithms = 13,                  
    qsc_tls_extension_application_layer_protocol_negotiation = 16,  
    qsc_tls_extension_supported_versions = 43,                      
    qsc_tls_extension_psk_key_exchange_modes = 45,                  
    qsc_tls_extension_signature_algorithms_cert = 50,                
    qsc_tls_extension_key_share = 51                             
} qsc_tls_extension_type;

typedef enum qsc_tls_named_group
{
    qsc_tls_group_none = 0,                           
    qsc_tls_group_secp256r1 = 0x0017,                
    qsc_tls_group_secp384r1 = 0x0018,                
    qsc_tls_group_secp521r1 = 0x0019,                
    qsc_tls_group_x25519 = 0x001D,                  
    qsc_tls_group_x448 = 0x001E,                  
    qsc_tls_group_mlkem512 = 0x0200,              
    qsc_tls_group_mlkem768 = 0x0201,              
    qsc_tls_group_mlkem1024 = 0x0202,                
    qsc_tls_group_x25519_mlkem768 = 0x11EC,            
    qsc_tls_group_secp256r1_mlkem768 = 0x11EB,      
    qsc_tls_group_secp384r1_mlkem1024 = 0x11ED     
} qsc_tls_named_group;

typedef enum qsc_tls_signature_scheme
{
    qsc_tls_sig_none = 0,                           
    qsc_tls_sig_ecdsa_secp256r1_sha256 = 0x0403,  
    qsc_tls_sig_ecdsa_secp384r1_sha384 = 0x0503,  
    qsc_tls_sig_ed25519 = 0x0807,                    
    qsc_tls_sig_mldsa44 = 0x0904,                    
    qsc_tls_sig_mldsa65 = 0x0905,                    
    qsc_tls_sig_mldsa87 = 0x0906                 
} qsc_tls_signature_scheme;

typedef enum qsc_tls_handshake_type
{
    qsc_tls_handshake_type_hello_request = 0,           
    qsc_tls_handshake_type_client_hello = 1,         
    qsc_tls_handshake_type_server_hello = 2,         
    qsc_tls_handshake_type_new_session_ticket = 4,     
    qsc_tls_handshake_type_end_of_early_data = 5,       
    qsc_tls_handshake_type_encrypted_extensions = 8, 
    qsc_tls_handshake_type_certificate = 11,          
    qsc_tls_handshake_type_certificate_request = 13,  
    qsc_tls_handshake_type_certificate_verify = 15,        
    qsc_tls_handshake_type_finished = 20,                
    qsc_tls_handshake_type_key_update = 24,                
    qsc_tls_handshake_type_message_hash = 254            
} qsc_tls_handshake_type;

typedef enum qsc_tls_psk_key_exchange_mode
{
    qsc_tls_psk_key_exchange_mode_psk_ke = 0,           
    qsc_tls_psk_key_exchange_mode_psk_dhe_ke = 1        
} qsc_tls_psk_key_exchange_mode;

typedef enum qsc_tls_certificate_type
{
    qsc_tls_certificate_type_x509 = 0,                 
    qsc_tls_certificate_type_raw_public_key = 2          
} qsc_tls_certificate_type;

typedef enum qsc_tls_alert_level
{
    qsc_tls_alert_level_warning = 1,                 
    qsc_tls_alert_level_fatal = 2                      
} qsc_tls_alert_level;
 
QSC_CPLUSPLUS_ENABLED_END
 
#endif