Crate p384_rs

RustCrypto: NIST P-384 (secp384r1) elliptic curve

[![Project Chat][chat-image]][chat-link] [![Build Status][build-image]][build-link]

NIST P-384 elliptic curve (a.k.a. secp384r1) types implemented in terms of traits from the elliptic-curve crate.

Documentation

About P-384

NIST P-384 is a Weierstrass curve specified in FIPS 186-4: Digital Signature Standard (DSS):

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

Also known as secp384r1 (SECG), 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.

Minimum Supported Rust Version

Rust 1.57 or higher.

Minimum supported Rust version can be changed in the future, but it will be done with a minor version bump.

SemVer Policy

• All on-by-default features of this library are covered by SemVer
• MSRV is considered exempt from SemVer as noted above

License

All crates licensed under either of

• Apache License, Version 2.0
• MIT license

at your option.

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

serde support

When the serde feature of this crate is enabled, Serialize and Deserialize are impl’d for the following types:

• AffinePoint
• Scalar
• ecdsa::VerifyingKey

Please see type-specific documentation for more information.

Re-exports

pub use elliptic_curve::pkcs8;

pub use elliptic_curve;

Modules

ecdhecdh

Elliptic Curve Diffie-Hellman (Ephemeral) Support.

ecdsaecdsa-core

Elliptic Curve Digital Signature Algorithm (ECDSA)

test_vectorstest-vectors

secp384r1 test vectors.

Structs

AffinePointarithmetic

NIST P-384 (secp384r1) curve point expressed in affine coordinates.

BlindedScalararithmetic

Scalar blinded with a randomly generated masking value.

NistP384

NIST P-384 elliptic curve.

ProjectivePointarithmetic

A point on the secP384r1 curve in projective coordinates.

Scalararithmetic

Scalars are elements in the finite field modulo n.

Type Definitions

CompressedPoint

Compressed SEC1-encoded NIST P-384 curve point.

EncodedPoint

NIST P-384 SEC1 encoded point.

FieldBytes

NIST P-384 field element serialized as bytes.

NonZeroScalar

Non-zero NIST P-384 scalar field element.

PublicKey

NIST P-384 public key.

ScalarBitsbits

Bit representation of a NIST P-384 scalar field element.

SecretKey

NIST P-384 secret key.

U384

384-bit unsigned big integer