Struct p384::NistP384

source · [−]

pub struct NistP384;

Expand description

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

source

impl AffineArithmetic for NistP384

type AffinePoint = AffinePoint

Elliptic curve point in affine coordinates.

source

impl AffineXCoordinate<NistP384> for AffinePoint

source

fn x(&self) -> FieldBytes

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

source

impl AssociatedOid for NistP384

source

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

The OID associated with this type.

source

impl Clone for NistP384

source

fn clone(&self) -> NistP384

Returns a copy of the value. Read more

1.0.0 · source

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

Performs copy-assignment from source. Read more

source

impl Curve for NistP384

type UInt = UInt<{_: usize}>

384-bit field modulus

source

const ORDER: U384 = ORDER

Curve order

source

impl Debug for NistP384

source

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

Formats the value using the given formatter. Read more

source

impl DecompressPoint<NistP384> for AffinePoint

source

fn decompress(x_bytes: &FieldBytes, y_is_odd: Choice) -> CtOption<Self>

Attempt to decompress an elliptic curve point.

source

impl Default for NistP384

source

fn default() -> NistP384

Returns the “default value” for a type. Read more

source

impl DigestPrimitive for NistP384

Available on crate features ecdsa and sha384 only.

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

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

source

impl FromEncodedPoint<NistP384> for AffinePoint

source

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

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

Returns

None value if encoded_point is not on the secp384r1 curve.

source

impl JwkParameters for NistP384

Available on crate feature jwk only.

source

const CRV: &'static str = "P-384"

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 Read more

source

impl Ord for NistP384

source

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

This method returns an Ordering between self and other. Read more

1.21.0 · source

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

Compares and returns the maximum of two values. Read more

1.21.0 · source

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

Compares and returns the minimum of two values. Read more

1.50.0 · source

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

Restrict a value to a certain interval. Read more

source

impl PartialEq<NistP384> for NistP384

source

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

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

1.0.0 · source

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

This method tests for !=.

source

impl PartialOrd<NistP384> for NistP384

source

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

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

1.0.0 · source

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

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

1.0.0 · source

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

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

1.0.0 · source

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

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

1.0.0 · source

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

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

source

impl PointCompression for NistP384

source

const COMPRESS_POINTS: bool = false

Should point compression be applied by default?

source

impl ScalarArithmetic for NistP384

type Scalar = Scalar

Scalar field type. Read more

source

impl ToEncodedPoint<NistP384> for AffinePoint

source

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

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

source

impl ValidatePublicKey for NistP384

source

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

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

source

impl VoprfParameters for NistP384

Available on crate feature voprf only.

source

const ID: u16 = 4u16

See https://www.ietf.org/archive/id/draft-irtf-cfrg-voprf-08.html#section-4.4-1.3.

type Hash = CoreWrapper<CtVariableCoreWrapper<Sha512VarCore, UInt<UInt<UInt<UInt<UInt<UInt<UTerm, B1>, B1>, B0>, B0>, B0>, B0>>>

See https://www.ietf.org/archive/id/draft-irtf-cfrg-voprf-08.html#section-4.4-1.2.

source

impl StructuralPartialEq for NistP384

Auto Trait Implementations

impl RefUnwindSafe for NistP384

impl Send for NistP384

impl Sync for NistP384

impl Unpin for NistP384

impl UnwindSafe for NistP384

Blanket Implementations

source

impl<T> Any for T where
T: 'static + ?Sized,

source

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more

source

impl<T> Borrow<T> for T where
T: ?Sized,

const: unstable · source

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more

source

impl<T> BorrowMut<T> for T where
T: ?Sized,

const: unstable · source

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more

source

impl<T> From<T> for T

const: unstable · source

fn from(t: T) -> T

Returns the argument unchanged.

source

impl<T, U> Into for T where
U: From<T>,

const: unstable · source

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

source

impl<T> Same<T> for T

type Output = T

Should always be Self

source

