Struct GuestState

pub struct GuestState {
    pub self_image_id: Digest,
    pub mmr: MerkleMountainRange,
}

Fields

self_image_id: Digest

Image ID of the set builder itself.

Passed as input since a guest cannot contain its own image ID. All successive calls to the set builder must use the same image ID, which is propagated to the journal as part of the guest output.

mmr: MerkleMountainRange

Merkle mountain range representing the state of the iterative tree building process at the end of guest execution.

Implementations

impl GuestState

pub fn initial(self_image_id: impl Into<Digest>) -> Self

Construct the initial, empty, state for set builder.

pub fn is_initial(&self) -> bool

Returns true if this is the initial state, for an empty claim set.

pub fn encode(&self) -> Vec<u8>

Encodes the GuestState for committing to the journal. Uses a specialized codec. See MerkleMountainRange::encode.

pub fn decode(bytes: impl AsRef<[u8]>) -> Result<Self, DecodingError>

Decodes the GuestState for the journal. Uses a specialized codec. See MerkleMountainRange::encode.

pub fn into_input( self, claims: Vec<ReceiptClaim>, finalize: bool, ) -> Result<GuestInput, Error>

Create a GuestInput from this GuestState. When run with the guest, the given claims will be accumulated into the Merkle mountain range, and will be finalized if finalize is set to true.

Will return an error if the MerkleMountainRange on the GuestState is already finalized, as no more claims may be added and the guest would reject this input.

Trait Implementations

impl Clone for GuestState

fn clone(&self) -> GuestState

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for GuestState

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for GuestState

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for GuestState

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

where __S: Serializer,

Serialize this value into the given Serde serializer.