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: 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> 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] method.

fn try_sign_with_rng( &self, rng: &mut impl CryptoRngCore, 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(&self, rng: &mut impl CryptoRngCore, msg: &[u8]) -> S

Sign the given message and return a digital signature

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

Available on crate feature 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>