Enum DeliveryError 

pub enum DeliveryError {
    IngressClosed,
    UnknownModule(String),
    UnknownInput {
        module: String,
        input: String,
    },
    InvalidEnvelope(String),
    OversizePayload {
        byte_count: usize,
        cap: usize,
    },
    TooManyInputs {
        count: usize,
        cap: usize,
    },
    AllocationFailed {
        byte_count: usize,
        reason: AllocFailReason,
    },
    BudgetExceeded {
        byte_count: usize,
        budget_remaining: usize,
    },
}

Errors surfaced by host-facing delivery methods on Node.

Variants

IngressClosed

The ingress queue is closed (Node is shutting down).

UnknownModule(String)

deliver_event / invoke referenced an unknown module name.

UnknownInput

deliver_event referenced a module that exists but has no such input port.

Fields

module: String

Module name (resolved successfully).

input: String

Input port name (not found on the module).

InvalidEnvelope(String)

deliver_inbound received bytes that failed EnvelopeCodec::decode_capped — malformed prost frame, schema-version mismatch, or one of the NodeConfig.envelope_caps limits exceeded.

OversizePayload

deliver_event / invoke payload exceeded the configured per-item cap (NodeConfig::max_app_event_bytes or NodeConfig::max_invoke_bytes). A matching InfraEvent::AppIngressError lands on the bus alongside this synchronous return so observers see the per-item rejection.

Fields

byte_count: usize

Bytes the caller attempted to admit.

cap: usize

Cap value the boundary enforced.

TooManyInputs

invoke carried more (name, bytes) inputs than the configured NodeConfig::max_invoke_inputs cap allowed. Matching InfraEvent::AppIngressError lands on the bus.

Fields

count: usize

Inputs the caller attempted to admit.

cap: usize

Cap value the boundary enforced.

AllocationFailed

deliver_event / invoke could not allocate the framework-owned buffer needed to hold the caller’s payload, either because Vec::try_reserve_exact returned TryReserveError or because admitting the payload would exceed NodeConfig::ingress_byte_budget. Matching InfraEvent::AppIngressError lands on the bus.

Fields

byte_count: usize

Bytes the boundary tried to admit.

reason: AllocFailReason

Why the reservation failed.

BudgetExceeded

Admitting this payload would push the engine over NodeConfig::ingress_byte_budget. Matching InfraEvent::AppIngressError lands on the bus.

Fields

byte_count: usize

Bytes the boundary tried to admit.

budget_remaining: usize

Bytes still available under the configured budget at the time of the rejection.

Trait Implementations

impl Clone for DeliveryError

fn clone(&self) -> DeliveryError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DeliveryError

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

Formats the value using the given formatter.

impl Display for DeliveryError

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

Formats the value using the given formatter.

impl Eq for DeliveryError

impl Error for DeliveryError

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 PartialEq for DeliveryError

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