1*81ad6265SDimitry Andric /*===-- llvm-c/blake3.h - BLAKE3 C Interface ----------------------*- C -*-===*\ 2*81ad6265SDimitry Andric |* *| 3*81ad6265SDimitry Andric |* Released into the public domain with CC0 1.0 *| 4*81ad6265SDimitry Andric |* See 'llvm/lib/Support/BLAKE3/LICENSE' for info. *| 5*81ad6265SDimitry Andric |* SPDX-License-Identifier: CC0-1.0 *| 6*81ad6265SDimitry Andric |* *| 7*81ad6265SDimitry Andric |*===----------------------------------------------------------------------===*| 8*81ad6265SDimitry Andric |* *| 9*81ad6265SDimitry Andric |* This header declares the C interface to LLVM's BLAKE3 implementation. *| 10*81ad6265SDimitry Andric |* Original BLAKE3 C API: https://github.com/BLAKE3-team/BLAKE3/tree/1.3.1/c *| 11*81ad6265SDimitry Andric |* *| 12*81ad6265SDimitry Andric |* Symbols are prefixed with 'llvm' to avoid a potential conflict with *| 13*81ad6265SDimitry Andric |* another BLAKE3 version within the same program. *| 14*81ad6265SDimitry Andric |* *| 15*81ad6265SDimitry Andric \*===----------------------------------------------------------------------===*/ 16*81ad6265SDimitry Andric 17*81ad6265SDimitry Andric #ifndef LLVM_C_BLAKE3_H 18*81ad6265SDimitry Andric #define LLVM_C_BLAKE3_H 19*81ad6265SDimitry Andric 20*81ad6265SDimitry Andric #include <stddef.h> 21*81ad6265SDimitry Andric #include <stdint.h> 22*81ad6265SDimitry Andric 23*81ad6265SDimitry Andric #ifdef __cplusplus 24*81ad6265SDimitry Andric extern "C" { 25*81ad6265SDimitry Andric #endif 26*81ad6265SDimitry Andric 27*81ad6265SDimitry Andric #define LLVM_BLAKE3_VERSION_STRING "1.3.1" 28*81ad6265SDimitry Andric #define LLVM_BLAKE3_KEY_LEN 32 29*81ad6265SDimitry Andric #define LLVM_BLAKE3_OUT_LEN 32 30*81ad6265SDimitry Andric #define LLVM_BLAKE3_BLOCK_LEN 64 31*81ad6265SDimitry Andric #define LLVM_BLAKE3_CHUNK_LEN 1024 32*81ad6265SDimitry Andric #define LLVM_BLAKE3_MAX_DEPTH 54 33*81ad6265SDimitry Andric 34*81ad6265SDimitry Andric // This struct is a private implementation detail. It has to be here because 35*81ad6265SDimitry Andric // it's part of llvm_blake3_hasher below. 36*81ad6265SDimitry Andric typedef struct { 37*81ad6265SDimitry Andric uint32_t cv[8]; 38*81ad6265SDimitry Andric uint64_t chunk_counter; 39*81ad6265SDimitry Andric uint8_t buf[LLVM_BLAKE3_BLOCK_LEN]; 40*81ad6265SDimitry Andric uint8_t buf_len; 41*81ad6265SDimitry Andric uint8_t blocks_compressed; 42*81ad6265SDimitry Andric uint8_t flags; 43*81ad6265SDimitry Andric } llvm_blake3_chunk_state; 44*81ad6265SDimitry Andric 45*81ad6265SDimitry Andric typedef struct { 46*81ad6265SDimitry Andric uint32_t key[8]; 47*81ad6265SDimitry Andric llvm_blake3_chunk_state chunk; 48*81ad6265SDimitry Andric uint8_t cv_stack_len; 49*81ad6265SDimitry Andric // The stack size is MAX_DEPTH + 1 because we do lazy merging. For example, 50*81ad6265SDimitry Andric // with 7 chunks, we have 3 entries in the stack. Adding an 8th chunk 51*81ad6265SDimitry Andric // requires a 4th entry, rather than merging everything down to 1, because we 52*81ad6265SDimitry Andric // don't know whether more input is coming. This is different from how the 53*81ad6265SDimitry Andric // reference implementation does things. 54*81ad6265SDimitry Andric uint8_t cv_stack[(LLVM_BLAKE3_MAX_DEPTH + 1) * LLVM_BLAKE3_OUT_LEN]; 55*81ad6265SDimitry Andric } llvm_blake3_hasher; 56*81ad6265SDimitry Andric 57*81ad6265SDimitry Andric const char *llvm_blake3_version(void); 58*81ad6265SDimitry Andric void llvm_blake3_hasher_init(llvm_blake3_hasher *self); 59*81ad6265SDimitry Andric void llvm_blake3_hasher_init_keyed(llvm_blake3_hasher *self, 60*81ad6265SDimitry Andric const uint8_t key[LLVM_BLAKE3_KEY_LEN]); 61*81ad6265SDimitry Andric void llvm_blake3_hasher_init_derive_key(llvm_blake3_hasher *self, 62*81ad6265SDimitry Andric const char *context); 63*81ad6265SDimitry Andric void llvm_blake3_hasher_init_derive_key_raw(llvm_blake3_hasher *self, 64*81ad6265SDimitry Andric const void *context, 65*81ad6265SDimitry Andric size_t context_len); 66*81ad6265SDimitry Andric void llvm_blake3_hasher_update(llvm_blake3_hasher *self, const void *input, 67*81ad6265SDimitry Andric size_t input_len); 68*81ad6265SDimitry Andric void llvm_blake3_hasher_finalize(const llvm_blake3_hasher *self, uint8_t *out, 69*81ad6265SDimitry Andric size_t out_len); 70*81ad6265SDimitry Andric void llvm_blake3_hasher_finalize_seek(const llvm_blake3_hasher *self, 71*81ad6265SDimitry Andric uint64_t seek, uint8_t *out, 72*81ad6265SDimitry Andric size_t out_len); 73*81ad6265SDimitry Andric void llvm_blake3_hasher_reset(llvm_blake3_hasher *self); 74*81ad6265SDimitry Andric 75*81ad6265SDimitry Andric #ifdef __cplusplus 76*81ad6265SDimitry Andric } 77*81ad6265SDimitry Andric #endif 78*81ad6265SDimitry Andric 79*81ad6265SDimitry Andric #endif /* LLVM_C_BLAKE3_H */ 80