QSC Post Quantum Cryptographic Library 1.3.0.0 (C1)
A post quantum secure library written in Ansi C
Loading...
Searching...
No Matches
tlstranscript.h
Go to the documentation of this file.
1/* 2020-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 QSC_TLS_TRANSCRIPT_H
53#define QSC_TLS_TRANSCRIPT_H
54
55#include "qsccommon.h"
56#include "tlsstate.h"
57#include "tlserrors.h"
58
59QSC_CPLUSPLUS_ENABLED_START
60
71
81
91
101QSC_EXPORT_API qsc_tls_status qsc_tls_transcript_update(qsc_tls_transcript_state* state, const uint8_t* input, size_t inplen);
102
117QSC_EXPORT_API qsc_tls_status qsc_tls_transcript_snapshot(const qsc_tls_transcript_state* state, uint8_t* output, size_t outlen, size_t* written);
118
132
141
142QSC_CPLUSPLUS_ENABLED_END
143
144#endif
Contains common definitions for the Quantum Secure Cryptographic (QSC) library.
#define QSC_EXPORT_API
API export macro for Microsoft compilers when importing from a DLL.
Definition qsccommon.h:645
Stores the active transcript hash context and its selected hash algorithm.
Definition tlsstate.h:72
TLS status code definitions and diagnostic string conversion.
qsc_tls_status
Definition tlserrors.h:65
TLS internal state container type definitions shared across the record and handshake layers.
QSC_EXPORT_API void qsc_tls_transcript_dispose(qsc_tls_transcript_state *state)
Dispose of a transcript hash state.
Definition tlstranscript.c:54
QSC_EXPORT_API qsc_tls_status qsc_tls_transcript_replace_with_message_hash(qsc_tls_transcript_state *state)
Replace the transcript with the synthetic message_hash form used after HelloRetryRequest.
Definition tlstranscript.c:189
QSC_EXPORT_API qsc_tls_status qsc_tls_transcript_initialize(qsc_tls_transcript_state *state, qsc_tls_hash_algorithm hash)
Initialize a transcript hash state.
Definition tlstranscript.c:6
QSC_EXPORT_API qsc_tls_status qsc_tls_transcript_update(qsc_tls_transcript_state *state, const uint8_t *input, size_t inplen)
Append serialized handshake bytes to the transcript hash.
Definition tlstranscript.c:64
QSC_EXPORT_API size_t qsc_tls_transcript_digest_size(qsc_tls_hash_algorithm hash)
Get the digest size in bytes for a TLS transcript hash algorithm.
Definition tlstranscript.c:274
QSC_EXPORT_API qsc_tls_status qsc_tls_transcript_snapshot(const qsc_tls_transcript_state *state, uint8_t *output, size_t outlen, size_t *written)
Snapshot the current transcript digest without disturbing the ongoing hash state.
Definition tlstranscript.c:111
qsc_tls_hash_algorithm
Identifies the transcript and HKDF hash algorithm associated with a TLS cipher suite.
Definition tlstypes.h:69