iqr_mceliece.h

Go to the documentation of this file.

#ifndef IQR_MCELIECE_H
#define IQR_MCELIECE_H

#ifdef __cplusplus
extern "C" {
#endif

#include "iqr_api.h"
#include "iqr_hash.h"
#include "iqr_retval.h"
#include "iqr_rng.h"

#include <stddef.h>
#include <stdint.h>

// ---------------------------------------------------------------------------------------------------------------------------------
// Constants.
// ---------------------------------------------------------------------------------------------------------------------------------

#define IQR_MCELIECE_SHARED_KEY_SIZE 32

#define IQR_MCELIECE_CIPHERTEXT_SIZE 8225

#define IQR_MCELIECE_PUBLIC_KEY_SIZE 4097

#define IQR_MCELIECE_PRIVATE_KEY_SIZE 548

// ---------------------------------------------------------------------------------------------------------------------------------
// Opaque data types.
// ---------------------------------------------------------------------------------------------------------------------------------

typedef struct iqr_McElieceParams_struct iqr_McElieceParams;

typedef struct iqr_McEliecePublicKey_struct iqr_McEliecePublicKey;

typedef struct iqr_McEliecePrivateKey_struct iqr_McEliecePrivateKey;

// ---------------------------------------------------------------------------------------------------------------------------------
// McEliece parameter management functions.
// ---------------------------------------------------------------------------------------------------------------------------------

IQR_API
iqr_retval iqr_McElieceCreateParams(const iqr_Context *ctx, iqr_HashAlgorithmType hash_algo, iqr_McElieceParams **params);

IQR_API_UNENFORCED_RETURN
iqr_retval iqr_McElieceDestroyParams(iqr_McElieceParams **params);

// ---------------------------------------------------------------------------------------------------------------------------------
// McEliece key management functions.
// ---------------------------------------------------------------------------------------------------------------------------------

IQR_API
iqr_retval iqr_McElieceCreateKeyPair(const iqr_McElieceParams *params, const iqr_RNG *rng, iqr_McEliecePublicKey **public_key,
    iqr_McEliecePrivateKey **private_key);

IQR_API
iqr_retval iqr_McElieceImportPublicKey(const iqr_McElieceParams *params, const uint8_t *buf, size_t buf_size,
    iqr_McEliecePublicKey **public_key);

IQR_API
iqr_retval iqr_McElieceImportPrivateKey(const iqr_McElieceParams *params, const uint8_t *buf, size_t buf_size,
    iqr_McEliecePrivateKey **private_key);

IQR_API
iqr_retval iqr_McElieceExportPublicKey(const iqr_McEliecePublicKey *public_key, uint8_t *buf, size_t buf_size);

IQR_API
iqr_retval iqr_McElieceExportPrivateKey(const iqr_McEliecePrivateKey *private_key, uint8_t *buf, size_t buf_size);

IQR_API_UNENFORCED_RETURN
iqr_retval iqr_McElieceDestroyPublicKey(iqr_McEliecePublicKey **public_key);

IQR_API_UNENFORCED_RETURN
iqr_retval iqr_McElieceDestroyPrivateKey(iqr_McEliecePrivateKey **private_key);

// ---------------------------------------------------------------------------------------------------------------------------------
// McEliece KEM encapsulation/decapsulation functions.
// ---------------------------------------------------------------------------------------------------------------------------------

IQR_API
iqr_retval iqr_McElieceEncapsulate(const iqr_McEliecePublicKey *public_key, const iqr_RNG *rng, uint8_t *ciphertext,
    size_t ciphertext_size, uint8_t *shared_key, size_t shared_key_size);

IQR_API
iqr_retval iqr_McElieceDecapsulate(const iqr_McEliecePrivateKey *private_key, const uint8_t *ciphertext, size_t ciphertext_size,
    uint8_t *shared_key, size_t shared_key_size);

#ifdef __cplusplus
}
#endif

#endif /* IQR_MCELIECE_H */