iqr_xmss.h

Go to the documentation of this file.

 
#ifndef IQR_XMSS_H
#define IQR_XMSS_H
 
#ifdef __cplusplus
extern "C" {
#endif
 
#include "iqr_api.h"
#include "iqr_hash.h"
#include "iqr_retval.h"
#include "iqr_rng.h"
 
#include <stddef.h>
#include <stdint.h>
 
// ---------------------------------------------------------------------------------------------------------------------------------
// Constants.
// ---------------------------------------------------------------------------------------------------------------------------------
 
#define IQR_XMSS_PUBLIC_KEY_SIZE 68
 
// ---------------------------------------------------------------------------------------------------------------------------------
// Opaque data types.
// ---------------------------------------------------------------------------------------------------------------------------------
 
typedef struct iqr_XMSSPrivateKeyState_struct iqr_XMSSPrivateKeyState;
 
typedef struct iqr_XMSSParams_struct iqr_XMSSParams;
 
typedef struct iqr_XMSSPublicKey_struct iqr_XMSSPublicKey;
 
typedef struct iqr_XMSSPrivateKey_struct iqr_XMSSPrivateKey;
 
typedef struct iqr_XMSSTreeStrategy_struct iqr_XMSSTreeStrategy;
 
typedef struct iqr_XMSSVariant_struct iqr_XMSSVariant;
 
// ---------------------------------------------------------------------------------------------------------------------------------
// XMSS tree strategies.
// ---------------------------------------------------------------------------------------------------------------------------------
 
 
IQR_EXTERN
const iqr_XMSSTreeStrategy IQR_XMSS_MEMORY_CONSTRAINED_STRATEGY;
 
IQR_EXTERN
const iqr_XMSSTreeStrategy IQR_XMSS_FULL_TREE_STRATEGY;
 
IQR_EXTERN
const iqr_XMSSTreeStrategy IQR_XMSS_VERIFY_ONLY_STRATEGY;
 
 
// ---------------------------------------------------------------------------------------------------------------------------------
// XMSS parameters.
// ---------------------------------------------------------------------------------------------------------------------------------
 
 
IQR_EXTERN
const iqr_XMSSVariant IQR_XMSS_2E10;
 
IQR_EXTERN
const iqr_XMSSVariant IQR_XMSS_2E16;
 
 
// ---------------------------------------------------------------------------------------------------------------------------------
// Domain parameter functions.
// ---------------------------------------------------------------------------------------------------------------------------------
 
IQR_API
iqr_retval iqr_XMSSCreateParams(const iqr_Context *ctx, const iqr_XMSSTreeStrategy *strategy, const iqr_XMSSVariant *variant,
    iqr_XMSSParams **params);
 
IQR_API
iqr_retval iqr_XMSSCreateParamsFromPublicKeyBuffer(const iqr_Context *ctx, const uint8_t *buf, size_t buf_size,
    iqr_XMSSParams **params);
 
IQR_API_UNENFORCED_RETURN
iqr_retval iqr_XMSSDestroyParams(iqr_XMSSParams **params);
 
// ---------------------------------------------------------------------------------------------------------------------------------
// Key management functions.
// ---------------------------------------------------------------------------------------------------------------------------------
 
IQR_API
iqr_retval iqr_XMSSCreateKeyPair(const iqr_XMSSParams *params, const iqr_RNG *rng, iqr_XMSSPublicKey **public_key,
    iqr_XMSSPrivateKey **private_key, iqr_XMSSPrivateKeyState **state);
 
IQR_API
iqr_retval iqr_XMSSImportPrivateKey(const iqr_XMSSParams *params, const uint8_t *buf, size_t buf_size,
    iqr_XMSSPrivateKey **private_key);
 
IQR_API
iqr_retval iqr_XMSSExportPrivateKey(const iqr_XMSSPrivateKey *private_key, uint8_t *buf, size_t buf_size);
 
IQR_API
iqr_retval iqr_XMSSImportPublicKey(const iqr_XMSSParams *params, const uint8_t *buf, size_t buf_size,
    iqr_XMSSPublicKey **public_key);
 
IQR_API
iqr_retval iqr_XMSSExportPublicKey(const iqr_XMSSPublicKey *public_key, uint8_t *buf, size_t buf_size);
 
IQR_API
iqr_retval iqr_XMSSImportState(const iqr_XMSSParams *params, const uint8_t *buf, size_t buf_size, iqr_XMSSPrivateKeyState **state);
 
IQR_API
iqr_retval iqr_XMSSExportState(const iqr_XMSSPrivateKeyState *state, uint8_t *buf, size_t buf_size);
 
IQR_API_UNENFORCED_RETURN
iqr_retval iqr_XMSSDestroyPrivateKey(iqr_XMSSPrivateKey **private_key);
 
IQR_API_UNENFORCED_RETURN
iqr_retval iqr_XMSSDestroyPublicKey(iqr_XMSSPublicKey **public_key);
 
IQR_API_UNENFORCED_RETURN
iqr_retval iqr_XMSSDestroyState(iqr_XMSSPrivateKeyState **state);
 
// ---------------------------------------------------------------------------------------------------------------------------------
// State management functionality.
// ---------------------------------------------------------------------------------------------------------------------------------
 
IQR_API
iqr_retval iqr_XMSSDetachState(const iqr_XMSSPrivateKey *private_key, iqr_XMSSPrivateKeyState *state, uint32_t num_sigs,
    iqr_XMSSPrivateKeyState **detached_state);
 
// ---------------------------------------------------------------------------------------------------------------------------------
// Key data retrieval functions.
// ---------------------------------------------------------------------------------------------------------------------------------
 
IQR_API
iqr_retval iqr_XMSSGetPrivateKeySize(const iqr_XMSSParams *params, size_t *private_key_size);
 
IQR_API
iqr_retval iqr_XMSSGetPublicKeySize(const iqr_XMSSParams *params, size_t *public_key_size);
 
IQR_API
iqr_retval iqr_XMSSGetStateSize(const iqr_XMSSParams *params, size_t *state_size);
 
// ---------------------------------------------------------------------------------------------------------------------------------
// Signature functionality.
// ---------------------------------------------------------------------------------------------------------------------------------
 
IQR_API
iqr_retval iqr_XMSSGetSignatureSize(const iqr_XMSSParams *params, size_t *sig_size);
 
IQR_API
iqr_retval iqr_XMSSGetSignatureCount(const iqr_XMSSPrivateKeyState *state, uint32_t *remaining_sigs);
 
IQR_API
iqr_retval iqr_XMSSSign(const iqr_XMSSPrivateKey *private_key, const uint8_t *message, size_t message_size,
    iqr_XMSSPrivateKeyState *state, uint8_t *sig, size_t sig_size);
 
IQR_API
iqr_retval iqr_XMSSVerify(const iqr_XMSSPublicKey *public_key, const uint8_t *message, size_t message_size, const uint8_t *sig,
    size_t sig_size);
 
#ifdef __cplusplus
}
#endif
 
#endif /* IQR_XMSS_H */