Struct ProjectivePoint

pub struct ProjectivePoint<C: PrimeCurveParams> { /* private fields */ }

Point on a Weierstrass curve in projective coordinates.

Implementations

impl<C> ProjectivePoint<C>

where C: PrimeCurveParams,

pub const IDENTITY: Self = _

Additive identity of the group a.k.a. the point at infinity.

pub const GENERATOR: Self = _

Base point of the curve.

pub fn to_affine(&self) -> AffinePoint<C>

Returns the affine representation of this point, or None if it is the identity.

pub fn neg(&self) -> Self

Returns -self.

pub fn add(&self, other: &Self) -> Self

Returns self + other.

pub fn sub(&self, other: &Self) -> Self

Returns self - other.

Trait Implementations

impl<C> Add<&AffinePoint<C>> for &ProjectivePoint<C>

where C: PrimeCurveParams,

type Output = ProjectivePoint<C>

The resulting type after applying the + operator.

fn add(self, other: &AffinePoint<C>) -> ProjectivePoint<C>

Performs the + operation.

impl<C> Add<&AffinePoint<C>> for ProjectivePoint<C>

where C: PrimeCurveParams,

type Output = ProjectivePoint<C>

The resulting type after applying the + operator.

fn add(self, other: &AffinePoint<C>) -> ProjectivePoint<C>

Performs the + operation.

impl<C> Add<&ProjectivePoint<C>> for &ProjectivePoint<C>

where C: PrimeCurveParams,

type Output = ProjectivePoint<C>

The resulting type after applying the + operator.

fn add(self, other: &ProjectivePoint<C>) -> ProjectivePoint<C>

Performs the + operation.

impl<C> Add<&ProjectivePoint<C>> for ProjectivePoint<C>

where C: PrimeCurveParams,

type Output = ProjectivePoint<C>

The resulting type after applying the + operator.

fn add(self, other: &ProjectivePoint<C>) -> ProjectivePoint<C>

Performs the + operation.

impl<C> Add<AffinePoint<C>> for ProjectivePoint<C>

where C: PrimeCurveParams,

type Output = ProjectivePoint<C>

The resulting type after applying the + operator.

fn add(self, other: AffinePoint<C>) -> ProjectivePoint<C>

Performs the + operation.

impl<C> Add for ProjectivePoint<C>

where C: PrimeCurveParams,

type Output = ProjectivePoint<C>

The resulting type after applying the + operator.

fn add(self, other: ProjectivePoint<C>) -> ProjectivePoint<C>

Performs the + operation.

impl<C> AddAssign<&AffinePoint<C>> for ProjectivePoint<C>

where C: PrimeCurveParams,

fn add_assign(&mut self, rhs: &AffinePoint<C>)

Performs the += operation.

impl<C> AddAssign<&ProjectivePoint<C>> for ProjectivePoint<C>

where C: PrimeCurveParams,

fn add_assign(&mut self, rhs: &ProjectivePoint<C>)

Performs the += operation.

impl<C> AddAssign<AffinePoint<C>> for ProjectivePoint<C>

where C: PrimeCurveParams,

fn add_assign(&mut self, rhs: AffinePoint<C>)

Performs the += operation.

impl<C> AddAssign for ProjectivePoint<C>

where C: PrimeCurveParams,

fn add_assign(&mut self, rhs: ProjectivePoint<C>)

Performs the += operation.

impl<const N: usize, C> BatchNormalize<[ProjectivePoint<C>; N]> for ProjectivePoint<C>

where Self: Double, C: PrimeCurveParams, C::FieldElement: Invert<Output = CtOption<C::FieldElement>>,

type Output = [<ProjectivePoint<C> as Curve>::AffineRepr; N]

The output of the batch normalization; a container of affine points.

fn batch_normalize(points: &[Self; N]) -> [Self::AffineRepr; N]

Perform a batched conversion to affine representation on a sequence of projective points at an amortized cost that should be practically as efficient as a single conversion. Internally, implementors should rely upon InvertBatch.

impl<C: Clone + PrimeCurveParams> Clone for ProjectivePoint<C>

where C::FieldElement: Clone,

fn clone(&self) -> ProjectivePoint<C>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<C> CofactorGroup for ProjectivePoint<C>

where Self: Double, C: PrimeCurveParams, FieldBytes<C>: Copy, FieldBytesSize<C>: ModulusSize, CompressedPoint<C>: Copy, <UncompressedPointSize<C> as ArrayLength<u8>>::ArrayType: Copy,

type Subgroup = ProjectivePoint<C>

The large prime-order subgroup in which cryptographic operations are performed. If Self implements PrimeGroup, then Self::Subgroup may be Self.

fn clear_cofactor(&self) -> Self::Subgroup

Maps self to the prime-order subgroup by multiplying this element by some k-multiple of the cofactor.

fn into_subgroup(self) -> CtOption<Self>

Returns self if it is contained in the prime-order subgroup.

fn is_torsion_free(&self) -> Choice

Determines if this element is “torsion free”, i.e., is contained in the prime-order subgroup.

