Struct G1Projective 

pub struct G1Projective(/* private fields */);

This is an element of $\mathbb{G}_1$ represented in the projective coordinate space.

Implementations

impl G1Projective

pub fn to_compressed(&self) -> [u8; 48]

Serializes this element into compressed form.

pub fn to_uncompressed(&self) -> [u8; 96]

Serializes this element into uncompressed form.

pub fn from_uncompressed(bytes: &[u8; 96]) -> CtOption<Self>

Attempts to deserialize an uncompressed element.

pub fn from_uncompressed_unchecked(bytes: &[u8; 96]) -> CtOption<Self>

Attempts to deserialize an uncompressed element, not checking if the element is on the curve and not checking if it is in the correct subgroup.

This is dangerous to call unless you trust the bytes you are reading; otherwise, API invariants may be broken. Please consider using from_uncompressed() instead.

pub fn from_compressed(bytes: &[u8; 48]) -> CtOption<Self>

Attempts to deserialize a compressed element.

pub fn from_compressed_unchecked(bytes: &[u8; 48]) -> CtOption<Self>

Attempts to deserialize an uncompressed element, not checking if the element is in the correct subgroup.

This is dangerous to call unless you trust the bytes you are reading; otherwise, API invariants may be broken. Please consider using from_compressed() instead.

pub fn is_on_curve(&self) -> Choice

Returns true if this point is on the curve. This should always return true unless an “unchecked” API was used.

pub fn from_raw_unchecked(x: Fp, y: Fp, z: Fp) -> Self

pub fn x(&self) -> Fp

Returns the x coordinate.

pub fn y(&self) -> Fp

Returns the y coordinate.

pub fn z(&self) -> Fp

Returns the z coordinate.

pub fn hash_to_curve(msg: &[u8], dst: &[u8], aug: &[u8]) -> Self

Hash to curve algorithm.

pub fn multi_exp(points: &[Self], scalars: &[Scalar]) -> Self

Perform a multi-exponentiation, aka “multi-scalar-multiplication” (MSM) using blst’s implementation of Pippenger’s algorithm. Note: scalars is cloned in this method.

Trait Implementations

impl Add<&G1Affine> for &G1Projective

type Output = G1Projective

The resulting type after applying the + operator.

fn add(self, rhs: &G1Affine) -> G1Projective

Performs the + operation.

impl Add<&G1Affine> for G1Projective

type Output = G1Projective

The resulting type after applying the + operator.

fn add(self, rhs: &G1Affine) -> G1Projective

Performs the + operation.

impl Add<&G1Projective> for &G1Affine

type Output = G1Projective

The resulting type after applying the + operator.

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

Performs the + operation.

impl Add<&G1Projective> for &G1Projective

type Output = G1Projective

The resulting type after applying the + operator.

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

Performs the + operation.

impl Add<&G1Projective> for G1Affine

type Output = G1Projective

The resulting type after applying the + operator.

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

Performs the + operation.

impl Add<&G1Projective> for G1Projective

type Output = G1Projective

The resulting type after applying the + operator.

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

Performs the + operation.

impl Add<G1Affine> for &G1Projective

type Output = G1Projective

The resulting type after applying the + operator.

fn add(self, rhs: G1Affine) -> G1Projective

Performs the + operation.

impl Add<G1Affine> for G1Projective

type Output = G1Projective

The resulting type after applying the + operator.

fn add(self, rhs: G1Affine) -> G1Projective

Performs the + operation.

impl Add<G1Projective> for &G1Affine

type Output = G1Projective

The resulting type after applying the + operator.

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

Performs the + operation.

impl Add<G1Projective> for &G1Projective

type Output = G1Projective

The resulting type after applying the + operator.

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

Performs the + operation.

impl Add<G1Projective> for G1Affine

type Output = G1Projective

The resulting type after applying the + operator.

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

Performs the + operation.

impl Add for G1Projective

type Output = G1Projective

The resulting type after applying the + operator.

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

Performs the + operation.

impl AddAssign<&G1Affine> for G1Projective

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

Performs the += operation.

impl AddAssign<&G1Projective> for G1Projective

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

Performs the += operation.

impl AddAssign<G1Affine> for G1Projective

fn add_assign(&mut self, rhs: G1Affine)

Performs the += operation.

impl AddAssign for G1Projective

fn add_assign(&mut self, rhs: G1Projective)

Performs the += operation.

impl AsMut<blst_p1> for G1Projective

fn as_mut(&mut self) -> &mut blst_p1

Converts this type into a mutable reference of the (usually inferred) input type.

impl AsRef<blst_p1> for G1Projective

fn as_ref(&self) -> &blst_p1

Converts this type into a shared reference of the (usually inferred) input type.

impl Clone for G1Projective

fn clone(&self) -> G1Projective

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl ConditionallySelectable for G1Projective

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 Curve for G1Projective

type AffineRepr = G1Affine

The affine representation for this elliptic curve.

fn to_affine(&self) -> Self::AffineRepr

Converts this element into its affine representation.

fn batch_normalize(p: &[Self], q: &mut [Self::AffineRepr])

Converts a batch of projective elements into affine elements. This function will panic if p.len() != q.len().

impl Debug for G1Projective

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for G1Projective

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

