Struct oasis_core_runtime::consensus::keymanager::churp::Status

pub struct Status {

    pub id: u8,
    pub runtime_id: Namespace,
    pub suite_id: SuiteId,
    pub threshold: u8,
    pub extra_shares: u8,
    pub handoff_interval: EpochTime,
    pub policy: SignedPolicySGX,
    pub handoff: EpochTime,
    pub checksum: Option<Hash>,
    pub committee: Vec<PublicKey>,
    pub next_handoff: EpochTime,
    pub next_checksum: Option<Hash>,
    pub applications: HashMap<PublicKey, Application>,
}

Status represents the current state of a CHURP instance.

Fields

id: u8

A unique identifier within the key manager runtime.

runtime_id: Namespace

The identifier of the key manager runtime.

suite_id: SuiteId

The identifier of a cipher suite used for verifiable secret sharing and key derivation.

threshold: u8

The degree of the secret-sharing polynomial.

In a (t,n) secret-sharing scheme, where t represents the threshold, any combination of t+1 or more shares can reconstruct the secret, while losing n-t or fewer shares still allows the secret to be recovered.

extra_shares: u8

The minimum number of shares that can be lost to render the secret unrecoverable.

If t and e represent the threshold and extra shares, respectively, then the minimum size of the committee is t+e+1.

handoff_interval: EpochTime

The time interval in epochs between handoffs.

A zero value disables handoffs.

policy: SignedPolicySGX

A signed SGX access control policy.

handoff: EpochTime

The epoch of the last successfully completed handoff.

The zero value indicates that no handoffs have been completed so far. Note that the first handoff is special and is called the dealer phase, in which nodes do not reshare or randomize shares but instead construct the secret and shares.

checksum: Option<Hash>

The hash of the verification matrix from the last successfully completed handoff.

committee: Vec<PublicKey>

A vector of nodes holding a share of the secret in the active handoff.

A client needs to obtain more than a threshold number of key shares from the nodes in this vector to construct the key.

next_handoff: EpochTime

The epoch in which the next handoff will occur.

If an insufficient number of applications is received, the next handoff will be delayed by one epoch.

next_checksum: Option<Hash>

The hash of the verification matrix from the current handoff.

The first candidate to confirm share reconstruction is the source of truth for the checksum. All other candidates need to confirm with the same checksum; otherwise, the applications will be annulled, and the nodes will need to apply for the new committee again.

applications: HashMap<PublicKey, Application>

A map of nodes that wish to form the new committee.

Candidates are expected to generate a random bivariate polynomial, construct a verification matrix, compute its checksum, and submit an application one epoch in advance of the next scheduled handoff. Subsequently, upon the arrival of the handoff epoch, nodes must execute the handoff protocol and confirm the reconstruction of its share.

Trait Implementations

impl Clone for Status

fn clone(&self) -> Status

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Status

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

Formats the value using the given formatter.

impl Decode for Status

fn try_default() -> Result<Self, DecodeError>

Try to decode from a missing/null/undefined value.

fn try_from_cbor_value(value: Value) -> Result<Self, DecodeError>

Try to decode from a given CBOR value.

fn try_from_cbor_value_default(value: Value) -> Result<Self, DecodeError>

where Self: Sized,

Try to decode from a given CBOR value, calling try_default in case the value is null or undefined.

impl Default for Status

fn default() -> Status

Returns the “default value” for a type.

impl Encode for Status

fn into_cbor_value(self) -> Value

Encode the type into a CBOR Value.

fn is_empty(&self) -> bool

Whether the value is equal to the empty value for the type.

impl EncodeAsMap for Status

fn into_cbor_value_map(self) -> Value

where Self: Sized,

Encode the type into a CBOR Map.

fn into_cbor_map(self) -> Vec<(Value, Value)>

where Self: Sized,

Encode the type into a CBOR Map, returning the map items.

impl PartialEq for Status

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

This method tests for self and other values to be equal, and is used by ==.

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

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

impl Eq for Status

impl StructuralPartialEq for Status