Struct blsttc::Fr

pub struct Fr(_);

Represents an element of the scalar field $\mathbb{F}_q$ of the BLS12-381 elliptic curve construction.

The inner representation blst_fr is stored in Montgomery form as little-endian u64 limbs.

Implementations

impl Scalar

pub fn from_bytes_le(bytes: &[u8; 32]) -> CtOption<Scalar>

Attempts to convert a little-endian byte representation of a scalar into a Scalar, failing if the input is not canonical.

pub fn from_bytes_be(be_bytes: &[u8; 32]) -> CtOption<Scalar>

Attempts to convert a big-endian byte representation of a scalar into a Scalar, failing if the input is not canonical.

pub fn to_bytes_le(&self) -> [u8; 32]

Converts an element of Scalar into a byte representation in little-endian byte order.

pub fn to_bytes_be(&self) -> [u8; 32]

Converts an element of Scalar into a byte representation in big-endian byte order.

pub fn from_u64s_le(bytes: &[u64; 4]) -> CtOption<Scalar>

pub fn is_quad_res(&self) -> Choice

pub fn legendre(&self) -> i8

pub fn char() -> <Scalar as PrimeField>::Repr

pub fn num_bits(&self) -> u32

pub fn mul3(&self) -> Scalar

Multiplies self with 3, returning the result.

pub fn shl(&self, count: usize) -> Scalar

Left shift self by count, returning the result.

pub fn shr(&self, count: usize) -> Scalar

Right shift self by count, returning the result.

pub fn square_assign(&mut self)

Calculates the square of this element.

Trait Implementations

impl Add<&Scalar> for &Scalar

type Output = Scalar

The resulting type after applying the + operator.

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

Performs the + operation.

impl Add<&Scalar> for Scalar

type Output = Scalar

The resulting type after applying the + operator.

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

Performs the + operation.

impl Add<Scalar> for &Scalar

type Output = Scalar

The resulting type after applying the + operator.

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

Performs the + operation.

impl Add<Scalar> for Poly

type Output = Poly

The resulting type after applying the + operator.

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

Performs the + operation.

impl Add<Scalar> for Scalar

type Output = Scalar

The resulting type after applying the + operator.

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

Performs the + operation.

impl AddAssign<&Scalar> for Scalar

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

Performs the += operation.

impl AddAssign<Scalar> for Scalar

fn add_assign(&mut self, rhs: Scalar)

Performs the += operation.

impl Clone for Scalar

fn clone(&self) -> Scalar

Returns a copy of the value.

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

Performs copy-assignment from source.

impl ConditionallySelectable for Scalar

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

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 Scalar

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

Determine if two items are equal.

impl Debug for Scalar

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

Formats the value using the given formatter.

impl Default for Scalar

fn default() -> Scalar

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Scalar

fn deserialize<D>(d: D) -> Result<Scalar, <D as Deserializer<'de>>::Error>where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for Scalar

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

Formats the value using the given formatter.

impl Field for Scalar

fn random(rng: impl RngCore) -> Scalar

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

fn zero() -> Scalar

Returns the zero element of the field, the additive identity.

fn one() -> Scalar

Returns the one element of the field, the multiplicative identity.

fn is_zero(&self) -> Choice

Returns true iff this element is zero.

fn square(&self) -> Scalar

Squares this element.

fn double(&self) -> Scalar

Doubles this element.

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

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

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

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

fn is_zero_vartime(&self) -> bool

Returns true iff this element is zero.

fn cube(&self) -> Self

Cubes this element.

fn pow_vartime<S>(&self, exp: S) -> Selfwhere S: AsRef<[u64]>,

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

impl From<SecretKey> for Scalar

Utility to convert blsttc to blst types

fn from(item: SecretKey) -> Self

Converts to this type from the input type.

impl From<blst_fr> for Scalar

fn from(val: blst_fr) -> Scalar

Converts to this type from the input type.

impl From<u64> for Scalar

fn from(val: u64) -> Scalar

Converts to this type from the input type.

impl Into<blst_scalar> for Scalar

fn into(self) -> blst_scalar

Converts this type into the (usually inferred) input type.

impl IntoFr for Fr

fn into_fr(self) -> Fr

Converts self to a field element.

impl<'a> Mul<&'a Scalar> for &'a Poly

type Output = Poly

The resulting type after applying the * operator.

fn mul(self, rhs: &Fr) -> Self::Output

Performs the * operation.

impl<'a> Mul<&'a Scalar> for Poly

