lc_bike.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_BIKE_H
#define LC_BIKE_H
 
#include "ext_headers.h"
 
#if defined __has_include
#if __has_include("lc_bike_5.h")
#include "lc_bike_5.h"
#define LC_BIKE_5_ENABLED
#endif
#if __has_include("lc_bike_3.h")
#include "lc_bike_3.h"
#define LC_BIKE_3_ENABLED
#endif
#if __has_include("lc_bike_1.h")
#include "lc_bike_1.h"
#define LC_BIKE_1_ENABLED
#endif
#else
#error "Compiler misses __has_include"
#endif
 
#ifdef __cplusplus
extern "C" {
#endif
 
enum lc_bike_type {
        LC_BIKE_UNKNOWN, 
        LC_BIKE_5, 
        LC_BIKE_3, 
        LC_BIKE_1, 
};

 
/************************************* KEM ************************************/
struct lc_bike_sk {
        enum lc_bike_type bike_type;
        union {
#ifdef LC_BIKE_5_ENABLED
                struct lc_bike_5_sk sk_5;
#endif
#ifdef LC_BIKE_3_ENABLED
                struct lc_bike_3_sk sk_3;
#endif
#ifdef LC_BIKE_1_ENABLED
                struct lc_bike_1_sk sk_1;
#endif
        } key;
};

struct lc_bike_pk {
        enum lc_bike_type bike_type;
        union {
#ifdef LC_BIKE_5_ENABLED
                struct lc_bike_5_pk pk_5;
#endif
#ifdef LC_BIKE_3_ENABLED
                struct lc_bike_3_pk pk_3;
#endif
#ifdef LC_BIKE_1_ENABLED
                struct lc_bike_1_pk pk_1;
#endif
        } key;
};

struct lc_bike_ct {
        enum lc_bike_type bike_type;
        union {
#ifdef LC_BIKE_5_ENABLED
                struct lc_bike_5_ct ct_5;
#endif
#ifdef LC_BIKE_3_ENABLED
                struct lc_bike_3_ct ct_3;
#endif
#ifdef LC_BIKE_1_ENABLED
                struct lc_bike_1_ct ct_1;
#endif
        } key;
};

struct lc_bike_ss {
        enum lc_bike_type bike_type;
        union {
#ifdef LC_BIKE_5_ENABLED
                struct lc_bike_5_ss ss_5;
#endif
#ifdef LC_BIKE_3_ENABLED
                struct lc_bike_3_ss ss_3;
#endif
#ifdef LC_BIKE_1_ENABLED
                struct lc_bike_1_ss ss_1;
#endif
        } key;
};

enum lc_bike_type lc_bike_sk_type(const struct lc_bike_sk *sk);

enum lc_bike_type lc_bike_pk_type(const struct lc_bike_pk *pk);

enum lc_bike_type lc_bike_ct_type(const struct lc_bike_ct *ct);

enum lc_bike_type lc_bike_ss_type(const struct lc_bike_ss *ss);

LC_PURE
unsigned int lc_bike_sk_size(enum lc_bike_type bike_type);

LC_PURE
unsigned int lc_bike_pk_size(enum lc_bike_type bike_type);

LC_PURE
unsigned int lc_bike_ct_size(enum lc_bike_type bike_type);

LC_PURE
unsigned int lc_bike_ss_size(enum lc_bike_type bike_type);

int lc_bike_sk_load(struct lc_bike_sk *sk, const uint8_t *src_key,
                    size_t src_key_len);

int lc_bike_pk_load(struct lc_bike_pk *pk, const uint8_t *src_key,
                    size_t src_key_len);

int lc_bike_ct_load(struct lc_bike_ct *ct, const uint8_t *src_key,
                    size_t src_key_len);

int lc_bike_ss_load(struct lc_bike_ss *ss, const uint8_t *src_key,
                    size_t src_key_len);

int lc_bike_sk_ptr(uint8_t **bike_key, size_t *bike_key_len,
                   struct lc_bike_sk *sk);

int lc_bike_pk_ptr(uint8_t **bike_key, size_t *bike_key_len,
                   struct lc_bike_pk *pk);

int lc_bike_ct_ptr(uint8_t **bike_ct, size_t *bike_ct_len,
                   struct lc_bike_ct *ct);

int lc_bike_ss_ptr(uint8_t **bike_ss, size_t *bike_ss_len,
                   struct lc_bike_ss *ss);

int lc_bike_keypair(struct lc_bike_pk *pk, struct lc_bike_sk *sk,
                    struct lc_rng_ctx *rng_ctx, enum lc_bike_type bike_type);

int lc_bike_keypair_from_seed(struct lc_bike_pk *pk, struct lc_bike_sk *sk,
                              const uint8_t *seed, size_t seedlen,
                              enum lc_bike_type bike_type);

int lc_bike_enc(struct lc_bike_ct *ct, struct lc_bike_ss *ss,
                const struct lc_bike_pk *pk);

int lc_bike_enc_kdf(struct lc_bike_ct *ct, uint8_t *ss, size_t ss_len,
                    const struct lc_bike_pk *pk);

int lc_bike_dec(struct lc_bike_ss *ss, const struct lc_bike_ct *ct,
                const struct lc_bike_sk *sk);

int lc_bike_dec_kdf(uint8_t *ss, size_t ss_len, const struct lc_bike_ct *ct,
                    const struct lc_bike_sk *sk);
 
#ifdef __cplusplus
}
#endif
 
#endif /* LC_BIKE_H */