Struct Puncher 

pub struct Puncher { /* private fields */ }

NAT hole punching coordinator.

Puncher manages the hole punching process, tracking attempts and adapting strategies based on NAT type and previous results.

Examples

use rust_p2p_core::punch::Puncher;

let puncher = Puncher::new(None, None);

Implementations

impl Puncher

pub fn new( udp_socket_manager: Option<Arc<UdpSocketManager>>, tcp_socket_manager: Option<Arc<TcpSocketManager>>, ) -> Puncher

Creates a new Puncher with the given socket managers.

Arguments

• udp_socket_manager - Optional UDP socket manager for UDP punching
• tcp_socket_manager - Optional TCP socket manager for TCP punching

impl Puncher

pub fn need_punch(&self, punch_info: &PunchInfo) -> bool

Determines whether hole punching is needed for a peer.

Call this method periodically. It uses adaptive frequency based on previous attempts to avoid excessive punching.

Arguments

• punch_info - Information about the peer to punch

Returns

true if punching should be attempted, false otherwise.

Examples

if puncher.need_punch(&punch_info) {
    // Perform punching
}

pub async fn punch(&self, buf: &[u8], punch_info: PunchInfo) -> Result<()>

Attempts hole punching if needed (convenience method).

This combines need_punch and punch_now into a single call.

Arguments

• buf - The data to send during punching
• punch_info - Information about the peer to punch

Examples

let punch_info = PunchInfo::default();
puncher.punch(b"punch_data", punch_info).await?;

pub async fn punch_now( &self, tcp_buf: Option<&[u8]>, udp_buf: &[u8], punch_info: PunchInfo, ) -> Result<()>

Performs hole punching immediately without checking if it’s needed.

Attempts both TCP and UDP hole punching based on available socket managers and the peer’s NAT information.

Arguments

• tcp_buf - Optional TCP punch data
• udp_buf - UDP punch data
• punch_info - Information about the peer to punch

Examples

let punch_info = PunchInfo::default();
puncher.punch_now(Some(b"tcp"), b"udp", punch_info).await?;

Trait Implementations

impl Clone for Puncher

fn clone(&self) -> Puncher

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl From<&TunnelDispatcher> for Puncher

fn from(value: &TunnelDispatcher) -> Self

Converts to this type from the input type.