Struct DilithiumSecretKey 

pub struct DilithiumSecretKey { /* private fields */ }

ML-DSA expanded private key encoded with FIPS 204 Algorithm 24 (skEncode).

In particular, bytes 64..128 contain the complete 64-byte tr = H(pk, 64) value. Bare bytes do not carry a format version, so use paired import or external provenance/framing when distinguishing affected legacy objects.

Implementations

impl DilithiumSecretKey

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

Decode a syntactically valid final-FIPS-204 expanded private key.

An expanded private-key encoding does not carry enough information for this backend to derive and validate its public key without reintroducing a second secret-arithmetic implementation. Use Self::from_bytes_with_public_key when the corresponding public key is available. A key decoded with this method can sign, but Self::public_key returns an error instead of guessing or panicking.

pub fn from_bytes_with_public_key( bytes: &[u8], public_key: &DilithiumPublicKey, ) -> Result<Self, SignError>

Decode an expanded private key and validate it against its public key.

Besides the exact FIPS 204 encodings, this checks the stored 64-byte tr, then performs a deterministic sign/verify coherence check through the libcrux backend. This is the preferred import API.

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

Return the exact FIPS 204 expanded private-key encoding.

pub fn public_key(&self) -> Result<DilithiumPublicKey, SignError>

Return the public key retained at generation or paired import time.

Trait Implementations

impl AsRef<[u8]> for DilithiumSecretKey

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

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

impl Clone for DilithiumSecretKey

fn clone(&self) -> DilithiumSecretKey

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DilithiumSecretKey

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

Formats the value using the given formatter.

impl Drop for DilithiumSecretKey

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.

impl Zeroize for DilithiumSecretKey

fn zeroize(&mut self)

Zero out this object from memory using Rust intrinsics which ensure the zeroization operation is not “optimized away” by the compiler.