iqr_newhopedh.h

Go to the documentation of this file.

#ifndef IQR_NEWHOPEDH_H
#define IQR_NEWHOPEDH_H

#ifdef __cplusplus
extern "C" {
#endif

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

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

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

#define IQR_NEWHOPEDH_SECRET_SIZE  32

#define IQR_NEWHOPEDH_INITIATOR_PUBLIC_KEY_SIZE  1824

#define IQR_NEWHOPEDH_RESPONDER_PUBLIC_KEY_SIZE  2048

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

typedef struct iqr_NewHopeDHParams_struct iqr_NewHopeDHParams;

typedef struct iqr_NewHopeDHInitiatorPrivateKey_struct iqr_NewHopeDHInitiatorPrivateKey;

typedef struct iqr_NewHopeDHResponderPrivateKey_struct iqr_NewHopeDHResponderPrivateKey;

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

IQR_API
iqr_retval iqr_NewHopeDHCreateParams(const iqr_Context *ctx, iqr_NewHopeDHParams **params);

IQR_API_UNENFORCED_RETURN
iqr_retval iqr_NewHopeDHDestroyParams(iqr_NewHopeDHParams **params);

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

IQR_API
iqr_retval iqr_NewHopeDHCreateInitiatorPrivateKey(const iqr_NewHopeDHParams *params, const iqr_RNG *rng,
    iqr_NewHopeDHInitiatorPrivateKey **initiator_private_key);

IQR_API
iqr_retval iqr_NewHopeDHCreateResponderPrivateKey(const iqr_NewHopeDHParams *params, const iqr_RNG *rng,
    iqr_NewHopeDHResponderPrivateKey **responder_private_key);

IQR_API_UNENFORCED_RETURN
iqr_retval iqr_NewHopeDHDestroyInitiatorPrivateKey(iqr_NewHopeDHInitiatorPrivateKey **initiator_private_key);

IQR_API_UNENFORCED_RETURN
iqr_retval iqr_NewHopeDHDestroyResponderPrivateKey(iqr_NewHopeDHResponderPrivateKey **responder_private_key);

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

IQR_API
iqr_retval iqr_NewHopeDHGetInitiatorPublicKey(iqr_NewHopeDHInitiatorPrivateKey *initiator_private_key, const iqr_RNG *rng,
    uint8_t *initiator_public_key, size_t initiator_public_key_size);

IQR_API
iqr_retval iqr_NewHopeDHGetResponderPublicKey(iqr_NewHopeDHResponderPrivateKey *responder_private_key, 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);

IQR_API
iqr_retval iqr_NewHopeDHGetInitiatorSecret(const iqr_NewHopeDHInitiatorPrivateKey *initiator_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_NewHopeDHGetResponderSecret(const iqr_NewHopeDHResponderPrivateKey *responder_private_key, uint8_t *secret,
    size_t secret_size);

#ifdef __cplusplus
}
#endif

#endif /* IQR_NEWHOPEDH_H */