group_session_builder.h

#ifndef GROUP_SESSION_BUILDER_H
#define GROUP_SESSION_BUILDER_H

#include "signal_protocol_types.h"

#ifdef __cplusplus
extern "C" {
#endif

/*
 * Group session builder is responsible for setting up group sender key encrypted sessions.
 *
 * Once a session has been established, group_cipher can be used to
 * encrypt/decrypt messages in that session.
 * <p>
 * The built sessions are unidirectional: they can be used either for sending
 * or for receiving, but not both.
 *
 * Sessions are constructed per (groupId + senderId + deviceId) tuple.  Remote logical users
 * are identified by their senderId, and each logical recipientId can have multiple physical
 * devices.
 */

int group_session_builder_create(group_session_builder **builder,
        signal_protocol_store_context *store, signal_context *global_context);

int group_session_builder_process_session(group_session_builder *builder,
        const signal_protocol_sender_key_name *sender_key_name,
        sender_key_distribution_message *distribution_message);

int group_session_builder_create_session(group_session_builder *builder,
        sender_key_distribution_message **distribution_message,
        const signal_protocol_sender_key_name *sender_key_name);

void group_session_builder_free(group_session_builder *builder);

#ifdef __cplusplus
}
#endif

#endif /* GROUP_SESSION_BUILDER_H */