fn is_small_order(&self) -> Choice

Determines if this element is of small order.

impl<C> ConditionallySelectable for ProjectivePoint<C>

where C: PrimeCurveParams,

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<C> ConstantTimeEq for ProjectivePoint<C>

where C: PrimeCurveParams,

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<C> Curve for ProjectivePoint<C>

where Self: Double, C: PrimeCurveParams,

type AffineRepr = AffinePoint<C>

The affine representation for this elliptic curve.

fn to_affine(&self) -> AffinePoint<C>

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<C: Debug + PrimeCurveParams> Debug for ProjectivePoint<C>

where C::FieldElement: Debug,

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

Formats the value using the given formatter.

impl<C> Default for ProjectivePoint<C>

where C: PrimeCurveParams,

fn default() -> Self

Returns the “default value” for a type.

impl<C: PrimeCurveParams> Double for ProjectivePoint<C>

fn double(&self) -> Self

Double this point.

impl<C> From<&AffinePoint<C>> for ProjectivePoint<C>

where C: PrimeCurveParams,

fn from(p: &AffinePoint<C>) -> Self

Converts to this type from the input type.

impl<C> From<&ProjectivePoint<C>> for AffinePoint<C>

where C: PrimeCurveParams,

fn from(p: &ProjectivePoint<C>) -> AffinePoint<C>

Converts to this type from the input type.

impl<C> From<&PublicKey<C>> for ProjectivePoint<C>

where C: PrimeCurveParams,

fn from(public_key: &PublicKey<C>) -> ProjectivePoint<C>

Converts to this type from the input type.

impl<C> From<AffinePoint<C>> for ProjectivePoint<C>

where C: PrimeCurveParams,

fn from(p: AffinePoint<C>) -> Self

Converts to this type from the input type.

impl<C> From<ProjectivePoint<C>> for AffinePoint<C>

where C: PrimeCurveParams,

fn from(p: ProjectivePoint<C>) -> AffinePoint<C>

Converts to this type from the input type.

impl<C> From<PublicKey<C>> for ProjectivePoint<C>

where C: PrimeCurveParams,

fn from(public_key: PublicKey<C>) -> ProjectivePoint<C>

Converts to this type from the input type.

impl<C> FromEncodedPoint<C> for ProjectivePoint<C>

where C: PrimeCurveParams, FieldBytes<C>: Copy, FieldBytesSize<C>: ModulusSize, CompressedPoint<C>: Copy,

fn from_encoded_point(p: &EncodedPoint<C>) -> CtOption<Self>

Deserialize the type this trait is impl’d on from an EncodedPoint.

impl<C> Group for ProjectivePoint<C>

where Self: Double, C: PrimeCurveParams,

type Scalar = <C as CurveArithmetic>::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<C> GroupEncoding for ProjectivePoint<C>

where C: PrimeCurveParams, FieldBytes<C>: Copy, FieldBytesSize<C>: ModulusSize, CompressedPoint<C>: Copy, <UncompressedPointSize<C> as ArrayLength<u8>>::ArrayType: Copy,

type Repr = GenericArray<u8, <<C as Curve>::FieldBytesSize as ModulusSize>::CompressedPointSize>

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> LinearCombination for ProjectivePoint<C>

where Self: Double, C: PrimeCurveParams,

fn lincomb(x: &Self, k: &Self::Scalar, y: &Self, l: &Self::Scalar) -> Self

Calculates x * k + y * l.

impl<C> Mul<&<C as CurveArithmetic>::Scalar> for &ProjectivePoint<C>

where C: PrimeCurveParams, ProjectivePoint<C>: Double,

type Output = ProjectivePoint<C>

The resulting type after applying the * operator.

fn mul(self, scalar: &Scalar<C>) -> ProjectivePoint<C>

Performs the * operation.

impl<C, S> Mul<S> for ProjectivePoint<C>

where Self: Double, C: PrimeCurveParams, S: Borrow<Scalar<C>>,

type Output = ProjectivePoint<C>

The resulting type after applying the * operator.

fn mul(self, scalar: S) -> Self

Performs the * operation.

impl<C, S> MulAssign<S> for ProjectivePoint<C>

where Self: Double, C: PrimeCurveParams, S: Borrow<Scalar<C>>,

fn mul_assign(&mut self, scalar: S)

Performs the *= operation.

impl<C> MulByGenerator for ProjectivePoint<C>

where Self: Double, C: PrimeCurveParams,

fn mul_by_generator(scalar: &Self::Scalar) -> Self

Multiply by the generator of the prime-order subgroup.

impl<'a, C> Neg for &'a ProjectivePoint<C>

where C: PrimeCurveParams,

type Output = ProjectivePoint<C>

The resulting type after applying the - operator.

fn neg(self) -> ProjectivePoint<C>

Performs the unary - operation.

impl<C> Neg for ProjectivePoint<C>

where C: PrimeCurveParams,

type Output = ProjectivePoint<C>

The resulting type after applying the - operator.

fn neg(self) -> ProjectivePoint<C>

Performs the unary - operation.

impl<C> PartialEq for ProjectivePoint<C>

