Struct ecdsa::VerifyingKey

pub struct VerifyingKey<C> where
    C: Curve + ProjectiveArithmetic,  { /* fields omitted */ }

This is supported on crate feature verify only.

ECDSA verification key (i.e. public key). Generic over elliptic curves.

Requires an elliptic_curve::ProjectiveArithmetic impl on the curve, and a VerifyPrimitive impl on its associated AffinePoint type.

Implementations

impl<C> VerifyingKey<C> where
    C: Curve + ProjectiveArithmetic,
    AffinePoint<C>: FromEncodedPoint<C> + ToEncodedPoint<C>,
    UntaggedPointSize<C>: Add<U1> + ArrayLength<u8>,
    UncompressedPointSize<C>: ArrayLength<u8>, 

pub fn from_sec1_bytes(bytes: &[u8]) -> Result<Self>

Initialize VerifyingKey from a SEC1-encoded public key.

pub fn from_encoded_point(public_key: &EncodedPoint<C>) -> Result<Self>

Initialize VerifyingKey from an EncodedPoint.

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

Serialize this VerifyingKey as a SEC1 EncodedPoint, optionally applying point compression.

Trait Implementations

impl<C: Clone> Clone for VerifyingKey<C> where
    C: Curve + ProjectiveArithmetic, 

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

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<C: Debug> Debug for VerifyingKey<C> where
    C: Curve + ProjectiveArithmetic, 

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

Formats the value using the given formatter.

impl<C, D> DigestVerifier<D, Signature<C>> for VerifyingKey<C> where
    C: Curve + ProjectiveArithmetic,
    D: Digest<OutputSize = FieldSize<C>>,
    AffinePoint<C>: VerifyPrimitive<C>,
    Scalar<C>: FromDigest<C>,
    SignatureSize<C>: ArrayLength<u8>, 

fn verify_digest(&self, digest: D, signature: &Signature<C>) -> Result<()>

Verify the signature against the given [Digest] output.

impl<C> From<&'_ PublicKey<C>> for VerifyingKey<C> where
    C: Curve + ProjectiveArithmetic, 

fn from(public_key: &PublicKey<C>) -> VerifyingKey<C>

Performs the conversion.

impl<C> From<&'_ SigningKey<C>> for VerifyingKey<C> where
    C: Curve + ProjectiveArithmetic,
    Scalar<C>: FromDigest<C> + Invert<Output = Scalar<C>> + SignPrimitive<C> + Zeroize,
    SignatureSize<C>: ArrayLength<u8>, 

fn from(signing_key: &SigningKey<C>) -> VerifyingKey<C>

Performs the conversion.

impl<C> From<&'_ VerifyingKey<C>> for EncodedPoint<C> where
    C: Curve + ProjectiveArithmetic + PointCompression,
    AffinePoint<C>: FromEncodedPoint<C> + ToEncodedPoint<C>,
    UntaggedPointSize<C>: Add<U1> + ArrayLength<u8>,
    UncompressedPointSize<C>: ArrayLength<u8>, 

fn from(verifying_key: &VerifyingKey<C>) -> EncodedPoint<C>

Performs the conversion.

impl<C> From<&'_ VerifyingKey<C>> for PublicKey<C> where
    C: Curve + ProjectiveArithmetic, 

fn from(verifying_key: &VerifyingKey<C>) -> PublicKey<C>

Performs the conversion.

impl<C> From<PublicKey<C>> for VerifyingKey<C> where
    C: Curve + ProjectiveArithmetic, 

fn from(public_key: PublicKey<C>) -> VerifyingKey<C>

Performs the conversion.

impl<C> From<VerifyingKey<C>> for PublicKey<C> where
    C: Curve + ProjectiveArithmetic, 

fn from(verifying_key: VerifyingKey<C>) -> PublicKey<C>

Performs the conversion.

impl<C> FromPublicKey for VerifyingKey<C> where
    C: Curve + AlgorithmParameters + ProjectiveArithmetic + PointCompression,
    AffinePoint<C>: FromEncodedPoint<C> + ToEncodedPoint<C>,
    UntaggedPointSize<C>: Add<U1> + ArrayLength<u8>,
    UncompressedPointSize<C>: ArrayLength<u8>, 

