qudag-crypto 0.5.1

Quantum-resistant cryptography library for QuDAG - includes ML-KEM-768, ML-DSA, HQC, and BLAKE3
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55

//! ML-DSA (Dilithium) digital signature implementation.

use thiserror::Error;

/// Errors that can occur during signature operations.
#[derive(Debug, Error)]
pub enum SignatureError {
    /// Invalid public key format
    #[error("Invalid public key format")]
    InvalidPublicKey,

    /// Invalid secret key format
    #[error("Invalid secret key format")]
    InvalidSecretKey,

    /// Invalid signature format
    #[error("Invalid signature format")]
    InvalidSignature,

    /// Signature verification failed
    #[error("Signature verification failed")]
    VerificationFailed,

    /// Key generation failed
    #[error("Key generation failed")]
    KeyGenerationFailed,
}

/// ML-DSA public key.
#[derive(Debug, Clone)]
pub struct PublicKey(#[allow(dead_code)] Vec<u8>);

/// ML-DSA secret key.
#[derive(Debug, Clone)]
pub struct SecretKey(#[allow(dead_code)] Vec<u8>);

/// ML-DSA signature.
#[derive(Debug, Clone)]
pub struct Signature(#[allow(dead_code)] Vec<u8>);

/// ML-DSA digital signature trait.
pub trait DigitalSignature {
    /// Generate a new key pair.
    fn keygen() -> Result<(PublicKey, SecretKey), SignatureError>;

    /// Sign a message using a secret key.
    fn sign(secret_key: &SecretKey, message: &[u8]) -> Result<Signature, SignatureError>;

    /// Verify a signature using a public key and message.
    fn verify(
        public_key: &PublicKey,
        message: &[u8],
        signature: &Signature,
    ) -> Result<bool, SignatureError>;
}