Skip to main content

Crate stoffelnet

Crate stoffelnet 

Source
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

§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

Modules§

ffi
C Foreign Function Interface (FFI) for stoffel-networking
network_utils
transports

Traits§

NetworkManager
Manages network connections.
PeerConnection
Represents a connection to a peer.

Type Aliases§

BoxPeerConnectionFuture