lc_hqc.h

Go to the documentation of this file.

/*
 * Copyright (C) 2024 - 2025, Stephan Mueller <smueller@chronox.de>
 *
 * License: see LICENSE file in root directory
 *
 * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESS OR IMPLIED
 * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
 * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE, ALL OF
 * WHICH ARE HEREBY DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR BE
 * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
 * OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
 * BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
 * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
 * USE OF THIS SOFTWARE, EVEN IF NOT ADVISED OF THE POSSIBILITY OF SUCH
 * DAMAGE.
 */
 
#ifndef LC_HQC_H
#define LC_HQC_H
 
#include "ext_headers.h"
 
#if defined __has_include
#if __has_include("lc_hqc_256.h")
#include "lc_hqc_256.h"
#define LC_HQC_256_ENABLED
#endif
#if __has_include("lc_hqc_192.h")
#include "lc_hqc_192.h"
#define LC_HQC_192_ENABLED
#endif
#if __has_include("lc_hqc_128.h")
#include "lc_hqc_128.h"
#define LC_HQC_128_ENABLED
#endif
#else
#error "Compiler misses __has_include"
#endif
 
#ifdef __cplusplus
extern "C" {
#endif
 
enum lc_hqc_type {
        LC_HQC_UNKNOWN, 
        LC_HQC_256, 
        LC_HQC_192, 
        LC_HQC_128, 
};

 
/************************************* KEM ************************************/
struct lc_hqc_sk {
        enum lc_hqc_type hqc_type;
        union {
#ifdef LC_HQC_256_ENABLED
                struct lc_hqc_256_sk sk_256;
#endif
#ifdef LC_HQC_192_ENABLED
                struct lc_hqc_192_sk sk_192;
#endif
#ifdef LC_HQC_128_ENABLED
                struct lc_hqc_128_sk sk_128;
#endif
        } key;
};

struct lc_hqc_pk {
        enum lc_hqc_type hqc_type;
        union {
#ifdef LC_HQC_256_ENABLED
                struct lc_hqc_256_pk pk_256;
#endif
#ifdef LC_HQC_192_ENABLED
                struct lc_hqc_192_pk pk_192;
#endif
#ifdef LC_HQC_128_ENABLED
                struct lc_hqc_128_pk pk_128;
#endif
        } key;
};

struct lc_hqc_ct {
        enum lc_hqc_type hqc_type;
        union {
#ifdef LC_HQC_256_ENABLED
                struct lc_hqc_256_ct ct_256;
#endif
#ifdef LC_HQC_192_ENABLED
                struct lc_hqc_192_ct ct_192;
#endif
#ifdef LC_HQC_128_ENABLED
                struct lc_hqc_128_ct ct_128;
#endif
        } key;
};

struct lc_hqc_ss {
        enum lc_hqc_type hqc_type;
        union {
#ifdef LC_HQC_256_ENABLED
                struct lc_hqc_256_ss ss_256;
#endif
#ifdef LC_HQC_192_ENABLED
                struct lc_hqc_192_ss ss_192;
#endif
#ifdef LC_HQC_128_ENABLED
                struct lc_hqc_128_ss ss_128;
#endif
        } key;
};

enum lc_hqc_type lc_hqc_sk_type(const struct lc_hqc_sk *sk);

enum lc_hqc_type lc_hqc_pk_type(const struct lc_hqc_pk *pk);

enum lc_hqc_type lc_hqc_ct_type(const struct lc_hqc_ct *ct);

enum lc_hqc_type lc_hqc_ss_type(const struct lc_hqc_ss *ss);

LC_PURE
unsigned int lc_hqc_sk_size(enum lc_hqc_type hqc_type);

LC_PURE
unsigned int lc_hqc_pk_size(enum lc_hqc_type hqc_type);

LC_PURE
unsigned int lc_hqc_ct_size(enum lc_hqc_type hqc_type);

LC_PURE
unsigned int lc_hqc_ss_size(enum lc_hqc_type hqc_type);

int lc_hqc_sk_load(struct lc_hqc_sk *sk, const uint8_t *src_key,
                   size_t src_key_len);

int lc_hqc_pk_load(struct lc_hqc_pk *pk, const uint8_t *src_key,
                   size_t src_key_len);

int lc_hqc_ct_load(struct lc_hqc_ct *ct, const uint8_t *src_key,
                   size_t src_key_len);

int lc_hqc_ss_load(struct lc_hqc_ss *ss, const uint8_t *src_key,
                   size_t src_key_len);

int lc_hqc_sk_ptr(uint8_t **hqc_key, size_t *hqc_key_len, struct lc_hqc_sk *sk);

int lc_hqc_pk_ptr(uint8_t **hqc_key, size_t *hqc_key_len, struct lc_hqc_pk *pk);

int lc_hqc_ct_ptr(uint8_t **hqc_ct, size_t *hqc_ct_len, struct lc_hqc_ct *ct);

int lc_hqc_ss_ptr(uint8_t **hqc_ss, size_t *hqc_ss_len, struct lc_hqc_ss *ss);

int lc_hqc_keypair(struct lc_hqc_pk *pk, struct lc_hqc_sk *sk,
                   struct lc_rng_ctx *rng_ctx, enum lc_hqc_type hqc_type);

int lc_hqc_keypair_from_seed(struct lc_hqc_pk *pk, struct lc_hqc_sk *sk,
                             const uint8_t *seed, size_t seedlen,
                             enum lc_hqc_type hqc_type);

int lc_hqc_enc(struct lc_hqc_ct *ct, struct lc_hqc_ss *ss,
               const struct lc_hqc_pk *pk);

int lc_hqc_enc_kdf(struct lc_hqc_ct *ct, uint8_t *ss, size_t ss_len,
                   const struct lc_hqc_pk *pk);

int lc_hqc_dec(struct lc_hqc_ss *ss, const struct lc_hqc_ct *ct,
               const struct lc_hqc_sk *sk);

int lc_hqc_dec_kdf(uint8_t *ss, size_t ss_len, const struct lc_hqc_ct *ct,
                   const struct lc_hqc_sk *sk);
 
#ifdef __cplusplus
}
#endif
 
#endif /* LC_HQC_H */