Struct vsss_rs::Gf256

#[repr(transparent)]
pub struct Gf256(pub u8);

Represents the finite field GF(2^8) with 256 elements.

Tuple Fields

0: u8

Implementations

impl Gf256

pub fn pow(&self, exp: u8) -> Self

Raise the element to the power of exp.

pub fn split_array<B: AsRef<[u8]>>( threshold: usize, limit: usize, secret: B, rng: impl RngCore + CryptoRng ) -> VsssResult<Vec<Vec<u8>>>

Split a byte array into shares.

pub fn split_array_with_participant_generator<P: ParticipantNumberGenerator<Self>, B: AsRef<[u8]>>( threshold: usize, limit: usize, secret: B, rng: impl RngCore + CryptoRng, participant_generator: P ) -> VsssResult<Vec<Vec<u8>>>

Split a byte array into shares using the participant number generator.

pub fn combine_array<B: AsRef<[Vec<u8>]>>(shares: B) -> VsssResult<Vec<u8>>

Combine shares into a byte array.

Trait Implementations

impl Add<&Gf256> for &Gf256

type Output = Gf256

The resulting type after applying the + operator.

fn add(self, rhs: &Gf256) -> Gf256

Performs the + operation.

impl Add<&Gf256> for Gf256

type Output = Gf256

The resulting type after applying the + operator.

fn add(self, rhs: &Gf256) -> Gf256

Performs the + operation.

impl Add<Gf256> for &Gf256

type Output = Gf256

The resulting type after applying the + operator.

fn add(self, rhs: Gf256) -> Gf256

Performs the + operation.

impl Add for Gf256

type Output = Gf256

The resulting type after applying the + operator.

fn add(self, rhs: Self) -> Self

Performs the + operation.

impl AddAssign<&Gf256> for Gf256

fn add_assign(&mut self, rhs: &Gf256)

Performs the += operation.

impl AddAssign for Gf256

fn add_assign(&mut self, rhs: Self)

Performs the += operation.

impl Binary for Gf256

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

Formats the value using the given formatter.

impl BitAnd<&Gf256> for &Gf256

type Output = Gf256

The resulting type after applying the & operator.

fn bitand(self, rhs: &Gf256) -> Gf256

Performs the & operation.

impl BitAnd<&Gf256> for Gf256

type Output = Gf256

The resulting type after applying the & operator.

fn bitand(self, rhs: &Gf256) -> Gf256

Performs the & operation.

impl BitAnd<Gf256> for &Gf256

type Output = Gf256

The resulting type after applying the & operator.

fn bitand(self, rhs: Gf256) -> Gf256

Performs the & operation.

impl BitAnd for Gf256

type Output = Gf256

The resulting type after applying the & operator.

fn bitand(self, rhs: Self) -> Self

Performs the & operation.

impl BitAndAssign<&Gf256> for Gf256

fn bitand_assign(&mut self, rhs: &Gf256)

Performs the &= operation.

impl BitAndAssign for Gf256

fn bitand_assign(&mut self, rhs: Self)

Performs the &= operation.

impl BitOr<&Gf256> for &Gf256

type Output = Gf256

The resulting type after applying the | operator.

fn bitor(self, rhs: &Gf256) -> Gf256

Performs the | operation.

impl BitOr<&Gf256> for Gf256

type Output = Gf256

The resulting type after applying the | operator.

fn bitor(self, rhs: &Gf256) -> Gf256

Performs the | operation.

impl BitOr<Gf256> for &Gf256

type Output = Gf256

The resulting type after applying the | operator.

fn bitor(self, rhs: Gf256) -> Gf256

Performs the | operation.

impl BitOr for Gf256

type Output = Gf256

The resulting type after applying the | operator.

fn bitor(self, rhs: Self) -> Self

Performs the | operation.

impl BitOrAssign<&Gf256> for Gf256

fn bitor_assign(&mut self, rhs: &Gf256)

Performs the |= operation.

impl BitOrAssign for Gf256

fn bitor_assign(&mut self, rhs: Self)

Performs the |= operation.

impl BitXor<&Gf256> for &Gf256

type Output = Gf256

The resulting type after applying the ^ operator.

fn bitxor(self, rhs: &Gf256) -> Gf256

Performs the ^ operation.

impl BitXor<&Gf256> for Gf256

type Output = Gf256

The resulting type after applying the ^ operator.

fn bitxor(self, rhs: &Gf256) -> Gf256

Performs the ^ operation.

impl BitXor<Gf256> for &Gf256

type Output = Gf256

The resulting type after applying the ^ operator.

fn bitxor(self, rhs: Gf256) -> Gf256

Performs the ^ operation.

impl BitXor for Gf256

type Output = Gf256

The resulting type after applying the ^ operator.

fn bitxor(self, rhs: Self) -> Self

Performs the ^ operation.

