Enum GroupMessageProcessingError 

pub enum GroupMessageProcessingError {
    IntentAlreadyProcessed,
    MessageAlreadyProcessed(MessageIdentifier),
    MessageIdentifierNotFound,
    WelcomeAlreadyProcessed(u64),
    InvalidSender {
        message_time_ns: u64,
        credential: Vec<u8>,
    },
    InvalidPayload,
    IncomingHeadChanged,
    CorruptIncomingEnvelope(DecodeError),
    UnsupportedMlsVersion,
    LostProposalState,
    Envelope(EnvelopeError),
    OwnMessageWithoutAttempt,
    UnsupportedOwnIntentKind(String),
    PreparedAttempt(Box<GroupError>),
    RejectedIntent(&'static str),
    Storage(StorageError),
    Identity(IdentityError),
    OpenMlsProcessMessage(ProcessMessageError<SqlKeyStoreError>),
    OpenMlsProcessMessageWithAppData(ProcessMessageWithAppDataError<SqlKeyStoreError>),
    MergeStagedCommit(MergeCommitError<SqlKeyStoreError>),
    TlsError(Error),
    UnsupportedMessageType(Discriminant<ProtocolMessage>),
    UnexpectedProcessedContent(&'static str),
    CommitValidation(CommitValidationError),
    EpochIncrementNotAllowed,
    ClearPendingCommit(SqlKeyStoreError),
    Serde(Error),
    IntentMissingStagedCommit,
    EncodeProto(EncodeError),
    DecodeProto(DecodeError),
    Intent(IntentError),
    Codec(CodecError),
    WrongCredentialType(BasicCredentialError),
    ProcessIntent(ProcessIntentError),
    AssociationDeserialization(DeserializationError),
    Client(ClientError),
    GroupPaused,
    GroupInactive,
    OldEpoch(u64, u64),
    FutureEpoch(u64, u64),
    Db(ConnectionError),
    Builder(UninitializedFieldError),
    Diesel(Error),
    EnrichMessage(EnrichMessageError),
    PreCommitProposalPhaseComplete,
    Conversion(ConversionError),
    EpochAuthenticatorNotAdvanced {
        group_id: GroupId,
        commit_sequence_id: i64,
        epoch: u64,
    },
}

Variants

IntentAlreadyProcessed

MessageAlreadyProcessed(MessageIdentifier)

MessageIdentifierNotFound

WelcomeAlreadyProcessed(u64)

InvalidSender

Fields

message_time_ns: u64

credential: Vec<u8>

InvalidPayload

IncomingHeadChanged

The received prefix changed before this attempt acquired the writer.

CorruptIncomingEnvelope(DecodeError)

The local pending record cannot be decoded. Processing must stop.

UnsupportedMlsVersion

The MLS wire version is not supported. Keep this envelope pending.

LostProposalState

A commit names a proposal the ordered prefix delivered, but the local proposal store no longer holds it. This is lost local state, not evidence that the commit is invalid, so the head is held.

Envelope(EnvelopeError)

Supported envelope framing fails validation after its complete prefix.

OwnMessageWithoutAttempt

Own ciphertext has no durable prepared attempt.

UnsupportedOwnIntentKind(String)

Our own echo names an intent whose kind a newer build wrote and this one cannot decode.

This holds the head rather than rejecting it. The envelope may be a commit every other member applied; skipping it would leave this installation behind the group with no way back. It is also not an external message — treating it as one would validate a commit we authored against external-actor rules. Not retryable, so the head is marked blocked and reconsidered once a build that can read the kind runs again.

PreparedAttempt(Box<GroupError>)

A local prepared attempt cannot safely explain this own envelope.

RejectedIntent(&'static str)

A stored terminal rejection whose original parameters were not retained.

Storage(StorageError)

Identity(IdentityError)

OpenMlsProcessMessage(ProcessMessageError<SqlKeyStoreError>)

OpenMlsProcessMessageWithAppData(ProcessMessageWithAppDataError<SqlKeyStoreError>)

AppDataUpdate-aware processing wrapper error.

Wraps the same ProcessMessageError as the variant above, plus the ComponentSourceError that fires when an incoming AppDataUpdate payload can’t be decoded under our wire format. Kept distinct from OpenMlsProcessMessage so the AppData-decode failure mode is greppable in logs.

MergeStagedCommit(MergeCommitError<SqlKeyStoreError>)

TlsError(Error)

UnsupportedMessageType(Discriminant<ProtocolMessage>)

UnexpectedProcessedContent(&'static str)

Processed-message content that cannot legitimately reach the apply phase: UnresolvedAppDataCommit is always resolved inside process_message_with_app_data, and OwnPendingCommit is only produced for public-framed commits, which libxmtp’s pure-ciphertext wire format policy never emits.

CommitValidation(CommitValidationError)

EpochIncrementNotAllowed

ClearPendingCommit(SqlKeyStoreError)

Serde(Error)

IntentMissingStagedCommit

EncodeProto(EncodeError)

DecodeProto(DecodeError)

Intent(IntentError)

Codec(CodecError)

WrongCredentialType(BasicCredentialError)

ProcessIntent(ProcessIntentError)

AssociationDeserialization(DeserializationError)

Client(ClientError)

GroupPaused

GroupInactive

Processing stops at the removal commit until a valid rejoin Welcome.

OldEpoch(u64, u64)

FutureEpoch(u64, u64)

Db(ConnectionError)

Builder(UninitializedFieldError)

Diesel(Error)

EnrichMessage(EnrichMessageError)

PreCommitProposalPhaseComplete

Conversion(ConversionError)

EpochAuthenticatorNotAdvanced

A successful staged-commit merge by a member that remains in the group must advance the epoch and therefore change the epoch authenticator. If it did not, the group state the commit was merged onto was corrupt/torn (e.g. produced by a cross-process race on a shared MLS DB). Retryable: the enclosing transaction (cursor + merge + commit log) rolls back and the message is reprocessed against settled state.

Fields

group_id: GroupId

commit_sequence_id: i64

epoch: u64

Trait Implementations

impl Debug for GroupMessageProcessingError

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

Formats the value using the given formatter.

impl Display for GroupMessageProcessingError

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

Formats the value using the given formatter.

impl Error for GroupMessageProcessingError

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<BasicCredentialError> for GroupMessageProcessingError

fn from(source: BasicCredentialError) -> Self

Converts to this type from the input type.

impl From<ClientError> for GroupMessageProcessingError

fn from(source: ClientError) -> Self

Converts to this type from the input type.

impl From<CodecError> for GroupMessageProcessingError

fn from(source: CodecError) -> Self

Converts to this type from the input type.

impl From<CommitRuleError> for GroupMessageProcessingError

fn from(error: CommitRuleError) -> Self

Converts to this type from the input type.

impl From<CommitValidationError> for GroupMessageProcessingError

fn from(source: CommitValidationError) -> Self

Converts to this type from the input type.

impl From<ConnectionError> for GroupMessageProcessingError

fn from(source: ConnectionError) -> Self

Converts to this type from the input type.

impl From<ConversionError> for GroupMessageProcessingError

fn from(source: ConversionError) -> Self

Converts to this type from the input type.

impl From<DecodeError> for GroupMessageProcessingError

fn from(source: DecodeError) -> Self

Converts to this type from the input type.

impl From<DeserializationError> for GroupMessageProcessingError

fn from(source: DeserializationError) -> Self

Converts to this type from the input type.

impl From<EncodeError> for GroupMessageProcessingError

fn from(source: EncodeError) -> Self

Converts to this type from the input type.

impl From<EnrichMessageError> for GroupMessageProcessingError

fn from(source: EnrichMessageError) -> Self

Converts to this type from the input type.

impl From<Error> for GroupMessageProcessingError

fn from(source: TlsCodecError) -> Self

Converts to this type from the input type.

impl From<Error> for GroupMessageProcessingError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for GroupMessageProcessingError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<GroupMessageProcessingError> for GroupError

fn from(source: GroupMessageProcessingError) -> Self

Converts to this type from the input type.

impl From<GroupMessageProcessingError> for IncomingError

fn from(source: GroupMessageProcessingError) -> Self

Converts to this type from the input type.

impl From<GroupMessageProcessingError> for SubscribeError

fn from(value: GroupMessageProcessingError) -> Self

Converts to this type from the input type.

impl From<IdentityError> for GroupMessageProcessingError

fn from(source: IdentityError) -> Self

Converts to this type from the input type.

impl From<IntentError> for GroupMessageProcessingError

fn from(source: IntentError) -> Self

Converts to this type from the input type.

impl From<MergeCommitError<SqlKeyStoreError>> for GroupMessageProcessingError

fn from(source: MergeCommitError<SqlKeyStoreError>) -> Self

Converts to this type from the input type.

impl From<ProcessMessageError<SqlKeyStoreError>> for GroupMessageProcessingError

fn from(source: ProcessMessageError<SqlKeyStoreError>) -> Self

Converts to this type from the input type.

impl From<ProcessMessageWithAppDataError<SqlKeyStoreError>> for GroupMessageProcessingError

fn from(source: ProcessMessageWithAppDataError<SqlKeyStoreError>) -> Self

Converts to this type from the input type.

impl From<SqlKeyStoreError> for GroupMessageProcessingError

fn from(source: SqlKeyStoreError) -> Self

Converts to this type from the input type.

impl From<StorageError> for GroupMessageProcessingError

fn from(source: StorageError) -> Self

Converts to this type from the input type.

impl From<UninitializedFieldError> for GroupMessageProcessingError

fn from(source: UninitializedFieldError) -> Self

Converts to this type from the input type.

impl NeedsDbReconnect for GroupMessageProcessingError

fn needs_db_reconnect(&self) -> bool

impl RetryableError for GroupMessageProcessingError

fn is_retryable(&self) -> bool