iqr_luke.h

Go to the documentation of this file.

#ifndef IQR_LUKE_H
#define IQR_LUKE_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_LUKE_SECRET_SIZE  32

#define IQR_LUKE_INITIATOR_PUBLIC_KEY_SIZE  1824

#define IQR_LUKE_RESPONDER_PUBLIC_KEY_SIZE  2048

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

typedef struct iqr_LUKEParams_struct iqr_LUKEParams;

typedef struct iqr_LUKEInitiatorPrivateKey_struct iqr_LUKEInitiatorPrivateKey;

typedef struct iqr_LUKEResponderPrivateKey_struct iqr_LUKEResponderPrivateKey;

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

IQR_API
iqr_retval iqr_LUKECreateParams(const iqr_Context *ctx, iqr_LUKEParams **params);

IQR_API_UNENFORCED_RETURN
iqr_retval iqr_LUKEDestroyParams(iqr_LUKEParams **params);

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

IQR_API
iqr_retval iqr_LUKECreateInitiatorPrivateKey(const iqr_LUKEParams *params, const iqr_RNG *rng,
    iqr_LUKEInitiatorPrivateKey **initiator_private_key);

IQR_API
iqr_retval iqr_LUKECreateResponderPrivateKey(const iqr_LUKEParams *params, const iqr_RNG *rng,
    iqr_LUKEResponderPrivateKey **responder_private_key);

IQR_API_UNENFORCED_RETURN
iqr_retval iqr_LUKEDestroyInitiatorPrivateKey(iqr_LUKEInitiatorPrivateKey **initiator_private_key);

IQR_API_UNENFORCED_RETURN
iqr_retval iqr_LUKEDestroyResponderPrivateKey(iqr_LUKEResponderPrivateKey **responder_private_key);

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

IQR_API
iqr_retval iqr_LUKEGetInitiatorPublicKey(iqr_LUKEInitiatorPrivateKey *initiator_private_key, const iqr_RNG *rng,
    uint8_t *initiator_public_key, size_t initiator_public_key_size);

IQR_API
iqr_retval iqr_LUKEGetResponderPublicKey(iqr_LUKEResponderPrivateKey *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_LUKEGetInitiatorSecret(const iqr_LUKEInitiatorPrivateKey *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_LUKEGetResponderSecret(const iqr_LUKEResponderPrivateKey *responder_private_key, uint8_t *secret,
    size_t secret_size);

#ifdef __cplusplus
}
#endif

#endif /* IQR_LUKE_H */