Struct diem_types::trusted_state::TrustedState

pub struct TrustedState { /* fields omitted */ }

TrustedState keeps track of our latest trusted state, including the latest verified version and the latest verified validator set.

Implementations

impl TrustedState

pub fn version(&self) -> Version

pub fn waypoint(&self) -> Waypoint

pub fn verify_and_ratchet<'a>(
    &self,
    latest_li: &'a LedgerInfoWithSignatures,
    epoch_change_proof: &'a EpochChangeProof
) -> Result<TrustedStateChange<'a>>

Verify and ratchet forward our trusted state using a EpochChangeProof (that moves us into the latest epoch) and a LedgerInfoWithSignatures inside that epoch.

For example, a client sends a GetStateProof request to an upstream FullNode and receives some epoch change proof along with a latest ledger info inside the StateProof response. This function verifies the change proof and ratchets the trusted state version forward if the response successfully moves us into a new epoch or a new latest ledger info within our current epoch.

• If there was a validation error, e.g., the epoch change proof was invalid, we return an Err.

• If the message was well formed but stale (i.e., the returned latest ledger is behind our trusted version), we also return an Err since stale responses should always be rejected.

• If the response is fresh and there is no epoch change, we just ratchet our trusted version to the latest ledger info and return Ok(TrustedStateChange::Version { .. }).

• If there is a new epoch and the server provides a correct proof, we ratchet our trusted version forward, update our verifier to contain the new validator set, and return Ok(TrustedStateChange::Epoch { .. }).

Trait Implementations

impl Clone for TrustedState

fn clone(&self) -> TrustedState

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for TrustedState

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for TrustedState

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error> where
    __D: Deserializer<'de>, 

Deserialize this value from the given Serde deserializer.

impl From<Waypoint> for TrustedState

fn from(waypoint: Waypoint) -> Self

Performs the conversion.

impl PartialEq<TrustedState> for TrustedState

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

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

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

This method tests for !=.

impl Serialize for TrustedState

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

Serialize this value into the given Serde serializer.

impl TryFrom<&'_ LedgerInfo> for TrustedState

type Error = Error

The type returned in the event of a conversion error.

fn try_from(ledger_info: &LedgerInfo) -> Result<Self>

Performs the conversion.

impl Eq for TrustedState

impl StructuralEq for TrustedState

impl StructuralPartialEq for TrustedState