Enum SessionCreationError 

pub enum SessionCreationError {
    MissingOneTimeKey(Curve25519PublicKey),
    MismatchedIdentityKey(Curve25519PublicKey, Curve25519PublicKey),
    MismatchedSessionConfig {
        expected: SessionConfig,
        got: Option<SessionConfig>,
    },
    Decryption(DecryptionError),
    NonContributoryKey,
}

Error describing failure modes when creating a Olm Session from an incoming Olm message.

Variants

MissingOneTimeKey(Curve25519PublicKey)

The pre-key message contained an unknown one-time key. This happens either because we never had such a one-time key, or because it has already been used up.

MismatchedIdentityKey(Curve25519PublicKey, Curve25519PublicKey)

The pre-key message contains a Curve25519 identity key that doesn’t match to the identity key that was given.

MismatchedSessionConfig

The pre-key message was encrypted with a Session which used an unexpected SessionConfig.

Fields

expected: SessionConfig

The SessionConfig we expected.

got: Option<SessionConfig>

The SessionConfig the pre-key message was encrypted with.

Will be None if we don’t understand the received config.

Decryption(DecryptionError)

The pre-key message that was used to establish the Session couldn’t be decrypted. The message needs to be decryptable, otherwise we will have created a Session that wasn’t used to encrypt the pre-key message.

NonContributoryKey

One or more keys lacked contributory behavior in the Diffie-Hellman operation, resulting in an insecure shared secret.

For more details on contributory behavior please refer to the x25519_dalek::SharedSecret::was_contributory() method.

Trait Implementations

impl Debug for SessionCreationError

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

Formats the value using the given formatter.

impl Display for SessionCreationError

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

Formats the value using the given formatter.

impl Error for SessionCreationError

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<DecryptionError> for SessionCreationError

fn from(source: DecryptionError) -> Self

Converts to this type from the input type.