openmls 0.8.1

A Rust implementation of the Messaging Layer Security (MLS) protocol, as defined in RFC 9420.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74

use thiserror::Error;

use crate::{
    error::LibraryError,
    extensions::errors::InvalidExtensionError,
    treesync::errors::{LeafNodeValidationError, TreeSyncFromNodesError},
};

/// Public group creation from external error.
#[derive(Error, Debug, PartialEq, Clone)]
pub enum CreationFromExternalError<StorageError> {
    /// See [`LibraryError`] for more details.
    #[error(transparent)]
    LibraryError(#[from] LibraryError),
    /// This error indicates the public tree is invalid. See [`TreeSyncFromNodesError`] for more details.
    #[error(transparent)]
    TreeSyncError(#[from] TreeSyncFromNodesError),
    /// Sender not found in tree.
    #[error("Sender not found in tree.")]
    UnknownSender,
    /// The signature on the GroupInfo is not valid.
    #[error("The signature on the GroupInfo is not valid.")]
    InvalidGroupInfoSignature,
    /// The computed tree hash does not match the one in the GroupInfo.
    #[error("The computed tree hash does not match the one in the GroupInfo.")]
    TreeHashMismatch,
    /// We don't support the version of the group we are trying to join.
    #[error("We don't support the version of the group we are trying to join.")]
    UnsupportedMlsVersion,
    /// See [`LeafNodeValidationError`]
    #[error(transparent)]
    LeafNodeValidation(#[from] LeafNodeValidationError),
    /// Error writing to storage.
    #[error("Error writing to storage: {0}")]
    WriteToStorageError(StorageError),
    /// A parent node has an unmerged leaf that is not a descendant of the node.
    #[error("A parent node has an unmerged leaf that is not a descendant of the node")]
    UnmergedLeafNotADescendant,
    /// Found a path from a parent with an unmerged leaf to the leaf with nodes that do not have that as a leaf  
    #[error("Found a path from a parent with an unmerged leaf to the leaf with nodes that do not have that as a leaf")]
    IntermediateNodeMissingUnmergedLeaf,
    /// The ratchet tree contains duplcate encryption keys
    #[error("The ratchet tree contains duplcate encryption keys")]
    DuplicateEncryptionKey,
    /// The ratchet tree contains duplcate signature keys
    #[error("The ratchet tree contains duplcate signature keys")]
    DuplicateSignatureKey,
}

/// Public group builder error.
#[derive(Error, Debug, PartialEq, Clone)]
pub enum PublicGroupBuildError {
    /// See [`LibraryError`] for more details.
    #[error(transparent)]
    LibraryError(#[from] LibraryError),
    /// Invalid extensions set in configuration
    #[error("Invalid extensions set in configuration")]
    InvalidExtensions(#[from] InvalidExtensionError),
}

/// The errors that may occur while applying AppDataUpdate proposals
#[cfg(feature = "extensions-draft-08")]
#[derive(Error, Debug, PartialEq, Clone)]
pub enum ApplyAppDataUpdateError {
    /// Found AppDataUpdate proposals, but was not provided the updated values
    #[error("Found AppDataUpdate proposals, but was not provided the updated values")]
    MissingAppDataUpdates,
    /// No AppDataUpdate proposals found, but was provided updated values
    #[error("No AppDataUpdate proposals found, but was provided updated values")]
    SuperfluousAppDataUpdates,
    /// See [`LibraryError`] for more details.
    #[error(transparent)]
    LibraryError(#[from] LibraryError),
}