qssl 0.2.0

Pure Rust post-quantum TLS — zero C code. ML-KEM, ML-DSA, SLH-DSA, Falcon. FIPS 203/204/205/206 compliant. 100 Lean 4 theorems.
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
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92

//! QSSL - Quantum-Safe Secure Layer
//!
//! A modern, quantum-resistant replacement for TLS/SSL built in Rust.
//!
//! QSSL provides:
//! - Post-quantum key exchange (Kyber)
//! - Post-quantum signatures (Falcon, Dilithium, SPHINCS+)
//! - Memory-safe implementation
//! - Zero-RTT resumption
//! - WebAssembly support

#![cfg_attr(not(feature = "std"), no_std)]

// Core modules
pub mod core;
pub mod crypto;
pub mod transport;
pub mod session;
pub mod integrations;

// TRUE Quantum-Native Protocol (not just TLS with PQC)
pub mod quantum_native;

// FFI for C bindings
// #[cfg(feature = "std")]
// pub mod ffi; // TODO: Implement FFI module

// Re-exports
pub use core::{
    QsslConnection, QsslContext, QsslError, QsslResult,
    HandshakeState, ConnectionRole, ProtocolVersion,
};

pub use crypto::{
    CipherSuite, KemAlgorithm, SignatureAlgorithm,
    SymmetricCipher, HashAlgorithm,
};

pub use transport::{QsslTransport, QsslRecord};
pub use session::{QsslSession, SessionCache};

// Version information
pub const QSSL_VERSION: &str = "0.1.0-alpha";
pub const QSSL_PROTOCOL_VERSION: u16 = 0x5110;  // 'Q' (0x51) + version 1.0 (0x10)

// Default configuration
pub const DEFAULT_CIPHER_SUITE: CipherSuite = CipherSuite::SphincsKemFalcon512Aes256;
pub const MAX_RECORD_SIZE: usize = 16384;
pub const MAX_HANDSHAKE_SIZE: usize = 65536;

/// Initialize QSSL library
pub fn init() -> QsslResult<()> {
    // Initialize crypto providers
    crypto::init()?;

    // Set up logging
    #[cfg(feature = "std")]
    {
        use tracing_subscriber::{fmt, EnvFilter};
        let _ = fmt()
            .with_env_filter(EnvFilter::from_default_env())
            .try_init();
    }

    Ok(())
}

/// Get QSSL version string
pub fn version() -> &'static str {
    QSSL_VERSION
}

/// Get protocol version
pub fn protocol_version() -> u16 {
    QSSL_PROTOCOL_VERSION
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn test_version() {
        assert_eq!(version(), "0.1.0-alpha");
        assert_eq!(protocol_version(), 0x5110);
    }

    #[test]
    fn test_init() {
        assert!(init().is_ok());
    }
}