iqr_hash.h

Go to the documentation of this file.

#ifndef IQR_HASH_H
#define IQR_HASH_H

#ifdef __cplusplus
extern "C" {
#endif

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

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

// ---------------------------------------------------------------------------------------------------------------------------------
// Opaque data type.
// ---------------------------------------------------------------------------------------------------------------------------------

typedef struct iqr_Hash_struct iqr_Hash;

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

typedef enum {
    IQR_HASHALGO_BLAKE2B_256,

    IQR_HASHALGO_BLAKE2B_512,

    IQR_HASHALGO_SHA2_256,

    IQR_HASHALGO_SHA2_384,

    IQR_HASHALGO_SHA2_512,

    IQR_HASHALGO_SHA3_256,

    IQR_HASHALGO_SHA3_512,

    // Maintain a count of supported algorithms. MUST BE LAST.
    IQR_HASHALGO_MAX,
} iqr_HashAlgorithmType;

#define IQR_BLAKE2B_256_DIGEST_SIZE  32  
#define IQR_BLAKE2B_512_DIGEST_SIZE  64  

#define IQR_SHA2_256_DIGEST_SIZE    32  
#define IQR_SHA2_384_DIGEST_SIZE    48  
#define IQR_SHA2_512_DIGEST_SIZE    64  

#define IQR_SHA3_256_DIGEST_SIZE    32  
#define IQR_SHA3_512_DIGEST_SIZE    64  

// ---------------------------------------------------------------------------------------------------------------------------------
// Data structure.
// ---------------------------------------------------------------------------------------------------------------------------------

typedef struct {
    iqr_retval (*initialize)(void **state);

    iqr_retval (*begin)(void *state);

    iqr_retval (*update)(void *state, const uint8_t *buf, size_t buf_size);

    iqr_retval (*end)(void *state, uint8_t *digest, size_t digest_size);

    iqr_retval (*cleanup)(void **state);
} iqr_HashCallbacks;

// ---------------------------------------------------------------------------------------------------------------------------------
// Global function registration.
// ---------------------------------------------------------------------------------------------------------------------------------

IQR_EXTERN
const iqr_HashCallbacks IQR_HASH_DEFAULT_BLAKE2B_256;

IQR_EXTERN
const iqr_HashCallbacks IQR_HASH_DEFAULT_BLAKE2B_512;

IQR_EXTERN
const iqr_HashCallbacks IQR_HASH_DEFAULT_SHA2_256;

IQR_EXTERN
const iqr_HashCallbacks IQR_HASH_DEFAULT_SHA2_384;

IQR_EXTERN
const iqr_HashCallbacks IQR_HASH_DEFAULT_SHA2_512;

IQR_EXTERN
const iqr_HashCallbacks IQR_HASH_DEFAULT_SHA3_256;

IQR_EXTERN
const iqr_HashCallbacks IQR_HASH_DEFAULT_SHA3_512;

IQR_API
iqr_retval iqr_HashRegisterCallbacks(iqr_Context *ctx, iqr_HashAlgorithmType hash_algo, const iqr_HashCallbacks *cb);

// ---------------------------------------------------------------------------------------------------------------------------------
// Hash object management.
// ---------------------------------------------------------------------------------------------------------------------------------

IQR_API
iqr_retval iqr_HashCreate(const iqr_Context *ctx, iqr_HashAlgorithmType hash_algo, iqr_Hash **obj);

IQR_API_UNENFORCED_RETURN
iqr_retval iqr_HashDestroy(iqr_Hash **obj);

// ---------------------------------------------------------------------------------------------------------------------------------
// Hashing functionality.
// ---------------------------------------------------------------------------------------------------------------------------------

IQR_API
iqr_retval iqr_HashBegin(iqr_Hash *obj);

IQR_API
iqr_retval iqr_HashUpdate(iqr_Hash *obj, const uint8_t *buf, size_t buf_size);

IQR_API
iqr_retval iqr_HashEnd(iqr_Hash *obj, uint8_t *digest, size_t digest_size);

IQR_API
iqr_retval iqr_HashMessage(iqr_Hash *obj, const uint8_t *buf, size_t buf_size, uint8_t *digest, size_t digest_size);

IQR_API
iqr_retval iqr_HashGetDigestSize(const iqr_Hash *obj, size_t *digest_size);

IQR_API
iqr_retval iqr_HashGetAlgorithmType(const iqr_Hash *obj, iqr_HashAlgorithmType *hash_algo);

IQR_API
iqr_retval iqr_HashAlgorithmGetDigestSize(const iqr_HashAlgorithmType hash_algo, size_t *digest_size);

// ---------------------------------------------------------------------------------------------------------------------------------
// Randomized hashing, as described in
// <a href="https://www.iacr.org/archive/crypto2006/41170039/41170039.pdf"><em>Strengthening
// Digital Signatures via Randomized Hashing</em></a> by Halevi and Krawczyk.
// ---------------------------------------------------------------------------------------------------------------------------------

IQR_API
iqr_retval iqr_HashSetSalt(iqr_Hash *obj, const uint8_t *salt, size_t salt_size);

IQR_API
iqr_retval iqr_HashGetSalt(const iqr_Hash *obj, uint8_t *salt, size_t salt_size);

IQR_API
iqr_retval iqr_HashGetSaltSize(const iqr_Hash *obj, size_t *salt_size);

#ifdef __cplusplus
}
#endif

#endif /* IQR_HASH_H */