Struct MlsCentralConfiguration

#[non_exhaustive]
pub struct MlsCentralConfiguration {
    pub store_path: String,
    pub identity_key: String,
    pub client_id: Option<ClientId>,
    pub external_entropy: Option<EntropySeed>,
    pub ciphersuites: Vec<MlsCiphersuite>,
    pub nb_init_key_packages: Option<usize>,
}

Configuration parameters for MlsCentral

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

store_path: String

Location where the SQLite/IndexedDB database will be stored

identity_key: String

Identity key to be used to instantiate the MlsCryptoProvider

client_id: Option<ClientId>

Identifier for the client to be used by MlsCentral

external_entropy: Option<EntropySeed>

Entropy pool seed for the internal PRNG

ciphersuites: Vec<MlsCiphersuite>

All supported ciphersuites

nb_init_key_packages: Option<usize>

Number of openmls::prelude::KeyPackage to create when creating a MLS client. Default to INITIAL_KEYING_MATERIAL_COUNT

Implementations

impl MlsCentralConfiguration

pub fn try_new( store_path: String, identity_key: String, client_id: Option<ClientId>, ciphersuites: Vec<MlsCiphersuite>, entropy: Option<Vec<u8>>, nb_init_key_packages: Option<usize>, ) -> CryptoResult<Self>

Creates a new instance of the configuration.

Arguments

• store_path - location where the SQLite/IndexedDB database will be stored
• identity_key - identity key to be used to instantiate the MlsCryptoProvider
• client_id - identifier for the client to be used by MlsCentral
• ciphersuites - Ciphersuites supported by this device
• entropy - External source of entropy for platforms where default source insufficient

Errors

Any empty string parameter will result in a CryptoError::MalformedIdentifier error.

Examples

This should fail:

use core_crypto::{prelude::MlsCentralConfiguration, CryptoError};

let result = MlsCentralConfiguration::try_new(String::new(), String::new(), Some(b"".to_vec().into()), vec![], None, Some(100));
assert!(matches!(result.unwrap_err(), CryptoError::MalformedIdentifier(_)));

This should work:

use core_crypto::prelude::{MlsCentralConfiguration, CryptoError, MlsCiphersuite};

let result = MlsCentralConfiguration::try_new(
    "/tmp/crypto".to_string(),
    "MY_IDENTITY_KEY".to_string(),
    Some(b"MY_CLIENT_ID".to_vec().into()),
    vec![MlsCiphersuite::default()],
    None,
    Some(100),
);
assert!(result.is_ok());

pub fn set_entropy(&mut self, entropy: EntropySeed)

Sets the entropy seed

Trait Implementations

impl Clone for MlsCentralConfiguration

fn clone(&self) -> MlsCentralConfiguration

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for MlsCentralConfiguration

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

Formats the value using the given formatter.