Struct FnDsaKeyPair 

pub struct FnDsaKeyPair { /* private fields */ }

An FN-DSA key pair (private key + public key).

Use logn = 9 for FN-DSA-512 (NIST Level I) or logn = 10 for FN-DSA-1024 (NIST Level V).

The private key bytes are automatically zeroized on drop.

Note: Clone duplicates private key material in memory. Only clone when you need multiple owners; prefer references otherwise.

Implementations

impl FnDsaKeyPair

pub fn generate(logn: u32) -> Result<Self, FalconError>

Generate a new FN-DSA key pair using OS entropy.

• logn — 9 for FN-DSA-512, 10 for FN-DSA-1024.

pub fn generate_deterministic( seed: &[u8], logn: u32, ) -> Result<Self, FalconError>

Generate a key pair deterministically from seed.

pub fn from_keys(privkey: &[u8], pubkey: &[u8]) -> Result<Self, FalconError>

Reconstruct from previously exported private + public key bytes.

pub fn from_private_key(privkey: &[u8]) -> Result<Self, FalconError>

Reconstruct from a private key only (public key is recomputed).

pub fn public_key_from_private(privkey: &[u8]) -> Result<Vec<u8>, FalconError>

Compute the public key bytes from a private key without creating a key pair.

pub fn sign( &self, message: &[u8], domain: &DomainSeparation<'_>, ) -> Result<FnDsaSignature, FalconError>

Sign message using FIPS 206 domain separation.

Supports both pure FN-DSA (DomainSeparation::None / DomainSeparation::Context) and HashFN-DSA (DomainSeparation::Prehashed).

Errors

• FalconError::BadArgument — context string > 255 bytes.
• FalconError::RandomError — OS RNG unavailable.

pub fn sign_deterministic( &self, message: &[u8], seed: &[u8], domain: &DomainSeparation<'_>, ) -> Result<FnDsaSignature, FalconError>

Sign with a deterministic seed (testing / reproducibility).

The same (key, message, seed, domain) tuple always produces the same signature.

Errors

• FalconError::BadArgument — context string > 255 bytes.

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

Get the encoded public key bytes.

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

Get the encoded private key bytes.

⚠️ Secret material — handle with care.

pub fn logn(&self) -> u32

Get the FN-DSA degree parameter.

Returns 9 for FN-DSA-512, 10 for FN-DSA-1024.

pub fn variant_name(&self) -> &'static str

Get the security variant name.

impl FnDsaKeyPair

pub fn expand(&self) -> Result<FnDsaExpandedKey, FalconError>

Expand the private key into a precomputed signing tree.

The resulting FnDsaExpandedKey is ~1.5× faster per sign operation at the cost of a one-time expansion (~2.5× a single sign).

Trait Implementations

impl Clone for FnDsaKeyPair

fn clone(&self) -> FnDsaKeyPair

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for FnDsaKeyPair

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

Formats the value using the given formatter.