where C: PrimeCurveParams,

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<C> PrimeCurve for ProjectivePoint<C>

where Self: Double, C: PrimeCurveParams, FieldBytes<C>: Copy, FieldBytesSize<C>: ModulusSize, CompressedPoint<C>: Copy, <UncompressedPointSize<C> as ArrayLength<u8>>::ArrayType: Copy,

type Affine = AffinePoint<C>

impl<C> Sub<&AffinePoint<C>> for &ProjectivePoint<C>

where C: PrimeCurveParams,

type Output = ProjectivePoint<C>

The resulting type after applying the - operator.

fn sub(self, other: &AffinePoint<C>) -> ProjectivePoint<C>

Performs the - operation.

impl<C> Sub<&AffinePoint<C>> for ProjectivePoint<C>

where C: PrimeCurveParams,

type Output = ProjectivePoint<C>

The resulting type after applying the - operator.

fn sub(self, other: &AffinePoint<C>) -> ProjectivePoint<C>

Performs the - operation.

impl<C> Sub<&ProjectivePoint<C>> for &ProjectivePoint<C>

where C: PrimeCurveParams,

type Output = ProjectivePoint<C>

The resulting type after applying the - operator.

fn sub(self, other: &ProjectivePoint<C>) -> ProjectivePoint<C>

Performs the - operation.

impl<C> Sub<&ProjectivePoint<C>> for ProjectivePoint<C>

where C: PrimeCurveParams,

type Output = ProjectivePoint<C>

The resulting type after applying the - operator.

fn sub(self, other: &ProjectivePoint<C>) -> ProjectivePoint<C>

Performs the - operation.

impl<C> Sub<AffinePoint<C>> for ProjectivePoint<C>

where C: PrimeCurveParams,

type Output = ProjectivePoint<C>

The resulting type after applying the - operator.

fn sub(self, other: AffinePoint<C>) -> ProjectivePoint<C>

Performs the - operation.

impl<C> Sub for ProjectivePoint<C>

where C: PrimeCurveParams,

type Output = ProjectivePoint<C>

The resulting type after applying the - operator.

fn sub(self, other: ProjectivePoint<C>) -> ProjectivePoint<C>

Performs the - operation.

impl<C> SubAssign<&AffinePoint<C>> for ProjectivePoint<C>

where C: PrimeCurveParams,

fn sub_assign(&mut self, rhs: &AffinePoint<C>)

Performs the -= operation.

impl<C> SubAssign<&ProjectivePoint<C>> for ProjectivePoint<C>

where C: PrimeCurveParams,

fn sub_assign(&mut self, rhs: &ProjectivePoint<C>)

Performs the -= operation.

impl<C> SubAssign<AffinePoint<C>> for ProjectivePoint<C>

where C: PrimeCurveParams,

fn sub_assign(&mut self, rhs: AffinePoint<C>)

Performs the -= operation.

impl<C> SubAssign for ProjectivePoint<C>

where C: PrimeCurveParams,

fn sub_assign(&mut self, rhs: ProjectivePoint<C>)

Performs the -= operation.

impl<'a, C> Sum<&'a ProjectivePoint<C>> for ProjectivePoint<C>

where C: PrimeCurveParams,

fn sum<I: Iterator<Item = &'a ProjectivePoint<C>>>(iter: I) -> Self

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

impl<C> Sum for ProjectivePoint<C>

where C: PrimeCurveParams,

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

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

impl<C> ToEncodedPoint<C> for ProjectivePoint<C>

where C: PrimeCurveParams, FieldBytesSize<C>: ModulusSize, CompressedPoint<C>: Copy, <UncompressedPointSize<C> as ArrayLength<u8>>::ArrayType: Copy,

fn to_encoded_point(&self, compress: bool) -> EncodedPoint<C>

Serialize this value as a SEC1 EncodedPoint, optionally applying point compression.

impl<C> TryFrom<&ProjectivePoint<C>> for PublicKey<C>

where C: PrimeCurveParams,

type Error = Error

The type returned in the event of a conversion error.

fn try_from(point: &ProjectivePoint<C>) -> Result<PublicKey<C>>

Performs the conversion.

impl<C> TryFrom<ProjectivePoint<C>> for PublicKey<C>

where C: PrimeCurveParams,

type Error = Error

The type returned in the event of a conversion error.

fn try_from(point: ProjectivePoint<C>) -> Result<PublicKey<C>>

Performs the conversion.

impl<C: Copy + PrimeCurveParams> Copy for ProjectivePoint<C>

where C::FieldElement: Copy,

impl<C> DefaultIsZeroes for ProjectivePoint<C>

where C: PrimeCurveParams,

impl<C> Eq for ProjectivePoint<C>

where C: PrimeCurveParams,

impl<C> PrimeGroup for ProjectivePoint<C>

where Self: Double, C: PrimeCurveParams, FieldBytes<C>: Copy, FieldBytesSize<C>: ModulusSize, CompressedPoint<C>: Copy, <UncompressedPointSize<C> as ArrayLength<u8>>::ArrayType: Copy,