Struct Client 

pub struct Client<Provider>
where
    Provider: OpenMlsProvider,
{
    pub identity: Vec<u8>,
    pub credentials: HashMap<Ciphersuite, CredentialWithKey>,
    pub provider: Provider,
    pub groups: RwLock<HashMap<GroupId, MlsGroup>>,
}

The client contains the necessary state for a client in the context of MLS. It contains the group states, as well as a reference to a KeyStore containing its CredentialWithKeys. The key_package_bundles field contains generated KeyPackageBundles that are waiting to be used for new groups.

Fields

identity: Vec<u8>

Name of the client.

credentials: HashMap<Ciphersuite, CredentialWithKey>

Ciphersuites supported by the client.

provider: Provider

groups: RwLock<HashMap<GroupId, MlsGroup>>

Implementations

impl<Provider> Client<Provider>

where Provider: OpenMlsProvider,

pub fn get_fresh_key_package( &self, ciphersuite: Ciphersuite, ) -> Result<KeyPackage, ClientError<<Provider as OpenMlsProvider>::StorageError>>

Generate a fresh key package and return it. The first ciphersuite determines the credential used to generate the KeyPackage.

pub fn create_group( &self, mls_group_create_config: MlsGroupCreateConfig, ciphersuite: Ciphersuite, ) -> Result<GroupId, ClientError<<Provider as OpenMlsProvider>::StorageError>>

Create a group with the given MlsGroupCreateConfig and Ciphersuite, and return the created GroupId.

Returns an error if the client doesn’t support the ciphersuite.

pub fn join_group( &self, mls_group_config: MlsGroupJoinConfig, welcome: Welcome, ratchet_tree: Option<RatchetTreeIn>, ) -> Result<(), ClientError<<Provider as OpenMlsProvider>::StorageError>>

Join a group based on the given welcome and ratchet_tree. The group is created with the given MlsGroupCreateConfig. Throws an error if no KeyPackage exists matching the Welcome, if the client doesn’t support the ciphersuite, or if an error occurs processing the Welcome.

pub fn receive_messages_for_group<AS>( &self, message: &ProtocolMessage, sender_id: &[u8], authentication_service: &AS, ) -> Result<(), ClientError<<Provider as OpenMlsProvider>::StorageError>>

where AS: Fn(&Credential) -> bool,

Have the client process the given messages. Returns an error if an error occurs during message processing or if no group exists for one of the messages.

pub fn get_members_of_group( &self, group_id: &GroupId, ) -> Result<Vec<Member>, ClientError<<Provider as OpenMlsProvider>::StorageError>>

Get the credential and the index of each group member of the group with the given id. Returns an error if no group exists with the given group id.

pub fn self_update( &self, action_type: ActionType, group_id: &GroupId, leaf_node_parameters: LeafNodeParameters, ) -> Result<(MlsMessageOut, Option<Welcome>, Option<GroupInfo>), ClientError<<Provider as OpenMlsProvider>::StorageError>>

Have the client either propose or commit (depending on the action_type) a self update in the group with the given group id. Optionally, a HpkeKeyPair can be provided, which the client will update their leaf with. Returns an error if no group with the given group id can be found or if an error occurs while creating the update.

pub fn add_members( &self, action_type: ActionType, group_id: &GroupId, key_packages: &[KeyPackage], ) -> Result<(Vec<MlsMessageOut>, Option<Welcome>, Option<GroupInfo>), ClientError<<Provider as OpenMlsProvider>::StorageError>>

Have the client either propose or commit (depending on the action_type) adding the clients with the given KeyPackages to the group with the given group id. Returns an error if no group with the given group id can be found or if an error occurs while performing the add operation.

pub fn remove_members( &self, action_type: ActionType, group_id: &GroupId, targets: &[LeafNodeIndex], ) -> Result<(Vec<MlsMessageOut>, Option<Welcome>, Option<GroupInfo>), ClientError<<Provider as OpenMlsProvider>::StorageError>>

Have the client either propose or commit (depending on the action_type) removing the clients with the given indices from the group with the given group id. Returns an error if no group with the given group id can be found or if an error occurs while performing the remove operation.

pub fn identity(&self, group_id: &GroupId) -> Option<Vec<u8>>

Get the identity of this client in the given group.

Trait Implementations

impl<Provider> Debug for Client<Provider>

where Provider: Debug + OpenMlsProvider,

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

Formats the value using the given formatter.