impl BitXorAssign<&Gf256> for Gf256

fn bitxor_assign(&mut self, rhs: &Gf256)

Performs the ^= operation.

impl BitXorAssign for Gf256

fn bitxor_assign(&mut self, rhs: Self)

Performs the ^= operation.

impl Clone for Gf256

fn clone(&self) -> Gf256

Returns a copy of the value.

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

Performs copy-assignment from source.

impl ConditionallySelectable for Gf256

fn conditional_select(a: &Self, b: &Self, choice: Choice) -> Self

Select a or b according to choice.

fn conditional_assign(&mut self, other: &Self, choice: Choice)

Conditionally assign other to self, according to choice.

fn conditional_swap(a: &mut Self, b: &mut Self, choice: Choice)

Conditionally swap self and other if choice == 1; otherwise, reassign both unto themselves.

impl ConstantTimeEq for Gf256

fn ct_eq(&self, other: &Self) -> Choice

Determine if two items are equal.

fn ct_ne(&self, other: &Self) -> Choice

Determine if two items are NOT equal.

impl Debug for Gf256

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

Formats the value using the given formatter.

impl Default for Gf256

fn default() -> Gf256

Returns the “default value” for a type.

impl Display for Gf256

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

Formats the value using the given formatter.

impl Div<&Gf256> for &Gf256

type Output = Gf256

The resulting type after applying the / operator.

fn div(self, rhs: &Gf256) -> Gf256

Performs the / operation.

impl Div<&Gf256> for Gf256

type Output = Gf256

The resulting type after applying the / operator.

fn div(self, rhs: &Gf256) -> Gf256

Performs the / operation.

impl Div<Gf256> for &Gf256

type Output = Gf256

The resulting type after applying the / operator.

fn div(self, rhs: Gf256) -> Gf256

Performs the / operation.

impl Div for Gf256

type Output = Gf256

The resulting type after applying the / operator.

fn div(self, rhs: Self) -> Self::Output

Performs the / operation.

impl DivAssign<&Gf256> for Gf256

fn div_assign(&mut self, rhs: &Gf256)

Performs the /= operation.

impl DivAssign for Gf256

fn div_assign(&mut self, rhs: Self)

Performs the /= operation.

impl Field for Gf256

const ZERO: Self = _

The zero element of the field, the additive identity.

const ONE: Self = _

The one element of the field, the multiplicative identity.

fn random(rng: impl RngCore) -> Self

Returns an element chosen uniformly at random using a user-provided RNG.

fn square(&self) -> Self

Squares this element.

fn double(&self) -> Self

Doubles this element.

fn invert(&self) -> CtOption<Self>

Computes the multiplicative inverse of this element, failing if the element is zero.

fn sqrt_ratio(num: &Self, div: &Self) -> (Choice, Self)

Computes:

fn is_zero(&self) -> Choice

Returns true iff this element is zero.

fn is_zero_vartime(&self) -> bool

Returns true iff this element is zero.

fn cube(&self) -> Self

Cubes this element.

fn sqrt_alt(&self) -> (Choice, Self)

Equivalent to Self::sqrt_ratio(self, one()).

fn sqrt(&self) -> CtOption<Self>

Returns the square root of the field element, if it is quadratic residue.

fn pow<S>(&self, exp: S) -> Self

where S: AsRef<[u64]>,

Exponentiates self by exp, where exp is a little-endian order integer exponent.

fn pow_vartime<S>(&self, exp: S) -> Self

where S: AsRef<[u64]>,

Exponentiates self by exp, where exp is a little-endian order integer exponent.

impl From<Gf256> for u128

fn from(val: Gf256) -> u128

Converts to this type from the input type.

impl From<Gf256> for u16

fn from(val: Gf256) -> u16

Converts to this type from the input type.

impl From<Gf256> for u32

fn from(val: Gf256) -> u32

Converts to this type from the input type.

impl From<Gf256> for u64

fn from(val: Gf256) -> u64

Converts to this type from the input type.

impl From<Gf256> for u8

fn from(val: Gf256) -> u8

Converts to this type from the input type.

impl From<u128> for Gf256

fn from(val: u128) -> Self

Converts to this type from the input type.

impl From<u16> for Gf256

fn from(val: u16) -> Self

Converts to this type from the input type.

impl From<u32> for Gf256

fn from(val: u32) -> Self

Converts to this type from the input type.

impl From<u64> for Gf256

fn from(val: u64) -> Self

Converts to this type from the input type.

impl From<u8> for Gf256

fn from(val: u8) -> Self

Converts to this type from the input type.

impl Hash for Gf256

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl LowerHex for Gf256

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

Formats the value using the given formatter.

impl Mul<&Gf256> for &Gf256

type Output = Gf256

The resulting type after applying the * operator.

fn mul(self, rhs: &Gf256) -> Gf256

