topology.h

Go to the documentation of this file.

/* 2025 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 within this implementation 
 * are proprietary to QRCS and its authorized licensors and are protected under 
 * applicable U.S. and international copyright, patent, and trade secret laws.
 *
 * CRYPTOGRAPHIC STANDARDS:
 * - This software includes implementations of cryptographic algorithms such as 
 *   SHA3, AES, and others. These algorithms are public domain or standardized 
 *   by organizations such as NIST and are NOT the property of QRCS.
 * - However, all source code, optimizations, and implementations in this library 
 *   are original works of QRCS and are protected under this license.
 *
 * RESTRICTIONS:
 * - Redistribution, modification, or unauthorized distribution of this software, 
 *   in whole or in part, is strictly prohibited.
 * - This software is provided for non-commercial, educational, and research 
 *   purposes only. Commercial use in any form is expressly forbidden.
 * - Licensing and authorized distribution are solely at the discretion of QRCS.
 * - Any use of this software implies acceptance of these restrictions.
 *
 * DISCLAIMER:
 * This software is provided "as is," without warranty of any kind, express or 
 * implied, including but not limited to warranties of merchantability or fitness 
 * for a particular purpose. QRCS disclaims all liability for any direct, indirect, 
 * incidental, or consequential damages resulting from the use or misuse of this software.
 *
 * FULL LICENSE:
 * This software is subject to the **Quantum Resistant Cryptographic Solutions 
 * Proprietary License (QRCS-PL)**. The complete license terms are included 
 * in the LICENSE.txt file distributed with this software.
 *
 * Written by: John G. Underhill
 * Contact: john.underhill@protonmail.com
 */
 
#ifndef MPDC_TOPOLOGY_H
#define MPDC_TOPOLOGY_H
 
#include "mpdc.h"
#include "certificate.h"
#include "../../QSC/QSC/ipinfo.h"
#include "../../QSC/QSC/list.h"
#include "../../QSC/QSC/timestamp.h"

 
/*---------------------------------------------------------------------------
  MACRO DEFINITIONS
---------------------------------------------------------------------------*/

#if defined(MPDC_NETWORK_PROTOCOL_IPV6)
#   define MPDC_TOPOLOGY_NODE_ENCODED_SIZE (MPDC_CHILD_CERTIFICATE_ISSUER_PREFIX_SIZE + MPDC_CERTIFICATE_ISSUER_SIZE + MPDC_CERTIFICATE_SEPERATOR_SIZE + \
    MPDC_CHILD_CERTIFICATE_ADDRESS_PREFIX_SIZE + QSC_IPINFO_IPV6_STRNLEN + MPDC_CERTIFICATE_SEPERATOR_SIZE + \
    MPDC_ROOT_CERTIFICATE_HASH_PREFIX_SIZE + (MPDC_CERTIFICATE_HASH_SIZE * 2) + MPDC_CERTIFICATE_SEPERATOR_SIZE + \
    MPDC_CHILD_CERTIFICATE_SERIAL_PREFIX_SIZE + (MPDC_CERTIFICATE_SERIAL_SIZE * 2) + MPDC_CERTIFICATE_SEPERATOR_SIZE + \
    MPDC_CHILD_CERTIFICATE_DESIGNATION_PREFIX_SIZE + MPDC_NETWORK_DESIGNATION_SIZE + MPDC_CERTIFICATE_SEPERATOR_SIZE + \
    MPDC_CHILD_CERTIFICATE_VALID_FROM_PREFIX_SIZE + QSC_TIMESTAMP_STRING_SIZE + MPDC_CERTIFICATE_SEPERATOR_SIZE + \
    MPDC_CHILD_CERTIFICATE_EXPIRATION_TO_PREFIX_SIZE + QSC_TIMESTAMP_STRING_SIZE + MPDC_CERTIFICATE_SEPERATOR_SIZE)
