Struct ChieError 

pub struct ChieError {
    pub kind: ErrorKind,
    pub message: String,
    pub context: Vec<String>,
}

Enhanced error type with context information

This error type wraps the underlying error with additional context about where and why the error occurred.

Fields

kind: ErrorKind

The kind of error that occurred

message: String

Human-readable error message

context: Vec<String>

Optional context about where/why the error occurred

Implementations

impl ChieError

pub fn new(kind: ErrorKind, message: impl Into<String>) -> Self

Create a new error with the specified kind and message

pub fn validation(message: impl Into<String>) -> Self

Create a validation error

pub fn network(message: impl Into<String>) -> Self

Create a network error

pub fn serialization(message: impl Into<String>) -> Self

Create a serialization error

pub fn cryptographic(message: impl Into<String>) -> Self

Create a cryptographic error

pub fn storage(message: impl Into<String>) -> Self

Create a storage error

pub fn resource_exhausted(message: impl Into<String>) -> Self

Create a resource exhausted error

pub fn not_found(message: impl Into<String>) -> Self

Create a not found error

pub fn already_exists(message: impl Into<String>) -> Self

Create an already exists error

pub fn permission_denied(message: impl Into<String>) -> Self

Create a permission denied error

pub fn internal(message: impl Into<String>) -> Self

Create an internal error

pub fn context(self, ctx: impl Into<String>) -> Self

Add context to the error

Examples

use chie_shared::ChieError;

let err = ChieError::validation("Invalid CID")
    .context("While validating content metadata")
    .context("In upload handler");

pub fn is_transient(&self) -> bool

Check if this is a transient error that might succeed on retry

pub fn is_permanent(&self) -> bool

Check if this is a permanent error that won’t succeed on retry

pub fn full_message(&self) -> String

Get the full error message with context

pub fn report_telemetry(&self)

Report this error to telemetry if a handler is set

This allows errors to be reported to external monitoring systems. The global telemetry handler must be set using set_telemetry_handler.

pub fn new_with_telemetry(kind: ErrorKind, message: impl Into<String>) -> Self

Create an error and immediately report it to telemetry

Trait Implementations

impl Clone for ChieError

fn clone(&self) -> ChieError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ChieError

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

Formats the value using the given formatter.

impl Display for ChieError

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

Formats the value using the given formatter.

impl Error for ChieError

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.