phantom-protocol 0.2.0

Post-quantum-secure L4/L6 universal transport framework — hybrid X25519+ML-KEM-768 / Ed25519+ML-DSA-65, multi-path, UniFFI bindings
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

//! Transport Legs Module
//!
//! Pluggable physical transports. The browser `wasm32` target exposes a
//! WebSocket leg (Phase 3.3) since browsers cannot open raw TCP/UDP sockets;
//! WASI Preview 2 uses a TCP leg; bare-metal uses the `embedded` leg.
//!
//! The native KCP / TCP / FakeTLS legs and the `TransportLeg` multipath trait
//! were removed in Phase 0 of the PhantomUDP rewrite — they were never wired
//! into the session data plane (`PhantomSession` consumes `SessionTransport`,
//! not `TransportLeg`) and are superseded by the forthcoming native
//! reliable-UDP transport. FakeTLS-style traffic mimicry will return as a
//! dedicated transport mode.

#[cfg(all(feature = "std", target_arch = "wasm32", target_os = "unknown"))]
pub mod websocket;

#[cfg(all(feature = "std", target_arch = "wasm32", target_os = "unknown"))]
pub use websocket::WebSocketLeg;

// Section B / B3 — WASI Preview 2 TCP leg. Same `cfg` gate as
// `runtime::wasi_runtime`: only built when the `wasi-leg` feature is
// active AND the build target is a WASI triple (`cfg(target_os = "wasi")`).
// Mutual exclusion with `wasm32-unknown-unknown` is enforced in
// `core/src/lib.rs`.
#[cfg(all(feature = "wasi-leg", target_os = "wasi"))]
pub mod wasi;

#[cfg(all(feature = "wasi-leg", target_os = "wasi"))]
pub use wasi::WasiLeg;

// `EmbeddedLeg` — `SessionTransport` over `embedded-io-async` byte streams,
// behind the `embedded` feature. Compiles on any target (host included) so the
// tests run there. Phase 3.4. no_std-clean, so it is NOT gated behind `std`.
#[cfg(feature = "embedded")]
pub mod embedded;

// `MimicTlsLeg` — TLS-over-TCP active-mimicry `SessionTransport` (queue item #13).
// Native-only (rides `tokio::net`), behind the off-by-default `mimicry` feature.
// PR-1 lands the record layer (`mimic_tls::record`); the handshake theater and the
// leg itself follow in later PRs. The outer TLS is anti-DPI obfuscation ONLY and is
// detectable by active probing — see the module head.
#[cfg(all(feature = "mimicry", not(target_arch = "wasm32")))]
pub mod mimic_tls;