Struct mithril_stm::stm::StmInitializer

pub struct StmInitializer {
    pub stake: Stake,
    pub params: StmParameters,
    /* private fields */
}

Initializer for StmSigner. This is the data that is used during the key registration procedure. Once the latter is finished, this instance is consumed into an StmSigner.

Fields

stake: Stake

This participant’s stake.

params: StmParameters

Current protocol instantiation parameters.

Implementations

impl StmInitializer

pub fn setup<R: RngCore + CryptoRng>( params: StmParameters, stake: Stake, rng: &mut R, ) -> Self

Builds an StmInitializer that is ready to register with the key registration service. This function generates the signing and verification key with a PoP, and initialises the structure.

pub fn verification_key(&self) -> StmVerificationKeyPoP

Extract the verification key.

pub fn new_signer<D: Digest + Clone>( self, closed_reg: ClosedKeyReg<D>, ) -> Result<StmSigner<D>, RegisterError>

Build the avk for the given list of parties.

Note that if this StmInitializer was modified between the last call to register, then the resulting StmSigner may not be able to produce valid signatures.

Returns an StmSigner specialized to

• this StmSigner’s ID and current stake
• this StmSigner’s parameter valuation
• the avk as built from the current registered parties (according to the registration service)
• the current total stake (according to the registration service)

Error

This function fails if the initializer is not registered.

pub fn new_core_signer<D: Digest + Clone>( self, eligible_parties: &[RegParty], ) -> Option<StmSigner<D>>

Creates a new core signer that does not include closed registration. Takes eligible_parties as a parameter and determines the signer’s index in the parties. eligible_parties is verified and trusted which is only run by a full-node that has already verified the parties.

pub fn to_bytes(&self) -> [u8; 256]

Convert to bytes

Layout

• Stake (u64)
• Params
• Secret Key
• Public key (including PoP)

pub fn from_bytes(bytes: &[u8]) -> Result<StmInitializer, RegisterError>

Convert a slice of bytes to an StmInitializer

Error

The function fails if the given string of bytes is not of required size.

Trait Implementations

impl Clone for StmInitializer

fn clone(&self) -> StmInitializer

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for StmInitializer

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for StmInitializer

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for StmInitializer

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.