vcl-protocol 1.5.0

Cryptographically chained packet transport with QUIC, cross-platform TUN, and bug fixes
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

//! # VCL Protocol
//!
//! Cryptographically chained packet transport protocol with:
//! - SHA-256 integrity chain
//! - Ed25519 digital signatures
//! - X25519 ephemeral key exchange
//! - XChaCha20-Poly1305 authenticated encryption
//! - Replay protection
//! - Connection events, ping/heartbeat, mid-session key rotation
//! - Connection pool for managing multiple peers
//!
//! ## Quick Start
//!
//! ```no_run
//! use vcl_protocol::connection::VCLConnection;
//!
//! #[tokio::main]
//! async fn main() {
//!     let mut server = VCLConnection::bind("127.0.0.1:8080").await.unwrap();
//!     server.accept_handshake().await.unwrap();
//!
//!     let packet = server.recv().await.unwrap();
//!     println!("Received: {}", String::from_utf8_lossy(&packet.payload));
//! }
//! ```

pub mod error;
pub mod event;
pub mod packet;
pub mod crypto;
pub mod connection;
pub mod handshake;
pub mod pool;
pub mod config;
pub mod transport;
pub mod fragment;
pub mod flow;
pub mod metrics;
pub mod tun_device;
pub mod ip_packet;
pub mod multipath;
pub mod mtu;
pub mod keepalive;
pub mod reconnect;
pub mod dns;
pub mod obfuscation;
pub mod tunnel;
pub mod prometheus_metrics;

// Post-Quantum module is optional and only compiled when the "pq" feature is enabled
#[cfg(feature = "pq")]
pub mod pq_crypto;

pub use error::VCLError;
pub use event::VCLEvent;
pub use pool::VCLPool;
pub use config::VCLConfig;
pub use transport::VCLTransport;
pub use fragment::{Fragmenter, Reassembler, Fragment};
pub use flow::FlowController;
pub use metrics::VCLMetrics;
pub use tun_device::{VCLTun, TunConfig, IpPacket, IpVersion};
pub use ip_packet::{ParsedPacket, TransportProtocol};
pub use multipath::{MultipathSender, MultipathReceiver, PathInfo, SchedulingPolicy};
pub use mtu::{MtuNegotiator, MtuConfig, PathMtu, MtuState};
pub use keepalive::{KeepaliveManager, KeepaliveConfig, KeepaliveAction, KeepalivePreset};
pub use reconnect::{ReconnectManager, ReconnectConfig, ReconnectState};
pub use dns::{DnsFilter, DnsConfig, DnsAction, DnsPacket};
pub use obfuscation::{Obfuscator, ObfuscationConfig, ObfuscationMode};
pub use tunnel::{VCLTunnel, TunnelConfig, TunnelState, TunnelStats};
pub use prometheus_metrics::VCLPrometheusExporter;

// Export PQ types only if the feature is enabled
#[cfg(feature = "pq")]
pub use pq_crypto::{PqKeyPair, PqHandshake, PqPublicBundle, PqServerResponse};