Struct Polls 

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

Implementations

impl<'a> Polls<'a>

pub async fn create( &self, to: impl Into<Jid>, name: &str, options: &[String], selectable_count: u32, ) -> Result<(SendResult, Vec<u8>), PollError>

Caller needs the returned message_secret to decrypt votes.

pub async fn create_quiz( &self, to: impl Into<Jid>, name: &str, options: &[String], correct_index: usize, ) -> Result<(SendResult, Vec<u8>), PollError>

Create a quiz poll: a single-select poll with exactly one correct option.

correct_index is the 0-based index into options of the right answer. Quizzes are inherently single-select (WA Web forces selectableOptionsCount=1), so the count is fixed at 1. Returns the message_secret needed to decrypt votes.

pub async fn vote( &self, chat_jid: impl Into<Jid>, poll_msg_id: &str, poll_creator_jid: &Jid, message_secret: &[u8], option_names: &[String], ) -> Result<SendResult, PollError>

pub async fn decrypt_vote( &self, ciphertext: PollVoteCiphertext<'_>, message_secret: &[u8], poll_msg_id: &str, poll_creator_jid: &Jid, voter_jid: &Jid, ) -> Result<Vec<Vec<u8>>, PollError>

Selected option hashes (32 bytes each). Retries under the opposite namespace (LID/PN) when a counterpart is known, so votes authored across the LID migration still open. Mirrors WA Web WAWebAddonEncryption.

pub async fn aggregate_votes( &self, poll_options: &[String], votes: &[(&Jid, PollVoteCiphertext<'_>)], message_secret: &[u8], poll_msg_id: &str, poll_creator_jid: &Jid, ) -> Result<Vec<PollOptionResult>, PollError>

Decrypts each vote and tallies per-option results. Later votes from the same voter replace earlier ones (last-vote-wins). votes should be ordered oldest-first.

Dedupes voters by their canonical (LID-preferred) identity so a voter who re-votes under the other namespace after migrating replaces, rather than duplicates, their earlier vote.