Struct p384::NistP384

pub struct NistP384;

NIST P-384 elliptic curve.

This curve is also known as secp384r1 (SECG) and is specified in FIPS 186-4: Digital Signature Standard (DSS):

https://nvlpubs.nist.gov/nistpubs/FIPS/NIST.FIPS.186-4.pdf

It’s included in the US National Security Agency’s “Suite B” and is widely used in protocols like TLS and the associated X.509 PKI.

Its equation is y² = x³ - 3x + b over a ~384-bit prime field where b is the “verifiably random”† constant:

b = 2758019355995970587784901184038904809305690585636156852142
    8707301988689241309860865136260764883745107765439761230575

† NOTE: the specific origins of this constant have never been fully disclosed (it is the SHA-1 digest of an inexplicable NSA-selected constant)

Trait Implementations

impl AlgorithmParameters for NistP384

const OID: ObjectIdentifier

Object Identifier (OID) for this curve

fn algorithm_identifier() -> AlgorithmIdentifier<'static>

Get the pkcs8::AlgorithmIdentifier for this curve

impl Clone for NistP384

fn clone(&self) -> NistP384

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Curve for NistP384

type UInt = U384

384-bit field modulus

const ORDER: U384

Curve order

impl Debug for NistP384

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

Formats the value using the given formatter.

impl Default for NistP384

fn default() -> NistP384

Returns the “default value” for a type.

impl DigestPrimitive for NistP384

This is supported on crate features ecdsa and sha384 only.

type Digest = Sha384

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

impl JwkParameters for NistP384

This is supported on crate feature jwk only.

const CRV: &'static str

The crv parameter which identifies a particular elliptic curve as defined in RFC 7518 Section 6.2.1.1: https://tools.ietf.org/html/rfc7518#section-6.2.1.1

impl Ord for NistP384

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

This method returns an Ordering between self and other.

#[must_use]

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

Compares and returns the maximum of two values.

#[must_use]

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

Compares and returns the minimum of two values.

#[must_use]

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

Restrict a value to a certain interval.

impl PartialEq<NistP384> for NistP384

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

This method tests for self and other values to be equal, and is used by ==.

#[must_use]

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

This method tests for !=.

impl PartialOrd<NistP384> for NistP384

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

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

#[must_use]

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

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

#[must_use]

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

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

#[must_use]

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

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

#[must_use]

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 NistP384

const COMPRESS_POINTS: bool

Should point compression be applied by default?

impl ValidatePublicKey for NistP384

fn validate_public_key(
    secret_key: &SecretKey<Self>,
    public_key: &EncodedPoint<Self>
) -> Result<(), Error>

Validate that the given EncodedPoint is a valid public key for the provided secret value.

impl Curve for NistP384

impl Eq for NistP384

impl StructuralEq for NistP384

impl StructuralPartialEq for NistP384