type Output = Poly

The resulting type after applying the * operator.

fn mul(self, rhs: &Fr) -> Self::Output

Performs the * operation.

impl Mul<&Scalar> for &G1Affine

type Output = G1Projective

The resulting type after applying the * operator.

fn mul(self, scalar: &Scalar) -> <&G1Affine as Mul<&Scalar>>::Output

Performs the * operation.

impl Mul<&Scalar> for &G1Projective

type Output = G1Projective

The resulting type after applying the * operator.

fn mul(self, scalar: &Scalar) -> <&G1Projective as Mul<&Scalar>>::Output

Performs the * operation.

impl Mul<&Scalar> for &G2Affine

type Output = G2Projective

The resulting type after applying the * operator.

fn mul(self, scalar: &Scalar) -> <&G2Affine as Mul<&Scalar>>::Output

Performs the * operation.

impl Mul<&Scalar> for &G2Projective

type Output = G2Projective

The resulting type after applying the * operator.

fn mul(self, scalar: &Scalar) -> <&G2Projective as Mul<&Scalar>>::Output

Performs the * operation.

impl Mul<&Scalar> for &Scalar

type Output = Scalar

The resulting type after applying the * operator.

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

Performs the * operation.

impl Mul<&Scalar> for G1Affine

type Output = G1Projective

The resulting type after applying the * operator.

fn mul(self, rhs: &Scalar) -> G1Projective

Performs the * operation.

impl Mul<&Scalar> for G1Projective

type Output = G1Projective

The resulting type after applying the * operator.

fn mul(self, rhs: &Scalar) -> G1Projective

Performs the * operation.

impl Mul<&Scalar> for G2Affine

type Output = G2Projective

The resulting type after applying the * operator.

fn mul(self, rhs: &Scalar) -> G2Projective

Performs the * operation.

impl Mul<&Scalar> for G2Projective

type Output = G2Projective

The resulting type after applying the * operator.

fn mul(self, rhs: &Scalar) -> G2Projective

Performs the * operation.

impl Mul<&Scalar> for Scalar

type Output = Scalar

The resulting type after applying the * operator.

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

Performs the * operation.

impl<'a> Mul<Scalar> for &'a Poly

type Output = Poly

The resulting type after applying the * operator.

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

Performs the * operation.

impl Mul<Scalar> for &G1Affine

type Output = G1Projective

The resulting type after applying the * operator.

fn mul(self, rhs: Scalar) -> G1Projective

Performs the * operation.

impl Mul<Scalar> for &G1Projective

type Output = G1Projective

The resulting type after applying the * operator.

fn mul(self, rhs: Scalar) -> G1Projective

Performs the * operation.

impl Mul<Scalar> for &G2Affine

type Output = G2Projective

The resulting type after applying the * operator.

fn mul(self, rhs: Scalar) -> G2Projective

Performs the * operation.

impl Mul<Scalar> for &G2Projective

type Output = G2Projective

The resulting type after applying the * operator.

fn mul(self, rhs: Scalar) -> G2Projective

Performs the * operation.

impl Mul<Scalar> for &Scalar

type Output = Scalar

The resulting type after applying the * operator.

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

Performs the * operation.

impl Mul<Scalar> for G1Affine

type Output = G1Projective

The resulting type after applying the * operator.

fn mul(self, rhs: Scalar) -> G1Projective

Performs the * operation.

impl Mul<Scalar> for G1Projective

type Output = G1Projective

The resulting type after applying the * operator.

fn mul(self, rhs: Scalar) -> G1Projective

Performs the * operation.

impl Mul<Scalar> for G2Affine

type Output = G2Projective

The resulting type after applying the * operator.

fn mul(self, rhs: Scalar) -> G2Projective

Performs the * operation.

impl Mul<Scalar> for G2Projective

type Output = G2Projective

The resulting type after applying the * operator.

fn mul(self, rhs: Scalar) -> G2Projective

Performs the * operation.

impl Mul<Scalar> for Poly

type Output = Poly

The resulting type after applying the * operator.

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

Performs the * operation.

impl Mul<Scalar> for Scalar

type Output = Scalar

The resulting type after applying the * operator.

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

Performs the * operation.

impl MulAssign<&Scalar> for G1Affine

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

Performs the *= operation.

impl MulAssign<&Scalar> for G1Projective

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

Performs the *= operation.

impl MulAssign<&Scalar> for G2Affine

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

Performs the *= operation.

