Struct ClientConfig 

pub struct ClientConfig {
    pub identity: Identity,
    pub device_label: String,
    pub storage: Arc<dyn Storage>,
    pub transport: Arc<dyn Transport>,
    pub now_ms: u64,
    pub storage_backend: StorageBackend,
    pub device_signing_secret_key: Option<[u8; 32]>,
}

Fields

identity: Identity

device_label: String

storage: Arc<dyn Storage>

transport: Arc<dyn Transport>

now_ms: u64

Wall clock in ms. Pulled from the host so we can use a synthetic clock in tests.

storage_backend: StorageBackend

[CR-4] OpenMLS-provider backend. Defaults to in-memory; iOS NSE and web SW cold-start paths MUST pass StorageBackend::Sqlite { path, encryption_key } (native) or StorageBackend::IndexedDb { db_name } (WASM, when that lands). See docs/design/CR4_CR7_PERSISTENCE.md.

device_signing_secret_key: Option<[u8; 32]>

Optional 32-byte Ed25519 secret key the SDK should use as the device signing key. When set AND no LocalDevice is yet persisted in storage, the SDK constructs its first LocalDevice from this key instead of generating a fresh random one — so device_id = SHA-256(public_key_of(secret)) is fully determined by what the host provided.

Use case: align the SDK’s device_id (which it stamps into every envelope’s sender_device field) with an externally- computed device id — typically SHA-256(device_signing_pubkey) in the host’s auth layer, where the JWT carries that same value as its device_id claim. Without this alignment, a server that validates envelope.sender_device == jwt.device_id would reject every send.

Ignored on re-init (when storage already has a persisted LocalDevice) so the device identity remains stable across restarts.

Implementations

impl ClientConfig

pub fn new_in_memory( identity: Identity, device_label: String, storage: Arc<dyn Storage>, transport: Arc<dyn Transport>, now_ms: u64, ) -> Self

Construct a config with StorageBackend::Memory — convenient for tests and the existing v0.1 in-memory flow.

Trait Implementations

impl Debug for ClientConfig

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

Formats the value using the given formatter.