Enum SoftchatError 

pub enum SoftchatError {
    InvalidSecretKey,
    InvalidPublicKey,
    InvalidEventId,
    InvalidEventSignature,
    InvalidEventKind,
    InvalidEventTimestamp,
    InvalidEventTag,
    InvalidEventJson,
    EventTooLarge,
    EventSigningFailed,
    Nip59EnvelopeCreationFailed,
    InvalidNip59Envelope,
    Nip17MessageCreationFailed,
    InvalidNip17Message,
    InvalidNip19Identifier,
    ExternalSignerCapabilityUnavailable,
    ExternalSignerCancelled,
    ExternalSignerRejected,
    InvalidExternalSignature,
    InvalidRelayFrame,
    InvalidRelayFilter,
    InvalidRelayAuthentication,
    InvalidRelayBatch,
    InvalidAttachmentMetadata,
    AttachmentTooLarge,
    AttachmentEncryptionFailed,
    AttachmentDecryptionFailed,
    InvalidHttpAuthorization,
    InvalidSoftchatEvent,
    SoftchatEventCreationFailed,
    InvalidSoftchatProjection,
    InvalidUserMetadata,
    InvalidContactList,
    InvalidApplicationData,
    InvalidRelaySession,
    RelaySessionQueueFull,
    InvalidDeliveryState,
    InvalidPersistenceResult,
    InvalidNoiseHandshake,
    NoiseHandshakeConsumed,
    NoiseSessionClosed,
    NoiseTransportFailed,
    InvalidNegentropy,
    EmptyPlaintext,
    PlaintextTooLarge,
    UnsupportedAlgorithm,
    CiphertextTooLarge,
    EncryptionFailed,
    DecryptionFailed,
    IdentityErased,
    InternalFailure,
}

Stable, redacted failures exposed by Softchat.

Variants

InvalidSecretKey

The supplied secret key is not one valid 32-byte secp256k1 scalar.

InvalidPublicKey

The supplied public key is not one valid 32-byte x-only public key.

InvalidEventId

The supplied event ID is malformed or does not match the event body.

InvalidEventSignature

The supplied Schnorr signature is malformed or does not verify.

InvalidEventKind

The event kind is outside the NIP-01 16-bit range.

InvalidEventTimestamp

The event timestamp cannot be represented exactly on every target.

InvalidEventTag

A NIP-01 tag is not an array containing at least one string.

InvalidEventJson

The event is not valid NIP-01 JSON.

EventTooLarge

The encoded event exceeds the portable Softchat input bound.

EventSigningFailed

Signing failed after the event draft and identity were validated.

Nip59EnvelopeCreationFailed

A NIP-59 envelope could not be created from the supplied inputs.

InvalidNip59Envelope

A NIP-59 envelope failed route, structure, or authentication checks.

Nip17MessageCreationFailed

A one-to-one NIP-17 text rumor could not be created.

InvalidNip17Message

A rumor is not a valid one-to-one NIP-17 text message.

InvalidNip19Identifier

A NIP-19 display identifier is malformed, unsupported, or oversized.

ExternalSignerCapabilityUnavailable

An external signer does not provide the capability required by a request.

ExternalSignerCancelled

An external signer operation was cancelled by the user or host.

ExternalSignerRejected

An external signer provider rejected an otherwise valid request.

InvalidExternalSignature

An external signer returned a signature that did not authenticate.

InvalidRelayFrame

A relay frame is malformed, unsupported, oversized, or has invalid arity.

InvalidRelayFilter

A NIP-01 relay filter is malformed or exceeds the portable bounds.

InvalidRelayAuthentication

A NIP-42 authentication request is malformed or does not match its context.

InvalidRelayBatch

An EVENTS batch or its acknowledgement set violates the Softchat profile.

InvalidAttachmentMetadata

Inline Softchat attachment metadata is malformed or outside its bounds.

AttachmentTooLarge

Attachment bytes exceed the bounded in-memory compatibility operation.

AttachmentEncryptionFailed

Attachment encryption failed after validation.

AttachmentDecryptionFailed

Attachment authentication or decryption failed.

InvalidHttpAuthorization

A NIP-98 request plan has an invalid method, URL, payload, or redirect.

InvalidSoftchatEvent

A typed Softchat chat event is malformed or violates its profile.

SoftchatEventCreationFailed

A canonical Softchat event could not be created from the supplied values.

InvalidSoftchatProjection

A pure event-history projection contains unauthorized or malformed input.

InvalidUserMetadata

A private metadata rumor or its retained JSON is invalid.

InvalidContactList

A private NIP-02 contact backup is malformed or ambiguous.

InvalidApplicationData

NIP-78 or Softchat app-data content is malformed or unauthorized.

InvalidRelaySession

A relay-session transition is invalid for its current state.

RelaySessionQueueFull

A bounded relay-session queue cannot accept more work.

InvalidDeliveryState

A delivery transition or retry result is contradictory.

