Struct Signature 

pub struct Signature<P: MlDsaParams> { /* private fields */ }

An ML-DSA signature

Implementations

impl<P: MlDsaParams> Signature<P>

pub fn encode(&self) -> EncodedSignature<P>

Encode the signature in a fixed-size byte array.

pub fn decode(enc: &EncodedSignature<P>) -> Option<Self>

Decode the signature from an appropriately sized byte array.

Trait Implementations

impl<P> AssociatedAlgorithmIdentifier for Signature<P>

where P: MlDsaParams + AssociatedAlgorithmIdentifier<Params = AnyRef<'static>>,

Available on crate feature pkcs8 only.

const ALGORITHM_IDENTIFIER: AlgorithmIdentifierRef<'static> = P::ALGORITHM_IDENTIFIER

AlgorithmIdentifier for this structure.

type Params = AnyRef<'static>

Algorithm parameters.

impl<P: Clone + MlDsaParams> Clone for Signature<P>

where P::Lambda: Clone, P::L: Clone,

fn clone(&self) -> Signature<P>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<P: Debug + MlDsaParams> Debug for Signature<P>

where P::Lambda: Debug, P::L: Debug,

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

Formats the value using the given formatter.

impl<P: MlDsaParams> DigestSigner<Shake256, Signature<P>> for KeyPair<P>

The DigestSigner implementation for KeyPair uses the optional deterministic variant of ML-DSA with a pre-computed μ, and only supports signing with an empty context string.

fn try_sign_digest<F: Fn(&mut Shake256) -> Result<(), Error>>( &self, f: F, ) -> Result<Signature<P>, Error>

Attempt to sign a message by updating the received Digest with it, returning a digital signature on success, or an error if something went wrong.

fn sign_digest<F>(&self, f: F) -> S

where F: Fn(&mut D),

Sign a message by updating the received Digest with it, returning a signature.

impl<P: MlDsaParams> DigestSigner<Shake256, Signature<P>> for SigningKey<P>

The Signer implementation for SigningKey uses the optional deterministic variant of ML-DSA with a pre-computed µ, and only supports signing with an empty context string. If you would like to include a context string, use the SigningKey::sign_mu_deterministic method.

fn try_sign_digest<F: Fn(&mut Shake256) -> Result<(), Error>>( &self, f: F, ) -> Result<Signature<P>, Error>

Attempt to sign a message by updating the received Digest with it, returning a digital signature on success, or an error if something went wrong.

fn sign_digest<F>(&self, f: F) -> S

where F: Fn(&mut D),

Sign a message by updating the received Digest with it, returning a signature.

impl<P: MlDsaParams> DigestVerifier<Shake256, Signature<P>> for VerifyingKey<P>

fn verify_digest<F: Fn(&mut Shake256) -> Result<(), Error>>( &self, f: F, signature: &Signature<P>, ) -> Result<(), Error>

Verify the signature against the received Digest output, by updating it with the message.

impl<P: MlDsaParams> MultipartSigner<Signature<P>> for KeyPair<P>

The Signer implementation for KeyPair uses the optional deterministic variant of ML-DSA, and only supports signing with an empty context string.

fn try_multipart_sign(&self, msg: &[&[u8]]) -> Result<Signature<P>, Error>

Equivalent of Signer::try_sign() but the message is provided in non-contiguous byte slices.

fn multipart_sign(&self, msg: &[&[u8]]) -> S

Equivalent of Signer::sign() but the message is provided in non-contiguous byte slices.

impl<P: MlDsaParams> MultipartSigner<Signature<P>> for SigningKey<P>

The Signer implementation for SigningKey uses the optional deterministic variant of ML-DSA, and only supports signing with an empty context string. If you would like to include a context string, use the SigningKey::sign_deterministic method.

fn try_multipart_sign(&self, msg: &[&[u8]]) -> Result<Signature<P>, Error>

Equivalent of Signer::try_sign() but the message is provided in non-contiguous byte slices.

fn multipart_sign(&self, msg: &[&[u8]]) -> S

Equivalent of Signer::sign() but the message is provided in non-contiguous byte slices.

impl<P: MlDsaParams> MultipartVerifier<Signature<P>> for VerifyingKey<P>

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

Equivalent of Verifier::verify() but the message is provided in non-contiguous byte slices.

impl<P: PartialEq + MlDsaParams> PartialEq for Signature<P>

where P::Lambda: PartialEq, P::L: PartialEq,

fn eq(&self, other: &Signature<P>) -> bool

Tests for self and other values to be equal, and is used by ==.

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

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

