Struct k256::Secp256k1

pub struct Secp256k1;

K-256 (secp256k1) 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 AffineArithmetic for Secp256k1

type AffinePoint = AffinePoint

Elliptic curve point in affine coordinates.

impl AlgorithmParameters for Secp256k1

const OID: ObjectIdentifier

Object Identifier (OID) for this curve

fn algorithm_identifier() -> AlgorithmIdentifier<'static>

Get the pkcs8::AlgorithmIdentifier for this curve

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 UInt = U256

256-bit field modulus

const ORDER: U256

Curve order

impl Debug for Secp256k1

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

Formats the value using the given formatter.

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 Secp256k1

fn default() -> Secp256k1

Returns the “default value” for a type.

impl DigestPrimitive for Secp256k1

This is supported on crate features ecdsa-core and sha256 only.

type Digest = Sha256

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

impl FromDigest<Secp256k1> for Scalar

This is supported on crate feature digest only.

fn from_digest<D>(digest: D) -> Self where
    D: Digest<OutputSize = U32>, 

Convert the output of a digest algorithm into a Scalar reduced modulo n.

impl FromEncodedPoint<Secp256k1> for AffinePoint

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

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) -> Option<Self>

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) -> Self

Compares and returns the maximum of two values.

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

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> 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 !=.

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

secp256k1 points are typically compressed.

impl ProjectiveArithmetic for Secp256k1

type ProjectivePoint = ProjectivePoint

Elliptic curve point in projective coordinates.

impl RecoverableSignPrimitive<Secp256k1> for Scalar

This is supported on crate feature ecdsa-core only.

fn try_sign_recoverable_prehashed<K>(
    &self,
    ephemeral_scalar: &K,
    z: &Scalar
) -> Result<(Signature, bool), Error> where
    K: Borrow<Scalar> + Invert<Output = Scalar>, 

Try to sign the prehashed message.

impl ScalarArithmetic for Secp256k1

type Scalar = Scalar

Scalar field type.

impl ToEncodedPoint<Secp256k1> for AffinePoint

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

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

impl ToEncodedPoint<Secp256k1> for ProjectivePoint

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

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

impl ToEncodedPoint<Secp256k1> for VerifyingKey

This is supported on crate feature ecdsa-core only.

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

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

impl VerifyPrimitive<Secp256k1> for AffinePoint

This is supported on crate feature ecdsa-core only.

fn verify_prehashed(
    &self,
    z: &Scalar,
    signature: &Signature
) -> Result<(), Error>

Verify the prehashed message against the provided signature

impl Curve for Secp256k1

impl Eq for Secp256k1

impl StructuralEq for Secp256k1

impl StructuralPartialEq for Secp256k1