mls-spec 2.0.0

This crate is a repository of MLS / RFC9420-related data structures.
Documentation 
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

#[derive(Debug, thiserror::Error, miette::Diagnostic)]
pub enum MlsSpecError {
    #[error("This wire format identifier is outside the private reserved use range")]
    #[diagnostic(code(mls_spec::invalid_private_range_wireformat))]
    InvalidPrivateRangeWireFormat,
    #[error("This ciphersuite identifier is outside the private reserved use range")]
    #[diagnostic(code(mls_spec::invalid_private_range_ciphersuite))]
    InvalidPrivateRangeCiphersuite,
    #[error("This extension type identifier is outside the private reserved use range")]
    #[diagnostic(code(mls_spec::invalid_private_range_extension_type))]
    InvalidPrivateRangeExtensionType,
    #[error("This proposal type identifier is outside the private reserved use range")]
    #[diagnostic(code(mls_spec::invalid_private_range_proposal_type))]
    InvalidPrivateRangeProposalType,
    #[error("This credential type identifier is outside the private reserved use range")]
    #[diagnostic(code(mls_spec::invalid_private_range_credential_type))]
    InvalidPrivateRangeCredentialType,
    #[error("This content type identifier is outside the specification")]
    #[diagnostic(code(mls_spec::invalid_content_type))]
    InvalidContentType,
    #[error("Trying to build a FramedContentTBS but the GroupContext hasn't been provided")]
    #[diagnostic(code(mls_spec::missing_ctx))]
    FramedContentTBSMissingGroupContext,
    #[error(
        "A reserved value has been used. While we do have definitions for them, they're not supposed to be used in-protocol"
    )]
    #[diagnostic(code(mls_spec::reserved_value_usage))]
    ReservedValueUsage,
    #[error("You have tried to use an invalid value spec-wise")]
    #[diagnostic(code(mls_spec::invalid_spec_value))]
    InvalidSpecValue,
    #[error(transparent)]
    #[diagnostic(code(mls_spec::tls_codec_error))]
    #[diagnostic_source]
    TlsCodecError(#[from] tls_codec::Error),
    #[cfg(feature = "mls-rs-compat")]
    #[error(transparent)]
    #[diagnostic(code(mls_spec::mls_rs_codec_error))]
    #[diagnostic_source]
    MlsRsCodecError(#[from] mls_rs_codec::Error),
    #[cfg(feature = "draft-ietf-mls-extensions")]
    #[error("The Parameter value isn't utf-8")]
    #[diagnostic(code(mls_spec::content_adv_utf8_param_err))]
    ContentAdvertisementUtf8ParameterError,
    #[cfg(feature = "draft-ietf-mls-extensions-content-advertisement-parse")]
    #[error(transparent)]
    #[diagnostic(code(mls_spec::content_adv_invalid_mimetype))]
    ContentAdvertisementInvalidMimeType(#[from] mediatype::MediaTypeError),
    #[cfg(feature = "draft-ietf-mls-extensions")]
    #[error("SafeApp component ID is outside the private reserved use range")]
    #[diagnostic(code(mls_spec::invalid_private_range_component_id))]
    InvalidPrivateRangeComponentId,
    #[cfg(feature = "draft-ietf-mls-extensions")]
    #[error("SafeApp component ID mismatches, expected {expected}, but data contains {actual}")]
    #[diagnostic(code(mls_spec::safe_app_component_id_mismatch))]
    SafeAppComponentIdMismatch {
        expected: crate::drafts::mls_extensions::safe_application::ComponentId,
        actual: crate::drafts::mls_extensions::safe_application::ComponentId,
    },
}

pub type MlsSpecResult<T> = Result<T, MlsSpecError>;