Enum NodeEvent 

pub enum NodeEvent {
    PeerConnected {
        peer_id: PeerId,
        addr: TransportAddr,
        method: TraversalMethod,
        direct: bool,
    },
    PeerDisconnected {
        peer_id: PeerId,
        reason: DisconnectReason,
    },
    ConnectionFailed {
        addr: SocketAddr,
        error: String,
    },
    ExternalAddressDiscovered {
        addr: TransportAddr,
    },
    PortMappingEstablished {
        external_addr: SocketAddr,
    },
    PortMappingRenewed {
        external_addr: SocketAddr,
    },
    PortMappingAddressChanged {
        previous_addr: SocketAddr,
        external_addr: SocketAddr,
    },
    PortMappingFailed {
        error: String,
    },
    PortMappingRemoved {
        external_addr: Option<SocketAddr>,
    },
    NatTypeDetected {
        nat_type: NatType,
    },
    NatTraversalComplete {
        peer_id: PeerId,
        success: bool,
        method: TraversalMethod,
    },
    DirectPathStatus {
        peer_id: PeerId,
        status: DirectPathStatus,
    },
    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,
    },
    MdnsServiceAdvertised {
        service: String,
        namespace: Option<String>,
        instance_fullname: String,
    },
    MdnsPeerDiscovered {
        peer: MdnsPeerRecord,
    },
    MdnsPeerUpdated {
        peer: MdnsPeerRecord,
    },
    MdnsPeerRemoved {
        peer: MdnsPeerRecord,
    },
    MdnsPeerEligible {
        peer: MdnsPeerRecord,
    },
    MdnsPeerIneligible {
        peer: MdnsPeerRecord,
        reason: String,
    },
    MdnsPeerApprovalRequired {
        peer: MdnsPeerRecord,
        reason: String,
    },
    MdnsAutoConnectAttempted {
        peer: MdnsPeerRecord,
        addresses: Vec<SocketAddr>,
    },
    MdnsAutoConnectSucceeded {
        peer: MdnsPeerRecord,
        authenticated_peer_id: PeerId,
        remote_addr: TransportAddr,
    },
    MdnsAutoConnectFailed {
        peer: MdnsPeerRecord,
        addresses: Vec<SocketAddr>,
        error: String,
    },
    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)

method: TraversalMethod

How the connection was established.

direct: bool

Whether this is a direct connection (vs relayed or assisted)

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)

PortMappingEstablished

Best-effort router port mapping was established.

Fields

external_addr: SocketAddr

The mapped external address.

PortMappingRenewed

Best-effort router port mapping was renewed.

Fields

external_addr: SocketAddr

The mapped external address.

PortMappingAddressChanged

Best-effort router port mapping changed to a different public address.

Fields

previous_addr: SocketAddr

Previous mapped public address.

external_addr: SocketAddr

Current mapped public address.

PortMappingFailed

Best-effort router port mapping failed.

Fields

error: String

Human-readable failure detail.

PortMappingRemoved

Best-effort router port mapping was removed or became inactive.

Fields

external_addr: Option<SocketAddr>

The last mapped external address, when known.

NatTypeDetected

Best-effort NAT behavior hint updated.

Fields

nat_type: NatType

Compatibility-oriented NAT behavior hint derived from native QUIC observations rather than STUN-style NAT classification.

NatTraversalComplete

NAT traversal completed

Fields

peer_id: PeerId

The peer we traversed to

success: bool

Whether traversal was successful

method: TraversalMethod

Connection method used

DirectPathStatus

Best-effort direct-path status for a peer.

Fields

peer_id: PeerId

Authenticated peer identity.

status: DirectPathStatus

Current direct-path status.

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

MdnsServiceAdvertised

The local endpoint is advertising itself via first-party mDNS.

Fields

service: String

Service/application scope being advertised.

namespace: Option<String>

Namespace/workspace scope, if configured.

instance_fullname: String

Full DNS-SD instance name being advertised.

MdnsPeerDiscovered

A peer was discovered via first-party mDNS.

Fields

peer: MdnsPeerRecord

Structured mDNS discovery record.

MdnsPeerUpdated

A previously discovered mDNS peer was updated.

Fields

peer: MdnsPeerRecord

Structured mDNS discovery record.

MdnsPeerRemoved

A previously discovered mDNS peer was removed.

Fields

peer: MdnsPeerRecord

Structured mDNS discovery record.

MdnsPeerEligible

A discovered mDNS peer passed local eligibility checks.

Fields

peer: MdnsPeerRecord

Structured mDNS discovery record.

MdnsPeerIneligible

A discovered mDNS peer was rejected by local eligibility checks.

Fields

peer: MdnsPeerRecord

Structured mDNS discovery record.

reason: String

Human-readable reason for rejection.

MdnsPeerApprovalRequired

A discovered mDNS peer requires explicit approval before auto-connect.

Fields

peer: MdnsPeerRecord

Structured mDNS discovery record.

reason: String

Human-readable policy reason.

MdnsAutoConnectAttempted

An mDNS-driven auto-connect attempt was scheduled.

Fields

peer: MdnsPeerRecord

Structured mDNS discovery record.

addresses: Vec<SocketAddr>

Candidate addresses routed through the unified connect path.

MdnsAutoConnectSucceeded

An mDNS-driven auto-connect attempt succeeded.

Fields

peer: MdnsPeerRecord

Structured mDNS discovery record.

authenticated_peer_id: PeerId

Authenticated peer identity learned from QUIC.

remote_addr: TransportAddr

Connected remote transport address.

MdnsAutoConnectFailed

An mDNS-driven auto-connect attempt failed.

Fields

peer: MdnsPeerRecord

Structured mDNS discovery record.

addresses: Vec<SocketAddr>

Candidate addresses routed through the unified connect path.

error: String

Human-readable failure detail.

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.