Struct NonIdentity

pub struct NonIdentity<P> { /* private fields */ }

Non-identity point type.

This type ensures that its value is not the identity point, ala core::num::NonZero*.

In the context of ECC, it’s useful for ensuring that certain arithmetic cannot result in the identity point.

Implementations

impl<P> NonIdentity<P>

where P: ConditionallySelectable + ConstantTimeEq + Default,

pub fn new(point: P) -> CtOption<Self>

Create a NonIdentity from a point.

impl<P> NonIdentity<P>

where P: ConditionallySelectable + ConstantTimeEq + Default + GroupEncoding,

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

Decode a NonIdentity from its encoding.

impl<P: Copy> NonIdentity<P>

pub fn to_point(self) -> P

Return wrapped point.

impl<P> NonIdentity<P>

where P: ConditionallySelectable + ConstantTimeEq + Curve + Default,

pub fn random(rng: impl CryptoRng + RngCore) -> Self

Generate a random NonIdentity<ProjectivePoint>.

pub fn to_affine(self) -> NonIdentity<P::AffineRepr>

Converts this element into its affine representation.

impl<P> NonIdentity<P>

where P: PrimeCurveAffine,

pub fn to_curve(self) -> NonIdentity<P::Curve>

Converts this element to its curve representation.

Trait Implementations

impl<P> AsRef<P> for NonIdentity<P>

fn as_ref(&self) -> &P

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

impl<P: Clone> Clone for NonIdentity<P>

fn clone(&self) -> NonIdentity<P>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<P> ConditionallySelectable for NonIdentity<P>

where P: ConditionallySelectable,

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<P> ConstantTimeEq for NonIdentity<P>

where P: ConstantTimeEq,

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

Determine if two items are equal.

impl<P> Deref for NonIdentity<P>

type Target = P

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.

impl<C, P> From<&NonIdentity<P>> for PublicKey<C>

where C: CurveArithmetic, P: Copy + Into<AffinePoint<C>>,

fn from(value: &NonIdentity<P>) -> Self

Converts to this type from the input type.

impl<C> From<&PublicKey<C>> for NonIdentity<AffinePoint<C>>

where C: CurveArithmetic,

fn from(value: &PublicKey<C>) -> Self

Converts to this type from the input type.

impl<C, P> From<NonIdentity<P>> for PublicKey<C>

where C: CurveArithmetic, P: Copy + Into<AffinePoint<C>>,

fn from(value: NonIdentity<P>) -> Self

Converts to this type from the input type.

impl<C> From<PublicKey<C>> for NonIdentity<AffinePoint<C>>

where C: CurveArithmetic,

fn from(value: PublicKey<C>) -> Self

Converts to this type from the input type.

impl<P> GroupEncoding for NonIdentity<P>

where P: ConditionallySelectable + ConstantTimeEq + Default + GroupEncoding,

type Repr = <P as GroupEncoding>::Repr

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<C, P> Mul<&NonZeroScalar<C>> for &NonIdentity<P>

where C: CurveArithmetic, P: Copy + Mul<Scalar<C>, Output = P>,

type Output = NonIdentity<P>

The resulting type after applying the * operator.

fn mul(self, rhs: &NonZeroScalar<C>) -> Self::Output

Performs the * operation.

impl<C, P> Mul<NonZeroScalar<C>> for NonIdentity<P>

where C: CurveArithmetic, P: Copy + Mul<Scalar<C>, Output = P>,

type Output = NonIdentity<P>

The resulting type after applying the * operator.

fn mul(self, rhs: NonZeroScalar<C>) -> Self::Output

Performs the * operation.

impl<P: Copy> Copy for NonIdentity<P>