Enum PeerFailureReason 

pub enum PeerFailureReason {
    Timeout,
    ConnectionFailed,
    DataUnavailable,
    CorruptedData,
    ProtocolError,
    Refused,
}

Categorizes why a peer interaction failed.

Used by consumers (like saorsa-node) to provide rich context when reporting failures to the trust/reputation system. Each variant carries a severity that the trust engine uses to weight the penalty.

Example

use saorsa_core::error::PeerFailureReason;

let reason = PeerFailureReason::Timeout;
assert!(reason.is_transient());
assert!(reason.trust_severity() < 0.5);

Variants

Timeout

The peer did not respond within the expected time window.

ConnectionFailed

Could not establish or maintain a connection to the peer.

DataUnavailable

The peer was reachable but did not have the requested data.

CorruptedData

The peer returned data that failed integrity/hash verification.

ProtocolError

The peer violated the expected wire protocol.

Refused

The peer explicitly refused the request.

Implementations

impl PeerFailureReason

pub fn is_transient(&self) -> bool

Whether this failure is transient (likely to succeed on retry).

Transient failures (timeout, connection issues) should not be penalized as heavily as persistent ones (corrupted data, protocol errors).

pub fn trust_severity(&self) -> f64

Trust severity score in the range [0.0, 1.0].

Higher values indicate more severe trust violations:

• 0.2 — transient issues (timeout, connection)
• 0.5 — data unavailable / refused
• 1.0 — data corruption or protocol violation

Trait Implementations

impl Clone for PeerFailureReason

fn clone(&self) -> PeerFailureReason

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PeerFailureReason

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for PeerFailureReason

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for PeerFailureReason

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

Formats the value using the given formatter.

impl Hash for PeerFailureReason

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for PeerFailureReason

fn eq(&self, other: &PeerFailureReason) -> 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 PeerFailureReason

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Copy for PeerFailureReason

impl Eq for PeerFailureReason

impl StructuralPartialEq for PeerFailureReason