impl<T> ToOwned for T where
T: Clone,

type Owned = T

The resulting type after obtaining ownership.

source

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more

source

fn clone_into(&self, target: &mut T)

🔬 This is a nightly-only experimental API. (toowned_clone_into)

Uses borrowed data to replace owned data, usually by cloning. Read more

source

impl<T, U> TryFrom for T where
U: Into<T>,

type Error = Infallible

The type returned in the event of a conversion error.

const: unstable · source

fn try_from(value: U) -> Result<T, <T as TryFrom>::Error>

Performs the conversion.

source

impl<T, U> TryInto for T where
U: TryFrom<T>,

type Error = >::Error

The type returned in the event of a conversion error.

const: unstable · source

fn try_into(self) -> Result<U, >::Error>

Performs the conversion.

Struct p384::NistP384

Trait Implementations

impl AffineArithmetic for NistP384

type AffinePoint = AffinePoint

impl AffineXCoordinate<NistP384> for AffinePoint

fn x(&self) -> FieldBytes

impl AssociatedOid for NistP384

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

impl Clone for NistP384

fn clone(&self) -> NistP384

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

impl Curve for NistP384

type UInt = UInt<{_: usize}>

const ORDER: U384 = ORDER

impl Debug for NistP384

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

impl DecompressPoint<NistP384> for AffinePoint

fn decompress(x_bytes: &FieldBytes, y_is_odd: Choice) -> CtOption<Self>

impl Default for NistP384

fn default() -> NistP384

impl DigestPrimitive for NistP384

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

impl FromEncodedPoint<NistP384> for AffinePoint

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

Returns

impl JwkParameters for NistP384

const CRV: &'static str = "P-384"

impl Ord for NistP384

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

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

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

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

impl PartialEq<NistP384> for NistP384

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

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

impl PartialOrd<NistP384> for NistP384

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

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

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

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

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

impl PointCompression for NistP384

const COMPRESS_POINTS: bool = false

impl ScalarArithmetic for NistP384

type Scalar = Scalar

impl ToEncodedPoint<NistP384> for AffinePoint

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

impl ValidatePublicKey for NistP384

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

impl VoprfParameters for NistP384

const ID: u16 = 4u16

type Hash = CoreWrapper<CtVariableCoreWrapper<Sha512VarCore, UInt<UInt<UInt<UInt<UInt<UInt<UTerm, B1>, B1>, B0>, B0>, B0>, B0>>>

impl Copy for NistP384

impl Eq for NistP384

impl PrimeCurve for NistP384

impl StructuralEq for NistP384

impl StructuralPartialEq for NistP384

Auto Trait Implementations

impl RefUnwindSafe for NistP384

impl Send for NistP384

impl Sync for NistP384

impl Unpin for NistP384

impl UnwindSafe for NistP384

Blanket Implementations

impl<T> Any for T where T: 'static + ?Sized,

fn type_id(&self) -> TypeId

impl<T> Borrow<T> for T where T: ?Sized,

fn borrow(&self) -> &T

impl<T> BorrowMut<T> for T where T: ?Sized,

fn borrow_mut(&mut self) -> &mut T

impl<T> From<T> for T

fn from(t: T) -> T

impl<T, U> Into<U> for T where U: From<T>,

fn into(self) -> U

impl<T> Same<T> for T

type Output = T

impl<T> ToOwned for T where T: Clone,

type Owned = T

fn to_owned(&self) -> T

fn clone_into(&self, target: &mut T)

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

impl<T> Any for T where
T: 'static + ?Sized,

impl<T> Borrow<T> for T where
T: ?Sized,

impl<T> BorrowMut<T> for T where
T: ?Sized,

impl<T, U> Into<U> for T where
U: From<T>,

impl<T> ToOwned for T where
T: Clone,

impl<T, U> TryFrom<U> for T where
U: Into<T>,

impl<T, U> TryInto<U> for T where
U: TryFrom<T>,