Enum RecursiveError 

pub enum RecursiveError {
    Root {
        context: &'static str,
        source: Box<Error>,
    },
    TransactionContext {
        context: &'static str,
        source: Box<Error>,
    },
    E2e {
        context: &'static str,
        source: Box<E2eIdentityError>,
    },
    MlsClient {
        context: &'static str,
        source: Box<Error>,
    },
    MlsConversation {
        context: &'static str,
        source: Box<Error>,
    },
    MlsCredential {
        context: &'static str,
        source: Box<Error>,
    },
}

These errors wrap each of the module-specific errors in CoreCrypto.

The goal here is to reduce the need to redeclare each of these error types as an individual variant of a module-specific error type.

Variants

Root

Fields

context: &'static str

source: Box<Error>

TransactionContext

Fields

context: &'static str

source: Box<Error>

E2e

Fields

context: &'static str

source: Box<E2eIdentityError>

MlsClient

Fields

context: &'static str

source: Box<Error>

MlsConversation

Fields

context: &'static str

source: Box<Error>

MlsCredential

Fields

context: &'static str

source: Box<Error>

Implementations

impl RecursiveError

pub fn root<E: Into<Error>>(context: &'static str) -> impl FnOnce(E) -> Self

Wrap an error convertible into crate::Error, given the current context.

Prefer Self::context unless you are relying on the Into conversion.

pub fn transaction<E: Into<Error>>( context: &'static str, ) -> impl FnOnce(E) -> Self

Wrap an error convertible into crate::transaction_context::Error, given the current context.

Prefer Self::context unless you are relying on the Into conversion.

pub fn e2e_identity<E: Into<E2eIdentityError>>( context: &'static str, ) -> impl FnOnce(E) -> Self

Wrap an error convertible into wire_e2e_identity::E2eIdentityError, given the current context.

Prefer Self::context unless you are relying on the Into conversion.

pub fn mls_client<E: Into<Error>>( context: &'static str, ) -> impl FnOnce(E) -> Self

Wrap an error convertible into crate::mls::session::Error, given the current context.

Prefer Self::context unless you are relying on the Into conversion.

pub fn mls_conversation<E: Into<Error>>( context: &'static str, ) -> impl FnOnce(E) -> Self

Wrap an error convertible into crate::mls::conversation::Error, given the current context.

Prefer Self::context unless you are relying on the Into conversion.

pub fn mls_credential<E: Into<Error>>( context: &'static str, ) -> impl FnOnce(E) -> Self

Wrap an error convertible into crate::mls::credential::Error, given the current context.

Prefer Self::context unless you are relying on the Into conversion.

impl RecursiveError

pub fn context<E: ToRecursiveError>( context: &'static str, ) -> impl FnOnce(E) -> Self

Wrap any error which RecursiveError knows how to wrap, given the current context.

The variant is selected from the error’s type, so this is usually what you want:

self.session().await.map_err(RecursiveError::context("getting mls client"))?

This only accepts the module error types themselves. When you need to convert first, for instance because you are holding a crate::TlsCodecError which several module errors can absorb, reach for the variant-specific constructor such as Self::mls_conversation instead.

Trait Implementations

impl Debug for RecursiveError

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

Formats the value using the given formatter.

impl Display for RecursiveError

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

Formats the value using the given formatter.

impl Error for RecursiveError

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<RecursiveError> for Error

fn from(source: RecursiveError) -> Self

Converts to this type from the input type.

impl From<RecursiveError> for Error

fn from(source: RecursiveError) -> Self

Converts to this type from the input type.

impl From<RecursiveError> for Error

fn from(source: RecursiveError) -> Self

Converts to this type from the input type.

impl From<RecursiveError> for Error

fn from(source: RecursiveError) -> Self

Converts to this type from the input type.