Struct Signal 

pub struct Signal<'a> { /* private fields */ }

Feature handle for Signal protocol operations.

Implementations

impl<'a> Signal<'a>

pub async fn encrypt_message( &self, jid: &Jid, plaintext: &[u8], ) -> Result<(EncType, Vec<u8>)>

Encrypt plaintext for a single recipient using the Signal protocol.

Returns (EncType, ciphertext_bytes). The caller is responsible for padding if needed; this method encrypts raw bytes.

PN JIDs are resolved to LID when a LID session exists, matching the internal send path.

pub async fn decrypt_message( &self, jid: &Jid, enc_type: EncType, ciphertext: &[u8], ) -> Result<Vec<u8>>

Decrypt a Signal protocol message from a sender.

Returns raw padded plaintext. Use MessageUtils::unpad_message_ref with the stanza’s v attribute if WhatsApp message unpadding is needed.

PN JIDs are resolved to LID when a LID session exists, matching the internal receive path.

pub async fn encrypt_group_message( &self, group_jid: &Jid, plaintext: &[u8], ) -> Result<(Option<Vec<u8>>, Vec<u8>)>

Encrypt plaintext for a group using sender keys.

Returns (Option<skdm_bytes>, ciphertext_bytes). The SKDM is Some only when a new sender key was created (first encrypt for this group or after key rotation). Callers must distribute the SKDM to all group participants when present. This matches WA Web which only creates SKDM on first group encrypt or after sender key rotation.

Not safe to call concurrently with decrypt_group_message for the same group — sender key state is not internally locked.

pub async fn decrypt_group_message( &self, group_jid: &Jid, sender_jid: &Jid, ciphertext: &[u8], ) -> Result<Vec<u8>>

Decrypt a group (sender-key) message.

Returns raw padded plaintext. Use MessageUtils::unpad_message_ref with the stanza’s v attribute if WhatsApp message unpadding is needed.

Not safe to call concurrently with encrypt_group_message for the same group — sender key state is not internally locked.

pub async fn validate_session(&self, jid: &Jid) -> Result<bool>

Check whether a Signal session exists for jid.

PN JIDs are resolved to LID when a LID mapping exists, matching the encrypt/decrypt paths.

pub async fn delete_sessions(&self, jids: &[Jid]) -> Result<()>

Delete Signal sessions and identity keys for the given JIDs.

Matches WA Web’s deleteRemoteSession which removes both session and identity as a paired operation. Changes are flushed to the persistent backend before returning.

PN JIDs are resolved to LID when a LID mapping exists, matching the encrypt/decrypt paths.

pub async fn create_participant_nodes( &self, recipient_jids: &[Jid], message: &Message, ) -> Result<(Vec<Node>, bool)>

Create encrypted participant <to> nodes for the given recipient JIDs.

Resolves devices, ensures Signal sessions, encrypts the message for each device, and returns the resulting XML nodes.

Returns (nodes, should_include_device_identity).

pub async fn assert_sessions(&self, jids: &[Jid]) -> Result<()>

Ensure E2E sessions exist for the given JIDs.

pub async fn get_user_devices(&self, jids: &[Jid]) -> Result<Vec<Jid>>

Get all known device JIDs for the given user JIDs via usync.