impl<P: MlDsaParams> RandomizedDigestSigner<Shake256, Signature<P>> for SigningKey<P>

Available on crate feature rand_core only.

The RandomizedSigner implementation for SigningKey only supports signing with an empty context string. If you would like to include a context string, use the SigningKey::sign_mu_randomized method.

fn try_sign_digest_with_rng<R: TryCryptoRng + ?Sized, F: Fn(&mut Shake256) -> Result<(), Error>>( &self, rng: &mut R, f: F, ) -> Result<Signature<P>, Error>

Attempt to sign a message by updating the received Digest with it, returning a digital signature on success, or an error if something went wrong.

fn sign_digest_with_rng<R, F>(&self, rng: &mut R, f: F) -> S

where R: CryptoRng + ?Sized, F: Fn(&mut D),

Sign a message by updating the received Digest with it, returning a signature.

impl<P: MlDsaParams> RandomizedMultipartSigner<Signature<P>> for SigningKey<P>

Available on crate feature rand_core only.

The RandomizedSigner implementation for SigningKey only supports signing with an empty context string. If you would like to include a context string, use the SigningKey::sign_randomized method.

fn try_multipart_sign_with_rng<R: TryCryptoRng + ?Sized>( &self, rng: &mut R, msg: &[&[u8]], ) -> Result<Signature<P>, Error>

Equivalent of RandomizedSigner::try_sign_with_rng() but the message is provided in non-contiguous byte slices.

fn multipart_sign_with_rng<R>(&self, rng: &mut R, msg: &[&[u8]]) -> S

where R: CryptoRng + ?Sized,

Equivalent of RandomizedSigner::sign_with_rng() but the message is provided in non-contiguous byte slices.

impl<P: MlDsaParams> RandomizedSigner<Signature<P>> for SigningKey<P>

Available on crate feature rand_core only.

The RandomizedSigner implementation for SigningKey only supports signing with an empty context string. If you would like to include a context string, use the SigningKey::sign_randomized method.

fn try_sign_with_rng<R: TryCryptoRng + ?Sized>( &self, rng: &mut R, msg: &[u8], ) -> Result<Signature<P>, Error>

Attempt to sign the given message, returning a digital signature on success, or an error if something went wrong.

fn sign_with_rng<R>(&self, rng: &mut R, msg: &[u8]) -> S

where R: CryptoRng + ?Sized,

Sign the given message and return a digital signature

impl<P: MlDsaParams> SignatureBitStringEncoding for Signature<P>

Available on crate features pkcs8 and alloc only.

fn to_bitstring(&self) -> Result<BitString>

BitString encoding for this signature.

impl<P: MlDsaParams> SignatureEncoding for Signature<P>

type Repr = Array<u8, <P as SignatureParams>::SignatureSize>

Byte representation of a signature.

fn to_bytes(&self) -> Self::Repr

Encode signature as its byte representation.

fn encoded_len(&self) -> usize

Get the length of this signature when encoded.

impl<P: MlDsaParams> Signer<Signature<P>> for KeyPair<P>

The Signer implementation for KeyPair uses the optional deterministic variant of ML-DSA, and only supports signing with an empty context string.

fn try_sign(&self, msg: &[u8]) -> Result<Signature<P>, Error>

Attempt to sign the given message, returning a digital signature on success, or an error if something went wrong.

fn sign(&self, msg: &[u8]) -> S

Sign the given message and return a digital signature

impl<P: MlDsaParams> Signer<Signature<P>> for SigningKey<P>

The Signer implementation for SigningKey uses the optional deterministic variant of ML-DSA, and only supports signing with an empty context string. If you would like to include a context string, use the SigningKey::sign_deterministic method.

fn try_sign(&self, msg: &[u8]) -> Result<Signature<P>, Error>

Attempt to sign the given message, returning a digital signature on success, or an error if something went wrong.

fn sign(&self, msg: &[u8]) -> S

Sign the given message and return a digital signature

impl<'a, P: MlDsaParams> TryFrom<&'a [u8]> for Signature<P>

type Error = Error

The type returned in the event of a conversion error.

fn try_from(value: &'a [u8]) -> Result<Self, Self::Error>

Performs the conversion.

impl<P: MlDsaParams> TryInto<Array<u8, <P as SignatureParams>::SignatureSize>> for Signature<P>

type Error = Error

The type returned in the event of a conversion error.

fn try_into(self) -> Result<EncodedSignature<P>, Self::Error>

Performs the conversion.

impl<P: MlDsaParams> Verifier<Signature<P>> for VerifyingKey<P>

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

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

impl<P: MlDsaParams> StructuralPartialEq for Signature<P>