Struct openmls::error::LibraryError

source · [−]

pub struct LibraryError { /* private fields */ }

Expand description

Generic error type that indicates unrecoverable errors in the library.

This error has 3 subtypes:

MissingBoundsCheck

This error is returned when the library tries to serialize data that is too big for the MLS structs. In particular, when element lists contain more elements than the theoretical maximum defined in the spec, the serialization will fail. This should not happen when all input values are checked.

CryptoEror

This error is returned if the underlying crypto provider encountered an unexpected error. Possible reasons for this could be: the implementation of the crypto provider is not correct, the key material is not correct, the crypto provider does not support all functions required. Another reason could be that the OpenMLS library does not use the crypto provider API correctly.

Custom

This error is returned in situations where the implementation would otherwise use an unwrap(). If applications receive this error, it clearly indicates an implementation mistake in OpenMLS. The error includes a string that can give some more context about where the error originated and helps debugging.

In all cases, when a LibraryError is returned, applications should try to recover gracefully from it. It is recommended to log the error for potential debugging.

Struct openmls::error::LibraryError

Trait Implementations

impl Clone for LibraryError

fn clone(&self) -> LibraryError

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

impl Debug for LibraryError

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

impl Display for LibraryError

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

impl Error for LibraryError

fn source(&self) -> Option<&(dyn Error + 'static)>

fn backtrace(&self) -> Option<&Backtrace>

fn description(&self) -> &str

fn cause(&self) -> Option<&dyn Error>

impl From<LibraryError> for CredentialError

fn from(source: LibraryError) -> Self

impl From<LibraryError> for ExtensionError

fn from(source: LibraryError) -> Self

impl From<LibraryError> for AddMembersError

fn from(source: LibraryError) -> Self

impl From<LibraryError> for ProposeAddMemberError

fn from(source: LibraryError) -> Self

impl From<LibraryError> for ProposeRemoveMemberError

fn from(source: LibraryError) -> Self

impl From<LibraryError> for RemoveMembersError

fn from(source: LibraryError) -> Self

impl From<LibraryError> for LeaveGroupError

fn from(source: LibraryError) -> Self

impl From<LibraryError> for SelfUpdateError

fn from(source: LibraryError) -> Self

impl From<LibraryError> for ProposeSelfUpdateError

fn from(source: LibraryError) -> Self

impl From<LibraryError> for CommitToPendingProposalsError

fn from(source: LibraryError) -> Self

impl From<LibraryError> for ExportPublicGroupStateError

fn from(source: LibraryError) -> Self

impl From<LibraryError> for ExportSecretError

fn from(source: LibraryError) -> Self

impl From<LibraryError> for MessageDecryptionError

fn from(source: LibraryError) -> Self

impl From<LibraryError> for WelcomeError

fn from(source: LibraryError) -> Self

impl From<LibraryError> for ExternalCommitError

fn from(source: LibraryError) -> Self

impl From<LibraryError> for StageCommitError

fn from(source: LibraryError) -> Self

impl From<LibraryError> for CreateCommitError

fn from(source: LibraryError) -> Self

impl From<LibraryError> for ValidationError

fn from(source: LibraryError) -> Self

impl From<LibraryError> for ProposalValidationError

fn from(source: LibraryError) -> Self

impl From<LibraryError> for ExternalCommitValidationError

fn from(source: LibraryError) -> Self

impl From<LibraryError> for KeyPackageVerifyError

fn from(source: LibraryError) -> Self

impl From<LibraryError> for KeyPackageNewError

fn from(source: LibraryError) -> Self

impl From<LibraryError> for KeyPackageBundleNewError

fn from(source: LibraryError) -> Self

impl From<LibraryError> for SenderError

fn from(source: LibraryError) -> Self

impl From<LibraryError> for PskError

fn from(source: LibraryError) -> Self

impl From<LibraryError> for ApplyUpdatePathError

fn from(source: LibraryError) -> Self

impl From<LibraryError> for MlsMessageError

fn from(source: LibraryError) -> Self

impl From<LibraryError> for NewGroupError

fn from(source: LibraryError) -> Self

impl From<LibraryError> for MlsGroupStateError

fn from(source: LibraryError) -> Self

impl From<LibraryError> for ParseMessageError

fn from(source: LibraryError) -> Self

impl From<LibraryError> for UnverifiedMessageError

fn from(source: LibraryError) -> Self

impl From<LibraryError> for CreateMessageError

fn from(source: LibraryError) -> Self

impl PartialEq<LibraryError> for LibraryError

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

impl<T> Any for T where
T: 'static + ?Sized,

impl<T> Borrow<T> for T where
T: ?Sized,

impl<T> BorrowMut<T> for T where
T: ?Sized,

impl<T, U> Into<U> for T where
U: From<T>,

impl<T> ToOwned for T where
T: Clone,

impl<T> ToString for T where
T: Display + ?Sized,

impl<T, U> TryFrom<U> for T where
U: Into<T>,

impl<T, U> TryInto<U> for T where
U: TryFrom<T>,