/* MIT License * * Copyright (c) 2016-2022 INRIA, CMU and Microsoft Corporation * Copyright (c) 2022-2023 HACL* Contributors * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in all * copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE * SOFTWARE. */ #ifndef __EverCrypt_Hash_H #define __EverCrypt_Hash_H #if defined(__cplusplus) extern "C" { #endif #include #include "krml/internal/types.h" #include "krml/lowstar_endianness.h" #include "krml/internal/target.h" #include "Hacl_Streaming_Types.h" #include "Hacl_Krmllib.h" #include "Hacl_Hash_SHA3.h" #include "Hacl_Hash_SHA2.h" #include "Hacl_Hash_Blake2s_Simd128.h" #include "Hacl_Hash_Blake2s.h" #include "Hacl_Hash_Blake2b_Simd256.h" #include "Hacl_Hash_Blake2b.h" #include "EverCrypt_Error.h" #include "EverCrypt_AutoConfig2.h" typedef struct EverCrypt_Hash_state_s_s EverCrypt_Hash_state_s; uint32_t EverCrypt_Hash_Incremental_hash_len(Spec_Hash_Definitions_hash_alg a); typedef struct EverCrypt_Hash_Incremental_state_t_s { EverCrypt_Hash_state_s *block_state; uint8_t *buf; uint64_t total_len; } EverCrypt_Hash_Incremental_state_t; /** Allocate initial state for the agile hash. The argument `a` stands for the choice of algorithm (see Hacl_Spec.h). This API will automatically pick the most efficient implementation, provided you have called EverCrypt_AutoConfig2_init() before. The state is to be freed by calling `free`. */ EverCrypt_Hash_Incremental_state_t *EverCrypt_Hash_Incremental_malloc(Spec_Hash_Definitions_hash_alg a); /** Reset an existing state to the initial hash state with empty data. */ void EverCrypt_Hash_Incremental_reset(EverCrypt_Hash_Incremental_state_t *state); /** Feed an arbitrary amount of data into the hash. This function returns EverCrypt_Error_Success for success, or EverCrypt_Error_MaximumLengthExceeded if the combined length of all of the data passed to `update` (since the last call to `init`) exceeds 2^61-1 bytes or 2^64-1 bytes, depending on the choice of algorithm. Both limits are unlikely to be attained in practice. */ EverCrypt_Error_error_code EverCrypt_Hash_Incremental_update( EverCrypt_Hash_Incremental_state_t *state, uint8_t *chunk, uint32_t chunk_len ); /** Perform a run-time test to determine which algorithm was chosen for the given piece of state. */ Spec_Hash_Definitions_hash_alg EverCrypt_Hash_Incremental_alg_of_state(EverCrypt_Hash_Incremental_state_t *s); /** Write the resulting hash into `output`, an array whose length is algorithm-specific. You can use the macros defined earlier in this file to allocate a destination buffer of the right length. The state remains valid after a call to `digest`, meaning the user may feed more data into the hash via `update`. (The finish function operates on an internal copy of the state and therefore does not invalidate the client-held state.) */ void EverCrypt_Hash_Incremental_digest(EverCrypt_Hash_Incremental_state_t *state, uint8_t *output); /** Free a state previously allocated with `create_in`. */ void EverCrypt_Hash_Incremental_free(EverCrypt_Hash_Incremental_state_t *state); /** Hash `input`, of len `input_len`, into `output`, an array whose length is determined by your choice of algorithm `a` (see Hacl_Spec.h). You can use the macros defined earlier in this file to allocate a destination buffer of the right length. This API will automatically pick the most efficient implementation, provided you have called EverCrypt_AutoConfig2_init() before. */ void EverCrypt_Hash_Incremental_hash( Spec_Hash_Definitions_hash_alg a, uint8_t *output, uint8_t *input, uint32_t input_len ); #define MD5_HASH_LEN (16U) #define SHA1_HASH_LEN (20U) #define SHA2_224_HASH_LEN (28U) #define SHA2_256_HASH_LEN (32U) #define SHA2_384_HASH_LEN (48U) #define SHA2_512_HASH_LEN (64U) #define SHA3_224_HASH_LEN (28U) #define SHA3_256_HASH_LEN (32U) #define SHA3_384_HASH_LEN (48U) #define SHA3_512_HASH_LEN (64U) #define BLAKE2S_HASH_LEN (32U) #define BLAKE2B_HASH_LEN (64U) #if defined(__cplusplus) } #endif #define __EverCrypt_Hash_H_DEFINED #endif