Trait MLDSAPublicKeyTrait 

pub trait MLDSAPublicKeyTrait<const k: usize, const PK_LEN: usize>: SignaturePublicKey {
    // Required methods
    fn pk_encode(&self) -> [u8; PK_LEN];
    fn pk_decode(pk: &[u8; PK_LEN]) -> Self;
    fn compute_tr(&self) -> [u8; 64];
}

General trait for all ML-DSA public keys types.

Required Methods

fn pk_encode(&self) -> [u8; PK_LEN]

Algorithm 22 pkEncode(𝜌, 𝐭1) Encodes a public key for ML-DSA into a byte string. Input:𝜌 ∈ 𝔹32, 𝐭1 ∈ 𝑅𝑘 with coefficients in [0, 2bitlen (𝑞−1)−𝑑 − 1]. Output: Public key 𝑝𝑘 ∈ 𝔹32+32𝑘(bitlen (𝑞−1)−𝑑).

fn pk_decode(pk: &[u8; PK_LEN]) -> Self

Algorithm 23 pkDecode(𝑝𝑘) Reverses the procedure pkEncode. Input: Public key 𝑝𝑘 ∈ 𝔹32+32𝑘(bitlen (𝑞−1)−𝑑). Output: 𝜌 ∈ 𝔹32, 𝐭1 ∈ 𝑅𝑘 with coefficients in [0, 2bitlen (𝑞−1)−𝑑 − 1].

fn compute_tr(&self) -> [u8; 64]

Compute the public key hash (tr) from the public key.

This is exposed as a public API for a few reasons:

1. tr is required for some external-prehashing schemes such as the so-called “external mu” signing mode.
2. tr is the canonical fingerprint of an ML-DSA public key, so would be an appropriate value to use, for example, to build a public key lookup or deny-listing table.

Dyn Compatibility

This trait is not dyn compatible.

In older versions of Rust, dyn compatibility was called "object safety", so this trait is not object safe.

Implementors

impl<const k: usize, const PK_LEN: usize> MLDSAPublicKeyTrait<k, PK_LEN> for MLDSAPublicKey<k, PK_LEN>