Expand description
§stoffelnet - QUIC-Based P2P Networking for MPC
stoffelnet is a peer-to-peer networking library designed for secure Multi-Party
Computation (MPC) applications. It provides a transport-agnostic abstraction layer
with a concrete QUIC implementation, NAT traversal capabilities via ICE/STUN, and
actor model compatibility for safe concurrent access.
§Features
- QUIC Transport: High-performance, encrypted connections using the QUIC protocol
- NAT Traversal: ICE (RFC 8445) and STUN (RFC 5389) support for peer-to-peer connectivity through NATs
- Actor Model Compatible: All connection types use interior mutability (
Arc<Mutex<>>) for safe sharing across async tasks - Transport Agnostic: Core traits (
PeerConnection,NetworkManager) allow alternative transport implementations - FFI Bindings: C-compatible API for Python, Go, and other language integrations
§Quick Start
use stoffelnet::transports::quic::{QuicNetworkManager, QuicNetworkConfig, NetworkManager};
use std::net::SocketAddr;
#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
// Create a network manager with default configuration
let mut manager = QuicNetworkManager::new();
// Start listening for incoming connections
let bind_addr: SocketAddr = "127.0.0.1:5000".parse()?;
manager.listen(bind_addr).await?;
// Connect to a peer
let peer_addr: SocketAddr = "127.0.0.1:5001".parse()?;
let connection = manager.connect(peer_addr).await?;
// Send and receive data
connection.send(b"Hello, peer!").await?;
let response = connection.receive().await?;
Ok(())
}§Module Structure
transports: Transport implementations and utilitiestransports::quic: QUIC-based networking ([QuicNetworkManager], [QuicPeerConnection])transports::ice: ICE candidate types and pair formationtransports::ice_agent: ICE state machine for NAT traversaltransports::stun: STUN client for reflexive address discoverytransports::net_envelope: Wire protocol message format
network_utils: Core types and traits ([Network], [Node], [PartyId])ffi: C Foreign Function Interface for cross-language bindings
§NAT Traversal
For peer-to-peer connectivity through NAT, enable NAT traversal features:
use stoffelnet::transports::quic::{QuicNetworkManager, QuicNetworkConfig};
use std::net::SocketAddr;
// Configure with STUN servers (use resolved IP addresses)
let stun_server: SocketAddr = "74.125.250.129:19302".parse().unwrap();
let config = QuicNetworkConfig {
enable_nat_traversal: true,
stun_servers: vec![stun_server],
..Default::default()
};
let manager = QuicNetworkManager::with_config(config);§Key Types
PeerConnection: Trait for point-to-point peer communicationNetworkManager: Trait for connection lifecycle managementnetwork_utils::Network: High-level network abstraction for MPC protocolstransports::quic::QuicNetworkManager: QUIC implementation of network managementtransports::ice_agent::IceAgent: ICE state machine for NAT traversal
Modules§
- ffi
- C Foreign Function Interface (FFI) for stoffel-networking
- network_
utils - transports
Traits§
- Network
Manager - Manages network connections.
- Peer
Connection - Represents a connection to a peer.