fss-rs 0.6.0

Function secret sharing including distributed comparison & point functions
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
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110

// SPDX-License-Identifier: Apache-2.0
// Copyright (C) 2023 Yulong Ming (myl7)

//! Integers as a group.
//!
//! - Associative operation: Integer wrapping addition, `$(a + b) \mod 2^N$`.
//! - Identity element: 0.
//! - Inverse element: `-x`.
//!
//! # Security
//!
//! Such a group whose cardinality is not a prime number cannot provide the attribute that: if `a` and `b` are individually indistinguishable with random elements, `a * b` (integer multiplication) is still that.
//! If you need this attribute (e.g., for some verification), use [`crate::group::int_prime`] instead.

use std::mem::size_of;
use std::ops::{Add, AddAssign, Neg};

use super::Group;

macro_rules! decl_int_group {
    ($t:ty, $t_impl:ident) => {
        /// See [`self`].
        #[derive(Debug, Clone, PartialEq, Eq)]
        pub struct $t_impl(pub $t);

        impl Add for $t_impl {
            type Output = Self;

            fn add(self, rhs: Self) -> Self::Output {
                $t_impl(self.0.wrapping_add(rhs.0))
            }
        }

        impl AddAssign for $t_impl {
            fn add_assign(&mut self, rhs: Self) {
                self.0 = self.0.wrapping_add(rhs.0);
            }
        }

        impl Neg for $t_impl {
            type Output = Self;

            fn neg(self) -> Self::Output {
                $t_impl(self.0.wrapping_neg())
            }
        }

        impl<const BLEN: usize> Group<BLEN> for $t_impl {
            fn zero() -> Self {
                $t_impl(0)
            }
        }

        impl<const BLEN: usize> From<[u8; BLEN]> for $t_impl {
            fn from(value: [u8; BLEN]) -> Self {
                if cfg!(not(feature = "int-be")) {
                    $t_impl(<$t>::from_le_bytes(
                        (&value[..size_of::<$t>()]).clone().try_into().unwrap(),
                    ))
                } else {
                    $t_impl(<$t>::from_be_bytes(
                        (&value[..size_of::<$t>()]).clone().try_into().unwrap(),
                    ))
                }
            }
        }

        impl From<$t> for $t_impl {
            fn from(value: $t) -> Self {
                $t_impl(value)
            }
        }

        impl<const BLEN: usize> From<$t_impl> for [u8; BLEN] {
            fn from(value: $t_impl) -> Self {
                let mut bs = [0; BLEN];
                if cfg!(not(feature = "int-be")) {
                    bs[..size_of::<$t>()].copy_from_slice(&value.0.to_le_bytes());
                } else {
                    bs[..size_of::<$t>()].copy_from_slice(&value.0.to_be_bytes());
                }
                bs
            }
        }

        impl From<$t_impl> for $t {
            fn from(value: $t_impl) -> Self {
                value.0
            }
        }
    };
}

decl_int_group!(u8, U8Group);
decl_int_group!(u16, U16Group);
decl_int_group!(u32, U32Group);
decl_int_group!(u64, U64Group);
decl_int_group!(u128, U128Group);

#[cfg(test)]
mod tests {
    use super::*;
    use crate::test_group_axioms;

    test_group_axioms!(test_u8_group_axioms, U8Group, 1);
    test_group_axioms!(test_u16_group_axioms, U16Group, 2);
    test_group_axioms!(test_u32_group_axioms, U32Group, 4);
    test_group_axioms!(test_u64_group_axioms, U64Group, 8);
    test_group_axioms!(test_u128_group_axioms, U128Group, 16);
}