#else
#   define MPDC_TOPOLOGY_NODE_ENCODED_SIZE (MPDC_CHILD_CERTIFICATE_ISSUER_PREFIX_SIZE + MPDC_CERTIFICATE_ISSUER_SIZE + MPDC_CERTIFICATE_SEPERATOR_SIZE + \
    MPDC_CHILD_CERTIFICATE_ADDRESS_PREFIX_SIZE + QSC_IPINFO_IPV4_STRNLEN + MPDC_CERTIFICATE_SEPERATOR_SIZE + \
    MPDC_ROOT_CERTIFICATE_HASH_PREFIX_SIZE + (MPDC_CERTIFICATE_HASH_SIZE * 2) + MPDC_CERTIFICATE_SEPERATOR_SIZE + \
    MPDC_CHILD_CERTIFICATE_SERIAL_PREFIX_SIZE + (MPDC_CERTIFICATE_SERIAL_SIZE * 2) + MPDC_CERTIFICATE_SEPERATOR_SIZE + \
    MPDC_CHILD_CERTIFICATE_DESIGNATION_PREFIX_SIZE + MPDC_NETWORK_DESIGNATION_SIZE + MPDC_CERTIFICATE_SEPERATOR_SIZE + \
    MPDC_CHILD_CERTIFICATE_VALID_FROM_PREFIX_SIZE + QSC_TIMESTAMP_STRING_SIZE + MPDC_CERTIFICATE_SEPERATOR_SIZE + \
    MPDC_CHILD_CERTIFICATE_EXPIRATION_TO_PREFIX_SIZE + QSC_TIMESTAMP_STRING_SIZE + MPDC_CERTIFICATE_SEPERATOR_SIZE)
#endif

#define MPDC_TOPOLOGY_NODE_MINIMUM_ISSUER_SIZE 3

#define MPDC_TOPOLOGY_NODE_NOT_FOUND -1

#define MPDC_NETWORK_TOPOLOGY_MAX_SIZE 1024

#define MPDC_NETWORK_TOPOLOGY_NODE_SIZE (MPDC_CERTIFICATE_ADDRESS_SIZE + \
    MPDC_CERTIFICATE_HASH_SIZE + \
    MPDC_CERTIFICATE_SERIAL_SIZE + \
    MPDC_CERTIFICATE_ISSUER_SIZE + \
    MPDC_CERTIFICATE_EXPIRATION_SIZE + \
    MPDC_CERTIFICATE_DESIGNATION_SIZE)
 
/*---------------------------------------------------------------------------
  STATIC CONSTANTS
---------------------------------------------------------------------------*/

static const char MPDC_TOPOLOGY_NETWORK_DELIMITER[] = "/";

static const char MPDC_TOPOLOGY_CTYPE_DELIMITER[] = ".";

static const char MPDC_TOPOLOGY_ALIAS_DELIMITER[] = ":";
 
/*---------------------------------------------------------------------------
  DATA STRUCTURES
---------------------------------------------------------------------------*/

MPDC_EXPORT_API typedef struct mpdc_topology_node_state
{
    char address[MPDC_CERTIFICATE_ADDRESS_SIZE];        
    uint8_t chash[MPDC_CERTIFICATE_HASH_SIZE];           
    uint8_t serial[MPDC_CERTIFICATE_SERIAL_SIZE];     
    char issuer[MPDC_CERTIFICATE_ISSUER_SIZE];            
    mpdc_certificate_expiration expiration;                
    mpdc_network_designations designation;              
} mpdc_topology_node_state;

MPDC_EXPORT_API typedef struct mpdc_topology_list_state
{
    uint8_t* topology;                                  
    uint32_t count;                                        
} mpdc_topology_list_state;
 
/*---------------------------------------------------------------------------
  FUNCTION PROTOTYPES
---------------------------------------------------------------------------*/

MPDC_EXPORT_API void mpdc_topology_address_from_issuer(char* address, const char* issuer, const mpdc_topology_list_state* list);

MPDC_EXPORT_API void mpdc_topology_node_add_alias(mpdc_topology_node_state* node, const char* alias);

MPDC_EXPORT_API bool mpdc_topology_nodes_are_equal(const mpdc_topology_node_state* a, const mpdc_topology_node_state* b);

MPDC_EXPORT_API uint8_t* mpdc_topology_child_add_empty_node(mpdc_topology_list_state* list);

MPDC_EXPORT_API void mpdc_topology_child_add_item(mpdc_topology_list_state* list, const mpdc_topology_node_state* node);

MPDC_EXPORT_API bool mpdc_topology_canonical_to_issuer_name(char* issuer, size_t isslen, const char* domain, const char* cname);

MPDC_EXPORT_API bool mpdc_topology_issuer_to_canonical_name(char* cname, size_t namelen, const char* issuer);

MPDC_EXPORT_API void mpdc_topology_child_register(mpdc_topology_list_state* list, const mpdc_child_certificate* ccert, const char* address);

MPDC_EXPORT_API void mpdc_topology_list_clone(const mpdc_topology_list_state* tlist, mpdc_topology_list_state* tcopy);

MPDC_EXPORT_API void mpdc_topology_list_deserialize(mpdc_topology_list_state* list, const uint8_t* input, size_t inplen);

MPDC_EXPORT_API void mpdc_topology_list_dispose(mpdc_topology_list_state* list);

