Enum RejectionReason 

pub enum RejectionReason {
    ChainIdMismatch,
    PeerIdAndPublicKeyMismatch,
    TargetPeerIdNotMe,
    PeerCapacityFull,
    AlreadyConnected,
    ConnectingToSelf,
}

Reasons why a WebRTC connection offer might be rejected.

RejectionReason provides detailed information about why a peer rejected a connection offer. This enables proper error handling and helps with debugging connection issues.

The rejection reasons are categorized into different types of validation failures that can occur during the offer evaluation process.

Classification

Some rejection reasons are considered “bad” (potentially indicating malicious behavior or protocol violations) while others are normal operational conditions. Use RejectionReason::is_bad to determine if a rejection indicates a problem.

Variants

ChainIdMismatch

The offering peer is on a different blockchain network.

This is a normal rejection reason that occurs when peers from different blockchain networks attempt to connect. Not considered a “bad” rejection.

PeerIdAndPublicKeyMismatch

The peer ID doesn’t match the peer’s public key.

This indicates a potential security issue or protocol violation where the claimed peer identity doesn’t match the cryptographic identity. Considered a “bad” rejection that may indicate malicious behavior.

TargetPeerIdNotMe

The target peer ID in the offer doesn’t match the local node’s peer ID.

This indicates the offer was sent to the wrong peer or there was an error in peer discovery. Considered a “bad” rejection.

PeerCapacityFull

The local node has reached its maximum peer capacity.

This is a normal operational condition when a node is at its connection limit. Not considered a “bad” rejection.

AlreadyConnected

A connection to this peer already exists.

This prevents duplicate connections to the same peer. Considered a “bad” rejection as it may indicate connection management issues.

ConnectingToSelf

The peer is attempting to connect to itself.

This is a normal condition that can occur during peer discovery. Not considered a “bad” rejection.

Implementations

impl RejectionReason

pub fn is_bad(&self) -> bool

Determines if this rejection reason indicates a potential problem.

Some rejection reasons are normal operational conditions (like capacity limits or chain ID mismatches), while others may indicate protocol violations, security issues, or implementation bugs.

Returns

• true if the rejection indicates a potentially problematic condition
• false if the rejection is a normal operational condition

“Bad” Rejection Reasons

• PeerIdAndPublicKeyMismatch - Identity verification failure
• TargetPeerIdNotMe - Targeting error or discovery issue
• AlreadyConnected - Connection management issue

Normal Rejection Reasons

• ChainIdMismatch - Cross-chain connection attempt
• PeerCapacityFull - Resource limitation
• ConnectingToSelf - Self-connection detection

Trait Implementations

impl Clone for RejectionReason

fn clone(&self) -> RejectionReason

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RejectionReason

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for RejectionReason

fn deserialize<__D>( __deserializer: __D, ) -> Result<RejectionReason, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for RejectionReason

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

Formats the value using the given formatter.

impl Error for RejectionReason

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0: use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0: replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl MallocSizeOf for RejectionReason

fn size_of(&self, ops: &mut MallocSizeOfOps) -> usize

Measure the heap usage of all descendant heap-allocated structures, but not the space taken up by the value itself.

impl PartialEq for RejectionReason

fn eq(&self, other: &RejectionReason) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for RejectionReason

fn serialize<__S>( &self, __serializer: __S, ) -> Result<<__S as Serializer>::Ok, <__S as Serializer>::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Copy for RejectionReason

impl Eq for RejectionReason

impl StructuralPartialEq for RejectionReason