Struct VcKeyPackageBatchBuilder 

pub struct VcKeyPackageBatchBuilder { /* private fields */ }

Available on crate feature virtual-clients-draft and (32-bit or 64-bit) only.

A builder for a batch of virtual-client KeyPackages a sibling can reproduce.

Allows to build heterogeneous batch of key packages, e.g. non-last-resort and last-restort, or packages with different ciphersuits. Return the batch on Self::finalize. Dropping the builder without calling finalize burns no generation.

Implementations

impl VcKeyPackageBatchBuilder

pub fn new( provider: &impl OpenMlsProvider, epoch_id: EpochId, ) -> Result<Self, KeyPackageNewError>

Load emulation epoch and allocate the next generation of the key package operation ratchet.

Nothing is persisted yet. Dropping the builder without calling finalize burns no generation.

pub fn with_capacity( provider: &impl OpenMlsProvider, epoch_id: EpochId, capacity: usize, ) -> Result<Self, KeyPackageNewError>

Same as Self::new, but with a capacity hint for the number of key packages.

pub fn add_key_package( &mut self, builder: KeyPackageBuilder, ciphersuite: Ciphersuite, crypto: &impl OpenMlsCrypto, signer: &impl Signer, credential_with_key: CredentialWithKey, ) -> Result<&KeyPackageInfo, KeyPackageNewError>

Build one key package at the next index.

The key package builder carries the per-step config: key package extensions (incl. last resort), leaf node extensions, capabilities, lifetime.

If building fails, the builder is left in a valid state:

• No storage is touched
• No generation is burned
• The failed index isn’t consumed

pub fn finalize( self, provider: &impl OpenMlsProvider, ) -> Result<VcKeyPackageBatch, KeyPackageNewError>

Finalize the batch.

Persists the operation tree and the key packages. The operation is not atomic. On failure, the generation should be considered as burned. Few orphaned key packages may be left in storage.

Trait Implementations

impl Debug for VcKeyPackageBatchBuilder

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

Formats the value using the given formatter.