Struct primeorder::AffinePoint

pub struct AffinePoint<C: PrimeOrderCurve> { /* private fields */ }

Point on a Weierstrass curve in affine coordinates.

Implementations

impl<C> AffinePoint<C>where
    C: PrimeOrderCurve,

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

Is this point the point at infinity?

Trait Implementations

impl<C> Add<&AffinePoint<C>> for &ProjectivePoint<C>where
    C: PrimeOrderCurve,

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: PrimeOrderCurve,

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: PrimeOrderCurve,

type Output = ProjectivePoint<C>

The resulting type after applying the + operator.

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

Performs the + operation.

impl<C> AddAssign<&AffinePoint<C>> for ProjectivePoint<C>where
    C: PrimeOrderCurve,

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

Performs the += operation.

impl<C> AddAssign<AffinePoint<C>> for ProjectivePoint<C>where
    C: PrimeOrderCurve,

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

Performs the += operation.

impl<C> AffineXCoordinate<C> for AffinePoint<C>where
    C: PrimeOrderCurve,

fn x(&self) -> FieldBytes<C>

Get the affine x-coordinate as a serialized field element.

impl<C: Clone + PrimeOrderCurve> Clone for AffinePoint<C>where
    C::FieldElement: Clone,
    C::FieldElement: Clone,

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

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<C> ConditionallySelectable for AffinePoint<C>where
    C: PrimeOrderCurve,

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 AffinePoint<C>where
    C: PrimeOrderCurve,

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

Determine if two items are equal.

impl<C: Debug + PrimeOrderCurve> Debug for AffinePoint<C>where
    C::FieldElement: Debug,
    C::FieldElement: Debug,

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

Formats the value using the given formatter.

impl<C> DecompactPoint<C> for AffinePoint<C>where
    C: PrimeOrderCurve,
    FieldBytes<C>: Copy,

fn decompact(x_bytes: &FieldBytes<C>) -> CtOption<Self>

Attempt to decompact an elliptic curve point

impl<C> DecompressPoint<C> for AffinePoint<C>where
    C: PrimeOrderCurve,
    FieldBytes<C>: Copy,

fn decompress(x_bytes: &FieldBytes<C>, y_is_odd: Choice) -> CtOption<Self>

Attempt to decompress an elliptic curve point.

impl<C> Default for AffinePoint<C>where
    C: PrimeOrderCurve,

fn default() -> Self

Returns the “default value” for a type.

impl<'de, C> Deserialize<'de> for AffinePoint<C>where
    C: PrimeOrderCurve,
    FieldBytes<C>: Copy,
    FieldSize<C>: ModulusSize,
    CompressedPoint<C>: Copy,

Available on crate feature serde only.

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

Deserialize this value from the given Serde deserializer.

impl<C> From<&AffinePoint<C>> for ProjectivePoint<C>where
    C: PrimeOrderCurve,

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

Converts to this type from the input type.

impl<C> From<&ProjectivePoint<C>> for AffinePoint<C>where
    C: PrimeOrderCurve,

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

Converts to this type from the input type.

impl<C> From<&PublicKey<C>> for AffinePoint<C>where
    C: PrimeOrderCurve,

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

Converts to this type from the input type.

impl<C> From<AffinePoint<C>> for EncodedPoint<C>where
    C: PrimeOrderCurve,
    FieldSize<C>: ModulusSize,
    CompressedPoint<C>: Copy,
    <UncompressedPointSize<C> as ArrayLength<u8>>::ArrayType: Copy,

fn from(affine: AffinePoint<C>) -> EncodedPoint<C>

Converts to this type from the input type.

impl<C> From<AffinePoint<C>> for ProjectivePoint<C>where
    C: PrimeOrderCurve,

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

Converts to this type from the input type.

impl<C> From<ProjectivePoint<C>> for AffinePoint<C>where
    C: PrimeOrderCurve,

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

Converts to this type from the input type.

impl<C> From<PublicKey<C>> for AffinePoint<C>where
    C: PrimeOrderCurve,

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

Converts to this type from the input type.

impl<C> FromEncodedPoint<C> for AffinePoint<C>where
    C: PrimeOrderCurve,
    FieldBytes<C>: Copy,
    FieldSize<C>: ModulusSize,
    CompressedPoint<C>: Copy,

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

Attempts to parse the given EncodedPoint as an SEC1-encoded AffinePoint.

Returns

None value if encoded_point is not on the secp384r1 curve.

impl<C> GroupEncoding for AffinePoint<C>where
    C: PrimeOrderCurve,
    FieldBytes<C>: Copy,
    FieldSize<C>: ModulusSize,
    CompressedPoint<C>: Copy,
    <UncompressedPointSize<C> as ArrayLength<u8>>::ArrayType: Copy,

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

NOTE: not constant-time with respect to identity point

type Repr = GenericArray<u8, <<<C as Curve>::UInt as ArrayEncoding>::ByteSize as ModulusSize>::CompressedPointSize>

