Struct NatTraversalManager 

pub struct NatTraversalManager { /* private fields */ }

Central manager for NAT traversal operations

Implementations

impl NatTraversalManager

pub fn new(config: NatTraversalConfig) -> Self

Create a new manager with the given configuration.

pub fn detect_nat_type(bindings: &[StunBinding]) -> NatType

Analyse a set of STUN bindings to determine the NAT type.

The algorithm compares mapped addresses across bindings:

• All identical mapped addresses => FullCone (or Open if mapped == local)
• Same IP but different ports => PortRestricted
• Different IPs => Symmetric
• Single binding or ambiguous => RestrictedCone or Unknown

pub fn add_binding(&mut self, binding: StunBinding)

Record a new STUN binding and re-detect the NAT type.

pub fn initiate_punch( &mut self, peer_id: &str, remote_addr: &str, local_port: u16, ) -> Result<(), String>

Begin a hole-punch attempt to a peer.

Returns an error if a punch is already active for this peer.

pub fn predict_port(&self, base_port: u16, sample_ports: &[u16]) -> Vec<u16>

Predict the next allocated port(s) based on observed samples.

If the samples show a linear pattern (constant delta), predict the next port and return a range around it. Otherwise return a range around the base port.

pub fn update_attempt( &mut self, peer_id: &str, status: HolePunchStatus, ) -> Result<(), String>

Update the status of an active hole-punch attempt.

pub fn get_attempt(&self, peer_id: &str) -> Option<&HolePunchAttempt>

Look up an active punch attempt by peer ID.

pub fn active_punch_count(&self) -> usize

Number of currently active (non-terminal) punch attempts.

pub fn cleanup_expired(&mut self, now: u64) -> usize

Remove expired or completed attempts older than now - stun_timeout_ms. Returns the number of entries removed.

pub fn success_rate(&self) -> f64

Fraction of successful punches out of total (0.0 if none attempted).

pub fn stats(&self) -> &NatTraversalStats

Reference to aggregated stats.

pub fn detected_nat_type(&self) -> &NatType

Reference to the currently detected NAT type.

pub fn best_strategy(&self) -> TraversalStrategy

Recommend the best traversal strategy based on the detected NAT type.