Crate oberon::inner_types::elliptic_curve

RustCrypto: Elliptic Curve Traits

General purpose Elliptic Curve Cryptography (ECC) support, including types and traits for representing various elliptic curve forms, scalars, points, and public/secret keys composed thereof.

Documentation

Minimum Supported Rust Version

Requires Rust 1.65 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.

Usage

This crate provides traits for describing elliptic curves, along with types which are generic over elliptic curves which can be used as the basis of curve-agnostic code.

It’s intended to be used with the following concrete elliptic curve implementations from the RustCrypto/elliptic-curves project:

• bp256: brainpoolP256r1 and brainpoolP256t1
• bp384: brainpoolP384r1 and brainpoolP384t1
• k256: secp256k1 a.k.a. K-256
• p224: NIST P-224 a.k.a. secp224r1
• p256: NIST P-256 a.k.a secp256r1, prime256v1
• p384: NIST P-384 a.k.a. secp384r1
• p521: NIST P-521 a.k.a. secp521r1

The ecdsa crate provides a generic implementation of the Elliptic Curve Digital Signature Algorithm which can be used with any of the above crates, either via an external ECDSA implementation, or using native curve arithmetic where applicable.

Type conversions

The following chart illustrates the various conversions possible between the various types defined by this crate.

serde support

When the serde feature of this crate is enabled, Serialize and Deserialize impls are provided for the following types:

• [JwkEcKey]
• PublicKey
• ScalarPrimitive

Please see type-specific documentation for more information.

Modules

• bigint
  RustCrypto: Cryptographic Big Integers
• ff
  This crate provides traits for working with finite fields.
• group
• hash2curve
  Traits for hashing byte sequences to curve points.
• ops
  Traits for arithmetic operations on elliptic curve field elements.
• point
  Traits for elliptic curve points.
• scalar
  Scalar types.
• weierstrass
  Complete projective formulas for prime order elliptic curves as described in Renes-Costello-Batina 2015.

Structs

• Error
  Elliptic curve errors.
• NonZeroScalar
  Non-zero scalar type.
• PublicKey
  Elliptic curve public keys.
• ScalarPrimitive
  Generic scalar type with primitive functionality.
• SecretKey
  Elliptic curve secret keys.

Traits

• Curve
  Elliptic curve.
• CurveArithmetic
  Elliptic curve with an arithmetic implementation.
• Field
  This trait represents an element of a field.
• FieldBytesEncoding
  Trait for decoding/encoding Curve::Uint from/to FieldBytes using curve-specific rules.
• Group
  This trait represents an element of a cryptographic group.
• PrimeCurve
  Marker trait for elliptic curves with prime order.
• PrimeCurveArithmetic
  Prime order elliptic curve with projective arithmetic implementation.
• PrimeField
  This represents an element of a non-binary prime field.

Type Definitions

• AffinePoint
  Affine point type for a given curve with a CurveArithmetic implementation.
• FieldBytes
  Byte representation of a base/scalar field element of a given curve.
• FieldBytesSize
  Size of serialized field elements of this elliptic curve.
• ProjectivePoint
  Projective point type for a given curve with a CurveArithmetic implementation.
• Result
  Result type with the elliptic-curve crate’s Error type.
• Scalar
  Scalar field element for a particular elliptic curve.