Struct AffinePoint 

pub struct AffinePoint { /* private fields */ }

secp256k1 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 secp256k1.

Gₓ = 79be667e f9dcbbac 55a06295 ce870b07 029bfcdb 2dce28d9 59f2815b 16f81798
Gᵧ = 483ada77 26a3c465 5da4fbfc 0e1108a8 fd17b448 a6855419 9c47d08f fb10d4b8

Trait Implementations

impl Add<&AffinePoint> for &ProjectivePoint

type Output = ProjectivePoint

The resulting type after applying the + operator.

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

Performs the + operation.

impl Add<&AffinePoint> for ProjectivePoint

type Output = ProjectivePoint

The resulting type after applying the + operator.

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

Performs the + operation.

impl Add<AffinePoint> for ProjectivePoint

type Output = ProjectivePoint

The resulting type after applying the + operator.

fn add(self, rhs: 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 AffineCoordinates for AffinePoint

type FieldRepr = Array<u8, <Secp256k1 as Curve>::FieldBytesSize>

Field element representation with curve-specific serialization/endianness.

fn from_coordinates(x: &Self::FieldRepr, y: &Self::FieldRepr) -> CtOption<Self>

Creates an affine point from its coordinates.

fn x(&self) -> FieldBytes

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

fn y(&self) -> FieldBytes

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

fn x_is_odd(&self) -> Choice

Is the affine x-coordinate odd?

fn y_is_odd(&self) -> Choice

Is the affine y-coordinate odd?

impl Clone for AffinePoint

fn clone(&self) -> AffinePoint

Returns a duplicate 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 Copy for AffinePoint

impl CtEq for AffinePoint

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

Determine if self is equal to other in constant-time.

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

Determine if self is NOT equal to other in constant-time.

impl CtSelect for AffinePoint

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

Select between self and other based on choice, returning a copy of the value.

fn ct_swap(&mut self, other: &mut Self, choice: Choice)

Conditionally swap self and other if choice is Choice::TRUE.

impl CurveAffine for AffinePoint

fn identity() -> Self

Returns the identity of the group: the point at infinity.

fn generator() -> Self

Returns the base point of secp256k1.

fn is_identity(&self) -> Choice

Is this point the identity point?

fn to_curve(&self) -> ProjectivePoint

Convert to curve representation.

type Scalar = Scalar

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

type Curve = ProjectivePoint

The efficient representation for this elliptic curve.

impl Debug for AffinePoint

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

Formats the value using the given formatter.

impl DecompactPoint<Secp256k1> for AffinePoint

Decompaction using Taproot conventions as described in BIP 340.

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

Attempt to decompact an elliptic curve point

impl DecompressPoint<Secp256k1> 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 DefaultIsZeroes for AffinePoint

impl Eq for AffinePoint

impl From<&AffinePoint> for Sec1Point

fn from(affine_point: &AffinePoint) -> Sec1Point

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<Secp256k1>> for AffinePoint

fn from(public_key: &PublicKey) -> AffinePoint

Converts to this type from the input type.

impl From<&VerifyingKey> for AffinePoint

fn from(vk: &VerifyingKey) -> AffinePoint

Converts to this type from the input type.

impl From<AffinePoint> for Sec1Point

fn from(affine_point: AffinePoint) -> Sec1Point

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<NonIdentity<AffinePoint>> for AffinePoint

fn from(affine_point: NonIdentity<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<Secp256k1>> for AffinePoint

fn from(public_key: PublicKey) -> AffinePoint

Converts to this type from the input type.

impl From<VerifyingKey> for AffinePoint

fn from(vk: VerifyingKey) -> AffinePoint

Converts to this type from the input type.

impl FromSec1Point<Secp256k1> for AffinePoint

fn from_sec1_point(encoded_point: &Sec1Point) -> CtOption<Self>

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

Returns

None value if encoded_point is not on the secp256k1 curve.

fn from_sec1_bytes(bytes: &[u8]) -> Result<Self, Error>

Decode curve point from the provided SEC1 encoding (compressed, uncompressed, or identity) using the Octet-String-to-Elliptic-Curve-Point conversion.

fn from_encoded_point( point: &EncodedPoint<<C as Curve>::FieldBytesSize>, ) -> CtOption<Self>

👎Deprecated since 0.14.0:

use FromSec1Point::from_sec1_point instead

DEPRECATED: legacy name for FromSec1Point::from_sec1_point.

impl Generate for AffinePoint

fn try_generate_from_rng<R: TryCryptoRng + ?Sized>( rng: &mut R, ) -> Result<Self, R::Error>

Generate random key using the provided TryCryptoRng.

fn generate_from_rng<R>(rng: &mut R) -> Self

where R: CryptoRng + ?Sized,

Generate random key using the provided CryptoRng.

fn try_generate() -> Result<Self, Error>

Randomly generate a value of this type using the system’s ambient cryptographically secure random number generator.

fn generate() -> Self

Randomly generate a value of this type using the system’s ambient cryptographically secure random number generator.

impl GroupEncoding for AffinePoint

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

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

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

Multiply self by rhs in variable-time.

impl MulVartime<Scalar> for AffinePoint

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

Multiply self by rhs in variable-time.

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 for AffinePoint

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

Equality operator ==.

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

Inequality operator !=.

impl PartialEq<AffinePoint> for ProjectivePoint

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

Equality operator ==.

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

Inequality operator !=.

impl PartialEq<ProjectivePoint> for AffinePoint

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

Equality operator ==.

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

Inequality operator !=.

impl Sub<&AffinePoint> for &ProjectivePoint

type Output = ProjectivePoint

The resulting type after applying the - operator.

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

Performs the - operation.

impl Sub<&AffinePoint> for ProjectivePoint

type Output = ProjectivePoint

The resulting type after applying the - operator.

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

Performs the - operation.

impl Sub<AffinePoint> for ProjectivePoint

type Output = ProjectivePoint

The resulting type after applying the - operator.

fn sub(self, rhs: 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 ToSec1Point<Secp256k1> for AffinePoint

fn to_sec1_point(&self, compress: bool) -> Sec1Point

Serialize curve point as a SEC1 Sec1Point, optionally applying point compression according to the compress flag.

fn to_sec1_bytes(&self) -> Box<[u8]>

where C: PointCompression,

Encode curve point using the Elliptic-Curve-Point-to-Octet-String conversion and the point compression default for this curve as specified by the PointCompression trait.

fn to_compressed_point( &self, ) -> Array<u8, <<C as Curve>::FieldBytesSize as ModulusSize>::CompressedPointSize>

Serialize curve point as a CompressedPoint.

fn to_uncompressed_point( &self, ) -> Array<u8, <<C as Curve>::FieldBytesSize as ModulusSize>::UncompressedPointSize>

Serialize curve point as a CompressedPoint.

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

👎Deprecated since 0.14.0:

use ToSec1Point::to_sec1_point instead

DEPRECATED: legacy name for ToSec1Point::to_sec1_point.

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<<Secp256k1 as Curve>::FieldBytesSize>> for AffinePoint

type Error = Error

The type returned in the event of a conversion error.

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

Performs the conversion.

impl TryFrom<AffinePoint> for NonIdentity<AffinePoint>

The constant-time alternative is available at NonIdentity::new().

type Error = Error

The type returned in the event of a conversion error.

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

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<AffinePoint> for VerifyingKey

type Error = Error

The type returned in the event of a conversion error.

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

Performs the conversion.

impl TryFrom<EncodedPoint<<Secp256k1 as Curve>::FieldBytesSize>> for AffinePoint

type Error = Error

The type returned in the event of a conversion error.

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

Performs the conversion.