iqr_sidh.h

Go to the documentation of this file.

#ifndef IQR_SIDH_H
#define IQR_SIDH_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>

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

typedef struct iqr_SIDHParams_struct iqr_SIDHParams;

typedef struct iqr_SIDHAlicePrivateKey_struct iqr_SIDHAlicePrivateKey;

typedef struct iqr_SIDHBobPrivateKey_struct iqr_SIDHBobPrivateKey;

typedef struct iqr_SIDHVariant_struct iqr_SIDHVariant;

// ---------------------------------------------------------------------------------------------------------------------------------
// SIDH variants.
// ---------------------------------------------------------------------------------------------------------------------------------

IQR_EXTERN
const iqr_SIDHVariant IQR_SIDH_P503;

IQR_EXTERN
const iqr_SIDHVariant IQR_SIDH_P751;

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

IQR_API
iqr_retval iqr_SIDHCreateParams(const iqr_Context *ctx, const iqr_SIDHVariant *variant, iqr_SIDHParams **params);

IQR_API_UNENFORCED_RETURN
iqr_retval iqr_SIDHDestroyParams(iqr_SIDHParams **params);

IQR_API
iqr_retval iqr_SIDHGetPublicKeySize(const iqr_SIDHParams *params, size_t *public_key_size);

IQR_API
iqr_retval iqr_SIDHGetSecretSize(const iqr_SIDHParams *params, size_t *secret_size);

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

IQR_API
iqr_retval iqr_SIDHCreateAlicePrivateKey(const iqr_SIDHParams *params, const iqr_RNG *rng,
    iqr_SIDHAlicePrivateKey **alice_private_key);

IQR_API
iqr_retval iqr_SIDHCreateBobPrivateKey(const iqr_SIDHParams *params, const iqr_RNG *rng, iqr_SIDHBobPrivateKey **bob_private_key);

IQR_API_UNENFORCED_RETURN
iqr_retval iqr_SIDHDestroyAlicePrivateKey(iqr_SIDHAlicePrivateKey **alice_private_key);

IQR_API_UNENFORCED_RETURN
iqr_retval iqr_SIDHDestroyBobPrivateKey(iqr_SIDHBobPrivateKey **bob_private_key);

// ---------------------------------------------------------------------------------------------------------------------------------
// Public key functions.
// ---------------------------------------------------------------------------------------------------------------------------------

IQR_API
iqr_retval iqr_SIDHGetAlicePublicKey(const iqr_SIDHAlicePrivateKey *alice_private_key, uint8_t *alice_public_key,
    size_t alice_public_key_size);

IQR_API
iqr_retval iqr_SIDHGetBobPublicKey(const iqr_SIDHBobPrivateKey *bob_private_key, uint8_t *bob_public_key,
    size_t bob_public_key_size);

// ---------------------------------------------------------------------------------------------------------------------------------
// Secret generation functions.
// ---------------------------------------------------------------------------------------------------------------------------------

IQR_API
iqr_retval iqr_SIDHGetAliceSecret(const iqr_SIDHAlicePrivateKey *alice_private_key, const uint8_t *bob_public_key,
    size_t bob_public_key_size, uint8_t *secret, size_t secret_size);

IQR_API
iqr_retval iqr_SIDHGetBobSecret(const iqr_SIDHBobPrivateKey *bob_private_key, const uint8_t *alice_public_key,
    size_t alice_public_key_size, uint8_t *secret, size_t secret_size);

#ifdef __cplusplus
}
#endif

#endif /* IQR_SIDH_H */