7ceaf9a40e
* Add mixtcp crate
Components:
- NymIprDevice: smoltcp::phy::Device impl using channel-based I/O
- NymIprBridge: async task bridging the device to IpMixStream
- create_device(): helper to set up the complete stack
* - Cleanup
- Add graceful shutdown
- Declutter logging - move a lot of bridge info! -> trace!
- Move rustls, nym-bin-common, bytes to dev-dependencies
- Extract TlsOverTcp to mod.rs
- Make timing more granular
- Update readme
* Add UDP example
* Add UDP example to readme
* rename mixtcp -> smolmix
* Add Tunnel API with TcpStream and UdpSocket over tokio-smoltcp
* Re-export Tunnel API and add init_logging convenience function
* Remove raw smoltcp path, flatten tunnel module
* Clean up bridge, device, and tunnel code
* Consolidate architecture docs, tidy examples and README
- Add src/ARCHITECTURE.md as single source of truth for architecture
- Include in docs.rs via doc = include_str!
- Strip duplicated diagrams from tunnel.rs, device.rs, README
- Extract tls_connector() helper in HTTPS example to match websocket example
- Use consistent 'smolmix' casing in README
* Update smolmix imports for ipr_wrapper API
- stream_wrapper::{IpMixStream, NetworkEnvironment} → ipr_wrapper::
- connect_tunnel() → check_connected()
- disconnect_stream() → disconnect()
- allocated_ips() returns &IpPair directly (no Option)
* Add Tunnel::new_with_ipr, re-export IpPair/Recipient, tidy examples
- Add Tunnel::new_with_ipr() for targeting a specific exit node
- Re-export IpPair and Recipient so users don't need direct deps
- Add DNS leak warning to WebSocket example
- Await hyper connection task in HTTPS example
* Restructure smolmix into multi-crate workspace
- Move core tunnel code to smolmix/core/- Rewrite examples for each crate with clearnet/mixnet comparisons
* Add workspace README with architecture overview
* Update nym-sdk README module descriptions
- Replace stale stream_wrapper description with ipr_wrapper + mixnet::stream
- Remove TODO comment
* Remove companion crates, scope to smolmix-core
* Comment out additional components on -core branch README.md
* Cargo.lock fix for compilation issue
* Downgrade accidentally bumped dependencies in Cargo lock + change
smolmix dependencies to import from workspace
* Fix workspace deps + move nym-bin-common to dev-deps
* PR review changes + fix Sink delegation
* Fix borked merge + update README.md
* Fix up stale docs + rewrite examples to use proper imports and timing
logs
* Update readmes + architecture file
* Impl Drop for BridgeShutdownHandle + update comment
144 lines
5.2 KiB
Rust
144 lines
5.2 KiB
Rust
//! WebSocket echo over the Nym mixnet.
|
|
//!
|
|
//! Demonstrates stacking tokio-tungstenite on top of tokio-rustls on top of
|
|
//! smolmix TcpStream. Sends a message to a public echo server via clearnet
|
|
//! and via the mixnet, then compares responses and timing.
|
|
//!
|
|
//! The clearnet and mixnet paths use the *exact same* TLS + WebSocket stack —
|
|
//! only the underlying TCP transport differs:
|
|
//!
|
|
//! ```text
|
|
//! tokio-tungstenite (WebSocket framing)
|
|
//! └─ tokio-rustls (TLS encryption)
|
|
//! └─ tokio::net::TcpStream (clearnet)
|
|
//! └─ smolmix::TcpStream (mixnet)
|
|
//! ```
|
|
//!
|
|
//! Run with:
|
|
//! cargo run -p smolmix --example websocket
|
|
//! cargo run -p smolmix --example websocket -- --ipr <IPR_ADDRESS>
|
|
|
|
use std::sync::Arc;
|
|
|
|
use futures::{SinkExt, StreamExt};
|
|
use rustls::pki_types::ServerName;
|
|
use smolmix::Tunnel;
|
|
use tokio_tungstenite::tungstenite::Message;
|
|
use tracing::info;
|
|
|
|
type BoxError = Box<dyn std::error::Error + Send + Sync>;
|
|
|
|
const WS_HOST: &str = "ws.postman-echo.com";
|
|
const WS_PATH: &str = "/raw";
|
|
const ECHO_MSG: &str = "Hello from the Nym mixnet!";
|
|
|
|
fn tls_connector() -> tokio_rustls::TlsConnector {
|
|
let mut root_store = rustls::RootCertStore::empty();
|
|
root_store.extend(webpki_roots::TLS_SERVER_ROOTS.iter().cloned());
|
|
let config = rustls::ClientConfig::builder()
|
|
.with_root_certificates(root_store)
|
|
.with_no_client_auth();
|
|
tokio_rustls::TlsConnector::from(Arc::new(config))
|
|
}
|
|
|
|
#[tokio::main]
|
|
async fn main() -> Result<(), BoxError> {
|
|
nym_bin_common::logging::setup_tracing_logger();
|
|
rustls::crypto::ring::default_provider()
|
|
.install_default()
|
|
.expect("Failed to install rustls crypto provider");
|
|
|
|
// Resolve hostname via clearnet DNS - you can resolve via the Mixnet (see UDP example) but for this test its not necessary
|
|
let addr = tokio::net::lookup_host(format!("{WS_HOST}:443"))
|
|
.await?
|
|
.next()
|
|
.ok_or("DNS resolution failed")?;
|
|
info!("Resolved {WS_HOST} -> {addr}");
|
|
|
|
let connector = tls_connector();
|
|
let domain = ServerName::try_from(WS_HOST)?.to_owned();
|
|
|
|
// Clearnet baseline: tokio TCP -> rustls -> tungstenite
|
|
info!("Connecting via clearnet...");
|
|
let clearnet_start = tokio::time::Instant::now();
|
|
|
|
let clearnet_tcp = tokio::net::TcpStream::connect(addr).await?;
|
|
let clearnet_tls = connector.connect(domain.clone(), clearnet_tcp).await?;
|
|
let (mut clearnet_ws, _) =
|
|
tokio_tungstenite::client_async(format!("wss://{WS_HOST}{WS_PATH}"), clearnet_tls).await?;
|
|
|
|
clearnet_ws.send(Message::Text(ECHO_MSG.into())).await?;
|
|
let clearnet_reply = clearnet_ws.next().await.ok_or("no clearnet reply")??;
|
|
let clearnet_duration = clearnet_start.elapsed();
|
|
let clearnet_text = clearnet_reply.into_text()?;
|
|
clearnet_ws.close(None).await?;
|
|
|
|
info!("Clearnet: \"{clearnet_text}\" in {clearnet_duration:?}");
|
|
|
|
// Mixnet: smolmix TCP -> rustls -> tungstenite (same stack)
|
|
let args: Vec<String> = std::env::args().collect();
|
|
let ipr_addr = args
|
|
.iter()
|
|
.position(|a| a == "--ipr")
|
|
.and_then(|i| args.get(i + 1));
|
|
|
|
let mut builder = Tunnel::builder();
|
|
if let Some(addr) = ipr_addr {
|
|
builder = builder.ipr_address(addr.parse().expect("invalid IPR address"));
|
|
}
|
|
let tunnel = builder.build().await?;
|
|
info!("Allocated IP: {}", tunnel.allocated_ips().ipv4);
|
|
|
|
// Phase 1: Setup (TCP + TLS + WebSocket handshakes)
|
|
let setup_start = tokio::time::Instant::now();
|
|
|
|
info!("TCP connecting via mixnet...");
|
|
let mixnet_tcp = tunnel.tcp_connect(addr).await?;
|
|
info!("TCP connected ({:?})", setup_start.elapsed());
|
|
|
|
info!("TLS handshake...");
|
|
let mixnet_tls = connector.connect(domain, mixnet_tcp).await?;
|
|
info!("TLS established ({:?})", setup_start.elapsed());
|
|
|
|
info!("WebSocket upgrade...");
|
|
let (mut mixnet_ws, _) =
|
|
tokio_tungstenite::client_async(format!("wss://{WS_HOST}{WS_PATH}"), mixnet_tls).await?;
|
|
|
|
let setup_duration = setup_start.elapsed();
|
|
info!("Setup complete ({:?})", setup_duration);
|
|
|
|
// Phase 2: Echo request/response
|
|
let request_start = tokio::time::Instant::now();
|
|
|
|
mixnet_ws.send(Message::Text(ECHO_MSG.into())).await?;
|
|
let mixnet_reply = mixnet_ws.next().await.ok_or("no mixnet reply")??;
|
|
|
|
let request_duration = request_start.elapsed();
|
|
let mixnet_text = mixnet_reply.into_text()?;
|
|
mixnet_ws.close(None).await?;
|
|
|
|
info!("Echo: \"{mixnet_text}\" ({:?})", request_duration);
|
|
|
|
// Results
|
|
info!("Clearnet: \"{clearnet_text}\" in {clearnet_duration:?}");
|
|
info!(
|
|
"Mixnet: \"{mixnet_text}\" (setup {:?} + echo {:?} = {:?})",
|
|
setup_duration,
|
|
request_duration,
|
|
setup_duration + request_duration
|
|
);
|
|
info!("Clearnet echo match: {}", clearnet_text == ECHO_MSG);
|
|
info!("Mixnet echo match: {}", mixnet_text == ECHO_MSG);
|
|
|
|
let total = setup_duration + request_duration;
|
|
let slowdown = total.as_millis() as f64 / clearnet_duration.as_millis().max(1) as f64;
|
|
info!(
|
|
"Slowdown: {slowdown:.1}x (setup: {:.1}x, echo: {:.1}x)",
|
|
setup_duration.as_millis() as f64 / clearnet_duration.as_millis().max(1) as f64,
|
|
request_duration.as_millis() as f64 / clearnet_duration.as_millis().max(1) as f64
|
|
);
|
|
|
|
tunnel.shutdown().await;
|
|
Ok(())
|
|
}
|