iqr_newhope.h

Go to the documentation of this file.

#ifndef IQR_NEWHOPE_H
#define IQR_NEWHOPE_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_NEWHOPE_SECRET_SIZE  32

#define IQR_NEWHOPE_INITIATOR_KEY_SIZE  1824
#define IQR_NEWHOPE_RESPONDER_KEY_SIZE  2048

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

typedef struct iqr_NewHopeParams_struct iqr_NewHopeParams;

typedef struct iqr_NewHopePrivateKey_struct iqr_NewHopePrivateKey;

typedef struct iqr_NewHopeVariant_struct iqr_NewHopeVariant;

// ---------------------------------------------------------------------------------------------------------------------------------
// NewHope variants.
// ---------------------------------------------------------------------------------------------------------------------------------

IQR_EXTERN
const iqr_NewHopeVariant IQR_NEWHOPE_REFERENCE;

IQR_EXTERN
const iqr_NewHopeVariant IQR_NEWHOPE_BORINGSSL;

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

IQR_API
iqr_retval iqr_NewHopeCreateParams(const iqr_Context *ctx, const iqr_NewHopeVariant *variant, iqr_NewHopeParams **params);

IQR_API_UNENFORCED_RETURN
iqr_retval iqr_NewHopeDestroyParams(iqr_NewHopeParams **params);

// ---------------------------------------------------------------------------------------------------------------------------------
// Private key generation functions.
// ---------------------------------------------------------------------------------------------------------------------------------

IQR_API
iqr_retval iqr_NewHopeCreatePrivateKey(const iqr_NewHopeParams *params, iqr_NewHopePrivateKey **private_key);

IQR_API_UNENFORCED_RETURN
iqr_retval iqr_NewHopeDestroyPrivateKey(iqr_NewHopePrivateKey **private_key);

// ---------------------------------------------------------------------------------------------------------------------------------
// Shared secret generation functions.
// ---------------------------------------------------------------------------------------------------------------------------------

IQR_API
iqr_retval iqr_NewHopeGetInitiatorPublicKey(iqr_NewHopePrivateKey *private_key, const iqr_RNG *rng, uint8_t *initiator_public_key,
    size_t initiator_public_key_size);

IQR_API
iqr_retval iqr_NewHopeGetInitiatorSecret(const iqr_NewHopePrivateKey *private_key, const uint8_t *responder_public_key,
    size_t responder_public_key_size,  uint8_t *secret, size_t secret_size);

IQR_API
iqr_retval iqr_NewHopeGetResponderPublicKeyandSecret(const iqr_NewHopeParams *params, const iqr_RNG *rng,
    const uint8_t *initiator_public_key, size_t initiator_public_key_size, uint8_t *responder_public_key,
    size_t responder_public_key_size, uint8_t *secret, size_t secret_size);

#ifdef __cplusplus
}
#endif

#endif /* IQR_NEWHOPE_H */