Enum DialError 

pub enum DialError {
    InvalidAddress {
        addr: String,
        source: InvalidUri,
    },
    Tls(String),
    Connect(ConnectError),
    InvalidBearer(String),
    MissingIngressCredentials,
    InvalidIngressReceipt(&'static str),
    InvalidApprovalRecovery(&'static str),
}

Errors an agent dial can produce.

Variants

InvalidAddress

Could not parse the configured agent address as a URI.

Fields

addr: String

The address string that failed to parse.

source: InvalidUri

The underlying URI parse error.

Tls(String)

Building the TLS client for an https:// endpoint failed (e.g. no process-default crypto provider). The dial fails closed rather than silently downgrading to plaintext.

Connect(ConnectError)

Connect-level error from the AgentService stream.

InvalidBearer(String)

A bearer credential could not be encoded as an HTTP header value (e.g. contains a newline or non-ASCII byte). Produced by AgentDialer::with_credentials, PersonaDialer::new_admin, CredentialDialer::new_admin, and RoutineDialer::fire_routine’s admin path. Fails the dial closed rather than silently sending the turn unauthenticated.

MissingIngressCredentials

A turn ingress was attempted with an unauthenticated dialer.

Stable source identity rides only inside the signed edge envelope, so sending without credentials would necessarily drop the identity and is refused before transport I/O.

InvalidIngressReceipt(&'static str)

The server returned a success response that cannot prove the requested source event was durably received.

InvalidApprovalRecovery(&'static str)

The recovery service returned an entry without one of its required states.

Implementations

impl DialError

pub const fn code(&self) -> Option<ErrorCode>

The Connect error code, when this is a transport-level Connect error (None for local address/TLS-setup/credential failures).

pub const fn is_retryable(&self) -> bool

Whether retrying the call could plausibly succeed. Only transient transport conditions are retryable; terminal codes (InvalidArgument, Unauthenticated, NotFound, …) and local address/TLS failures are not. Edges use this to decide whether to ask the source platform to redeliver (retryable) or to drop / 4xx (terminal — redelivery would loop forever).

pub const fn is_deadline_exceeded(&self) -> bool

Whether this error is a DeadlineExceeded — the call’s deadline elapsed rather than anything failing.

A long-lived stream that is idle by design (NotificationDialer::subscribe) ends this way on every cycle, so its caller reports the recycle as routine instead of as a failure. Callers of short unary RPCs should keep treating it as an error.

The subscribe stream carries a deadline it cannot be exempted from where it is currently mounted, so reaching that deadline is the normal cycle, not a failure — reporting it as one buries the case where the notifier is genuinely broken (#1794).

pub const fn is_stale_capability(&self) -> bool

Whether a signed human-action capability is absent, expired, or no longer matches the durable occurrence it names.

Approval edges use this to retire a stale card instead of inviting a deterministic retry. The server reports malformed/expired capability tokens as Unauthenticated and an occurrence that can no longer be answered as FailedPrecondition.

Trait Implementations

impl Debug for DialError

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

Formats the value using the given formatter.

impl Display for DialError

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

Formats the value using the given formatter.

impl Error for DialError

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 From<ConnectError> for DialError

fn from(source: ConnectError) -> Self

Converts to this type from the input type.