Struct StmSigner

pub struct StmSigner<D: Digest> { /* private fields */ }

Participant in the protocol can sign messages.

• If the signer has closed_reg, then it can generate Stm certificate.
  • This kind of signer can only be generated out of an StmInitializer and a ClosedKeyReg.
  • This ensures that a MerkleTree root is not computed before all participants have registered.
• If the signer does not have closed_reg, then it is a core signer.
  • This kind of signer cannot participate certificate generation.
  • Signature generated can be verified by a full node verifier (core verifier).

Implementations

impl<D: Clone + Digest + FixedOutput> StmSigner<D>

pub fn set_stm_signer( signer_index: u64, stake: Stake, params: StmParameters, sk: SigningKey, vk: StmVerificationKey, closed_reg: ClosedKeyReg<D>, ) -> StmSigner<D>

Create an StmSigner for given input

pub fn set_core_signer( signer_index: u64, stake: Stake, params: StmParameters, sk: SigningKey, vk: StmVerificationKey, ) -> StmSigner<D>

Create a core signer (no registration data) for given input

pub fn sign(&self, msg: &[u8]) -> Option<StmSig>

This function produces a signature following the description of Section 2.4. Once the signature is produced, this function checks whether any index in [0,..,self.params.m] wins the lottery by evaluating the dense mapping. It records all the winning indexes in Self.indexes. If it wins at least one lottery, it stores the signer’s merkle tree index. The proof of membership will be handled by the aggregator.

pub fn verification_key(&self) -> StmVerificationKey

Extract the verification key.

pub fn get_stake(&self) -> Stake

Extract stake from the signer.

pub fn core_sign(&self, msg: &[u8], total_stake: Stake) -> Option<StmSig>

A core signature generated without closed registration. The core signature can be verified by core verifier. Once the signature is produced, this function checks whether any index in [0,..,self.params.m] wins the lottery by evaluating the dense mapping. It records all the winning indexes in Self.indexes.

pub fn check_lottery( &self, msg: &[u8], sigma: &Signature, total_stake: Stake, ) -> Vec<u64>

Collects and returns the winning indices.

pub fn get_params(&self) -> StmParameters

Get StmParameters

pub fn get_closed_reg(&self) -> Option<ClosedKeyReg<D>>

Get closed key registration

pub fn get_vk(&self) -> StmVerificationKey

Get verification key

Trait Implementations

impl<D: Clone + Digest> Clone for StmSigner<D>

fn clone(&self) -> StmSigner<D>

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<D: Debug + Digest> Debug for StmSigner<D>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.