iqr_ntruprime.h

Go to the documentation of this file.

#ifndef IQR_NTRUPRIME_H
#define IQR_NTRUPRIME_H

#ifdef __cplusplus
extern "C" {
#endif

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

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

#define IQR_NTRUPRIME_SHARED_KEY_SIZE 32

#define IQR_NTRUPRIME_CIPHERTEXT_SIZE 1047

#define IQR_NTRUPRIME_PUBLIC_KEY_SIZE 1218

#define IQR_NTRUPRIME_PRIVATE_KEY_SIZE 1600

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

typedef struct iqr_NTRUPrimeParams_struct iqr_NTRUPrimeParams;

typedef struct iqr_NTRUPrimePrivateKey_struct iqr_NTRUPrimePrivateKey;

typedef struct iqr_NTRUPrimePublicKey_struct iqr_NTRUPrimePublicKey;

// ---------------------------------------------------------------------------------------------------------------------------------
// Domain parameter functions.
// ---------------------------------------------------------------------------------------------------------------------------------

IQR_API
iqr_retval iqr_NTRUPrimeCreateParams(const iqr_Context *ctx, iqr_NTRUPrimeParams **params);

IQR_API_UNENFORCED_RETURN
iqr_retval iqr_NTRUPrimeDestroyParams(iqr_NTRUPrimeParams **params);

// ---------------------------------------------------------------------------------------------------------------------------------
// NTRUPrime key management functions.
// ---------------------------------------------------------------------------------------------------------------------------------

IQR_API
iqr_retval iqr_NTRUPrimeCreateKeyPair(const iqr_NTRUPrimeParams *params, const iqr_RNG *rng, iqr_NTRUPrimePublicKey **public_key,
    iqr_NTRUPrimePrivateKey **private_key);

IQR_API
iqr_retval iqr_NTRUPrimeImportPublicKey(const iqr_NTRUPrimeParams *params, const uint8_t *buf, size_t buf_size,
    iqr_NTRUPrimePublicKey **public_key);

IQR_API
iqr_retval iqr_NTRUPrimeImportPrivateKey(const iqr_NTRUPrimeParams *params, const uint8_t *buf, size_t buf_size,
    iqr_NTRUPrimePrivateKey **private_key);

IQR_API
iqr_retval iqr_NTRUPrimeExportPublicKey(const iqr_NTRUPrimePublicKey *public_key, uint8_t *buf, size_t buf_size);

IQR_API
iqr_retval iqr_NTRUPrimeExportPrivateKey(const iqr_NTRUPrimePrivateKey *private_key, uint8_t *buf, size_t buf_size);

IQR_API_UNENFORCED_RETURN
iqr_retval iqr_NTRUPrimeDestroyPublicKey(iqr_NTRUPrimePublicKey **public_key);

IQR_API_UNENFORCED_RETURN
iqr_retval iqr_NTRUPrimeDestroyPrivateKey(iqr_NTRUPrimePrivateKey **private_key);

// ---------------------------------------------------------------------------------------------------------------------------------
// NTRUPrime encapsulation/decapsulation functions.
// ---------------------------------------------------------------------------------------------------------------------------------

IQR_API
iqr_retval iqr_NTRUPrimeEncapsulate(const iqr_NTRUPrimePublicKey *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_NTRUPrimeDecapsulate(const iqr_NTRUPrimePrivateKey *private_key, const uint8_t *ciphertext, size_t ciphertext_size,
    uint8_t *shared_key, size_t shared_key_size);

#ifdef __cplusplus
}
#endif

#endif /* IQR_NTRUPRIME_H */