Struct SsaShareGenerator 

pub struct SsaShareGenerator<S: PixSpec> {
    polynomials: Cache<S::Pseudonym, Arc<Mutex<SsaPseudonymEntry<S>>>, RandomState>,
    cfg: SsaGeneratorConfig,
}

Generator for Session Stealth Address (SSA) shares distributed over Single Use Reply Blocks (SURBs).

Fields

polynomials: Cache<S::Pseudonym, Arc<Mutex<SsaPseudonymEntry<S>>>, RandomState>

cfg: SsaGeneratorConfig

Implementations

impl<S: PixSpec> SsaShareGenerator<S>

pub fn try_new(cfg: SsaGeneratorConfig) -> Result<Self, S::Pseudonym>

Creates a new share generator with the provided configuration.

Fails if the configuration does not validate. Prefer this over Self::new anywhere the configuration is assembled at runtime — a config built programmatically or read from a file is input, not a constant, and turning it into a panic makes it un-handleable by the caller.

pub fn new(cfg: SsaGeneratorConfig) -> Self

Creates a new share generator with the provided configuration.

Panics

Panics if the configuration fails validation. Use Self::try_new to handle that case instead.

pub fn config(&self) -> &SsaGeneratorConfig

Returns the configuration used to generate this SsaShareGenerator.

Trait Implementations

impl<S: PixSpec> Default for SsaShareGenerator<S>

fn default() -> Self

Returns the “default value” for a type.

impl<S: PixSpec> EntryShareGenerator<S> for SsaShareGenerator<S>

fn next_share( &self, pseudonym: &S::Pseudonym, msg: &impl AsRef<[u8]>, ) -> Result<Option<GeneratedShare<S>>, S::Pseudonym>

Generate the next PartialSsaShare for the given pseudonym and message msg.

IMPORTANT: Each msg MUST be unique for a given pseudonym.

Returns None if all polynomials for the given pseudonym have been used up. This signals that a new SSA must be committed.

fn new_ssa_commitment( &self, pseudonym: &S::Pseudonym, ssa_index: SsaIndex, ) -> Result<SsaCommitment<S>, S::Pseudonym>

Generates a new SSA commitment from the sender side, for the given pseudonym.

Returns the new random SSA-commitment and the corresponding SSA share verifier.

type Error = PixError<<S as PixSpec>::Pseudonym>