Mesh SDK error codes

These names come from the v0.27.0 UniFFI ProtocolError enum. Bindings expose errors through their own exception or rejected-promise representation; do not assume a shared HTTP status or a stable free-text message. Keep the native error detail in diagnostics without recording secrets.

Error	Application action
`NotStarted`	Start the protocol before this operation.
`AlreadyStarted`	Reuse the running instance.
`InvalidConfiguration`	Correct the configuration before starting.
`SendFailed`	Capture the accompanying detail and inspect the failing operation before retrying.
`NoKeyPackage`	Exchange key packages before creating the session.
`SessionNotReady`	Wait for session establishment; do not count the request as accepted.
`EncryptFailed`	Capture the accompanying detail and inspect the failing operation before retrying.
`InvalidState`	Check lifecycle and document removal state before retrying.
`MlsNotInitialized`	Capture the accompanying detail and inspect the failing operation before retrying.
`MlsError`	Capture the accompanying detail and inspect the failing operation before retrying.
`UserBlocked`	Respect the block decision; do not retry automatically.
`MediaTransferLimit`	Wait for an active transfer to settle.
`LockPoisoned`	Capture diagnostics and restart the affected process; report the panic.
`Other`	Capture the accompanying detail and inspect the failing operation before retrying.
`TransportError`	Capture the accompanying detail and inspect the failing operation before retrying.
`SerializationError`	Capture the accompanying detail and inspect the failing operation before retrying.
`ServiceError`	Capture the accompanying detail and inspect the failing operation before retrying.
`GroupNotFound`	Check local group membership.
`PermissionDenied`	Check authorization and group role.
`InvalidArgument`	Correct the rejected argument.
`DataDisabled`	Enable encryption and the data layer.
`DataStorageUnavailable`	Initialize MLS storage before accessing documents.
`DocTooLarge`	Shrink the document. The change that exceeded the cap may already be durable.
`DataCorrupted`	Do not retry the same corrupt blob; recover from a trusted copy.
`TelemetryConfigInvalid`	Correct the named telemetry configuration field.

A failed call and an asynchronous delivery failure are different. Track message_failed and media terminal events as well as caught errors. See troubleshooting.

SDK setup

API by task

Types and events

Architecture