InvalidPersistenceResult

A platform persistence result does not match its requested transaction.

InvalidNoiseHandshake

A Noise NK handshake key or message is malformed or unauthenticated.

NoiseHandshakeConsumed

A single-use Noise handshake capability was already consumed.

NoiseSessionClosed

An established Noise session was explicitly closed.

NoiseTransportFailed

Noise transport rejected a frame without exposing cryptographic detail.

InvalidNegentropy

A Negentropy set, frame, limit, or state transition is invalid.

EmptyPlaintext

NIP-44 does not permit an empty plaintext.

PlaintextTooLarge

The UTF-8 plaintext exceeds the NIP-44 v2 limit.

UnsupportedAlgorithm

The message declares an algorithm this library does not understand.

CiphertextTooLarge

The encoded ciphertext exceeds Softchat’s cheap pre-decode bound.

EncryptionFailed

Encryption failed after the inputs were validated.

DecryptionFailed

Authentication, decoding, padding, version, or UTF-8 validation failed.

IdentityErased

The local identity’s secret material was explicitly erased.

InternalFailure

An unexpected implementation failure was redacted at the public boundary.

Implementations

impl SoftchatError

pub const fn code(&self) -> &'static str

Stable machine-readable error code used by authored language facades.

Trait Implementations

impl Clone for SoftchatError

fn clone(&self) -> SoftchatError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<UT> ConvertError<UT> for SoftchatError

fn try_convert_unexpected_callback_error( e: UnexpectedUniFFICallbackError, ) -> Result<Self>

impl Debug for SoftchatError

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

Formats the value using the given formatter.

impl Display for SoftchatError

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

Formats the value using the given formatter.

impl Error for SoftchatError

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<UT> FfiConverter<UT> for SoftchatError

const TYPE_ID_META: MetadataBuffer

Type ID metadata, serialized into a [MetadataBuffer].

type FfiType = RustBuffer

The low-level type used for passing values of this type over the FFI.

fn lower(v: Self) -> RustBuffer

Lower a rust value of the target type, into an FFI value of type Self::FfiType.

fn try_lift(buf: RustBuffer) -> Result<Self>

Lift a rust value of the target type, from an FFI value of type Self::FfiType.

fn write(obj: Self, buf: &mut Vec<u8>)

Write a rust value into a buffer, to send over the FFI in serialized form.

fn try_read(buf: &mut &[u8]) -> Result<Self>

Read a rust value from a buffer, received over the FFI in serialized form.

impl From<ExternalSignerFailure> for SoftchatError

fn from(failure: ExternalSignerFailure) -> Self

Converts to this type from the input type.

impl<UT> Lift<UT> for SoftchatError

type FfiType = <SoftchatError as FfiConverter<UT>>::FfiType

fn try_lift(v: Self::FfiType) -> Result<Self>

fn try_read(buf: &mut &[u8]) -> Result<Self>

fn try_lift_from_rust_buffer(v: RustBuffer) -> Result<Self, Error>

Convenience method

impl<UT> LiftRef<UT> for SoftchatError

type LiftType = SoftchatError

impl<UT> LiftReturn<UT> for SoftchatError

type ReturnType = <SoftchatError as Lift<UT>>::FfiType

FFI return type for trait interfaces

fn try_lift_successful_return(v: Self::ReturnType) -> Result<Self>

Lift a successfully returned value from a trait interface

fn lift_foreign_return( ffi_return: Self::ReturnType, call_status: RustCallStatus, ) -> Self

Lift a foreign returned value from a trait interface

fn lift_error(_buf: RustBuffer) -> Self

Lift a Rust value for a callback interface method error result

fn handle_callback_unexpected_error(e: UnexpectedUniFFICallbackError) -> Self

Lift a Rust value for an unexpected callback interface error

impl<UT> Lower<UT> for SoftchatError

type FfiType = <SoftchatError as FfiConverter<UT>>::FfiType

fn lower(obj: Self) -> Self::FfiType

fn write(obj: Self, buf: &mut Vec<u8>)

fn lower_into_rust_buffer(obj: Self) -> RustBuffer

Convenience method

impl<UT> LowerError<UT> for SoftchatError

fn lower_error(obj: Self) -> RustBuffer

Lower this value for scaffolding function return

impl<UT> LowerReturn<UT> for SoftchatError

type ReturnType = <SoftchatError as Lower<UT>>::FfiType

The type that should be returned by scaffolding functions for this type.

fn lower_return(v: Self) -> Result<Self::ReturnType, RustCallError>

Lower the return value from an scaffolding call

fn handle_failed_lift( error: LiftArgsError, ) -> Result<Self::ReturnType, RustCallError>

Lower the return value for failed argument lifts

impl PartialEq for SoftchatError

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

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<UT> TypeId<UT> for SoftchatError

const TYPE_ID_META: MetadataBuffer

impl Copy for SoftchatError

impl Eq for SoftchatError

impl StructuralPartialEq for SoftchatError