Struct oberon::inner_types::elliptic_curve::PublicKey

pub struct PublicKey<C>where
    C: CurveArithmetic,{ /* private fields */ }

Elliptic curve public keys.

This is a wrapper type for AffinePoint which ensures an inner non-identity point and provides a common place to handle encoding/decoding.

Parsing “SPKI” Keys

X.509 SubjectPublicKeyInfo (SPKI) is a commonly used format for encoding public keys, notably public keys corresponding to PKCS#8 private keys. (especially ones generated by OpenSSL).

Keys in SPKI format are either binary (ASN.1 BER/DER), or PEM encoded (ASCII) and begin with the following:

-----BEGIN PUBLIC KEY-----

To decode an elliptic curve public key from SPKI, enable the pkcs8 feature of this crate (or the pkcs8 feature of a specific RustCrypto elliptic curve crate) and use the [elliptic_curve::pkcs8::DecodePublicKey][pkcs8::DecodePublicKey] trait to parse it.

When the pem feature of this crate (or a specific RustCrypto elliptic curve crate) is enabled, a [FromStr] impl is also available.

serde support

When the optional serde feature of this create is enabled, [Serialize] and [Deserialize] impls are provided for this type.

The serialization is binary-oriented and supports ASN.1 DER Subject Public Key Info (SPKI) as the encoding format.

For a more text-friendly encoding of public keys, use [JwkEcKey] instead.

Implementations

impl<C> PublicKey<C>where C: CurveArithmetic,

pub fn from_affine( point: <C as CurveArithmetic>::AffinePoint ) -> Result<PublicKey<C>, Error>

Convert an AffinePoint into a PublicKey

pub fn from_secret_scalar(scalar: &NonZeroScalar<C>) -> PublicKey<C>

Compute a PublicKey from a secret NonZeroScalar value (i.e. a secret key represented as a raw scalar value)

pub fn as_affine(&self) -> &<C as CurveArithmetic>::AffinePoint

Borrow the inner AffinePoint from this PublicKey.

In ECC, public keys are elliptic curve points.

pub fn to_projective(&self) -> <C as CurveArithmetic>::ProjectivePoint

Convert this PublicKey to a ProjectivePoint for the given curve

pub fn to_nonidentity(&self) -> NonIdentity<<C as CurveArithmetic>::AffinePoint>

Convert this PublicKey to a NonIdentity of the inner AffinePoint

Trait Implementations

impl<C> AsRef<<C as CurveArithmetic>::AffinePoint> for PublicKey<C>where C: CurveArithmetic,

fn as_ref(&self) -> &<C as CurveArithmetic>::AffinePoint

Converts this type into a shared reference of the (usually inferred) input type.

impl<C> Clone for PublicKey<C>where C: Clone + CurveArithmetic,

fn clone(&self) -> PublicKey<C>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<C> Debug for PublicKey<C>where C: Debug + CurveArithmetic,

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

Formats the value using the given formatter.

impl<C, P> From<&NonIdentity<P>> for PublicKey<C>where C: CurveArithmetic, P: Copy + Into<<C as CurveArithmetic>::AffinePoint>,

fn from(value: &NonIdentity<P>) -> PublicKey<C>

Converts to this type from the input type.

impl<C> From<&PublicKey<C>> for NonIdentity<<C as CurveArithmetic>::AffinePoint>where C: CurveArithmetic,

fn from( value: &PublicKey<C> ) -> NonIdentity<<C as CurveArithmetic>::AffinePoint>

Converts to this type from the input type.

impl<C, P> From<NonIdentity<P>> for PublicKey<C>where C: CurveArithmetic, P: Copy + Into<<C as CurveArithmetic>::AffinePoint>,

fn from(value: NonIdentity<P>) -> PublicKey<C>

Converts to this type from the input type.

impl<C> From<PublicKey<C>> for NonIdentity<<C as CurveArithmetic>::AffinePoint>where C: CurveArithmetic,

fn from(value: PublicKey<C>) -> NonIdentity<<C as CurveArithmetic>::AffinePoint>

Converts to this type from the input type.

impl<C> PartialEq<PublicKey<C>> for PublicKey<C>where C: PartialEq<C> + CurveArithmetic,

fn eq(&self, other: &PublicKey<C>) -> bool

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

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

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<C> Copy for PublicKey<C>where C: CurveArithmetic,

impl<C> Eq for PublicKey<C>where C: Eq + CurveArithmetic,

impl<C> StructuralEq for PublicKey<C>where C: CurveArithmetic,

impl<C> StructuralPartialEq for PublicKey<C>where C: CurveArithmetic,