Enum NodeEvent 

pub enum NodeEvent {
    PeerConnected {
        peer_id: PeerId,
        addr: TransportAddr,
        direct: bool,
    },
    PeerDisconnected {
        peer_id: PeerId,
        reason: DisconnectReason,
    },
    ConnectionFailed {
        addr: SocketAddr,
        error: String,
    },
    ExternalAddressDiscovered {
        addr: TransportAddr,
    },
    NatTypeDetected {
        nat_type: NatType,
    },
    NatTraversalComplete {
        peer_id: PeerId,
        success: bool,
        method: TraversalMethod,
    },
    RelaySessionStarted {
        peer_id: PeerId,
    },
    RelaySessionEnded {
        peer_id: PeerId,
        bytes_forwarded: u64,
    },
    CoordinationStarted {
        peer_a: PeerId,
        peer_b: PeerId,
    },
    CoordinationComplete {
        peer_a: PeerId,
        peer_b: PeerId,
        success: bool,
    },
    DataReceived {
        peer_id: PeerId,
        stream_id: u64,
        bytes: usize,
    },
    DataSent {
        peer_id: PeerId,
        stream_id: u64,
        bytes: usize,
    },
}

Unified event type for all node activities

Subscribe to these events via node.subscribe() to monitor all significant node activities in real-time.

Variants

PeerConnected

A peer connected successfully

Fields

peer_id: PeerId

The connected peer’s ID

addr: TransportAddr

The peer’s address (supports all transport types)

direct: bool

Whether this is a direct connection (vs relayed)

PeerDisconnected

A peer disconnected

Fields

peer_id: PeerId

The disconnected peer’s ID

reason: DisconnectReason

Reason for disconnection

ConnectionFailed

Connection attempt failed

Fields

addr: SocketAddr

Target address that failed

error: String

Error message

ExternalAddressDiscovered

External address discovered

This is the address as seen by other peers.

Fields

addr: TransportAddr

The discovered external address (supports all transport types)

NatTypeDetected

NAT type detected

Fields

nat_type: NatType

The detected NAT type

NatTraversalComplete

NAT traversal completed

Fields

peer_id: PeerId

The peer we traversed to

success: bool

Whether traversal was successful

method: TraversalMethod

Connection method used

RelaySessionStarted

Started relaying for a peer

Fields

peer_id: PeerId

The peer we’re relaying for

RelaySessionEnded

Stopped relaying for a peer

Fields

peer_id: PeerId

The peer we were relaying for

bytes_forwarded: u64

Total bytes forwarded during session

CoordinationStarted

Started coordinating NAT traversal for peers

Fields

peer_a: PeerId

Peer A in the coordination

peer_b: PeerId

Peer B in the coordination

CoordinationComplete

NAT traversal coordination completed

Fields

peer_a: PeerId

Peer A in the coordination

peer_b: PeerId

Peer B in the coordination

success: bool

Whether coordination was successful

DataReceived

Data received from a peer

Fields

peer_id: PeerId

The peer that sent data

stream_id: u64

Stream ID (for multiplexed connections)

bytes: usize

Number of bytes received

DataSent

Data sent to a peer

Fields

peer_id: PeerId

The peer we sent data to

stream_id: u64

Stream ID

bytes: usize

Number of bytes sent

Implementations

impl NodeEvent

pub fn is_connection_event(&self) -> bool

Check if this is a connection event

pub fn is_nat_event(&self) -> bool

Check if this is a NAT-related event

pub fn is_relay_event(&self) -> bool

Check if this is a relay event

pub fn is_coordination_event(&self) -> bool

Check if this is a coordination event

pub fn is_data_event(&self) -> bool

Check if this is a data event

pub fn peer_id(&self) -> Option<&PeerId>

Get the peer ID associated with this event (if any)

Trait Implementations

impl Clone for NodeEvent

fn clone(&self) -> NodeEvent

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for NodeEvent

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

Formats the value using the given formatter.