Struct ExternalProposal 

pub struct ExternalProposal;

Available on 32-bit or 64-bit only.

External Proposal where sender is External. A party outside the group can request to add or remove a member to the group. This proposal should then be committed by a group member. The sender must be pre configured within the group through the crate::extensions::ExternalSendersExtension

Implementations

impl ExternalProposal

pub fn new_group_context_extensions<Provider: OpenMlsProvider>( extensions: Extensions<GroupContext>, group_id: GroupId, epoch: GroupEpoch, signer: &impl Signer, sender_index: SenderExtensionIndex, ) -> Result<MlsMessageOut, CreateGroupContextExtProposalError<Provider::StorageError>>

Creates an external GroupContextExtensions proposal. For example, for delivery services requesting to update the group context extension. This proposal will have to be committed later by a group member.

Arguments

• extensions - a new set of extensions for the group context
• group_id - unique group identifier of the group to join
• epoch - group’s epoch
• signer - of the sender to sign the message
• sender_index - index of the sender of the proposal (in the ExternalSendersExtension array from the Group Context)

pub fn new_remove<Provider: OpenMlsProvider>( removed: LeafNodeIndex, group_id: GroupId, epoch: GroupEpoch, signer: &impl Signer, sender_index: SenderExtensionIndex, ) -> Result<MlsMessageOut, ProposeRemoveMemberError<Provider::StorageError>>

Creates an external Remove proposal. For example, for delivery services requesting to remove a client. This proposal will have to be committed later by a group member.

Arguments

• removed - index of the client to remove
• group_id - unique group identifier of the group to join
• epoch - group’s epoch
• signer - of the sender to sign the message
• sender_index - index of the sender of the proposal (in the ExternalSendersExtension array from the Group Context)

pub fn new_add<Provider: OpenMlsProvider>( key_package: KeyPackage, group_id: GroupId, epoch: GroupEpoch, signer: &impl Signer, sender_index: SenderExtensionIndex, ) -> Result<MlsMessageOut, ProposeAddMemberError<Provider::StorageError>>

Creates an external Add proposal. For delivery services requesting to add a client. This proposal will have to be committed later by a group member.

Arguments

• key_package - key package of the client to add
• group_id - unique group identifier of the group to join
• epoch - group’s epoch
• signer - of the sender to sign the message
• sender_index - index of the sender of the proposal (in the ExternalSendersExtension array from the Group Context)

pub fn new_pre_shared_key( psk_id: PreSharedKeyId, group_id: GroupId, epoch: GroupEpoch, signer: &impl Signer, sender_index: SenderExtensionIndex, ) -> Result<MlsMessageOut, LibraryError>

Creates an external PreSharedKey proposal. For example for delivery services requesting to inject a pre-shared key into the group’s key schedule (RFC 9420 §12.1.8 permits external senders to send PSK proposals). This proposal will have to be committed later by a group member. The same constructor is used for both external and resumption PSKs; the distinction is carried by the PreSharedKeyId.

Arguments

• psk_id - identifier of the pre-shared key to inject
• group_id - unique group identifier of the group
• epoch - group’s epoch
• signer - of the sender to sign the message
• sender_index - index of the sender of the proposal (in the ExternalSendersExtension array from the Group Context)