Module prelude

Common imports that should be useful for most uses of the crate

Re-exports

• pub use crate::e2e_identity::error::E2eIdentityError;
• pub use crate::e2e_identity::error::E2eIdentityResult;
• pub use crate::e2e_identity::types::E2eiAcmeChallenge;
• pub use crate::e2e_identity::types::E2eiAcmeDirectory;
• pub use crate::e2e_identity::types::E2eiNewAcmeAuthz;
• pub use crate::e2e_identity::types::E2eiNewAcmeOrder;
• pub use crate::e2e_identity::E2eiEnrollment;
• pub use crate::mls::conversation::decrypt;
• pub use crate::mls::conversation::decrypt::MlsBufferedConversationDecryptMessage;
• pub use crate::mls::conversation::decrypt::MlsConversationDecryptMessage;
• pub use crate::mls::conversation::ConversationId;
• pub use crate::mls::conversation::MlsConversation;
• pub use crate::mls::MlsCentral;
• pub use crate::CoreCrypto;
• pub use crate::MlsTransport;

Structs

• CertificateBundle
  Represents a x509 certificate chain supplied by the client It can fetch it after an end-to-end identity process where it can get back a certificate from the Authentication Service
• Client
  Represents a MLS client which in our case is the equivalent of a device.
• ClientId
  A Client identifier
• Credential
  Credential.
• EntropySeed
  Wrapped 32-byte entropy seed with bounds check
• GroupEpoch
  Group epoch. Internally this is stored as a u64. The group epoch is incremented with every valid Commit that is merged into the group state.
• KeyPackage
  The key package struct.
• KeyPackageIn
  The key package struct.
• MlsCentralConfiguration
  Configuration parameters for MlsCentral
• MlsCiphersuite
  A wrapper for the OpenMLS Ciphersuite, so that we are able to provide a default value.
• MlsCommitBundle
  Returned when a commit is created
• MlsConversationConfiguration
  The configuration parameters for a group/conversation
• MlsConversationCreationMessage
  Returned when initializing a conversation through a commit. Different from conversation created from a [openmls::prelude::Welcome] message or an external commit.
• MlsConversationInitBundle
  Returned when a commit is created
• MlsCryptoProvider
• MlsCustomConfiguration
  The configuration parameters for a group/conversation which are not handled natively by openmls
• MlsGroup
  A MlsGroup represents an MLS group with a high-level API. The API exposes high level functions to manage a group by adding/removing members, get the current member list, etc.
• MlsGroupConfig
  Specifies the configuration parameters for a MlsGroup. Refer to the User Manual for more information about the different configuration values.
• MlsGroupInfoBundle
  A [GroupInfo] with metadata
• MlsMessageIn
  Before use with the MlsGroup API, the message has to be unpacked via extract to yield its [MlsMessageInBody].
• MlsProposalBundle
  Returned when a Proposal is created. Helps roll backing a local proposal
• MlsProposalRef
  Abstraction over a [openmls::prelude::hash_ref::ProposalRef] to deal with conversions
• MlsRotateBundle
  Result returned after rotating the Credential of the current client in all the local conversations
• VerifiableGroupInfo
  A type that represents a group info of which the signature has not been verified. It implements the [Verifiable] trait and can be turned into a group info by calling verify(...) with the signature key of the Credential. When receiving a serialized group info, it can only be deserialized into a VerifiableGroupInfo, which can then be turned into a group info as described above.
• WelcomeBundle
  Contains everything client needs to know after decrypting an (encrypted) Welcome message
• WireIdentity
  Represents the identity claims identifying a client Those claims are verifiable by any member in the group
• X509Identity
  Represents the parts of WireIdentity that are specific to a X509 certificate (and not a Basic one).

Enums

• CiphersuiteName
  MLS ciphersuites.
• ClientIdentifier
  Used by consumers to initializes a MLS client. Encompasses all the client types available. Could be enriched later with Verifiable Presentations.
• CryptoError
  CoreCrypto errors
• CryptoboxMigrationError
  Wrapper for errors that can happen during a Cryptobox migration
• DeviceStatus
  Indicates the standalone status of a device Credential in a MLS group at a moment T. This does not represent the states where a device is not using MLS or is not using end-to-end identity
• E2eiConversationState
  Indicates the state of a Conversation regarding end-to-end identity.
• GroupInfoPayload
  Represents the byte array in MlsGroupInfoBundle
• MlsCredentialType
  Lists all the supported Credential types. Could list in the future some types not supported by openmls such as Verifiable Presentation
• MlsError
  MLS-specific error wrapper - see github.com/openmls/openmls for details
• MlsGroupInfoEncryptionType
  GroupInfoEncryptionType
• MlsProposal
  Internal representation of proposal to ease further additions
• MlsRatchetTreeType
  RatchetTreeType
• MlsWirePolicy
  Wrapper over WireFormatPolicy
• Node
  Container enum for leaf and parent nodes.
• ProteusError
  Wrapper for Proteus-related errors

Constants

• INITIAL_KEYING_MATERIAL_COUNT
  Default number of KeyPackages a client generates the first time it’s created

Type Aliases

• CryptoResult
  A simpler definition for Result types that the Error is a CryptoError
• KeyPackageRef
  A reference to a key package. This value uniquely identifies a key package.
• RawEntropySeed
  32-byte raw entropy seed