Enum PublishError 

pub enum PublishError {
    Offline,
    InvalidProof(VdfRejectReason),
    AlreadyOwned {
        name: String,
    },
    AllFailed {
        count: usize,
    },
    Rejected(String),
    Internal {
        message: String,
        source: Option<Box<dyn Error + Send + Sync>>,
    },
}

Errors when publishing records to the DHT.

Variants

Offline

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

InvalidProof(VdfRejectReason)

The VDF proof attached to the record failed verification.

AlreadyOwned

The name is already owned by a different Ed25519 public key.

Fields

name: String

The .kin name that is already registered.

AllFailed

Every DHT PUT attempt for this record failed.

Fields

count: usize

Number of failed PUT operations.

Rejected(String)

The record was rejected by the store (e.g. invalid signature, stale).

Internal

An unexpected internal error occurred during the publish flow.

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 PublishError

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.

Trait Implementations

impl Debug for PublishError

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

Formats the value using the given formatter.

impl Display for PublishError

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

Formats the value using the given formatter.

impl Eq for PublishError

impl Error for PublishError

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

fn from(e: PublishError) -> Self

Converts to this type from the input type.

impl From<VdfRejectReason> for PublishError

fn from(source: VdfRejectReason) -> Self

Converts to this type from the input type.

impl PartialEq for PublishError

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

Equality operator ==.

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

Inequality operator !=.