Struct Secp256k1 

pub struct Secp256k1;

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

The OID associated with this type.

impl Clone for Secp256k1

fn clone(&self) -> Secp256k1

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for Secp256k1

impl Curve for Secp256k1

const ORDER: Odd<U256> = ORDER

Curve order.

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 FIELD_ENDIANNESS: ByteOrder = ByteOrder::BigEndian

Endianness used for serializing field elements of this 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

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 Secp256k1

fn default() -> Secp256k1

Returns the “default value” for a type.

impl DigestAlgorithm for Secp256k1

Available on crate feature sha256 only.

type Digest = Sha256

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

impl EcdsaCurve for Secp256k1

const NORMALIZE_S: bool = true

Does this curve use low-S normalized signatures?

impl Eq for Secp256k1

impl FieldArithmetic for Secp256k1

type FieldElement = FieldElement

Base field element 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 FromSec1Point<Secp256k1> for ProjectivePoint

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

Decode curve point from a SEC1 Sec1Point.

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 Mul<&<Secp256k1 as CurveArithmetic>::AffinePoint> for Scalar

type Output = <Secp256k1 as CurveArithmetic>::ProjectivePoint

The resulting type after applying the * operator.

fn mul(self, rhs: &AffinePoint<Secp256k1>) -> ProjectivePoint<Secp256k1>

Performs the * operation.

impl Mul<&<Secp256k1 as CurveArithmetic>::AffinePoint> for &Scalar

type Output = <Secp256k1 as CurveArithmetic>::ProjectivePoint

The resulting type after applying the * operator.

fn mul(self, rhs: &AffinePoint<Secp256k1>) -> ProjectivePoint<Secp256k1>

Performs the * operation.

impl Mul<&<Secp256k1 as CurveArithmetic>::ProjectivePoint> for Scalar

type Output = <Secp256k1 as CurveArithmetic>::ProjectivePoint

The resulting type after applying the * operator.

fn mul(self, rhs: &ProjectivePoint<Secp256k1>) -> ProjectivePoint<Secp256k1>

Performs the * operation.

impl Mul<&<Secp256k1 as CurveArithmetic>::ProjectivePoint> for &Scalar

type Output = <Secp256k1 as CurveArithmetic>::ProjectivePoint

The resulting type after applying the * operator.

fn mul(self, rhs: &ProjectivePoint<Secp256k1>) -> ProjectivePoint<Secp256k1>

Performs the * operation.

impl Mul<<Secp256k1 as CurveArithmetic>::AffinePoint> for Scalar

type Output = <Secp256k1 as CurveArithmetic>::ProjectivePoint

The resulting type after applying the * operator.

fn mul(self, rhs: AffinePoint<Secp256k1>) -> ProjectivePoint<Secp256k1>

Performs the * operation.

impl Mul<<Secp256k1 as CurveArithmetic>::AffinePoint> for &Scalar

type Output = <Secp256k1 as CurveArithmetic>::ProjectivePoint

The resulting type after applying the * operator.

fn mul(self, rhs: AffinePoint<Secp256k1>) -> ProjectivePoint<Secp256k1>

Performs the * operation.

impl Mul<<Secp256k1 as CurveArithmetic>::ProjectivePoint> for Scalar

type Output = <Secp256k1 as CurveArithmetic>::ProjectivePoint

The resulting type after applying the * operator.

fn mul(self, rhs: ProjectivePoint<Secp256k1>) -> ProjectivePoint<Secp256k1>

Performs the * operation.

impl Mul<<Secp256k1 as CurveArithmetic>::ProjectivePoint> for &Scalar

type Output = <Secp256k1 as CurveArithmetic>::ProjectivePoint

The resulting type after applying the * operator.

fn mul(self, rhs: ProjectivePoint<Secp256k1>) -> ProjectivePoint<Secp256k1>

Performs the * operation.

impl MulVartime<&<Secp256k1 as CurveArithmetic>::AffinePoint> for Scalar

fn mul_vartime(self, rhs: &AffinePoint<Secp256k1>) -> ProjectivePoint<Secp256k1>

Multiply self by rhs in variable-time.

impl MulVartime<&<Secp256k1 as CurveArithmetic>::AffinePoint> for &Scalar

fn mul_vartime(self, rhs: &AffinePoint<Secp256k1>) -> ProjectivePoint<Secp256k1>

Multiply self by rhs in variable-time.

impl MulVartime<&<Secp256k1 as CurveArithmetic>::ProjectivePoint> for Scalar

fn mul_vartime( self, rhs: &ProjectivePoint<Secp256k1>, ) -> ProjectivePoint<Secp256k1>

Multiply self by rhs in variable-time.

impl MulVartime<&<Secp256k1 as CurveArithmetic>::ProjectivePoint> for &Scalar

fn mul_vartime( self, rhs: &ProjectivePoint<Secp256k1>, ) -> ProjectivePoint<Secp256k1>

Multiply self by rhs in variable-time.

impl MulVartime<<Secp256k1 as CurveArithmetic>::AffinePoint> for Scalar

fn mul_vartime(self, rhs: AffinePoint<Secp256k1>) -> ProjectivePoint<Secp256k1>

Multiply self by rhs in variable-time.

impl MulVartime<<Secp256k1 as CurveArithmetic>::AffinePoint> for &Scalar

fn mul_vartime(self, rhs: AffinePoint<Secp256k1>) -> ProjectivePoint<Secp256k1>

Multiply self by rhs in variable-time.

impl MulVartime<<Secp256k1 as CurveArithmetic>::ProjectivePoint> for Scalar

fn mul_vartime( self, rhs: ProjectivePoint<Secp256k1>, ) -> ProjectivePoint<Secp256k1>

Multiply self by rhs in variable-time.

impl MulVartime<<Secp256k1 as CurveArithmetic>::ProjectivePoint> for &Scalar

fn mul_vartime( self, rhs: ProjectivePoint<Secp256k1>, ) -> ProjectivePoint<Secp256k1>

Multiply self by rhs in variable-time.

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

where Self: Sized,

Compares and returns the maximum of two values.

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

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl PartialEq for Secp256k1

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

Equality operator ==.

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

Inequality operator !=.

impl PartialOrd 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

Tests less than (for self and other) and is used by the < operator.

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

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

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

Tests greater than (for self and other) and is used by the > operator.

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

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

impl PrimeCurveWithBasepointTable<WINDOW_SIZE> for Secp256k1

const BASEPOINT_TABLE: &'static BasepointTable<ProjectivePoint, WINDOW_SIZE>

Basepoint table for this curve.

impl StructuralPartialEq for Secp256k1

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 ToSec1Point<Secp256k1> for ProjectivePoint

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.