Struct sm2::dsa::VerifyingKey

pub struct VerifyingKey { /* private fields */ }

Available on crate features arithmetic and dsa only.

SM2DSA public key used for verifying signatures are valid for a given message.

Usage

The signature crate defines the following traits which are the primary API for verifying:

• Verifier: verify a message against a provided key and signature
• PrehashVerifier: verify the low-level raw output bytes of a message digest

serde support

When the serde feature of this crate is enabled, it provides support for serializing and deserializing ECDSA signatures using the Serialize and Deserialize traits.

The serialization leverages the encoding used by the PublicKey type, which is a binary-oriented ASN.1 DER encoding.

Implementations

impl VerifyingKey

pub fn new(distid: &str, public_key: PublicKey) -> Result<Self>

Initialize VerifyingKey from a signer’s distinguishing identifier and public key.

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

Initialize VerifyingKey from a SEC1-encoded public key.

pub fn from_affine(distid: &str, affine: AffinePoint) -> Result<Self>

Initialize VerifyingKey from an affine point.

Returns an Error if the given affine point is the additive identity (a.k.a. point at infinity).

pub fn as_affine(&self) -> &AffinePoint

Borrow the inner AffinePoint for this public key.

pub fn distid(&self) -> &str

Available on crate feature alloc only.

Get the distinguishing identifier for this key.

pub fn to_sec1_bytes(&self) -> Box<[u8]>

Available on crate feature alloc only.

Convert this VerifyingKey into the Elliptic-Curve-Point-to-Octet-String encoding described in SEC 1: Elliptic Curve Cryptography (Version 2.0) section 2.3.3 (page 10).

http://www.secg.org/sec1-v2.pdf

Trait Implementations

impl AsRef<AffinePoint<Sm2>> for VerifyingKey

fn as_ref(&self) -> &AffinePoint

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

impl AsRef<VerifyingKey> for SigningKey

fn as_ref(&self) -> &VerifyingKey

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

impl Clone for VerifyingKey

fn clone(&self) -> VerifyingKey

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for VerifyingKey

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

Formats the value using the given formatter.

impl From<&VerifyingKey> for PublicKey

fn from(verifying_key: &VerifyingKey) -> PublicKey

Converts to this type from the input type.

impl From<VerifyingKey> for PublicKey

fn from(verifying_key: VerifyingKey) -> PublicKey

Converts to this type from the input type.

impl PrehashVerifier<Signature> for VerifyingKey

fn verify_prehash(&self, prehash: &[u8], signature: &Signature) -> Result<()>

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

impl ToEncodedPoint<Sm2> for VerifyingKey

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

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

impl Verifier<Signature> for VerifyingKey

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

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