Performs the * operation.

impl Mul<&Gf256> for Gf256

type Output = Gf256

The resulting type after applying the * operator.

fn mul(self, rhs: &Gf256) -> Gf256

Performs the * operation.

impl Mul<Gf256> for &Gf256

type Output = Gf256

The resulting type after applying the * operator.

fn mul(self, rhs: Gf256) -> Gf256

Performs the * operation.

impl Mul for Gf256

type Output = Gf256

The resulting type after applying the * operator.

fn mul(self, rhs: Self) -> Self

Performs the * operation.

impl MulAssign<&Gf256> for Gf256

fn mul_assign(&mut self, rhs: &Gf256)

Performs the *= operation.

impl MulAssign for Gf256

fn mul_assign(&mut self, rhs: Self)

Performs the *= operation.

impl Neg for Gf256

type Output = Gf256

The resulting type after applying the - operator.

fn neg(self) -> Self

Performs the unary - operation.

impl Ord for Gf256

fn cmp(&self, other: &Gf256) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized + PartialOrd,

Restrict a value to a certain interval.

impl PartialEq for Gf256

fn eq(&self, other: &Gf256) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialOrd for Gf256

fn partial_cmp(&self, other: &Gf256) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, other: &Rhs) -> bool

This method tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

This method tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

This method tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

This method tests greater than or equal to (for self and other) and is used by the >= operator.

impl PrimeField for Gf256

type Repr = [u8; 1]

The prime field can be converted back and forth into this binary representation.

fn from_repr(repr: Self::Repr) -> CtOption<Self>

Attempts to convert a byte representation of a field element into an element of this prime field, failing if the input is not canonical (is not smaller than the field’s modulus).

fn to_repr(&self) -> Self::Repr

Converts an element of the prime field into the standard byte representation for this field.

fn is_odd(&self) -> Choice

Returns true iff this element is odd.

const MODULUS: &'static str = ""

Modulus of the field written as a string for debugging purposes.

const NUM_BITS: u32 = 8u32

How many bits are needed to represent an element of this field.

const CAPACITY: u32 = 7u32

How many bits of information can be reliably stored in the field element.

const TWO_INV: Self = _

Inverse of $2$ in the field.

const MULTIPLICATIVE_GENERATOR: Self = _

A fixed multiplicative generator of modulus - 1 order. This element must also be a quadratic nonresidue.

const S: u32 = 3u32

An integer s satisfying the equation 2^s * t = modulus - 1 with t odd.

const ROOT_OF_UNITY: Self = _

The 2^s root of unity.

const ROOT_OF_UNITY_INV: Self = _

Inverse of Self::ROOT_OF_UNITY.

const DELTA: Self = _

Generator of the t-order multiplicative subgroup.

fn from_str_vartime(s: &str) -> Option<Self>

Interpret a string of numbers as a (congruent) prime field element. Does not accept unnecessary leading zeroes or a blank string.

fn from_u128(v: u128) -> Self

Obtains a field element congruent to the integer v.

fn from_repr_vartime(repr: Self::Repr) -> Option<Self>

Attempts to convert a byte representation of a field element into an element of this prime field, failing if the input is not canonical (is not smaller than the field’s modulus).

fn is_even(&self) -> Choice

Returns true iff this element is even.

impl<T: Borrow<Gf256>> Product<T> for Gf256

fn product<I: Iterator<Item = T>>(iter: I) -> Self

Method which takes an iterator and generates Self from the elements by multiplying the items.

impl Sub<&Gf256> for &Gf256

type Output = Gf256

The resulting type after applying the - operator.

fn sub(self, rhs: &Gf256) -> Gf256

Performs the - operation.

impl Sub<&Gf256> for Gf256

type Output = Gf256

The resulting type after applying the - operator.

fn sub(self, rhs: &Gf256) -> Gf256

Performs the - operation.

impl Sub<Gf256> for &Gf256

type Output = Gf256

The resulting type after applying the - operator.

fn sub(self, rhs: Gf256) -> Gf256

Performs the - operation.

impl Sub for Gf256

type Output = Gf256

The resulting type after applying the - operator.

fn sub(self, rhs: Self) -> Self

Performs the - operation.

impl SubAssign<&Gf256> for Gf256

fn sub_assign(&mut self, rhs: &Gf256)

Performs the -= operation.

impl SubAssign for Gf256

fn sub_assign(&mut self, rhs: Self)

Performs the -= operation.

impl<T: Borrow<Gf256>> Sum<T> for Gf256

fn sum<I: Iterator<Item = T>>(iter: I) -> Self

Method which takes an iterator and generates Self from the elements by “summing up” the items.

impl UpperHex for Gf256

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

Formats the value using the given formatter.

impl Copy for Gf256

impl Eq for Gf256

impl StructuralPartialEq for Gf256