Struct p256::AffinePoint

pub struct AffinePoint { /* private fields */ }

NIST P-256 (secp256r1) curve point expressed in affine coordinates.

serde support

When the serde feature of this crate is enabled, the Serialize and Deserialize traits are impl’d for this type.

The serialization uses the SEC1 Elliptic-Curve-Point-to-Octet-String encoding, serialized as binary.

When serialized with a text-based format, the SEC1 representation is subsequently hex encoded.

Implementations

impl AffinePoint

pub const IDENTITY: Self = _

Additive identity of the group: the point at infinity.

pub const GENERATOR: Self = _

Base point of P-256.

Defined in FIPS 186-4 § D.1.2.3:

Gₓ = 6b17d1f2 e12c4247 f8bce6e5 63a440f2 77037d81 2deb33a0 f4a13945 d898c296
Gᵧ = 4fe342e2 fe1a7f9b 8ee7eb4a 7c0f9e16 2bce3357 6b315ece cbb64068 37bf51f5

Trait Implementations

impl Add<&AffinePoint> for &ProjectivePoint

type Output = ProjectivePoint

The resulting type after applying the + operator.

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

Performs the + operation.

impl Add<&AffinePoint> for ProjectivePoint

type Output = ProjectivePoint

The resulting type after applying the + operator.

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

Performs the + operation.

impl Add<AffinePoint> for ProjectivePoint

type Output = ProjectivePoint

The resulting type after applying the + operator.

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

Performs the + operation.

impl AddAssign<&AffinePoint> for ProjectivePoint

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

Performs the += operation.

impl AddAssign<AffinePoint> for ProjectivePoint

fn add_assign(&mut self, rhs: AffinePoint)

Performs the += operation.

impl AffineXCoordinate<NistP256> for AffinePoint

fn x(&self) -> FieldBytes

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

impl Clone for AffinePoint

fn clone(&self) -> AffinePoint

Returns a copy of the value.

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

Performs copy-assignment from source.

impl ConditionallySelectable for AffinePoint

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

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 AffinePoint

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

Determine if two items are equal.

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

Determine if two items are NOT equal.

impl Debug for AffinePoint

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

Formats the value using the given formatter.

impl DecompactPoint<NistP256> for AffinePoint

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

Attempt to decompact an elliptic curve point

impl DecompressPoint<NistP256> for AffinePoint

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

Attempt to decompress an elliptic curve point.

impl Default for AffinePoint

fn default() -> Self

Returns the “default value” for a type.

impl From<&AffinePoint> for ProjectivePoint

fn from(p: &AffinePoint) -> Self

Converts to this type from the input type.

impl From<&AffinePoint> for SharedSecret

fn from(affine: &AffinePoint) -> SharedSecret

Converts to this type from the input type.

impl From<&ProjectivePoint> for AffinePoint

fn from(p: &ProjectivePoint) -> AffinePoint

Converts to this type from the input type.

impl From<&PublicKey<NistP256>> for AffinePoint

fn from(public_key: &PublicKey) -> AffinePoint

Converts to this type from the input type.

impl From<AffinePoint> for EncodedPoint

fn from(affine_point: AffinePoint) -> EncodedPoint

Converts to this type from the input type.

impl From<AffinePoint> for ProjectivePoint

fn from(p: AffinePoint) -> Self

Converts to this type from the input type.

impl From<ProjectivePoint> for AffinePoint

fn from(p: ProjectivePoint) -> AffinePoint

Converts to this type from the input type.

impl From<PublicKey<NistP256>> for AffinePoint

fn from(public_key: PublicKey) -> AffinePoint

Converts to this type from the input type.

impl FromEncodedPoint<NistP256> for AffinePoint

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

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

Returns

None value if encoded_point is not on the secp256r1 curve.

impl GroupEncoding for AffinePoint

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

NOTE: not constant-time with respect to identity point

type Repr = GenericArray<u8, UInt<UInt<UInt<UInt<UInt<UInt<UTerm, B1>, B0>, B0>, B0>, B0>, B1>>

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 Mul<&Scalar> for AffinePoint

type Output = ProjectivePoint

The resulting type after applying the * operator.

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

Performs the * operation.

impl Mul<Scalar> for AffinePoint

type Output = ProjectivePoint

The resulting type after applying the * operator.

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

Performs the * operation.

impl Neg for AffinePoint

type Output = AffinePoint

The resulting type after applying the - operator.

fn neg(self) -> Self::Output

Performs the unary - operation.

impl PartialEq<AffinePoint> for AffinePoint

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

type Scalar = Scalar

type Curve = ProjectivePoint

fn identity() -> AffinePoint

Returns the additive identity.

fn generator() -> AffinePoint

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

Converts this element to its curve representation.

impl Sub<&AffinePoint> for &ProjectivePoint

type Output = ProjectivePoint

The resulting type after applying the - operator.

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

Performs the - operation.

impl Sub<&AffinePoint> for ProjectivePoint

type Output = ProjectivePoint

The resulting type after applying the - operator.

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

Performs the - operation.

impl Sub<AffinePoint> for ProjectivePoint

type Output = ProjectivePoint

The resulting type after applying the - operator.

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

Performs the - operation.

impl SubAssign<&AffinePoint> for ProjectivePoint

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

Performs the -= operation.

impl SubAssign<AffinePoint> for ProjectivePoint

fn sub_assign(&mut self, rhs: AffinePoint)

Performs the -= operation.

impl ToCompactEncodedPoint<NistP256> for AffinePoint

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

Serialize this value as a SEC1 compact EncodedPoint

impl ToEncodedPoint<NistP256> for AffinePoint

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

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

impl TryFrom<&AffinePoint> for PublicKey

type Error = Error

The type returned in the event of a conversion error.

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

Performs the conversion.

impl TryFrom<&EncodedPoint<<<NistP256 as Curve>::UInt as ArrayEncoding>::ByteSize>> for AffinePoint

type Error = Error

The type returned in the event of a conversion error.

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

Performs the conversion.

impl TryFrom<AffinePoint> for PublicKey

type Error = Error

The type returned in the event of a conversion error.

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

Performs the conversion.

impl TryFrom<EncodedPoint<<<NistP256 as Curve>::UInt as ArrayEncoding>::ByteSize>> for AffinePoint

type Error = Error

The type returned in the event of a conversion error.

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

Performs the conversion.

impl Copy for AffinePoint

impl DefaultIsZeroes for AffinePoint

impl Eq for AffinePoint