MPDC_EXPORT_API void mpdc_topology_list_initialize(mpdc_topology_list_state* list);

MPDC_EXPORT_API bool mpdc_topology_list_item(const mpdc_topology_list_state* list, mpdc_topology_node_state* node, size_t index);

MPDC_EXPORT_API size_t mpdc_topology_list_remove_duplicates(mpdc_topology_list_state* list);

MPDC_EXPORT_API size_t mpdc_topology_list_server_count(const mpdc_topology_list_state* list, mpdc_network_designations ntype);

MPDC_EXPORT_API size_t mpdc_topology_list_serialize(uint8_t* output, const mpdc_topology_list_state* list);

MPDC_EXPORT_API size_t mpdc_topology_list_size(const mpdc_topology_list_state* list);

MPDC_EXPORT_API size_t mpdc_topology_list_to_string(const mpdc_topology_list_state* list, char* output, size_t outlen);

MPDC_EXPORT_API size_t mpdc_topology_list_update_pack(uint8_t* output, const mpdc_topology_list_state* list, mpdc_network_designations ntype);

MPDC_EXPORT_API size_t mpdc_topology_list_update_unpack(mpdc_topology_list_state* list, const uint8_t* input, size_t inplen);

MPDC_EXPORT_API size_t mpdc_topology_ordered_server_list(mpdc_topology_list_state* olist, const mpdc_topology_list_state* tlist, mpdc_network_designations ntype);

MPDC_EXPORT_API void mpdc_topology_node_clear(mpdc_topology_node_state* node);

MPDC_EXPORT_API void mpdc_topology_node_copy(const mpdc_topology_node_state* source, mpdc_topology_node_state* destination);

MPDC_EXPORT_API void mpdc_topology_node_deserialize(mpdc_topology_node_state* node, const uint8_t* input);

MPDC_EXPORT_API size_t mpdc_topology_node_encode(const mpdc_topology_node_state* node, char output[MPDC_TOPOLOGY_NODE_ENCODED_SIZE]);

MPDC_EXPORT_API bool mpdc_topology_node_exists(const mpdc_topology_list_state* list, const uint8_t* serial);

MPDC_EXPORT_API int32_t mpdc_topology_node_get_index(const mpdc_topology_list_state* list, const uint8_t* serial);

MPDC_EXPORT_API bool mpdc_topology_node_find(const mpdc_topology_list_state* list, mpdc_topology_node_state* node, const uint8_t* serial);

MPDC_EXPORT_API bool mpdc_topology_node_find_address(const mpdc_topology_list_state* list, mpdc_topology_node_state* node, const char* address);

MPDC_EXPORT_API bool mpdc_topology_node_find_alias(const mpdc_topology_list_state* list, mpdc_topology_node_state* node, const char* alias);

MPDC_EXPORT_API bool mpdc_topology_node_find_dla(const mpdc_topology_list_state* list, mpdc_topology_node_state* node);

MPDC_EXPORT_API bool mpdc_topology_node_find_issuer(const mpdc_topology_list_state* list, mpdc_topology_node_state* node, const char* issuer);

MPDC_EXPORT_API bool mpdc_topology_node_find_root(const mpdc_topology_list_state* list, mpdc_topology_node_state* node);

MPDC_EXPORT_API void mpdc_topology_node_remove(mpdc_topology_list_state* list, const uint8_t* serial);

MPDC_EXPORT_API void mpdc_topology_node_remove_duplicate(mpdc_topology_list_state* list, const char* issuer);

MPDC_EXPORT_API bool mpdc_topology_node_verify_dla(const mpdc_topology_list_state* list, const mpdc_child_certificate* ccert);

MPDC_EXPORT_API bool mpdc_topology_node_verify_issuer(const mpdc_topology_list_state* list, const mpdc_child_certificate* ccert, const char* issuer);

MPDC_EXPORT_API bool mpdc_topology_node_verify_root(const mpdc_topology_list_state* list, const mpdc_root_certificate* rcert);

MPDC_EXPORT_API size_t mpdc_topology_node_serialize(uint8_t* output, const mpdc_topology_node_state* node);

MPDC_EXPORT_API void mpdc_topology_root_register(mpdc_topology_list_state* list, const mpdc_root_certificate* rcert, const char* address);

MPDC_EXPORT_API void mpdc_topology_from_file(const char* fpath, mpdc_topology_list_state* list);

MPDC_EXPORT_API void mpdc_topology_to_file(const mpdc_topology_list_state* list, const char* fpath);
 
#if defined(QSC_DEBUG_MODE)
MPDC_EXPORT_API bool mpdc_topology_functions_test();
#endif
 
#endif