Struct NetProxy 

pub struct NetProxy { /* private fields */ }

Net Proxy for zero-copy multi-hop forwarding.

The proxy forwards packets without decrypting the payload, only reading and updating the routing header.

Implementations

impl NetProxy

pub async fn new(config: ProxyConfig) -> Result<Self>

Create a new proxy

pub fn local_addr(&self) -> Result<SocketAddr>

Get local address

pub fn add_route(&self, dest_id: u64, next_hop: SocketAddr)

Add a route to the next-hop table

pub fn remove_route(&self, dest_id: u64)

Remove a route.

Drops both the next_hop entry and the matching hop_stats entry. Removing only the former would let hop_stats grow indefinitely (memory ∝ total-distinct-dest-ids-ever-seen, not active dest count) for a peer churning through many destinations.

pub fn lookup(&self, dest_id: u64) -> Option<SocketAddr>

Lookup next hop for destination

pub fn forward(&self, data: Bytes) -> ForwardResult

Forward a packet (zero-copy, no decryption).

This is the hot path - it only reads and updates the routing header, then forwards the entire packet to the next hop.

pub async fn forward_and_send( &self, data: Bytes, ) -> Result<ForwardResult, ProxyError>

Forward and send a packet in one operation

pub async fn send_to(&self, data: &[u8], dest: SocketAddr) -> Result<usize>

Send data to a destination

pub async fn recv_from(&self, buf: &mut [u8]) -> Result<(usize, SocketAddr)>

Receive a packet

pub fn stats(&self) -> ProxyStats

Get proxy statistics

pub fn reset_stats(&self)

Reset statistics

pub fn hop_stats(&self, dest_id: u64) -> Option<(u64, u64, u64)>

Get hop stats for a destination

pub fn route_count(&self) -> usize

Get route count

Trait Implementations

impl Debug for NetProxy

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.