The encoding of group elements.

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, S> Mul<S> for AffinePoint<C>where
    C: PrimeOrderCurve,
    S: Borrow<Scalar<C>>,

type Output = ProjectivePoint<C>

The resulting type after applying the * operator.

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

Performs the * operation.

impl<C> Neg for &AffinePoint<C>where
    C: PrimeOrderCurve,

type Output = AffinePoint<C>

The resulting type after applying the - operator.

fn neg(self) -> AffinePoint<C>

Performs the unary - operation.

impl<C> Neg for AffinePoint<C>where
    C: PrimeOrderCurve,

type Output = AffinePoint<C>

The resulting type after applying the - operator.

fn neg(self) -> Self

Performs the unary - operation.

impl<C> PartialEq<AffinePoint<C>> for AffinePoint<C>where
    C: PrimeOrderCurve,

fn eq(&self, other: &Self) -> 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<C> PrimeCurveAffine for AffinePoint<C>where
    C: PrimeOrderCurve,
    FieldBytes<C>: Copy,
    FieldSize<C>: ModulusSize,
    CompressedPoint<C>: Copy,
    <UncompressedPointSize<C> as ArrayLength<u8>>::ArrayType: Copy,

type Curve = ProjectivePoint<C>

type Scalar = <C as ScalarArithmetic>::Scalar

fn identity() -> AffinePoint<C>

Returns the additive identity.

fn generator() -> AffinePoint<C>

Returns a fixed generator of unknown exponent.

fn is_identity(&self) -> Choice

Determines if this point represents the point at infinity; the additive identity.

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

Converts this element to its curve representation.

impl<C> Serialize for AffinePoint<C>where
    C: PrimeOrderCurve,
    FieldSize<C>: ModulusSize,
    CompressedPoint<C>: Copy,
    <UncompressedPointSize<C> as ArrayLength<u8>>::ArrayType: Copy,

Available on crate feature serde only.

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

Serialize this value into the given Serde serializer.

impl<C> Sub<&AffinePoint<C>> for &ProjectivePoint<C>where
    C: PrimeOrderCurve,

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: PrimeOrderCurve,

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: PrimeOrderCurve,

type Output = ProjectivePoint<C>

The resulting type after applying the - operator.

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

Performs the - operation.

impl<C> SubAssign<&AffinePoint<C>> for ProjectivePoint<C>where
    C: PrimeOrderCurve,

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

Performs the -= operation.

impl<C> SubAssign<AffinePoint<C>> for ProjectivePoint<C>where
    C: PrimeOrderCurve,

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

Performs the -= operation.

impl<C> ToCompactEncodedPoint<C> for AffinePoint<C>where
    C: PrimeOrderCurve,
    FieldSize<C>: ModulusSize,
    CompressedPoint<C>: Copy,
    <UncompressedPointSize<C> as ArrayLength<u8>>::ArrayType: Copy,

fn to_compact_encoded_point(&self) -> CtOption<EncodedPoint<C>>

Serialize this value as a SEC1 compact EncodedPoint

impl<C> ToEncodedPoint<C> for AffinePoint<C>where
    C: PrimeOrderCurve,
    FieldSize<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<&AffinePoint<C>> for PublicKey<C>where
    C: PrimeOrderCurve,

type Error = Error

The type returned in the event of a conversion error.

fn try_from(affine_point: &AffinePoint<C>) -> Result<PublicKey<C>>

Performs the conversion.

impl<C> TryFrom<&EncodedPoint<<<C as Curve>::UInt as ArrayEncoding>::ByteSize>> for AffinePoint<C>where
    C: PrimeOrderCurve,
    FieldBytes<C>: Copy,
    FieldSize<C>: ModulusSize,
    CompressedPoint<C>: Copy,

type Error = Error

The type returned in the event of a conversion error.

fn try_from(point: &EncodedPoint<C>) -> Result<AffinePoint<C>>

Performs the conversion.

impl<C> TryFrom<AffinePoint<C>> for PublicKey<C>where
    C: PrimeOrderCurve,

type Error = Error

The type returned in the event of a conversion error.

fn try_from(affine_point: AffinePoint<C>) -> Result<PublicKey<C>>

Performs the conversion.

impl<C> TryFrom<EncodedPoint<<<C as Curve>::UInt as ArrayEncoding>::ByteSize>> for AffinePoint<C>where
    C: PrimeOrderCurve,
    FieldBytes<C>: Copy,
    FieldSize<C>: ModulusSize,
    CompressedPoint<C>: Copy,

type Error = Error

The type returned in the event of a conversion error.

fn try_from(point: EncodedPoint<C>) -> Result<AffinePoint<C>>

Performs the conversion.

impl<C: Copy + PrimeOrderCurve> Copy for AffinePoint<C>where
    C::FieldElement: Copy,
    C::FieldElement: Copy,

impl<C> DefaultIsZeroes for AffinePoint<C>where
    C: PrimeOrderCurve,

impl<C> Eq for AffinePoint<C>where
    C: PrimeOrderCurve,