package siphash /* Copyright 2022 zhibog Made available under the BSD-3 license. List of contributors: zhibog: Initial implementation. Implementation of the SipHash hashing algorithm, as defined at and Use the specific procedures for a certain setup. The generic procdedures will default to Siphash 2-4 */ import "core:crypto" import "core:crypto/util" /* High level API */ KEY_SIZE :: 16 DIGEST_SIZE :: 8 // sum_string_1_3 will hash the given message with the key and return // the computed hash as a u64 sum_string_1_3 :: proc(msg, key: string) -> u64 { return sum_bytes_1_3(transmute([]byte)(msg), transmute([]byte)(key)) } // sum_bytes_1_3 will hash the given message with the key and return // the computed hash as a u64 sum_bytes_1_3 :: proc (msg, key: []byte) -> u64 { ctx: Context hash: u64 init(&ctx, key, 1, 3) update(&ctx, msg) final(&ctx, &hash) return hash } // sum_string_to_buffer_1_3 will hash the given message with the key and write // the computed hash into the provided destination buffer sum_string_to_buffer_1_3 :: proc(msg, key: string, dst: []byte) { sum_bytes_to_buffer_1_3(transmute([]byte)(msg), transmute([]byte)(key), dst) } // sum_bytes_to_buffer_1_3 will hash the given message with the key and write // the computed hash into the provided destination buffer sum_bytes_to_buffer_1_3 :: proc(msg, key, dst: []byte) { assert(len(dst) >= DIGEST_SIZE, "crypto/siphash: Destination buffer needs to be at least of size 8") hash := sum_bytes_1_3(msg, key) _collect_output(dst[:], hash) } sum_1_3 :: proc { sum_string_1_3, sum_bytes_1_3, sum_string_to_buffer_1_3, sum_bytes_to_buffer_1_3, } // verify_u64_1_3 will check if the supplied tag matches with the output you // will get from the provided message and key verify_u64_1_3 :: proc (tag: u64 msg, key: []byte) -> bool { return sum_bytes_1_3(msg, key) == tag } // verify_bytes will check if the supplied tag matches with the output you // will get from the provided message and key verify_bytes_1_3 :: proc (tag, msg, key: []byte) -> bool { derived_tag: [8]byte sum_bytes_to_buffer_1_3(msg, key, derived_tag[:]) return crypto.compare_constant_time(derived_tag[:], tag) == 1 } verify_1_3 :: proc { verify_bytes_1_3, verify_u64_1_3, } // sum_string_2_4 will hash the given message with the key and return // the computed hash as a u64 sum_string_2_4 :: proc(msg, key: string) -> u64 { return sum_bytes_2_4(transmute([]byte)(msg), transmute([]byte)(key)) } // sum_bytes_2_4 will hash the given message with the key and return // the computed hash as a u64 sum_bytes_2_4 :: proc (msg, key: []byte) -> u64 { ctx: Context hash: u64 init(&ctx, key, 2, 4) update(&ctx, msg) final(&ctx, &hash) return hash } // sum_string_to_buffer_2_4 will hash the given message with the key and write // the computed hash into the provided destination buffer sum_string_to_buffer_2_4 :: proc(msg, key: string, dst: []byte) { sum_bytes_to_buffer_2_4(transmute([]byte)(msg), transmute([]byte)(key), dst) } // sum_bytes_to_buffer_2_4 will hash the given message with the key and write // the computed hash into the provided destination buffer sum_bytes_to_buffer_2_4 :: proc(msg, key, dst: []byte) { assert(len(dst) >= DIGEST_SIZE, "crypto/siphash: Destination buffer needs to be at least of size 8") hash := sum_bytes_2_4(msg, key) _collect_output(dst[:], hash) } sum_2_4 :: proc { sum_string_2_4, sum_bytes_2_4, sum_string_to_buffer_2_4, sum_bytes_to_buffer_2_4, } sum_string :: sum_string_2_4 sum_bytes :: sum_bytes_2_4 sum_string_to_buffer :: sum_string_to_buffer_2_4 sum_bytes_to_buffer :: sum_bytes_to_buffer_2_4 sum :: proc { sum_string, sum_bytes, sum_string_to_buffer, sum_bytes_to_buffer, } // verify_u64_2_4 will check if the supplied tag matches with the output you // will get from the provided message and key verify_u64_2_4 :: proc (tag: u64 msg, key: []byte) -> bool { return sum_bytes_2_4(msg, key) == tag } // verify_bytes will check if the supplied tag matches with the output you // will get from the provided message and key verify_bytes_2_4 :: proc (tag, msg, key: []byte) -> bool { derived_tag: [8]byte sum_bytes_to_buffer_2_4(msg, key, derived_tag[:]) return crypto.compare_constant_time(derived_tag[:], tag) == 1 } verify_2_4 :: proc { verify_bytes_2_4, verify_u64_2_4, } verify_bytes :: verify_bytes_2_4 verify_u64 :: verify_u64_2_4 verify :: proc { verify_bytes, verify_u64, } // sum_string_4_8 will hash the given message with the key and return // the computed hash as a u64 sum_string_4_8 :: proc(msg, key: string) -> u64 { return sum_bytes_4_8(transmute([]byte)(msg), transmute([]byte)(key)) } // sum_bytes_4_8 will hash the given message with the key and return // the computed hash as a u64 sum_bytes_4_8 :: proc (msg, key: []byte) -> u64 { ctx: Context hash: u64 init(&ctx, key, 4, 8) update(&ctx, msg) final(&ctx, &hash) return hash } // sum_string_to_buffer_4_8 will hash the given message with the key and write // the computed hash into the provided destination buffer sum_string_to_buffer_4_8 :: proc(msg, key: string, dst: []byte) { sum_bytes_to_buffer_4_8(transmute([]byte)(msg), transmute([]byte)(key), dst) } // sum_bytes_to_buffer_4_8 will hash the given message with the key and write // the computed hash into the provided destination buffer sum_bytes_to_buffer_4_8 :: proc(msg, key, dst: []byte) { assert(len(dst) >= DIGEST_SIZE, "crypto/siphash: Destination buffer needs to be at least of size 8") hash := sum_bytes_4_8(msg, key) _collect_output(dst[:], hash) } sum_4_8 :: proc { sum_string_4_8, sum_bytes_4_8, sum_string_to_buffer_4_8, sum_bytes_to_buffer_4_8, } // verify_u64_4_8 will check if the supplied tag matches with the output you // will get from the provided message and key verify_u64_4_8 :: proc (tag: u64 msg, key: []byte) -> bool { return sum_bytes_4_8(msg, key) == tag } // verify_bytes will check if the supplied tag matches with the output you // will get from the provided message and key verify_bytes_4_8 :: proc (tag, msg, key: []byte) -> bool { derived_tag: [8]byte sum_bytes_to_buffer_4_8(msg, key, derived_tag[:]) return crypto.compare_constant_time(derived_tag[:], tag) == 1 } verify_4_8 :: proc { verify_bytes_4_8, verify_u64_4_8, } /* Low level API */ init :: proc(ctx: ^Context, key: []byte, c_rounds, d_rounds: int) { assert(len(key) == KEY_SIZE, "crypto/siphash: Invalid key size, want 16") ctx.c_rounds = c_rounds ctx.d_rounds = d_rounds is_valid_setting := (ctx.c_rounds == 1 && ctx.d_rounds == 3) || (ctx.c_rounds == 2 && ctx.d_rounds == 4) || (ctx.c_rounds == 4 && ctx.d_rounds == 8) assert(is_valid_setting, "crypto/siphash: Incorrect rounds set up. Valid pairs are (1,3), (2,4) and (4,8)") ctx.k0 = util.U64_LE(key[:8]) ctx.k1 = util.U64_LE(key[8:]) ctx.v0 = 0x736f6d6570736575 ~ ctx.k0 ctx.v1 = 0x646f72616e646f6d ~ ctx.k1 ctx.v2 = 0x6c7967656e657261 ~ ctx.k0 ctx.v3 = 0x7465646279746573 ~ ctx.k1 ctx.is_initialized = true } update :: proc(ctx: ^Context, data: []byte) { assert(ctx.is_initialized, "crypto/siphash: Context is not initialized") ctx.last_block = len(data) / 8 * 8 ctx.buf = data i := 0 m: u64 for i < ctx.last_block { m = u64(ctx.buf[i] & 0xff) i += 1 for r in u64(1)..<8 { m |= u64(ctx.buf[i] & 0xff) << (r * 8) i += 1 } ctx.v3 ~= m for _ in 0..= ctx.last_block; i -= 1 { m <<= 8 m |= u64(ctx.buf[i] & 0xff) } m |= u64(len(ctx.buf) << 56) ctx.v3 ~= m for _ in 0.. byte { return byte(into >> (((~byte_num) & (size_of(u64) - 1)) << 3)) } _collect_output :: #force_inline proc "contextless" (dst: []byte, hash: u64) { dst[0] = _get_byte(7, hash) dst[1] = _get_byte(6, hash) dst[2] = _get_byte(5, hash) dst[3] = _get_byte(4, hash) dst[4] = _get_byte(3, hash) dst[5] = _get_byte(2, hash) dst[6] = _get_byte(1, hash) dst[7] = _get_byte(0, hash) } _compress :: #force_inline proc "contextless" (ctx: ^Context) { ctx.v0 += ctx.v1 ctx.v1 = util.ROTL64(ctx.v1, 13) ctx.v1 ~= ctx.v0 ctx.v0 = util.ROTL64(ctx.v0, 32) ctx.v2 += ctx.v3 ctx.v3 = util.ROTL64(ctx.v3, 16) ctx.v3 ~= ctx.v2 ctx.v0 += ctx.v3 ctx.v3 = util.ROTL64(ctx.v3, 21) ctx.v3 ~= ctx.v0 ctx.v2 += ctx.v1 ctx.v1 = util.ROTL64(ctx.v1, 17) ctx.v1 ~= ctx.v2 ctx.v2 = util.ROTL64(ctx.v2, 32) }