impl MulAssign<&Scalar> for G2Projective

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

Performs the *= operation.

impl MulAssign<&Scalar> for Scalar

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

Performs the *= operation.

impl MulAssign<Scalar> for G1Affine

fn mul_assign(&mut self, rhs: Scalar)

Performs the *= operation.

impl MulAssign<Scalar> for G1Projective

fn mul_assign(&mut self, rhs: Scalar)

Performs the *= operation.

impl MulAssign<Scalar> for G2Affine

fn mul_assign(&mut self, rhs: Scalar)

Performs the *= operation.

impl MulAssign<Scalar> for G2Projective

fn mul_assign(&mut self, rhs: Scalar)

Performs the *= operation.

impl MulAssign<Scalar> for Poly

fn mul_assign(&mut self, rhs: Fr)

Performs the *= operation.

impl MulAssign<Scalar> for Scalar

fn mul_assign(&mut self, rhs: Scalar)

Performs the *= operation.

impl Neg for &Scalar

type Output = Scalar

The resulting type after applying the - operator.

fn neg(self) -> Scalar

Performs the unary - operation.

impl Neg for Scalar

type Output = Scalar

The resulting type after applying the - operator.

fn neg(self) -> Scalar

Performs the unary - operation.

impl Ord for Scalar

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

This method returns an Ordering between self and other.

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

Compares and returns the maximum of two values.

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

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Selfwhere Self: Sized + PartialOrd<Self>,

Restrict a value to a certain interval.

impl PartialEq<Scalar> for Scalar

fn eq(&self, other: &Scalar) -> 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 PartialEq<Scalar> for SecretKey

Utility to compare between blsttc and blst types

fn eq(&self, other: &Fr) -> 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<Scalar> for Scalar

fn partial_cmp(&self, other: &Scalar) -> 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 Scalar

fn from_repr(repr: <Scalar as PrimeField>::Repr) -> CtOption<Scalar>

Converts a little-endian non-Montgomery form repr into a Montgomery form Scalar.

fn to_repr(&self) -> <Scalar as PrimeField>::Repr

Converts a Montgomery form Scalar into little-endian non-Montgomery from.

type Repr = [u8; 32]

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

const NUM_BITS: u32 = 255u32

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

const CAPACITY: u32 = 254u32

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

const S: u32 = 32u32

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

fn from_repr_vartime(repr: <Scalar as PrimeField>::Repr) -> Option<Scalar>

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_odd(&self) -> Choice

Returns true iff this element is odd.

fn multiplicative_generator() -> Scalar

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

fn root_of_unity() -> Scalar

Returns the 2^s root of unity.

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 is_even(&self) -> Choice

Returns true iff this element is even.

impl PrimeFieldBits for Scalar

type ReprBits = [u64; 4]

The backing store for a bit representation of a prime field element.

fn to_le_bits(&self) -> BitArray<<Scalar as PrimeFieldBits>::ReprBits, Lsb0>

Converts an element of the prime field into a little-endian sequence of bits.

fn char_le_bits() -> BitArray<<Scalar as PrimeFieldBits>::ReprBits, Lsb0>

Returns the bits of the field characteristic (the modulus) in little-endian order.

impl<T> Product<T> for Scalarwhere T: Borrow<Scalar>,

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

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

impl Serialize for Scalar

fn serialize<S>( &self, s: S ) -> Result<<S as Serializer>::Ok, <S as Serializer>::Error>where S: Serializer,

Serialize this value into the given Serde serializer.

impl Sub<&Scalar> for &Scalar

type Output = Scalar

The resulting type after applying the - operator.

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

Performs the - operation.

impl Sub<&Scalar> for Scalar

type Output = Scalar

The resulting type after applying the - operator.

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

Performs the - operation.

impl Sub<Scalar> for &Scalar

type Output = Scalar

The resulting type after applying the - operator.

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

Performs the - operation.

impl Sub<Scalar> for Poly

type Output = Poly

The resulting type after applying the - operator.

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

Performs the - operation.

impl Sub<Scalar> for Scalar

type Output = Scalar

The resulting type after applying the - operator.

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

Performs the - operation.

impl SubAssign<&Scalar> for Scalar

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

Performs the -= operation.

impl SubAssign<Scalar> for Scalar

fn sub_assign(&mut self, rhs: Scalar)

Performs the -= operation.

impl<T> Sum<T> for Scalarwhere T: Borrow<Scalar>,

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

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

impl Copy for Scalar

impl Eq for Scalar