Struct IntermediateOutcome 

pub struct IntermediateOutcome {
    pub(crate) n_players: u16,
    pub(crate) dealer: PublicKey,
    pub(crate) dealer_signature: Signature,
    pub(crate) epoch: Epoch,
    pub(crate) commitment: Public<MinSig>,
    pub(crate) acks: Vec<Ack>,
    pub(crate) reveals: Vec<Share>,
}

The local outcome of a dealer’s dealings.

This is the intermediate outcome of a ceremony, which contains a dealer’s generated commitment, all acks for the shares it sent to the ceremony’s players, and finally the revealed shares, for which it did not receive acks.

This object is persisted on-chain. Every player collects the intermediate outcomes of the other dealers to create the overall outcome of the ceremony.

Fields

n_players: u16

The number of players in this epoch.

dealer: PublicKey

The public key of the dealer.

dealer_signature: Signature

The dealer’s signature over the resharing round, commitment, acks, and reveals.

epoch: Epoch

The epoch of the resharing operation.

commitment: Public<MinSig>

The new group public key polynomial.

acks: Vec<Ack>

All signed acknowledgements from participants.

reveals: Vec<Share>

Any revealed secret shares.

Implementations

impl IntermediateOutcome

pub fn new( n_players: u16, dealer_signer: &PrivateKey, namespace: &[u8], epoch: Epoch, commitment: Public<MinSig>, acks: Vec<Ack>, reveals: Vec<Share>, ) -> Self

Creates a new intermediate ceremony outcome.

This object contains, the number of players, the epoch of the ceremony, the dealer’s commitment (public polynomial), the acks received by the players and the revealed shares for which no acks are received.

Finally, it also includes a signature over (namespace, epoch, commitment, acks, reveals) signed by the dealer.

pub fn new_pre_allegretto( n_players: u16, dealer_signer: &PrivateKey, namespace: &[u8], epoch: Epoch, commitment: Public<MinSig>, acks: Vec<Ack>, reveals: Vec<Share>, ) -> Self

Creates a new intermediate ceremony outcome.

This method constructs a signature without the number players. This is incorrect and addressed by Self::new. Self::new_pre_allegretto exists for compatibility reasons and should only be used for hardforks pre allegretto.

This object contains, the number of players, the epoch of the ceremony, the dealer’s commitment (public polynomial), the acks received by the players and the revealed shares for which no acks are received.

Finally, it also includes a signature over (namespace, epoch, commitment, acks, reveals) signed by the dealer.

pub fn verify(&self, namespace: &[u8]) -> bool

Verifies the intermediate outcome’s signature.

pub fn verify_pre_allegretto(&self, namespace: &[u8]) -> bool

Verifies the intermediate outcome’s signature.

This method constructs a signature without the number players. This is incorrect and addressed by Self::new. Self::new_pre_allegretto exists for compatibility reasons and should only be used for hardforks pre allegretto.

pub(crate) fn signature_payload_from_parts( n_players: u16, epoch: Epoch, commitment: &Public<MinSig>, acks: &Vec<Ack>, reveals: &Vec<Share>, ) -> Vec<u8>

Returns the payload that was signed by the dealer, formed from raw parts.

pub(crate) fn signature_payload_from_parts_pre_allegretto( epoch: Epoch, commitment: &Public<MinSig>, acks: &Vec<Ack>, reveals: &Vec<Share>, ) -> Vec<u8>

Returns the payload that was signed by the dealer, formed from raw parts.

This method constructs a signature without the number players. This is incorrect and addressed by Self::new. Self::new_pre_allegretto exists for compatibility reasons and should only be used for hardforks pre allegretto.

pub fn acks(&self) -> &[Ack]

pub fn dealer(&self) -> &PublicKey

pub fn signature(&self) -> &Signature

pub fn epoch(&self) -> Epoch

pub fn commitment(&self) -> &Public<MinSig>

pub fn reveals(&self) -> &[Share]

Trait Implementations

impl Clone for IntermediateOutcome

fn clone(&self) -> IntermediateOutcome

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for IntermediateOutcome

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

Formats the value using the given formatter.

impl EncodeSize for IntermediateOutcome

fn encode_size(&self) -> usize

Returns the encoded size of this value (in bytes).

impl PartialEq for IntermediateOutcome

fn eq(&self, other: &IntermediateOutcome) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Read for IntermediateOutcome

type Cfg = ()

The Cfg type parameter allows passing configuration during the read process. This is crucial for safely decoding untrusted data, for example, by providing size limits for collections or strings.

fn read_cfg(buf: &mut impl Buf, _cfg: &Self::Cfg) -> Result<Self, Error>

Reads a value from the buffer using the provided configuration cfg.

impl Write for IntermediateOutcome

fn write(&self, buf: &mut impl BufMut)

Writes the binary representation of self to the provided buffer buf.

impl Eq for IntermediateOutcome

impl StructuralPartialEq for IntermediateOutcome

Layout

Note: Most layout information is completely unstable and may even differ between compilations. The only exception is types with certain repr(...) attributes. Please see the Rust Reference's “Type Layout” chapter for details on type layout guarantees.

Size: 440 bytes