Enum MigrationError 

pub enum MigrationError {
    MissingPolicyField(&'static str),
    UnknownMetadataField(String),
    NonConstrainedAdminPolicy(Option<i32>),
    UpdatePermissionsNotSuperAdmin(Option<i32>),
    Registry(ComponentRegistryError),
    MissingMutableMetadataExtension,
    MissingGroupMembershipExtension,
    GroupMembershipDecode(DecodeError),
    GroupPermissionsDecode(DecodeError),
    MutableMetadataDecode(GroupMutableMetadataError),
    GroupMetadataDecode(GroupMetadataError),
    TlsCodec(Error),
    InvalidInboxId(InboxIdError),
    UnknownMembershipPolicy(Option<i32>),
    ConversationTypePayloadLength(usize),
    DmMembersSelfReference(String),
    GroupMembershipEntryUnknownVersion,
    InvalidFailedInstallationLength(usize),
    GroupMembershipNonInsertBootstrapMutation,
    GroupMembershipDuplicateInbox(String),
    InvalidDisappearingTimestamp {
        field: &'static str,
        value: String,
        reason: String,
    },
    InvalidCommitLogSignerHex {
        reason: String,
    },
    InvalidCommitLogSignerLength {
        expected: usize,
        actual: usize,
    },
}

Errors produced by the synthesis functions in this module.

Variants

MissingPolicyField(&'static str)

A required PolicySet field was None. Both production presets populate every field, so this only fires on corrupt input.

UnknownMetadataField(String)

update_metadata_policy referenced a metadata field we don’t recognize. Silently dropping it would lose permission enforcement, so synthesis fails fast.

NonConstrainedAdminPolicy(Option<i32>)

add_admin_policy/remove_admin_policy wasn’t admin- or super-admin-gated; the constrained-component MetadataPolicy shape can’t represent it.

UpdatePermissionsNotSuperAdmin(Option<i32>)

update_permissions_policy must be AllowIfSuperAdmin — COMPONENT_REGISTRY is hardcoded super-admin-only on the receiver, so any other value would silently disagree.

Registry(ComponentRegistryError)

MissingMutableMetadataExtension

MissingGroupMembershipExtension

GroupMembershipDecode(DecodeError)

GroupPermissionsDecode(DecodeError)

Kept distinct from GroupMembershipDecode so incident-response greps land on the right extension type.

MutableMetadataDecode(GroupMutableMetadataError)

GroupMetadataDecode(GroupMetadataError)

TlsCodec(Error)

InvalidInboxId(InboxIdError)

UnknownMembershipPolicy(Option<i32>)

A GROUP_MEMBERSHIP membership-policy variant we can’t translate onto MetadataPolicyProto. Mirrors UnknownMetadataField — silently collapsing to Deny would lose enforcement.

ConversationTypePayloadLength(usize)

DmMembersSelfReference(String)

Legacy GroupMetadata.dm_members had the same inbox in both slots. TlsSet<InboxId> (the DM_MEMBERS wire encoding) dedupes by value and would silently collapse this to one element, so we fail loud instead of destroying information.

GroupMembershipEntryUnknownVersion

GroupMembershipEntry envelope decoded but the version oneof was unset (or set to a variant this build doesn’t recognize). Treated as a hard decode failure rather than a silent skip.

InvalidFailedInstallationLength(usize)

Legacy GroupMembership.failed_installations carried an entry whose length isn’t 32 bytes (the Ed25519 installation-key size). Either the legacy state is corrupt or the wire shape changed — either way, fail loud rather than silently admit a malformed installation ID into the validator’s allow-set.

GroupMembershipNonInsertBootstrapMutation

A bootstrap-time GROUP_MEMBERSHIP wire delta carried a non-Insert mutation. Bootstrap is always “delta from empty,” so anything but Insert means the sender is malformed.

GroupMembershipDuplicateInbox(String)

A bootstrap-time GROUP_MEMBERSHIP wire delta carried two Insert mutations for the same inbox id. The wire shape is TlsMapDelta which permits this in principle, but bootstrap must be a deterministic snapshot — the duplicate would let the sender’s queue order diverge from honest receivers.

InvalidDisappearingTimestamp

Legacy MessageDisappearFromNS / MessageDisappearInNS GMM attribute didn’t parse as a base-10 string of an i64. The legacy reader at MessageDisappearingSettings returns MissingExtension for this case; bootstrap synthesis fails loud instead so the migrated dict can’t silently drop a configured value.

Fields

field: &'static str

value: String

reason: String

InvalidCommitLogSignerHex

Legacy CommitLogSigner GMM attribute wasn’t valid hex.

Fields

reason: String

InvalidCommitLogSignerLength

Legacy CommitLogSigner decoded to the wrong number of bytes — the AppData wire shape is the raw 32-byte Ed25519 private key.

Fields

expected: usize

actual: usize

Trait Implementations

impl Debug for MigrationError

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

Formats the value using the given formatter.

impl Display for MigrationError

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

Formats the value using the given formatter.

impl Error for MigrationError

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<ComponentRegistryError> for MigrationError

fn from(source: ComponentRegistryError) -> Self

Converts to this type from the input type.

impl From<DecodeError> for MigrationError

fn from(source: DecodeError) -> Self

Converts to this type from the input type.

impl From<Error> for MigrationError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<GroupMetadataError> for MigrationError

fn from(source: GroupMetadataError) -> Self

Converts to this type from the input type.

impl From<GroupMutableMetadataError> for MigrationError

fn from(source: GroupMutableMetadataError) -> Self

Converts to this type from the input type.

impl From<InboxIdError> for MigrationError

fn from(source: InboxIdError) -> Self

Converts to this type from the input type.