/* MIT License * * Copyright (c) 2016-2020 INRIA, CMU and Microsoft Corporation * * 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. */ #include "Hacl_Bignum32.h" #include "internal/Hacl_Kremlib.h" #include "internal/Hacl_Bignum.h" /* SNIPPET_START: Hacl_Bignum32_add */ /******************************************************************************* A verified bignum library. This is a 32-bit optimized version, where bignums are represented as an array of `len` unsigned 32-bit integers, i.e. uint32_t[len]. *******************************************************************************/ /************************/ /* Arithmetic functions */ /************************/ /* Write `a + b mod 2 ^ (32 * len)` in `res`. This functions returns the carry. The arguments a, b and the outparam res are meant to be `len` limbs in size, i.e. uint32_t[len] */ uint32_t Hacl_Bignum32_add(uint32_t len, uint32_t *a, uint32_t *b, uint32_t *res) { return Hacl_Bignum_Addition_bn_add_eq_len_u32(len, a, b, res); } /* SNIPPET_END: Hacl_Bignum32_add */ /* SNIPPET_START: Hacl_Bignum32_sub */ /* Write `a - b mod 2 ^ (32 * len)` in `res`. This functions returns the carry. The arguments a, b and the outparam res are meant to be `len` limbs in size, i.e. uint32_t[len] */ uint32_t Hacl_Bignum32_sub(uint32_t len, uint32_t *a, uint32_t *b, uint32_t *res) { return Hacl_Bignum_Addition_bn_sub_eq_len_u32(len, a, b, res); } /* SNIPPET_END: Hacl_Bignum32_sub */ /* SNIPPET_START: Hacl_Bignum32_add_mod */ /* Write `(a + b) mod n` in `res`. The arguments a, b, n and the outparam res are meant to be `len` limbs in size, i.e. uint32_t[len]. Before calling this function, the caller will need to ensure that the following preconditions are observed. • a < n • b < n */ void Hacl_Bignum32_add_mod(uint32_t len, uint32_t *n, uint32_t *a, uint32_t *b, uint32_t *res) { Hacl_Bignum_bn_add_mod_n_u32(len, n, a, b, res); } /* SNIPPET_END: Hacl_Bignum32_add_mod */ /* SNIPPET_START: Hacl_Bignum32_sub_mod */ /* Write `(a - b) mod n` in `res`. The arguments a, b, n and the outparam res are meant to be `len` limbs in size, i.e. uint32_t[len]. Before calling this function, the caller will need to ensure that the following preconditions are observed. • a < n • b < n */ void Hacl_Bignum32_sub_mod(uint32_t len, uint32_t *n, uint32_t *a, uint32_t *b, uint32_t *res) { Hacl_Bignum_bn_sub_mod_n_u32(len, n, a, b, res); } /* SNIPPET_END: Hacl_Bignum32_sub_mod */ /* SNIPPET_START: Hacl_Bignum32_mul */ /* Write `a * b` in `res`. The arguments a and b are meant to be `len` limbs in size, i.e. uint32_t[len]. The outparam res is meant to be `2*len` limbs in size, i.e. uint32_t[2*len]. */ void Hacl_Bignum32_mul(uint32_t len, uint32_t *a, uint32_t *b, uint32_t *res) { KRML_CHECK_SIZE(sizeof (uint32_t), (uint32_t)4U * len); uint32_t tmp[(uint32_t)4U * len]; memset(tmp, 0U, (uint32_t)4U * len * sizeof (uint32_t)); Hacl_Bignum_Karatsuba_bn_karatsuba_mul_uint32(len, a, b, tmp, res); } /* SNIPPET_END: Hacl_Bignum32_mul */ /* SNIPPET_START: Hacl_Bignum32_sqr */ /* Write `a * a` in `res`. The argument a is meant to be `len` limbs in size, i.e. uint32_t[len]. The outparam res is meant to be `2*len` limbs in size, i.e. uint32_t[2*len]. */ void Hacl_Bignum32_sqr(uint32_t len, uint32_t *a, uint32_t *res) { KRML_CHECK_SIZE(sizeof (uint32_t), (uint32_t)4U * len); uint32_t tmp[(uint32_t)4U * len]; memset(tmp, 0U, (uint32_t)4U * len * sizeof (uint32_t)); Hacl_Bignum_Karatsuba_bn_karatsuba_sqr_uint32(len, a, tmp, res); } /* SNIPPET_END: Hacl_Bignum32_sqr */ /* SNIPPET_START: bn_slow_precomp */ static inline void bn_slow_precomp( uint32_t len, uint32_t *n, uint32_t mu, uint32_t *r2, uint32_t *a, uint32_t *res ) { KRML_CHECK_SIZE(sizeof (uint32_t), len); uint32_t a_mod[len]; memset(a_mod, 0U, len * sizeof (uint32_t)); KRML_CHECK_SIZE(sizeof (uint32_t), len + len); uint32_t a1[len + len]; memset(a1, 0U, (len + len) * sizeof (uint32_t)); memcpy(a1, a, (len + len) * sizeof (uint32_t)); uint32_t c0 = (uint32_t)0U; for (uint32_t i0 = (uint32_t)0U; i0 < len; i0++) { uint32_t qj = mu * a1[i0]; uint32_t *res_j0 = a1 + i0; uint32_t c = (uint32_t)0U; for (uint32_t i = (uint32_t)0U; i < len / (uint32_t)4U; i++) { uint32_t a_i = n[(uint32_t)4U * i]; uint32_t *res_i0 = res_j0 + (uint32_t)4U * i; c = Hacl_Bignum_Base_mul_wide_add2_u32(a_i, qj, c, res_i0); uint32_t a_i0 = n[(uint32_t)4U * i + (uint32_t)1U]; uint32_t *res_i1 = res_j0 + (uint32_t)4U * i + (uint32_t)1U; c = Hacl_Bignum_Base_mul_wide_add2_u32(a_i0, qj, c, res_i1); uint32_t a_i1 = n[(uint32_t)4U * i + (uint32_t)2U]; uint32_t *res_i2 = res_j0 + (uint32_t)4U * i + (uint32_t)2U; c = Hacl_Bignum_Base_mul_wide_add2_u32(a_i1, qj, c, res_i2); uint32_t a_i2 = n[(uint32_t)4U * i + (uint32_t)3U]; uint32_t *res_i = res_j0 + (uint32_t)4U * i + (uint32_t)3U; c = Hacl_Bignum_Base_mul_wide_add2_u32(a_i2, qj, c, res_i); } for (uint32_t i = len / (uint32_t)4U * (uint32_t)4U; i < len; i++) { uint32_t a_i = n[i]; uint32_t *res_i = res_j0 + i; c = Hacl_Bignum_Base_mul_wide_add2_u32(a_i, qj, c, res_i); } uint32_t r = c; uint32_t c1 = r; uint32_t *resb = a1 + len + i0; uint32_t res_j = a1[len + i0]; c0 = Lib_IntTypes_Intrinsics_add_carry_u32(c0, c1, res_j, resb); } memcpy(a_mod, a1 + len, (len + len - len) * sizeof (uint32_t)); uint32_t c00 = c0; KRML_CHECK_SIZE(sizeof (uint32_t), len); uint32_t tmp0[len]; memset(tmp0, 0U, len * sizeof (uint32_t)); uint32_t c1 = Hacl_Bignum_Addition_bn_sub_eq_len_u32(len, a_mod, n, tmp0); uint32_t m = (uint32_t)0U - c00; for (uint32_t i = (uint32_t)0U; i < len; i++) { uint32_t *os = a_mod; uint32_t x = (m & tmp0[i]) | (~m & a_mod[i]); os[i] = x; } KRML_CHECK_SIZE(sizeof (uint32_t), len + len); uint32_t c[len + len]; memset(c, 0U, (len + len) * sizeof (uint32_t)); KRML_CHECK_SIZE(sizeof (uint32_t), (uint32_t)4U * len); uint32_t tmp[(uint32_t)4U * len]; memset(tmp, 0U, (uint32_t)4U * len * sizeof (uint32_t)); Hacl_Bignum_Karatsuba_bn_karatsuba_mul_uint32(len, a_mod, r2, tmp, c); Hacl_Bignum_Montgomery_bn_mont_reduction_u32(len, n, mu, c, res); } /* SNIPPET_END: bn_slow_precomp */ /* SNIPPET_START: Hacl_Bignum32_mod */ /* Write `a mod n` in `res`. The argument a is meant to be `2*len` limbs in size, i.e. uint32_t[2*len]. The argument n and the outparam res are meant to be `len` limbs in size, i.e. uint32_t[len]. The function returns false if any of the following preconditions are violated, true otherwise. • 1 < n • n % 2 = 1 */ bool Hacl_Bignum32_mod(uint32_t len, uint32_t *n, uint32_t *a, uint32_t *res) { KRML_CHECK_SIZE(sizeof (uint32_t), len); uint32_t one[len]; memset(one, 0U, len * sizeof (uint32_t)); memset(one, 0U, len * sizeof (uint32_t)); one[0U] = (uint32_t)1U; uint32_t bit0 = n[0U] & (uint32_t)1U; uint32_t m0 = (uint32_t)0U - bit0; uint32_t acc = (uint32_t)0U; for (uint32_t i = (uint32_t)0U; i < len; i++) { uint32_t beq = FStar_UInt32_eq_mask(one[i], n[i]); uint32_t blt = ~FStar_UInt32_gte_mask(one[i], n[i]); acc = (beq & acc) | (~beq & ((blt & (uint32_t)0xFFFFFFFFU) | (~blt & (uint32_t)0U))); } uint32_t m1 = acc; uint32_t is_valid_m = m0 & m1; uint32_t nBits = (uint32_t)32U * Hacl_Bignum_Lib_bn_get_top_index_u32(len, n); if (is_valid_m == (uint32_t)0xFFFFFFFFU) { KRML_CHECK_SIZE(sizeof (uint32_t), len); uint32_t r2[len]; memset(r2, 0U, len * sizeof (uint32_t)); Hacl_Bignum_Montgomery_bn_precomp_r2_mod_n_u32(len, nBits, n, r2); uint32_t mu = Hacl_Bignum_ModInvLimb_mod_inv_uint32(n[0U]); bn_slow_precomp(len, n, mu, r2, a, res); } else { memset(res, 0U, len * sizeof (uint32_t)); } return is_valid_m == (uint32_t)0xFFFFFFFFU; } /* SNIPPET_END: Hacl_Bignum32_mod */ /* SNIPPET_START: Hacl_Bignum32_mod_exp_vartime */ /* Write `a ^ b mod n` in `res`. The arguments a, n and the outparam res are meant to be `len` limbs in size, i.e. uint32_t[len]. The argument b is a bignum of any size, and bBits is an upper bound on the number of significant bits of b. A tighter bound results in faster execution time. When in doubt, the number of bits for the bignum size is always a safe default, e.g. if b is a 4096-bit bignum, bBits should be 4096. The function is *NOT* constant-time on the argument b. See the mod_exp_consttime_* functions for constant-time variants. The function returns false if any of the following preconditions are violated, true otherwise. • n % 2 = 1 • 1 < n • b < pow2 bBits • a < n */ bool Hacl_Bignum32_mod_exp_vartime( uint32_t len, uint32_t *n, uint32_t *a, uint32_t bBits, uint32_t *b, uint32_t *res ) { uint32_t is_valid_m = Hacl_Bignum_Exponentiation_bn_check_mod_exp_u32(len, n, a, bBits, b); uint32_t nBits = (uint32_t)32U * Hacl_Bignum_Lib_bn_get_top_index_u32(len, n); if (is_valid_m == (uint32_t)0xFFFFFFFFU) { Hacl_Bignum_Exponentiation_bn_mod_exp_vartime_u32(len, nBits, n, a, bBits, b, res); } else { memset(res, 0U, len * sizeof (uint32_t)); } return is_valid_m == (uint32_t)0xFFFFFFFFU; } /* SNIPPET_END: Hacl_Bignum32_mod_exp_vartime */ /* SNIPPET_START: Hacl_Bignum32_mod_exp_consttime */ /* Write `a ^ b mod n` in `res`. The arguments a, n and the outparam res are meant to be `len` limbs in size, i.e. uint32_t[len]. The argument b is a bignum of any size, and bBits is an upper bound on the number of significant bits of b. A tighter bound results in faster execution time. When in doubt, the number of bits for the bignum size is always a safe default, e.g. if b is a 4096-bit bignum, bBits should be 4096. This function is constant-time over its argument b, at the cost of a slower execution time than mod_exp_vartime. The function returns false if any of the following preconditions are violated, true otherwise. • n % 2 = 1 • 1 < n • b < pow2 bBits • a < n */ bool Hacl_Bignum32_mod_exp_consttime( uint32_t len, uint32_t *n, uint32_t *a, uint32_t bBits, uint32_t *b, uint32_t *res ) { uint32_t is_valid_m = Hacl_Bignum_Exponentiation_bn_check_mod_exp_u32(len, n, a, bBits, b); uint32_t nBits = (uint32_t)32U * Hacl_Bignum_Lib_bn_get_top_index_u32(len, n); if (is_valid_m == (uint32_t)0xFFFFFFFFU) { Hacl_Bignum_Exponentiation_bn_mod_exp_consttime_u32(len, nBits, n, a, bBits, b, res); } else { memset(res, 0U, len * sizeof (uint32_t)); } return is_valid_m == (uint32_t)0xFFFFFFFFU; } /* SNIPPET_END: Hacl_Bignum32_mod_exp_consttime */ /* SNIPPET_START: Hacl_Bignum32_mod_inv_prime_vartime */ /* Write `a ^ (-1) mod n` in `res`. The arguments a, n and the outparam res are meant to be `len` limbs in size, i.e. uint32_t[len]. Before calling this function, the caller will need to ensure that the following preconditions are observed. • n is a prime The function returns false if any of the following preconditions are violated, true otherwise. • n % 2 = 1 • 1 < n • 0 < a • a < n */ bool Hacl_Bignum32_mod_inv_prime_vartime(uint32_t len, uint32_t *n, uint32_t *a, uint32_t *res) { KRML_CHECK_SIZE(sizeof (uint32_t), len); uint32_t one[len]; memset(one, 0U, len * sizeof (uint32_t)); memset(one, 0U, len * sizeof (uint32_t)); one[0U] = (uint32_t)1U; uint32_t bit0 = n[0U] & (uint32_t)1U; uint32_t m0 = (uint32_t)0U - bit0; uint32_t acc0 = (uint32_t)0U; for (uint32_t i = (uint32_t)0U; i < len; i++) { uint32_t beq = FStar_UInt32_eq_mask(one[i], n[i]); uint32_t blt = ~FStar_UInt32_gte_mask(one[i], n[i]); acc0 = (beq & acc0) | (~beq & ((blt & (uint32_t)0xFFFFFFFFU) | (~blt & (uint32_t)0U))); } uint32_t m1 = acc0; uint32_t m00 = m0 & m1; KRML_CHECK_SIZE(sizeof (uint32_t), len); uint32_t bn_zero[len]; memset(bn_zero, 0U, len * sizeof (uint32_t)); uint32_t mask = (uint32_t)0xFFFFFFFFU; for (uint32_t i = (uint32_t)0U; i < len; i++) { uint32_t uu____0 = FStar_UInt32_eq_mask(a[i], bn_zero[i]); mask = uu____0 & mask; } uint32_t mask1 = mask; uint32_t res10 = mask1; uint32_t m10 = res10; uint32_t acc = (uint32_t)0U; for (uint32_t i = (uint32_t)0U; i < len; i++) { uint32_t beq = FStar_UInt32_eq_mask(a[i], n[i]); uint32_t blt = ~FStar_UInt32_gte_mask(a[i], n[i]); acc = (beq & acc) | (~beq & ((blt & (uint32_t)0xFFFFFFFFU) | (~blt & (uint32_t)0U))); } uint32_t m2 = acc; uint32_t is_valid_m = (m00 & ~m10) & m2; uint32_t nBits = (uint32_t)32U * Hacl_Bignum_Lib_bn_get_top_index_u32(len, n); if (is_valid_m == (uint32_t)0xFFFFFFFFU) { KRML_CHECK_SIZE(sizeof (uint32_t), len); uint32_t n2[len]; memset(n2, 0U, len * sizeof (uint32_t)); uint32_t c0 = Lib_IntTypes_Intrinsics_sub_borrow_u32((uint32_t)0U, n[0U], (uint32_t)2U, n2); uint32_t c1; if ((uint32_t)1U < len) { uint32_t rLen = len - (uint32_t)1U; uint32_t *a1 = n + (uint32_t)1U; uint32_t *res1 = n2 + (uint32_t)1U; uint32_t c = c0; for (uint32_t i = (uint32_t)0U; i < rLen / (uint32_t)4U; i++) { uint32_t t1 = a1[(uint32_t)4U * i]; uint32_t *res_i0 = res1 + (uint32_t)4U * i; c = Lib_IntTypes_Intrinsics_sub_borrow_u32(c, t1, (uint32_t)0U, res_i0); uint32_t t10 = a1[(uint32_t)4U * i + (uint32_t)1U]; uint32_t *res_i1 = res1 + (uint32_t)4U * i + (uint32_t)1U; c = Lib_IntTypes_Intrinsics_sub_borrow_u32(c, t10, (uint32_t)0U, res_i1); uint32_t t11 = a1[(uint32_t)4U * i + (uint32_t)2U]; uint32_t *res_i2 = res1 + (uint32_t)4U * i + (uint32_t)2U; c = Lib_IntTypes_Intrinsics_sub_borrow_u32(c, t11, (uint32_t)0U, res_i2); uint32_t t12 = a1[(uint32_t)4U * i + (uint32_t)3U]; uint32_t *res_i = res1 + (uint32_t)4U * i + (uint32_t)3U; c = Lib_IntTypes_Intrinsics_sub_borrow_u32(c, t12, (uint32_t)0U, res_i); } for (uint32_t i = rLen / (uint32_t)4U * (uint32_t)4U; i < rLen; i++) { uint32_t t1 = a1[i]; uint32_t *res_i = res1 + i; c = Lib_IntTypes_Intrinsics_sub_borrow_u32(c, t1, (uint32_t)0U, res_i); } uint32_t c10 = c; c1 = c10; } else { c1 = c0; } Hacl_Bignum_Exponentiation_bn_mod_exp_vartime_u32(len, nBits, n, a, (uint32_t)32U * len, n2, res); } else { memset(res, 0U, len * sizeof (uint32_t)); } return is_valid_m == (uint32_t)0xFFFFFFFFU; } /* SNIPPET_END: Hacl_Bignum32_mod_inv_prime_vartime */ /* SNIPPET_START: Hacl_Bignum32_mont_ctx_init */ /**********************************************/ /* Arithmetic functions with precomputations. */ /**********************************************/ /* Heap-allocate and initialize a montgomery context. The argument n is meant to be `len` limbs in size, i.e. uint32_t[len]. Before calling this function, the caller will need to ensure that the following preconditions are observed. • n % 2 = 1 • 1 < n The caller will need to call Hacl_Bignum32_mont_ctx_free on the return value to avoid memory leaks. */ Hacl_Bignum_MontArithmetic_bn_mont_ctx_u32 *Hacl_Bignum32_mont_ctx_init(uint32_t len, uint32_t *n) { KRML_CHECK_SIZE(sizeof (uint32_t), len); uint32_t *r2 = KRML_HOST_CALLOC(len, sizeof (uint32_t)); KRML_CHECK_SIZE(sizeof (uint32_t), len); uint32_t *n1 = KRML_HOST_CALLOC(len, sizeof (uint32_t)); uint32_t *r21 = r2; uint32_t *n11 = n1; memcpy(n11, n, len * sizeof (uint32_t)); uint32_t nBits = (uint32_t)32U * Hacl_Bignum_Lib_bn_get_top_index_u32(len, n); Hacl_Bignum_Montgomery_bn_precomp_r2_mod_n_u32(len, nBits, n, r21); uint32_t mu = Hacl_Bignum_ModInvLimb_mod_inv_uint32(n[0U]); Hacl_Bignum_MontArithmetic_bn_mont_ctx_u32 res = { .len = len, .n = n11, .mu = mu, .r2 = r21 }; KRML_CHECK_SIZE(sizeof (Hacl_Bignum_MontArithmetic_bn_mont_ctx_u32), (uint32_t)1U); Hacl_Bignum_MontArithmetic_bn_mont_ctx_u32 *buf = KRML_HOST_MALLOC(sizeof (Hacl_Bignum_MontArithmetic_bn_mont_ctx_u32)); buf[0U] = res; return buf; } /* SNIPPET_END: Hacl_Bignum32_mont_ctx_init */ /* SNIPPET_START: Hacl_Bignum32_mont_ctx_free */ /* Deallocate the memory previously allocated by Hacl_Bignum32_mont_ctx_init. The argument k is a montgomery context obtained through Hacl_Bignum32_mont_ctx_init. */ void Hacl_Bignum32_mont_ctx_free(Hacl_Bignum_MontArithmetic_bn_mont_ctx_u32 *k) { Hacl_Bignum_MontArithmetic_bn_mont_ctx_u32 k1 = *k; uint32_t *n = k1.n; uint32_t *r2 = k1.r2; KRML_HOST_FREE(n); KRML_HOST_FREE(r2); KRML_HOST_FREE(k); } /* SNIPPET_END: Hacl_Bignum32_mont_ctx_free */ /* SNIPPET_START: Hacl_Bignum32_mod_precomp */ /* Write `a mod n` in `res`. The argument a is meant to be `2*len` limbs in size, i.e. uint32_t[2*len]. The outparam res is meant to be `len` limbs in size, i.e. uint32_t[len]. The argument k is a montgomery context obtained through Hacl_Bignum32_mont_ctx_init. */ void Hacl_Bignum32_mod_precomp( Hacl_Bignum_MontArithmetic_bn_mont_ctx_u32 *k, uint32_t *a, uint32_t *res ) { Hacl_Bignum_MontArithmetic_bn_mont_ctx_u32 k10 = *k; uint32_t len1 = k10.len; Hacl_Bignum_MontArithmetic_bn_mont_ctx_u32 k1 = *k; bn_slow_precomp(len1, k1.n, k1.mu, k1.r2, a, res); } /* SNIPPET_END: Hacl_Bignum32_mod_precomp */ /* SNIPPET_START: Hacl_Bignum32_mod_exp_vartime_precomp */ /* Write `a ^ b mod n` in `res`. The arguments a and the outparam res are meant to be `len` limbs in size, i.e. uint32_t[len]. The argument k is a montgomery context obtained through Hacl_Bignum32_mont_ctx_init. The argument b is a bignum of any size, and bBits is an upper bound on the number of significant bits of b. A tighter bound results in faster execution time. When in doubt, the number of bits for the bignum size is always a safe default, e.g. if b is a 4096-bit bignum, bBits should be 4096. The function is *NOT* constant-time on the argument b. See the mod_exp_consttime_* functions for constant-time variants. Before calling this function, the caller will need to ensure that the following preconditions are observed. • b < pow2 bBits • a < n */ void Hacl_Bignum32_mod_exp_vartime_precomp( Hacl_Bignum_MontArithmetic_bn_mont_ctx_u32 *k, uint32_t *a, uint32_t bBits, uint32_t *b, uint32_t *res ) { Hacl_Bignum_MontArithmetic_bn_mont_ctx_u32 k10 = *k; uint32_t len1 = k10.len; Hacl_Bignum_MontArithmetic_bn_mont_ctx_u32 k1 = *k; Hacl_Bignum_Exponentiation_bn_mod_exp_vartime_precomp_u32(len1, k1.n, k1.mu, k1.r2, a, bBits, b, res); } /* SNIPPET_END: Hacl_Bignum32_mod_exp_vartime_precomp */ /* SNIPPET_START: Hacl_Bignum32_mod_exp_consttime_precomp */ /* Write `a ^ b mod n` in `res`. The arguments a and the outparam res are meant to be `len` limbs in size, i.e. uint32_t[len]. The argument k is a montgomery context obtained through Hacl_Bignum32_mont_ctx_init. The argument b is a bignum of any size, and bBits is an upper bound on the number of significant bits of b. A tighter bound results in faster execution time. When in doubt, the number of bits for the bignum size is always a safe default, e.g. if b is a 4096-bit bignum, bBits should be 4096. This function is constant-time over its argument b, at the cost of a slower execution time than mod_exp_vartime_*. Before calling this function, the caller will need to ensure that the following preconditions are observed. • b < pow2 bBits • a < n */ void Hacl_Bignum32_mod_exp_consttime_precomp( Hacl_Bignum_MontArithmetic_bn_mont_ctx_u32 *k, uint32_t *a, uint32_t bBits, uint32_t *b, uint32_t *res ) { Hacl_Bignum_MontArithmetic_bn_mont_ctx_u32 k10 = *k; uint32_t len1 = k10.len; Hacl_Bignum_MontArithmetic_bn_mont_ctx_u32 k1 = *k; Hacl_Bignum_Exponentiation_bn_mod_exp_consttime_precomp_u32(len1, k1.n, k1.mu, k1.r2, a, bBits, b, res); } /* SNIPPET_END: Hacl_Bignum32_mod_exp_consttime_precomp */ /* SNIPPET_START: Hacl_Bignum32_mod_inv_prime_vartime_precomp */ /* Write `a ^ (-1) mod n` in `res`. The argument a and the outparam res are meant to be `len` limbs in size, i.e. uint32_t[len]. The argument k is a montgomery context obtained through Hacl_Bignum32_mont_ctx_init. Before calling this function, the caller will need to ensure that the following preconditions are observed. • n is a prime • 0 < a • a < n */ void Hacl_Bignum32_mod_inv_prime_vartime_precomp( Hacl_Bignum_MontArithmetic_bn_mont_ctx_u32 *k, uint32_t *a, uint32_t *res ) { Hacl_Bignum_MontArithmetic_bn_mont_ctx_u32 k10 = *k; uint32_t len1 = k10.len; Hacl_Bignum_MontArithmetic_bn_mont_ctx_u32 k1 = *k; KRML_CHECK_SIZE(sizeof (uint32_t), len1); uint32_t n2[len1]; memset(n2, 0U, len1 * sizeof (uint32_t)); uint32_t c0 = Lib_IntTypes_Intrinsics_sub_borrow_u32((uint32_t)0U, k1.n[0U], (uint32_t)2U, n2); uint32_t c1; if ((uint32_t)1U < len1) { uint32_t rLen = len1 - (uint32_t)1U; uint32_t *a1 = k1.n + (uint32_t)1U; uint32_t *res1 = n2 + (uint32_t)1U; uint32_t c = c0; for (uint32_t i = (uint32_t)0U; i < rLen / (uint32_t)4U; i++) { uint32_t t1 = a1[(uint32_t)4U * i]; uint32_t *res_i0 = res1 + (uint32_t)4U * i; c = Lib_IntTypes_Intrinsics_sub_borrow_u32(c, t1, (uint32_t)0U, res_i0); uint32_t t10 = a1[(uint32_t)4U * i + (uint32_t)1U]; uint32_t *res_i1 = res1 + (uint32_t)4U * i + (uint32_t)1U; c = Lib_IntTypes_Intrinsics_sub_borrow_u32(c, t10, (uint32_t)0U, res_i1); uint32_t t11 = a1[(uint32_t)4U * i + (uint32_t)2U]; uint32_t *res_i2 = res1 + (uint32_t)4U * i + (uint32_t)2U; c = Lib_IntTypes_Intrinsics_sub_borrow_u32(c, t11, (uint32_t)0U, res_i2); uint32_t t12 = a1[(uint32_t)4U * i + (uint32_t)3U]; uint32_t *res_i = res1 + (uint32_t)4U * i + (uint32_t)3U; c = Lib_IntTypes_Intrinsics_sub_borrow_u32(c, t12, (uint32_t)0U, res_i); } for (uint32_t i = rLen / (uint32_t)4U * (uint32_t)4U; i < rLen; i++) { uint32_t t1 = a1[i]; uint32_t *res_i = res1 + i; c = Lib_IntTypes_Intrinsics_sub_borrow_u32(c, t1, (uint32_t)0U, res_i); } uint32_t c10 = c; c1 = c10; } else { c1 = c0; } Hacl_Bignum_Exponentiation_bn_mod_exp_vartime_precomp_u32(len1, k1.n, k1.mu, k1.r2, a, (uint32_t)32U * len1, n2, res); } /* SNIPPET_END: Hacl_Bignum32_mod_inv_prime_vartime_precomp */ /* SNIPPET_START: Hacl_Bignum32_new_bn_from_bytes_be */ /********************/ /* Loads and stores */ /********************/ /* Load a bid-endian bignum from memory. The argument b points to `len` bytes of valid memory. The function returns a heap-allocated bignum of size sufficient to hold the result of loading b, or NULL if either the allocation failed, or the amount of required memory would exceed 4GB. If the return value is non-null, clients must eventually call free(3) on it to avoid memory leaks. */ uint32_t *Hacl_Bignum32_new_bn_from_bytes_be(uint32_t len, uint8_t *b) { if ( len == (uint32_t)0U || !((len - (uint32_t)1U) / (uint32_t)4U + (uint32_t)1U <= (uint32_t)1073741823U) ) { return NULL; } KRML_CHECK_SIZE(sizeof (uint32_t), (len - (uint32_t)1U) / (uint32_t)4U + (uint32_t)1U); uint32_t *res = KRML_HOST_CALLOC((len - (uint32_t)1U) / (uint32_t)4U + (uint32_t)1U, sizeof (uint32_t)); if (res == NULL) { return res; } uint32_t *res1 = res; uint32_t *res2 = res1; uint32_t bnLen = (len - (uint32_t)1U) / (uint32_t)4U + (uint32_t)1U; uint32_t tmpLen = (uint32_t)4U * bnLen; KRML_CHECK_SIZE(sizeof (uint8_t), tmpLen); uint8_t tmp[tmpLen]; memset(tmp, 0U, tmpLen * sizeof (uint8_t)); memcpy(tmp + tmpLen - len, b, len * sizeof (uint8_t)); for (uint32_t i = (uint32_t)0U; i < bnLen; i++) { uint32_t *os = res2; uint32_t u = load32_be(tmp + (bnLen - i - (uint32_t)1U) * (uint32_t)4U); uint32_t x = u; os[i] = x; } return res2; } /* SNIPPET_END: Hacl_Bignum32_new_bn_from_bytes_be */ /* SNIPPET_START: Hacl_Bignum32_new_bn_from_bytes_le */ /* Load a little-endian bignum from memory. The argument b points to `len` bytes of valid memory. The function returns a heap-allocated bignum of size sufficient to hold the result of loading b, or NULL if either the allocation failed, or the amount of required memory would exceed 4GB. If the return value is non-null, clients must eventually call free(3) on it to avoid memory leaks. */ uint32_t *Hacl_Bignum32_new_bn_from_bytes_le(uint32_t len, uint8_t *b) { if ( len == (uint32_t)0U || !((len - (uint32_t)1U) / (uint32_t)4U + (uint32_t)1U <= (uint32_t)1073741823U) ) { return NULL; } KRML_CHECK_SIZE(sizeof (uint32_t), (len - (uint32_t)1U) / (uint32_t)4U + (uint32_t)1U); uint32_t *res = KRML_HOST_CALLOC((len - (uint32_t)1U) / (uint32_t)4U + (uint32_t)1U, sizeof (uint32_t)); if (res == NULL) { return res; } uint32_t *res1 = res; uint32_t *res2 = res1; uint32_t bnLen = (len - (uint32_t)1U) / (uint32_t)4U + (uint32_t)1U; uint32_t tmpLen = (uint32_t)4U * bnLen; KRML_CHECK_SIZE(sizeof (uint8_t), tmpLen); uint8_t tmp[tmpLen]; memset(tmp, 0U, tmpLen * sizeof (uint8_t)); memcpy(tmp, b, len * sizeof (uint8_t)); for (uint32_t i = (uint32_t)0U; i < (len - (uint32_t)1U) / (uint32_t)4U + (uint32_t)1U; i++) { uint32_t *os = res2; uint8_t *bj = tmp + i * (uint32_t)4U; uint32_t u = load32_le(bj); uint32_t r1 = u; uint32_t x = r1; os[i] = x; } return res2; } /* SNIPPET_END: Hacl_Bignum32_new_bn_from_bytes_le */ /* SNIPPET_START: Hacl_Bignum32_bn_to_bytes_be */ /* Serialize a bignum into big-endian memory. The argument b points to a bignum of ⌈len / 4⌉ size. The outparam res points to `len` bytes of valid memory. */ void Hacl_Bignum32_bn_to_bytes_be(uint32_t len, uint32_t *b, uint8_t *res) { uint32_t bnLen = (len - (uint32_t)1U) / (uint32_t)4U + (uint32_t)1U; uint32_t tmpLen = (uint32_t)4U * bnLen; KRML_CHECK_SIZE(sizeof (uint8_t), tmpLen); uint8_t tmp[tmpLen]; memset(tmp, 0U, tmpLen * sizeof (uint8_t)); uint32_t numb = (uint32_t)4U; for (uint32_t i = (uint32_t)0U; i < bnLen; i++) { store32_be(tmp + i * numb, b[bnLen - i - (uint32_t)1U]); } memcpy(res, tmp + tmpLen - len, len * sizeof (uint8_t)); } /* SNIPPET_END: Hacl_Bignum32_bn_to_bytes_be */ /* SNIPPET_START: Hacl_Bignum32_bn_to_bytes_le */ /* Serialize a bignum into little-endian memory. The argument b points to a bignum of ⌈len / 4⌉ size. The outparam res points to `len` bytes of valid memory. */ void Hacl_Bignum32_bn_to_bytes_le(uint32_t len, uint32_t *b, uint8_t *res) { uint32_t bnLen = (len - (uint32_t)1U) / (uint32_t)4U + (uint32_t)1U; uint32_t tmpLen = (uint32_t)4U * bnLen; KRML_CHECK_SIZE(sizeof (uint8_t), tmpLen); uint8_t tmp[tmpLen]; memset(tmp, 0U, tmpLen * sizeof (uint8_t)); for (uint32_t i = (uint32_t)0U; i < bnLen; i++) { store32_le(tmp + i * (uint32_t)4U, b[i]); } memcpy(res, tmp, len * sizeof (uint8_t)); } /* SNIPPET_END: Hacl_Bignum32_bn_to_bytes_le */ /* SNIPPET_START: Hacl_Bignum32_lt_mask */ /***************/ /* Comparisons */ /***************/ /* Returns 2^32 - 1 if a < b, otherwise returns 0. The arguments a and b are meant to be `len` limbs in size, i.e. uint32_t[len]. */ uint32_t Hacl_Bignum32_lt_mask(uint32_t len, uint32_t *a, uint32_t *b) { uint32_t acc = (uint32_t)0U; for (uint32_t i = (uint32_t)0U; i < len; i++) { uint32_t beq = FStar_UInt32_eq_mask(a[i], b[i]); uint32_t blt = ~FStar_UInt32_gte_mask(a[i], b[i]); acc = (beq & acc) | (~beq & ((blt & (uint32_t)0xFFFFFFFFU) | (~blt & (uint32_t)0U))); } return acc; } /* SNIPPET_END: Hacl_Bignum32_lt_mask */ /* SNIPPET_START: Hacl_Bignum32_eq_mask */ /* Returns 2^32 - 1 if a = b, otherwise returns 0. The arguments a and b are meant to be `len` limbs in size, i.e. uint32_t[len]. */ uint32_t Hacl_Bignum32_eq_mask(uint32_t len, uint32_t *a, uint32_t *b) { uint32_t mask = (uint32_t)0xFFFFFFFFU; for (uint32_t i = (uint32_t)0U; i < len; i++) { uint32_t uu____0 = FStar_UInt32_eq_mask(a[i], b[i]); mask = uu____0 & mask; } uint32_t mask1 = mask; return mask1; } /* SNIPPET_END: Hacl_Bignum32_eq_mask */