Skip to main content

Module group_root

Module group_root 

Expand description

The group root in a group context’s GROUP_ROOT_KEY component.

A keyed group stores its 32-byte root in the immutable GROUP_ROOT_KEY component. Every installation the group adds receives it in the Welcome’s group context, and a joiner accepts a Welcome only when the root derives the Welcome’s group id.

Reads borrow the dictionary’s bytes. The only copies these helpers make are a GroupRoot and the GroupKeys derived from it, and both wipe on drop. No error carries root or key bytes.

Enums§

GroupRootError
Why a group context’s root cannot name its group.

Functions§

check_group_root
Require the root in a group context to derive group_id, and return the keys it derives. A 16-byte group id never matches: every derived id is a 32-byte public key.
group_keys_from_extensions
Derive the group key table from the root in a group context.
read_group_root
Read the group root from a group context. Ok(None) when the context has no GROUP_ROOT_KEY component, as for a restored placeholder.