iqr_classicmceliece.h

Go to the documentation of this file.

 
#ifndef IQR_CLASSICMCELIECE_H
#define IQR_CLASSICMCELIECE_H
 
#ifdef __cplusplus
extern "C" {
#endif
 
#include "iqr_api.h"
#include "iqr_retval.h"
#include "iqr_rng.h"
 
#include <stddef.h>
#include <stdint.h>
 
// ---------------------------------------------------------------------------------------------------------------------------------
// Constants.
// ---------------------------------------------------------------------------------------------------------------------------------
 
#define IQR_CLASSICMCELIECE_SHARED_KEY_SIZE 32
 
// ---------------------------------------------------------------------------------------------------------------------------------
// Opaque data types.
// ---------------------------------------------------------------------------------------------------------------------------------
 
typedef struct iqr_ClassicMcElieceParams_struct iqr_ClassicMcElieceParams;
 
typedef struct iqr_ClassicMcEliecePublicKey_struct iqr_ClassicMcEliecePublicKey;
 
typedef struct iqr_ClassicMcEliecePrivateKey_struct iqr_ClassicMcEliecePrivateKey;
 
typedef struct iqr_ClassicMcElieceVariant_struct iqr_ClassicMcElieceVariant;
 
// ---------------------------------------------------------------------------------------------------------------------------------
// ClassicMcEliece variants.
// ---------------------------------------------------------------------------------------------------------------------------------
 
IQR_EXTERN
const iqr_ClassicMcElieceVariant IQR_CLASSICMCELIECE_6;
 
IQR_EXTERN
const iqr_ClassicMcElieceVariant IQR_CLASSICMCELIECE_8;
 
// ---------------------------------------------------------------------------------------------------------------------------------
// ClassicMcEliece parameter management functions.
// ---------------------------------------------------------------------------------------------------------------------------------
 
IQR_API
iqr_retval iqr_ClassicMcElieceCreateParams(const iqr_Context *ctx, const iqr_ClassicMcElieceVariant *variant,
    iqr_ClassicMcElieceParams **params);
 
IQR_API_UNENFORCED_RETURN
iqr_retval iqr_ClassicMcElieceDestroyParams(iqr_ClassicMcElieceParams **params);
 
// ---------------------------------------------------------------------------------------------------------------------------------
// ClassicMcEliece key management functions.
// ---------------------------------------------------------------------------------------------------------------------------------
 
IQR_API
iqr_retval iqr_ClassicMcElieceCreateKeyPair(const iqr_ClassicMcElieceParams *params, const iqr_RNG *rng,
    iqr_ClassicMcEliecePublicKey **public_key, iqr_ClassicMcEliecePrivateKey **private_key);
 
IQR_API
iqr_retval iqr_ClassicMcElieceImportPublicKey(const iqr_ClassicMcElieceParams *params, const uint8_t *buf, size_t buf_size,
    iqr_ClassicMcEliecePublicKey **public_key);
 
IQR_API
iqr_retval iqr_ClassicMcElieceImportPrivateKey(const iqr_ClassicMcElieceParams *params, const uint8_t *buf, size_t buf_size,
    iqr_ClassicMcEliecePrivateKey **private_key);
 
IQR_API
iqr_retval iqr_ClassicMcElieceExportPublicKey(const iqr_ClassicMcEliecePublicKey *public_key, uint8_t *buf, size_t buf_size);
 
IQR_API
iqr_retval iqr_ClassicMcElieceExportPrivateKey(const iqr_ClassicMcEliecePrivateKey *private_key, uint8_t *buf, size_t buf_size);
 
IQR_API_UNENFORCED_RETURN
iqr_retval iqr_ClassicMcElieceDestroyPublicKey(iqr_ClassicMcEliecePublicKey **public_key);
 
IQR_API_UNENFORCED_RETURN
iqr_retval iqr_ClassicMcElieceDestroyPrivateKey(iqr_ClassicMcEliecePrivateKey **private_key);
 
// ---------------------------------------------------------------------------------------------------------------------------------
// ClassicMcEliece size functions.
// ---------------------------------------------------------------------------------------------------------------------------------
 
IQR_API
iqr_retval iqr_ClassicMcElieceGetPublicKeySize(const iqr_ClassicMcElieceParams *params, size_t *public_key_size);
 
IQR_API
iqr_retval iqr_ClassicMcElieceGetPrivateKeySize(const iqr_ClassicMcElieceParams *params, size_t *private_key_size);
 
IQR_API
iqr_retval iqr_ClassicMcElieceGetCiphertextSize(const iqr_ClassicMcElieceParams *params, size_t *ciphertext_size);
 
IQR_API
iqr_retval iqr_ClassicMcElieceGetSharedKeySize(const iqr_ClassicMcElieceParams *params, size_t *shared_key_size);
 
// ---------------------------------------------------------------------------------------------------------------------------------
// ClassicMcEliece encapsulation/decapsulation functions.
// ---------------------------------------------------------------------------------------------------------------------------------
 
IQR_API
iqr_retval iqr_ClassicMcElieceEncapsulate(const iqr_ClassicMcEliecePublicKey *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_ClassicMcElieceDecapsulate(const iqr_ClassicMcEliecePrivateKey *private_key, const uint8_t *ciphertext,
    size_t ciphertext_size, uint8_t *shared_key, size_t shared_key_size);
 
#ifdef __cplusplus
}
#endif
 
#endif /* IQR_CLASSICMCELIECE_H */