Struct GroupHandle 

pub struct GroupHandle { /* private fields */ }

Handle for a single MLS group’s app-level state.

Contains state needed for group operations:

• Application ID for message deduplication across instances
• Steward flag indicating whether this user batches commits
• Proposal queues for tracking voting and approved proposals

Note: MLS cryptographic state (encryption keys, group members) is managed by MlsService. Use mls_service.encrypt(), mls_service.decrypt(), etc. for MLS operations.

Thread Safety

The GroupHandle should be wrapped in RwLock or similar by the application layer (see User.groups in the app module).

Steward vs Member

• Steward: Creates proposals, collects votes, batches approved proposals into MLS commits. Created via new_as_creator().
• Member: Votes on proposals, receives commits. Created via new_for_join().

Implementations

impl GroupHandle

pub fn new_for_join(group_name: &str) -> Self

Create a new group handle for an existing group (joining).

Arguments

• group_name - The name of the group

pub fn new_as_creator(group_name: &str) -> Self

Create a new group handle for creating a new group (as steward).

The MLS group should be created via mls_service.create_group() first.

Arguments

• group_name - The name of the group

pub fn group_name(&self) -> &str

Get the group name.

pub fn group_name_bytes(&self) -> &[u8]

Get the group name as bytes.

pub fn app_id(&self) -> &[u8]

Get the application ID.

pub fn is_steward(&self) -> bool

Check if this user is the steward.

pub fn is_mls_initialized(&self) -> bool

Check if the MLS group is initialized.

pub fn set_mls_initialized(&mut self)

Mark MLS as initialized (called after joining via welcome).

pub fn become_steward(&mut self)

Become the steward of this group.

pub fn resign_steward(&mut self)

Resign as steward of this group.

pub fn is_owner_of_proposal(&self, proposal_id: ProposalId) -> bool

Check if this user owns (created) the given proposal.

Owners are responsible for broadcasting the proposal to peers and must include the full Proposal when casting their vote.

pub fn approved_proposals_count(&self) -> usize

Get the count of approved proposals waiting to be committed.

The steward checks this to determine when to create a batch commit.

pub fn approved_proposals(&self) -> HashMap<ProposalId, GroupUpdateRequest>

Get a copy of all approved proposals.

Called by the steward when creating a batch commit. The proposals are sorted by SHA256 hash for deterministic ordering.

pub fn mark_proposal_as_approved(&mut self, proposal_id: ProposalId)

Move a proposal from voting to approved queue.

Called when consensus is reached with result = true and this user is the proposal owner.

pub fn mark_proposal_as_rejected(&mut self, proposal_id: ProposalId)

Remove a proposal from the voting queue (rejected or failed).

Called when consensus is reached with result = false or when consensus fails (timeout, insufficient votes).

pub fn store_voting_proposal( &mut self, proposal_id: ProposalId, proposal: GroupUpdateRequest, )

Store a newly created proposal in the voting queue.

Called after start_voting() successfully creates a proposal. The proposal remains here until consensus completes.

pub fn insert_approved_proposal( &mut self, proposal_id: ProposalId, proposal: GroupUpdateRequest, )

Insert a proposal directly into the approved queue.

Called by non-owners when they receive a consensus result for a proposal they didn’t create. They fetch the payload from the consensus service and insert it directly as approved.

pub fn clear_approved_proposals(&mut self)

Clear approved proposals after a commit, archiving to history.

Called after a batch commit is successfully applied. The proposals are moved to epoch_history for UI display (up to 10 epochs retained).

pub fn epoch_history( &self, ) -> &VecDeque<HashMap<ProposalId, GroupUpdateRequest>>

Get the epoch history (past batches of approved proposals).

Returns up to 10 past epochs, most recent last. Useful for UI to show recent membership changes.

Trait Implementations

impl Clone for GroupHandle

fn clone(&self) -> GroupHandle

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for GroupHandle

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

Formats the value using the given formatter.