// Copyright 2020 The Matrix.org Foundation C.I.C. // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. use cjson::Error as CjsonError; use matrix_sdk_common::identifiers::{DeviceId, Error as IdentifierError, UserId}; use olm_rs::errors::{OlmGroupSessionError, OlmSessionError}; use serde_json::Error as SerdeError; use thiserror::Error; use super::store::CryptoStoreError; pub type OlmResult = Result; pub type MegolmResult = Result; /// Error representing a failure during a device to device cryptographic /// operation. #[derive(Error, Debug)] pub enum OlmError { /// The event that should have been decrypted is malformed. #[error(transparent)] EventError(#[from] EventError), /// The received decrypted event couldn't be deserialized. #[error(transparent)] JsonError(#[from] SerdeError), /// The underlying Olm session operation returned an error. #[error("can't finish Olm Session operation {0}")] OlmSession(#[from] OlmSessionError), /// The underlying group session operation returned an error. #[error("can't finish Olm Session operation {0}")] OlmGroupSession(#[from] OlmGroupSessionError), /// The storage layer returned an error. #[error("failed to read or write to the crypto store {0}")] Store(#[from] CryptoStoreError), /// The session with a device has become corrupted. #[error("decryption failed likely because a Olm session was wedged")] SessionWedged, /// Encryption failed because the device does not have a valid Olm session /// with us. #[error( "encryption failed because the device does not \ have a valid Olm session with us" )] MissingSession, } /// Error representing a failure during a group encryption operation. #[derive(Error, Debug)] pub enum MegolmError { /// The event that should have been decrypted is malformed. #[error(transparent)] EventError(#[from] EventError), /// The received decrypted event couldn't be deserialized. #[error(transparent)] JsonError(#[from] SerdeError), /// Decryption failed because the session needed to decrypt the event is /// missing. #[error("decryption failed because the session to decrypt the message is missing")] MissingSession, /// The underlying group session operation returned an error. #[error("can't finish Olm group session operation {0}")] OlmGroupSession(#[from] OlmGroupSessionError), /// The storage layer returned an error. #[error(transparent)] Store(#[from] CryptoStoreError), } #[derive(Error, Debug)] pub enum EventError { #[error("the Olm message has a unsupported type")] UnsupportedOlmType, #[error("the Encrypted message has been encrypted with a unsupported algorithm.")] UnsupportedAlgorithm, #[error("the provided JSON value isn't an object")] NotAnObject, #[error("the Encrypted message doesn't contain a ciphertext for our device")] MissingCiphertext, #[error("the Encrypted message is missing the signing key of the sender")] MissingSigningKey, #[error("the Encrypted message is missing the sender key")] MissingSenderKey, #[error("the Encrypted message is missing the field {0}")] MissingField(String), #[error("the sender of the plaintext doesn't match the sender of the encrypted message.")] MissmatchedSender, #[error("the keys of the message don't match the keys in our database.")] MissmatchedKeys, } #[derive(Error, Debug)] pub enum SignatureError { #[error("the signature used a unsupported algorithm")] UnsupportedAlgorithm, #[error("the key id of the signing key is invalid")] InvalidKeyId(#[from] IdentifierError), #[error("the signing key is missing from the object that signed the message")] MissingSigningKey, #[error("the provided JSON value isn't an object")] NotAnObject, #[error("the provided JSON object doesn't contain a signatures field")] NoSignatureFound, #[error("the provided JSON object can't be converted to a canonical representation")] CanonicalJsonError(CjsonError), #[error("the signature didn't match the provided key")] VerificationError, } #[derive(Error, Debug)] pub(crate) enum SessionCreationError { #[error( "Failed to create a new Olm session for {0} {1}, the requested \ one-time key isn't a signed curve key" )] OneTimeKeyNotSigned(UserId, Box), #[error( "Tried to create a new Olm session for {0} {1}, but the signed \ one-time key is missing" )] OneTimeKeyMissing(UserId, Box), #[error("Failed to verify the one-time key signatures for {0} {1}: {2:?}")] InvalidSignature(UserId, Box, SignatureError), #[error( "Tried to create an Olm session for {0} {1}, but the device is missing \ a curve25519 key" )] DeviceMissingCurveKey(UserId, Box), #[error("Error creating new Olm session for {0} {1}: {2:?}")] OlmError(UserId, Box, OlmSessionError), } impl From for SignatureError { fn from(error: CjsonError) -> Self { Self::CanonicalJsonError(error) } }