Enum MLDSAPublicKey 

pub enum MLDSAPublicKey {
    MLDSA44(Box<PublicKey>),
    MLDSA65(Box<PublicKey>),
    MLDSA87(Box<PublicKey>),
}

A public key for the ML-DSA post-quantum digital signature algorithm.

MLDSAPublicKey represents a public key that can be used to verify digital signatures created with the ML-DSA (Module Lattice-based Digital Signature Algorithm) post-quantum algorithm. It supports multiple security levels through the variants:

• MLDSA44: NIST security level 2 (roughly equivalent to AES-128)
• MLDSA65: NIST security level 3 (roughly equivalent to AES-192)
• MLDSA87: NIST security level 5 (roughly equivalent to AES-256)

Examples

use bc_components::MLDSA;

// Generate a keypair
let (private_key, public_key) = MLDSA::MLDSA44.keypair();

// Sign a message
let message = b"Hello, post-quantum world!";
let signature = private_key.sign(message);

// Verify the signature
assert!(public_key.verify(&signature, message).unwrap());

Variants

MLDSA44(Box<PublicKey>)

An ML-DSA44 public key (NIST security level 2)

MLDSA65(Box<PublicKey>)

An ML-DSA65 public key (NIST security level 3)

MLDSA87(Box<PublicKey>)

An ML-DSA87 public key (NIST security level 5)

Implementations

impl MLDSAPublicKey

pub fn verify( &self, signature: &MLDSASignature, message: impl AsRef<[u8]>, ) -> Result<bool>

Verifies an ML-DSA signature for a message using this public key.

Parameters

• signature - The signature to verify.
• message - The message that was signed.

Returns

Ok(true) if the signature is valid for the message and this public key, Ok(false) if the signature is invalid, or an error if the security levels of the signature and public key don’t match.

Errors

Returns an error if the security level of the signature doesn’t match the security level of this public key.

Examples

use bc_components::MLDSA;

let (private_key, public_key) = MLDSA::MLDSA44.keypair();
let message = b"Hello, world!";
let signature = private_key.sign(message);

assert!(public_key.verify(&signature, message).unwrap());

pub fn level(&self) -> MLDSA

Returns the security level of this ML-DSA public key.

pub fn size(&self) -> usize

Returns the size of this ML-DSA public key in bytes.

pub fn as_bytes(&self) -> &[u8]

Returns the raw bytes of this ML-DSA public key.

pub fn from_bytes(level: MLDSA, bytes: &[u8]) -> Result<Self>

Creates an ML-DSA public key from raw bytes and a security level.

Parameters

• level - The security level of the key.
• bytes - The raw bytes of the key.

Returns

An MLDSAPublicKey if the bytes represent a valid key for the given level, or an error otherwise.

Errors

Returns an error if the bytes do not represent a valid ML-DSA public key for the specified security level.

Trait Implementations

impl AsRef<[u8]> for MLDSAPublicKey

fn as_ref(&self) -> &[u8]

Returns the public key as a byte slice.

impl CBORTagged for MLDSAPublicKey

Defines CBOR tags for ML-DSA public keys.

fn cbor_tags() -> Vec<Tag>

Returns the CBOR tag for ML-DSA public keys.

impl CBORTaggedDecodable for MLDSAPublicKey

Implements CBOR decoding for ML-DSA public keys.

fn from_untagged_cbor(untagged_cbor: CBOR) -> Result<Self>

Creates an MLDSAPublicKey from untagged CBOR.

Errors

Returns an error if the CBOR value doesn’t represent a valid ML-DSA public key.

fn from_tagged_cbor(cbor: CBOR) -> Result<Self, Error>

where Self: Sized,

Creates an instance of this type by decoding it from tagged CBOR.

fn from_tagged_cbor_data(data: impl AsRef<[u8]>) -> Result<Self, Error>

where Self: Sized,

Creates an instance of this type by decoding it from binary encoded tagged CBOR.

fn from_untagged_cbor_data(data: impl AsRef<[u8]>) -> Result<Self, Error>

where Self: Sized,

Creates an instance of this type by decoding it from binary encoded untagged CBOR.

impl CBORTaggedEncodable for MLDSAPublicKey

Implements CBOR encoding for ML-DSA public keys.

fn untagged_cbor(&self) -> CBOR

Creates the untagged CBOR representation as an array with level and key bytes.

fn tagged_cbor(&self) -> CBOR

Returns the tagged CBOR encoding of this instance.

fn tagged_cbor_data(&self) -> Vec<u8>

Returns the tagged value in CBOR binary representation.

impl Clone for MLDSAPublicKey

fn clone(&self) -> MLDSAPublicKey

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for MLDSAPublicKey

Provides debug formatting for ML-DSA public keys.

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

Formats the public key as a string for debugging purposes.

impl From<MLDSAPublicKey> for CBOR

Converts an MLDSAPublicKey to CBOR.

fn from(value: MLDSAPublicKey) -> Self

Converts to tagged CBOR.

impl Hash for MLDSAPublicKey

Implements hashing for ML-DSA public keys.

fn hash<H: Hasher>(&self, state: &mut H)

Hashes both the security level and the raw bytes of the public key.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for MLDSAPublicKey

Implements equality comparison for ML-DSA public keys.

fn eq(&self, other: &Self) -> bool

Compares two ML-DSA public keys for equality.

Two ML-DSA public keys are equal if they have the same security level and the same raw byte representation.

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 TryFrom<CBOR> for MLDSAPublicKey

Attempts to convert CBOR to an MLDSAPublicKey.

fn try_from(cbor: CBOR) -> Result<Self>

Converts from tagged CBOR.

type Error = Error

The type returned in the event of a conversion error.

impl Eq for MLDSAPublicKey