Struct yubihsm::ecdsa::Secp256k1

pub struct Secp256k1;

Available on crate feature secp256k1 only.

secp256k1 (K-256) elliptic curve.

Specified in Certicom’s SECG in “SEC 2: Recommended Elliptic Curve Domain Parameters”:

https://www.secg.org/sec2-v2.pdf

The curve’s equation is y² = x³ + 7 over a ~256-bit prime field.

It’s primarily notable for usage in Bitcoin and other cryptocurrencies, particularly in conjunction with the Elliptic Curve Digital Signature Algorithm (ECDSA).

Trait Implementations

impl AssociatedOid for Secp256k1

Available on crate feature pkcs8 only.

const OID: ObjectIdentifier = pkcs8::ObjectIdentifier::new_unwrap("1.3.132.0.10")

The OID associated with this type.

impl Clone for Secp256k1

fn clone(&self) -> Secp256k1

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Curve for Secp256k1

type FieldBytesSize = UInt<UInt<UInt<UInt<UInt<UInt<UTerm, B1>, B0>, B0>, B0>, B0>, B0>

32-byte serialized field elements.

type Uint = Uint<crypto_bigint::::uint::U256::{constant#0}>

256-bit field modulus.

const ORDER: Uint<crypto_bigint::::uint::U256::{constant#0}> = ORDER

Curve order.

impl CurveAlgorithm for Secp256k1

fn asymmetric_algorithm() -> Algorithm

YubiHSM asymmetric algorithm for this elliptic curve

impl CurveArithmetic for Secp256k1

type AffinePoint = AffinePoint

Elliptic curve point in affine coordinates.

type ProjectivePoint = ProjectivePoint

Elliptic curve point in projective coordinates.

type Scalar = Scalar

Scalar field modulo this curve’s order.

impl Debug for Secp256k1

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

Formats the value using the given formatter.

impl Default for Secp256k1

fn default() -> Secp256k1

Returns the “default value” for a type.

impl DigestPrimitive for Secp256k1

Available on crate feature sha256 only.

type Digest = CoreWrapper<CtVariableCoreWrapper<Sha256VarCore, UInt<UInt<UInt<UInt<UInt<UInt<UTerm, B1>, B0>, B0>, B0>, B0>, B0>, OidSha256>>

Preferred digest to use when computing ECDSA signatures for this elliptic curve. This is typically a member of the SHA-2 family.

impl FromEncodedPoint<Secp256k1> for AffinePoint

fn from_encoded_point( encoded_point: &EncodedPoint<<Secp256k1 as Curve>::FieldBytesSize> ) -> CtOption<AffinePoint>

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

Returns

None value if encoded_point is not on the secp256k1 curve.

impl FromEncodedPoint<Secp256k1> for ProjectivePoint

fn from_encoded_point( p: &EncodedPoint<<Secp256k1 as Curve>::FieldBytesSize> ) -> CtOption<ProjectivePoint>

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

impl Ord for Secp256k1

fn cmp(&self, other: &Secp256k1) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Selfwhere Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Selfwhere Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Selfwhere Self: Sized + PartialOrd<Self>,

Restrict a value to a certain interval.

impl PartialEq<Secp256k1> for Secp256k1

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

fn partial_cmp(&self, other: &Secp256k1) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

This method tests less than (for self and other) and is used by the < operator.

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

This method tests less than or equal to (for self and other) and is used by the <= operator.

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

This method tests greater than (for self and other) and is used by the > operator.

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

This method tests greater than or equal to (for self and other) and is used by the >= operator.

impl PointCompression for Secp256k1

const COMPRESS_POINTS: bool = true

secp256k1 points are typically compressed.

impl ToEncodedPoint<Secp256k1> for AffinePoint

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

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

impl ToEncodedPoint<Secp256k1> for ProjectivePoint

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

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

impl Copy for Secp256k1

impl Eq for Secp256k1

impl PrimeCurve for Secp256k1

impl StructuralEq for Secp256k1

impl StructuralPartialEq for Secp256k1