Struct NatTraversalManager 

pub struct NatTraversalManager { /* private fields */ }

Production ICE traversal manager.

Renamed to NtmNatTraversalManager at crate root to avoid collision with nat_traversal::NatTraversalManager.

Implementations

impl NatTraversalManager

pub fn new(config: TraversalConfig) -> Self

Create a new manager with config.

pub fn add_local_candidate( &mut self, addr: CandidateAddress, ) -> Result<(), TraversalError>

Add a local candidate.

pub fn add_remote_candidate( &mut self, addr: CandidateAddress, ) -> Result<(), TraversalError>

Add a remote candidate.

pub fn form_check_pairs(&mut self) -> Vec<IcePair>

Form the check list from the Cartesian product of local × remote candidates, sorted by descending RFC 5245 pair priority and capped to config.max_pairs.

pub fn detect_nat_type(candidates: &[CandidateAddress]) -> NatType

Heuristic NAT type detection from a slice of gathered candidates.

Algorithm:

1. No candidates → Unknown
2. Only Host candidates → OpenInternet
3. Multiple ServerReflexive candidates with different IP+port combinations (one per distinct STUN server) → Symmetric
4. Exactly one ServerReflexive candidate → FullCone
5. Both Host and ServerReflexive present with the same reflexive address per server → RestrictedCone
6. Relayed candidates present (TURN allocation needed) → PortRestrictedCone
7. Otherwise → Unknown

pub fn check_pair(&self, pair: &mut IcePair, _current_ts: u64) -> PairState

Run a single connectivity check on pair.

Deterministic rule (no real network I/O):

• Host, ServerReflexive, PeerReflexive, or Relayed candidates on both sides → Succeeded.
• Any other combination → Failed.

The pair transitions through InProgress before the final state.

pub fn nominate_best_pair(&mut self) -> Result<IcePair, TraversalError>

Among all Succeeded pairs in the current check list, nominate the one with the highest priority.

pub fn run_checks(&mut self, current_ts: u64) -> Vec<(String, PairState)>

Run connectivity checks on all Waiting and InProgress pairs. Returns (pair_key, new_state) for every pair that was checked.

pub fn encode_stun_message(&self, msg: &StunMessage) -> Vec<u8>

Encode a StunMessage to bytes (RFC 5389 §6 format).

Layout:

0                   1                   2                   3
0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|0 0|     STUN Message Type     |         Message Length        |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|                         Magic Cookie                          |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|                                                               |
|                     Transaction ID (96 bits)                  |
|                                                               |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|                          Attributes …                         |

pub fn decode_stun_message( &self, data: &[u8], ) -> Result<StunMessage, TraversalError>

Decode bytes into a StunMessage.

pub fn stats(&self) -> TraversalStats

Return a snapshot of traversal statistics.

Trait Implementations

impl Default for NatTraversalManager

fn default() -> Self

Returns the “default value” for a type.