Struct SetInclusionReceipt

#[non_exhaustive]
pub struct SetInclusionReceipt<Claim>
where
    Claim: Digestible + Clone + Serialize,
{
    pub claim: MaybePruned<Claim>,
    pub root: Option<Receipt>,
    pub merkle_path: Vec<Digest>,
    pub verifier_parameters: Digest,
}

Available on crate feature verify only.

A receipt for a claim that is part of a set of verified claims (i.e. an aggregation).

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

claim: MaybePruned<Claim>

Claim containing information about the computation that this receipt proves.

The standard claim type is ReceiptClaim, which represents a RISC-V zkVM execution.

root: Option<Receipt>

Root receipt attesting to the validity of all claims included in the set committed to by the Merkle root in the journal of this receipt. It is required that this receipt was produced by running the aggregation set builder, which verifies each receipt before adding it to the set represented by a Merkle tree.

In certain contexts, the root claim can be omitted. In particular, the zkVM guest can verify the root by making an assumption (i.e. by calling env::verify), and verifies in an EVM context may reference previously proven claims via a verification cache in storage.

merkle_path: Vec<Digest>

Merkle proof for inclusion in the set of claims attested to by the root receipt.

verifier_parameters: Digest

A digest of the verifier parameters that can be used to verify this receipt.

Acts as a fingerprint to identity differing proof system or circuit versions between a prover and a verifier. Is not intended to contain the full verifier parameters, which must be provided by a trusted source (e.g. packaged with the verifier code).

Implementations

impl<Claim> SetInclusionReceipt<Claim>

where Claim: Digestible + Clone + Serialize,

pub fn from_path_with_verifier_params( claim: impl Into<MaybePruned<Claim>>, merkle_path: Vec<Digest>, verifier_parameters: impl Into<Digest>, ) -> Self

Construct a SetInclusionReceipt with the given Merkle inclusion path and claim.

Path should contain all sibling nodes in the tree from the leaf to the root. Note that the path does not include the leaf or the root itself. Resulting receipt will have the given verifier parameter digest and no root receipt.

pub fn with_root(self, root_receipt: Receipt) -> Self

Add the given root receipt to this set inclusion receipt.

See SetInclusionReceipt::root for more information about the root receipt.

pub fn without_root(self) -> Self

Drops the root receipt from this SetInclusionReceipt.

This is useful when the verifier has a cache of verified roots, as is the case for smart contract verifiers. Use this method when submitting this receipt as part of a batch of receipts to be verified, to reduce the encoded size of this receipt.

pub fn verify_integrity_with_context( &self, ctx: &VerifierContext, set_verifier_params: SetInclusionReceiptVerifierParameters, _recursion_verifier_params: Option<RecursionVerifierParamters>, ) -> Result<(), VerificationError>

Verify the integrity of this receipt, ensuring the claim is attested to by the seal.

pub fn abi_encode_seal(&self) -> Result<Vec<u8>, EncodingError>

Encode the seal of the given receipt for use with EVM smart contract verifiers.

Appends the verifier selector, determined from the first 4 bytes of the verifier parameters digest, which contains the aggregation set builder image ID. If non-empty, the root receipt will be appended.

Trait Implementations

impl<Claim> Clone for SetInclusionReceipt<Claim>

where Claim: Digestible + Clone + Serialize + Clone,

fn clone(&self) -> SetInclusionReceipt<Claim>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<Claim> Debug for SetInclusionReceipt<Claim>

where Claim: Digestible + Clone + Serialize + Debug,

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

Formats the value using the given formatter.

impl<'de, Claim> Deserialize<'de> for SetInclusionReceipt<Claim>

where Claim: Digestible + Clone + Serialize + Deserialize<'de>,

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<Claim> Serialize for SetInclusionReceipt<Claim>

where Claim: Digestible + Clone + Serialize + Serialize,

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

where __S: Serializer,

Serialize this value into the given Serde serializer.