Deserialize this value from the given Serde deserializer.

impl Display for G1Projective

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

Formats the value using the given formatter.

impl From<&G1Affine> for G1Projective

fn from(p: &G1Affine) -> G1Projective

Converts to this type from the input type.

impl From<&G1Projective> for G1Affine

fn from(p: &G1Projective) -> G1Affine

Converts to this type from the input type.

impl From<G1Affine> for G1Projective

fn from(p: G1Affine) -> G1Projective

Converts to this type from the input type.

impl From<G1Projective> for G1Affine

fn from(p: G1Projective) -> G1Affine

Converts to this type from the input type.

impl Group for G1Projective

type Scalar = Scalar

Scalars modulo the order of this group’s scalar field.

fn random(rng: impl RngCore) -> Self

Returns an element chosen uniformly at random from the non-identity elements of this group.

fn identity() -> Self

Returns the additive identity, also known as the “neutral element”.

fn generator() -> Self

Returns a fixed generator of the prime-order subgroup.

fn is_identity(&self) -> Choice

Determines if this point is the identity.

fn double(&self) -> Self

Doubles this element.

impl GroupEncoding for G1Projective

type Repr = G1Compressed

The encoding of group elements.

fn from_bytes(bytes: &Self::Repr) -> CtOption<Self>

Attempts to deserialize a group element from its encoding.

fn from_bytes_unchecked(bytes: &Self::Repr) -> CtOption<Self>

Attempts to deserialize a group element, not checking if the element is valid.

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

Converts this element into its byte encoding. This may or may not support encoding the identity.

impl Mul<&Scalar> for &G1Projective

type Output = G1Projective

The resulting type after applying the * operator.

fn mul(self, scalar: &Scalar) -> Self::Output

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 &G1Projective

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 MulAssign<&Scalar> for G1Projective

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 Neg for &G1Projective

type Output = G1Projective

The resulting type after applying the - operator.

fn neg(self) -> G1Projective

Performs the unary - operation.

impl Neg for G1Projective

type Output = G1Projective

The resulting type after applying the - operator.

fn neg(self) -> G1Projective

Performs the unary - operation.

impl PartialEq for G1Projective

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

Tests for self and other values to be equal, and is used by ==.

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

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

impl PrimeCurve for G1Projective

type Affine = G1Affine

impl Serialize for G1Projective

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

Serialize this value into the given Serde serializer.

impl Sub<&G1Affine> for &G1Projective

type Output = G1Projective

The resulting type after applying the - operator.

fn sub(self, rhs: &G1Affine) -> G1Projective

Performs the - operation.

impl Sub<&G1Affine> for G1Projective

type Output = G1Projective

The resulting type after applying the - operator.

fn sub(self, rhs: &G1Affine) -> G1Projective

Performs the - operation.

impl Sub<&G1Projective> for &G1Affine

type Output = G1Projective

The resulting type after applying the - operator.

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

Performs the - operation.

impl Sub<&G1Projective> for &G1Projective

type Output = G1Projective

The resulting type after applying the - operator.

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

Performs the - operation.

impl Sub<&G1Projective> for G1Affine

type Output = G1Projective

The resulting type after applying the - operator.

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

Performs the - operation.

impl Sub<&G1Projective> for G1Projective

type Output = G1Projective

The resulting type after applying the - operator.

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

Performs the - operation.

impl Sub<G1Affine> for &G1Projective

type Output = G1Projective

The resulting type after applying the - operator.

fn sub(self, rhs: G1Affine) -> G1Projective

Performs the - operation.

impl Sub<G1Affine> for G1Projective

type Output = G1Projective

The resulting type after applying the - operator.

fn sub(self, rhs: G1Affine) -> G1Projective

Performs the - operation.

impl Sub<G1Projective> for &G1Affine

type Output = G1Projective

The resulting type after applying the - operator.

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

Performs the - operation.

impl Sub<G1Projective> for &G1Projective

type Output = G1Projective

The resulting type after applying the - operator.

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

Performs the - operation.

impl Sub<G1Projective> for G1Affine

type Output = G1Projective

The resulting type after applying the - operator.

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

Performs the - operation.

impl Sub for G1Projective

type Output = G1Projective

The resulting type after applying the - operator.

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

Performs the - operation.

impl SubAssign<&G1Affine> for G1Projective

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

Performs the -= operation.

impl SubAssign<&G1Projective> for G1Projective

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

Performs the -= operation.

impl SubAssign<G1Affine> for G1Projective

fn sub_assign(&mut self, rhs: G1Affine)

Performs the -= operation.

impl SubAssign for G1Projective

fn sub_assign(&mut self, rhs: G1Projective)

Performs the -= operation.

impl<T> Sum<T> for G1Projective

where T: Borrow<G1Projective>,

fn sum<I>(iter: I) -> Self

where I: Iterator<Item = T>,

Takes an iterator and generates Self from the elements by “summing up” the items.

impl WnafGroup for G1Projective

fn recommended_wnaf_for_num_scalars(num_scalars: usize) -> usize

Recommends a wNAF window size given the number of scalars you intend to multiply a base by. Always returns a number between 2 and 22, inclusive.

impl Copy for G1Projective

impl Eq for G1Projective

impl PrimeGroup for G1Projective