MCEL: Merkle-Chaining Event Ledger 1.0.0.0a (A1)
A post-quantum secure block-chain ledger system
domain.h
Go to the documentation of this file.
1/* 2025-2026 Quantum Resistant Cryptographic Solutions Corporation
2 * All Rights Reserved.
3 *
4 * NOTICE:
5 * This software and all accompanying materials are the exclusive property of
6 * Quantum Resistant Cryptographic Solutions Corporation (QRCS). The intellectual
7 * and technical concepts contained herein are proprietary to QRCS and are
8 * protected under applicable Canadian, U.S., and international copyright,
9 * patent, and trade secret laws.
10 *
11 * CRYPTOGRAPHIC ALGORITHMS AND IMPLEMENTATIONS:
12 * - This software includes implementations of cryptographic primitives and
13 * algorithms that are standardized or in the public domain, such as AES
14 * and SHA-3, which are not proprietary to QRCS.
15 * - This software also includes cryptographic primitives, constructions, and
16 * algorithms designed by QRCS, including but not limited to RCS, SCB, CSX, QMAC, and
17 * related components, which are proprietary to QRCS.
18 * - All source code, implementations, protocol compositions, optimizations,
19 * parameter selections, and engineering work contained in this software are
20 * original works of QRCS and are protected under this license.
21 *
22 * LICENSE AND USE RESTRICTIONS:
23 * - This software is licensed under the Quantum Resistant Cryptographic Solutions
24 * Public Research and Evaluation License (QRCS-PREL), 2025-2026.
25 * - Permission is granted solely for non-commercial evaluation, academic research,
26 * cryptographic analysis, interoperability testing, and feasibility assessment.
27 * - Commercial use, production deployment, commercial redistribution, or
28 * integration into products or services is strictly prohibited without a
29 * separate written license agreement executed with QRCS.
30 * - Licensing and authorized distribution are solely at the discretion of QRCS.
31 *
32 * EXPERIMENTAL CRYPTOGRAPHY NOTICE:
33 * Portions of this software may include experimental, novel, or evolving
34 * cryptographic designs. Use of this software is entirely at the user's risk.
35 *
36 * DISCLAIMER:
37 * THIS SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
38 * IMPLIED, INCLUDING BUT NOT LIMITED TO WARRANTIES OF MERCHANTABILITY, FITNESS
39 * FOR A PARTICULAR PURPOSE, SECURITY, OR NON-INFRINGEMENT. QRCS DISCLAIMS ALL
40 * LIABILITY FOR ANY DIRECT, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL DAMAGES
41 * ARISING FROM THE USE OR MISUSE OF THIS SOFTWARE.
42 *
43 * FULL LICENSE:
44 * This software is subject to the Quantum Resistant Cryptographic Solutions
45 * Public Research and Evaluation License (QRCS-PREL), 2025-2026. The complete license terms
46 * are provided in the accompanying LICENSE file or at https://www.qrcscorp.ca.
47 *
48 * Written by: John G. Underhill
49 * Contact: contact\qrcscorp.ca
50 */
51
52#ifndef MCEL_DOMAIN_H
53#define MCEL_DOMAIN_H
54
55#include "mcelcommon.h"
56
61
66#define MCEL_DOMAIN_HASH_SIZE 32U
67
72#define MCEL_DOMAIN_NAME_STRING "MCEL-LEDGER"
73
78#define MCEL_DOMAIN_STRING_DEPTH 8U
79
84#define MCEL_DOMAIN_STRING_WIDTH 17U
85
86
102
103static const char USBL_DOMAIN_NAME_STRINGS[MCEL_DOMAIN_STRING_DEPTH][MCEL_DOMAIN_STRING_WIDTH] =
104{
105 "MCEL-DOMAIN-NONE",
106 "MCEL-DOMAIN-BLCK",
107 "MCEL-DOMAIN-CHCK",
108 "MCEL-DOMAIN-CTXT",
109 "MCEL-DOMAIN-NODE",
110 "MCEL-DOMAIN-PTXT",
111 "MCEL-DOMAIN-RCRD",
112 "MCEL-DOMAIN-ANCR",
113};
114
122MCEL_EXPORT_API const char* mcel_domain_to_name(mcel_domain_types domain);
123
134MCEL_EXPORT_API bool mcel_domain_hash_message(uint8_t* output, mcel_domain_types domain, const uint8_t* msg, size_t msglen);
135
136#endif
MCEL_EXPORT_API bool mcel_domain_hash_message(uint8_t *output, mcel_domain_types domain, const uint8_t *msg, size_t msglen)
Compute a 32-byte MCEL domain-separated digest using cSHAKE-256.
Definition domain.c:20
MCEL_EXPORT_API const char * mcel_domain_to_name(mcel_domain_types domain)
Returns the string representation of the domain types enumeration.
Definition domain.c:4
#define MCEL_DOMAIN_STRING_WIDTH
The width of each MCEL domain string.
Definition domain.h:84
#define MCEL_DOMAIN_STRING_DEPTH
The depth of the MCEL domain string array.
Definition domain.h:78
mcel_domain_types
The MCEL hash domain identifiers used to separate commitment types.
Definition domain.h:92
@ mcel_domain_block
Definition domain.h:94
@ mcel_domain_none
Definition domain.h:93
@ mcel_domain_record
Definition domain.h:99
@ mcel_domain_ciphertext
Definition domain.h:96
@ mcel_domain_checkpoint
Definition domain.h:95
@ mcel_domain_node
Definition domain.h:97
@ mcel_domain_plaintext
Definition domain.h:98
@ mcel_domain_anchor
Definition domain.h:100