Module dilithium 

Post-Quantum Signatures with CRYSTALS-Dilithium.

This module implements CRYSTALS-Dilithium, a NIST-standardized post-quantum digital signature scheme designed to be secure against attacks by quantum computers.

Security Levels

• Dilithium2: Security level 2 (AES-128 equivalent)
• Dilithium3: Security level 3 (AES-192 equivalent) - Recommended
• Dilithium5: Security level 5 (AES-256 equivalent)

Use Cases for CHIE Protocol

• Future-proof digital signatures resistant to quantum attacks
• Long-term secure content signing and verification
• Migration path from Ed25519 to post-quantum signatures
• Hybrid signatures during transition period

Example

use chie_crypto::dilithium::*;

// Generate a keypair
let (pk, sk) = Dilithium3::keypair();

// Sign a message
let message = b"Important content hash";
let signature = Dilithium3::sign(message, &sk);

// Verify the signature
assert!(Dilithium3::verify(message, &signature, &pk).is_ok());

// Invalid message should fail verification
let wrong_message = b"Different content";
assert!(Dilithium3::verify(wrong_message, &signature, &pk).is_err());

Structs

Dilithium2

Dilithium2 - Security level 2 (AES-128 equivalent).

Dilithium3

Dilithium3 - Security level 3 (AES-192 equivalent) - Recommended.

Dilithium5

Dilithium5 - Security level 5 (AES-256 equivalent).

Dilithium2PublicKey

Dilithium2 public key (security level 2).

Dilithium2SecretKey

Dilithium2 secret key (security level 2).

Dilithium2Signature

Dilithium2 signature.

Dilithium3PublicKey

Dilithium3 public key (security level 3) - Recommended.

Dilithium3SecretKey

Dilithium3 secret key (security level 3) - Recommended.

Dilithium3Signature

Dilithium3 signature.

Dilithium5PublicKey

Dilithium5 public key (security level 5).

Dilithium5SecretKey

Dilithium5 secret key (security level 5).

Dilithium5Signature

Dilithium5 signature.

Enums

DilithiumError

Errors that can occur during Dilithium operations.

Type Aliases

DilithiumResult

Result type for Dilithium operations.