Crate p521

RustCrypto: NIST P-521 (secp521r1) elliptic curve

Pure Rust implementation of the NIST P-521 (a.k.a. secp521r1) elliptic curve.

Documentation

⚠️ Security Warning

The elliptic curve arithmetic contained in this crate has never been independently audited!

This crate has been designed with the goal of ensuring that secret-dependent operations are performed in constant time (using the subtle crate and constant-time formulas). However, it has not been thoroughly assessed to ensure that generated assembly is constant time on common CPU architectures.

USE AT YOUR OWN RISK!

Supported Algorithms

• Elliptic Curve Diffie-Hellman (ECDH): gated under the ecdh feature.
• Elliptic Curve Digital Signature Algorithm (ECDSA): gated under the ecdsa feature.

About P-521

NIST P-521 is a Weierstrass curve specified in SP 800-186: Recommendations for Discrete Logarithm-based Cryptography: Elliptic Curve Domain Parameters.

Also known as secp521r1 (SECG).

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
• ProjectivePoint
• Scalar

Please see type-specific documentation for more information.

Re-exports

pub use elliptic_curve;

pub use elliptic_curve::pkcs8;pkcs8

Modules

ecdhecdh

Elliptic Curve Diffie-Hellman (Ephemeral) Support.

ecdsaecdsa-core

Elliptic Curve Digital Signature Algorithm (ECDSA)

test_vectorstest-vectors

secp521r1 test vectors.

Structs

FieldElementarithmetic and expose-field

Element of the secp521r1 base field used for curve coordinates.

NistP521

NIST P-521 elliptic curve.

Scalararithmetic

Scalars are elements in the finite field modulo n.

Type Aliases

AffinePointarithmetic

Elliptic curve point in affine coordinates.

CompressedPoint

Compressed SEC1-encoded NIST P-521 curve point.

EncodedPoint

NIST P-521 SEC1 encoded point.

FieldBytes

NIST P-521 field element serialized as bytes.

NonZeroScalararithmetic

Non-zero NIST P-521 scalar field element.

ProjectivePointarithmetic

Elliptic curve point in projective coordinates.

PublicKeyarithmetic

NIST P-521 public key.

SecretKey

NIST P-521 secret key.

U576

576-bit unsigned big integer.