This is supported on crate feature pkcs8 only.

fn from_spki(spki: SubjectPublicKeyInfo<'_>) -> Result<Self>

Parse SubjectPublicKeyInfo into a public key object.

fn from_public_key_der(bytes: &[u8]) -> Result<Self, Error>

Deserialize object from ASN.1 DER-encoded SubjectPublicKeyInfo (binary format).

fn from_public_key_doc(doc: &PublicKeyDocument) -> Result<Self, Error>

Deserialize PKCS#8 private key from a PrivateKeyDocument.

fn from_public_key_pem(s: &str) -> Result<Self, Error>

Deserialize PEM-encoded SubjectPublicKeyInfo.

impl<C> FromStr for VerifyingKey<C> where
    C: Curve + AlgorithmParameters + ProjectiveArithmetic + PointCompression,
    AffinePoint<C>: FromEncodedPoint<C> + ToEncodedPoint<C>,
    UntaggedPointSize<C>: Add<U1> + ArrayLength<u8>,
    UncompressedPointSize<C>: ArrayLength<u8>, 

This is supported on crate feature pem only.

type Err = Error

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<Self>

Parses a string s to return a value of this type.

impl<C> Ord for VerifyingKey<C> where
    C: Curve + ProjectiveArithmetic,
    AffinePoint<C>: FromEncodedPoint<C> + ToEncodedPoint<C>,
    UntaggedPointSize<C>: Add<U1> + ArrayLength<u8>,
    UncompressedPointSize<C>: ArrayLength<u8>, 

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

This method returns an Ordering between self and other.

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

Compares and returns the maximum of two values.

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

Compares and returns the minimum of two values.

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

Restrict a value to a certain interval.

impl<C> PartialEq<VerifyingKey<C>> for VerifyingKey<C> where
    C: Curve + ProjectiveArithmetic,
    AffinePoint<C>: FromEncodedPoint<C> + ToEncodedPoint<C>,
    UntaggedPointSize<C>: Add<U1> + ArrayLength<u8>,
    UncompressedPointSize<C>: ArrayLength<u8>, 

fn eq(&self, other: &Self) -> 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 !=.

impl<C> PartialOrd<VerifyingKey<C>> for VerifyingKey<C> where
    C: Curve + ProjectiveArithmetic,
    AffinePoint<C>: FromEncodedPoint<C> + ToEncodedPoint<C>,
    UntaggedPointSize<C>: Add<U1> + ArrayLength<u8>,
    UncompressedPointSize<C>: ArrayLength<u8>, 

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

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

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

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

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

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

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

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

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

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

impl<C> TryFrom<&'_ [u8]> for VerifyingKey<C> where
    C: Curve + ProjectiveArithmetic,
    AffinePoint<C>: FromEncodedPoint<C> + ToEncodedPoint<C>,
    UntaggedPointSize<C>: Add<U1> + ArrayLength<u8>,
    UncompressedPointSize<C>: ArrayLength<u8>, 

type Error = Error

The type returned in the event of a conversion error.

fn try_from(bytes: &[u8]) -> Result<Self>

Performs the conversion.

impl<C> Verifier<Signature<C>> for VerifyingKey<C> where
    C: Curve + ProjectiveArithmetic + DigestPrimitive,
    C::Digest: Digest<OutputSize = FieldSize<C>>,
    AffinePoint<C>: VerifyPrimitive<C>,
    Scalar<C>: FromDigest<C>,
    SignatureSize<C>: ArrayLength<u8>, 

fn verify(&self, msg: &[u8], signature: &Signature<C>) -> Result<()>

Use Self to verify that the provided signature for a given message bytestring is authentic.

impl<C> Copy for VerifyingKey<C> where
    C: Curve + ProjectiveArithmetic, 

impl<C> Eq for VerifyingKey<C> where
    C: Curve + ProjectiveArithmetic,
    AffinePoint<C>: FromEncodedPoint<C> + ToEncodedPoint<C>,
    UntaggedPointSize<C>: Add<U1> + ArrayLength<u8>,
    UncompressedPointSize<C>: ArrayLength<u8>,