Struct seec::mul_triple::boolean::MulTriples

pub struct MulTriples {
    pub a: BitVec<usize>,
    pub b: BitVec<usize>,
    pub c: BitVec<usize>,
}

Efficient storage of multiple triples.

This struct is a container for multiple multiplication triples, where the components are efficiently stored in BitVecs. For a large amount, a single multiplication triple will only take up 3 bits of storage, compared to the 3 bytes needed for a single MulTriple. Prefer this type over Vec<MulTriple>.

Fields

a: BitVec<usize>

b: BitVec<usize>

c: BitVec<usize>

Implementations

impl MulTriples

pub fn zeros(size: usize) -> Self

Create size multiplication triples where a,b,c are set to zero. Intended for testing purposes.

pub fn random_pair<R: CryptoRng + Rng>(size: usize, rng: &mut R) -> [Self; 2]

Create a random pair of multiplication triples [(a1, b1, c1), (a2, b2, c2)] where c1 ^ c2 = (a1 ^ a2) & (b1 ^ b2).

pub fn random<R: Rng + CryptoRng>(size: usize, rng: &mut R) -> Self

Create multiplication triples with random values, without any structure.

pub fn random_with_fixed_c<R: Rng + CryptoRng>( c: BitVec<usize>, rng: &mut R ) -> Self

Create multiplication triples with the provided c values and random a,b values.

pub fn from_raw(a: BitVec<usize>, b: BitVec<usize>, c: BitVec<usize>) -> Self

Construct multiplication triples from their components.

Panics

Panics if the provided bitvectors don’t have an equal length.

pub fn len(&self) -> usize

Return the amount of multiplication triples.

pub fn is_empty(&self) -> bool

Returns true if there are no multiplication triples stored.

pub fn iter( &self ) -> impl ExactSizeIterator<Item = MulTriple> + DoubleEndedIterator + '_

Provides an iterator over the multiplication triples in the form of MulTriples.

pub fn pop(&mut self) -> Option<MulTriple>

pub fn slice<Idx>(&self, range: Idx) -> MulTriplesSlice<'_>

where BitSlice<usize>: Index<Idx, Output = BitSlice<usize>>, Idx: Clone,

pub fn a(&self) -> &BitVec<usize>

pub fn b(&self) -> &BitVec<usize>

pub fn c(&self) -> &BitVec<usize>

pub fn extend_from_mts(&mut self, other: &Self)

Trait Implementations

impl Clone for MulTriples

fn clone(&self) -> MulTriples

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for MulTriples

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for MulTriples

fn default() -> MulTriples

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for MulTriples

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for MulTriples

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl SetupStorage for MulTriples

fn split_off_last(&mut self, count: usize) -> Self

Split of the last count many multiplication triples into a new MulTriples.

fn remove_first(&mut self, count: usize) -> Self

WARNIGN: We implement remove_first as split_off_last for performance reasons. This should generally be fine, as the order of MTs is not important. However, this can lead to problems when e.g. mixing mt storage with different batch sizes for the parties. But there is currently no way to create stored MT files which would have this problem.

fn len(&self) -> usize

fn reserve(&mut self, additional: usize)

fn append(&mut self, other: Self)

fn is_empty(&self) -> bool