crypto-bigint 0.7.2

Pure Rust implementation of a big integer library which has been designed from the ground-up for use in cryptographic applications. Provides constant-time, no_std-friendly implementations of modern formulas using const generics.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79

//! [`BoxedUint`] multiplication helper to reduce allocations.

use alloc::vec::Vec;

use crate::{BoxedUint, Choice, Limb, UintRef};

/// Boxed multiplier with a pre-allocated internal buffer to avoid additional allocations.
#[derive(Debug, Clone)]
pub struct BoxedMultiplier {
    product: Vec<Limb>,
}

impl BoxedMultiplier {
    pub fn new() -> Self {
        Self {
            product: Vec::new(),
        }
    }

    fn get_buffer(&mut self, limbs: usize) -> &mut UintRef {
        self.product.clear();
        self.product.resize(limbs, Limb::ZERO);
        UintRef::new_mut(&mut self.product[..limbs])
    }

    pub fn overflowing_mul(&mut self, lhs: &BoxedUint, rhs: &BoxedUint) -> (&mut UintRef, Choice) {
        let buf = self.get_buffer(lhs.nlimbs());
        let overflow = lhs.as_uint_ref().overflowing_mul(rhs.as_uint_ref(), buf);
        (buf, overflow)
    }

    pub fn overflowing_mul_assign(&mut self, lhs: &mut BoxedUint, rhs: &BoxedUint) -> Choice {
        let (buf, overflow) = self.overflowing_mul(lhs, rhs);
        lhs.as_mut_uint_ref().copy_from(buf);
        overflow
    }

    pub fn overflowing_square(&mut self, lhs: &BoxedUint) -> (&mut UintRef, Choice) {
        let buf = self.get_buffer(lhs.nlimbs());
        let overflow = lhs.as_uint_ref().overflowing_square(buf);
        (buf, overflow)
    }

    pub fn overflowing_square_assign(&mut self, lhs: &mut BoxedUint) -> Choice {
        let (buf, overflow) = self.overflowing_square(lhs);
        lhs.as_mut_uint_ref().copy_from(buf);
        overflow
    }

    pub fn wrapping_mul(&mut self, lhs: &BoxedUint, rhs: &BoxedUint) -> &mut UintRef {
        self.wrapping_mul_with_carry(lhs, rhs).0
    }

    pub fn wrapping_mul_assign(&mut self, lhs: &mut BoxedUint, rhs: &BoxedUint) {
        let (buf, _) = self.wrapping_mul_with_carry(lhs, rhs);
        lhs.as_mut_uint_ref().copy_from(buf);
    }

    fn wrapping_mul_with_carry(
        &mut self,
        lhs: &BoxedUint,
        rhs: &BoxedUint,
    ) -> (&mut UintRef, Limb) {
        let buf = self.get_buffer(lhs.nlimbs());
        let carry = lhs.as_uint_ref().wrapping_mul(rhs.as_uint_ref(), buf);
        (buf, carry)
    }

    pub fn wrapping_square_assign(&mut self, lhs: &mut BoxedUint) {
        let (buf, _) = self.wrapping_square_with_carry(lhs);
        lhs.as_mut_uint_ref().copy_from(buf);
    }

    fn wrapping_square_with_carry(&mut self, lhs: &BoxedUint) -> (&mut UintRef, Limb) {
        let buf = self.get_buffer(lhs.nlimbs());
        let carry = lhs.as_uint_ref().wrapping_square(buf);
        (buf, carry)
    }
}