Struct BranchGroupBuilder 

pub struct BranchGroupBuilder { /* private fields */ }

Available on 32-bit or 64-bit only.

Builder that creates a fresh sub-group and its branch commit in a single step, as described in RFC 9420 §11.3.

Create this with MlsGroupBuilder::branch.

Implementations

impl BranchGroupBuilder

pub fn propose_group_context_extensions( self, extensions: Extensions<GroupContext>, ) -> Self

Add a GroupContextExtensions proposal to the branch commit. See CommitBuilder::propose_group_context_extensions.

pub fn force_self_update(self, force_self_update: bool) -> Self

Force a self-update (path) in the branch commit. See CommitBuilder::force_self_update.

pub fn build_branch<Provider: OpenMlsProvider>( self, provider: &Provider, signer: &impl Signer, credential_with_key: CredentialWithKey, new_members: Vec<KeyPackage>, ) -> Result<(MlsGroup, CommitMessageBundle), BranchError<Provider::StorageError>>

Create the sub-group and the branch commit that adds new_members to it.

This creates a fresh group with the parent’s ciphersuite, adds the branch resumption PSK (mixing in the parent’s resumption PSK secret), and commits the additions (plus any extra proposals set via Self::propose_group_context_extensions / Self::force_self_update). It returns the new (epoch-0) sub-group and the CommitMessageBundle carrying the branch commit and Welcome.

The commit is staged but not merged: merge it with MlsGroup::merge_pending_commit only once the delivery service has confirmed it.