Enum ResolutionError 

pub enum ResolutionError {
    Offline,
    NotFound {
        name: String,
        peers_queried: usize,
    },
    VdfVerificationFailed {
        name: String,
        count: usize,
    },
    Expired {
        name: String,
        age: u64,
    },
    Timeout {
        name: String,
        elapsed_ms: u64,
        peers_queried: usize,
    },
    Internal {
        message: String,
        source: Option<Box<dyn Error + Send + Sync>>,
    },
}

Errors during DHT name resolution. Rich developer context, NOT serialized over wire. Convert to ApiError at the HTTP/FFI boundary.

Variants

Offline

The local node has no connected peers and cannot reach the DHT.

NotFound

The name was not found after querying the given number of peers.

Fields

name: String

The .kin name that was queried.

peers_queried: usize

Number of DHT peers that were contacted.

VdfVerificationFailed

The name was found but one or more of the returned records failed VDF verification.

Fields

name: String

The .kin name that was queried.

count: usize

Number of records that failed verification.

Expired

The name’s registration has passed its validity window.

Fields

name: String

The .kin name that was queried.

age: u64

Age of the record in drand rounds.

Timeout

The resolution attempt timed out before a result was returned.

Fields

name: String

The .kin name that was queried.

elapsed_ms: u64

Wall-clock time elapsed during the query in milliseconds.

peers_queried: usize

Number of DHT peers that were contacted before the timeout.

Internal

An unexpected internal error occurred during resolution.

Fields

message: String

Developer-facing description of what went wrong.

source: Option<Box<dyn Error + Send + Sync>>

Optional chain of underlying error causes.

Implementations

impl ResolutionError

pub fn code(&self) -> &'static str

Stable protocol error code. Part of the Kinetic error taxonomy.

pub fn error_type_uri(&self) -> String

RFC 7807 type URI for this error.

pub fn is_retryable(&self) -> bool

Whether the client should offer a retry action.

pub fn severity(&self) -> Severity

Severity level for logging and monitoring.

pub fn user_message(&self) -> String

Clean user-facing message with no developer details.

pub fn details(&self) -> Value

Structured developer-facing details for ApiError.details.

Trait Implementations

impl Debug for ResolutionError

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

Formats the value using the given formatter.

impl Display for ResolutionError

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

Formats the value using the given formatter.

impl Eq for ResolutionError

impl Error for ResolutionError

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<ResolutionError> for ApiError

fn from(e: ResolutionError) -> Self

Converts to this type from the input type.

impl PartialEq for ResolutionError

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

Equality operator ==.

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

Inequality operator !=.