Struct PartialVault 

pub struct PartialVault { /* private fields */ }

A partial representation of an AssetVault, containing only proofs for a subset of assets.

Partial vault is used to provide verifiable access to specific assets in a vault without the need to provide the full vault data. It contains all required data for loading vault data into the transaction kernel for transaction execution.

Implementations

impl PartialVault

pub fn new(partial_smt: PartialSmt) -> Result<Self, PartialAssetVaultError>

Returns a new instance of a partial vault from the provided partial SMT.

Errors

Returns an error if:

• the provided SMT does not track only valid Assets.
• the vault key at which the asset is stored does not match the vault key derived from the asset.

pub fn root(&self) -> Word

Returns the root of the partial vault.

pub fn inner_nodes(&self) -> impl Iterator<Item = InnerNodeInfo> + '_

Returns an iterator over all inner nodes in the Sparse Merkle Tree proofs.

This is useful for reconstructing parts of the Sparse Merkle Tree or for verification purposes.

pub fn leaves(&self) -> impl Iterator<Item = &SmtLeaf>

Returns an iterator over all leaves in the Sparse Merkle Tree proofs.

Each item returned is a tuple containing the leaf index and a reference to the leaf.

pub fn get(&self, vault_key: Word) -> Result<Option<Asset>, MerkleError>

Returns the Asset associated with the given vault_key.

The return value is None if the asset does not exist in the vault.

Errors

Returns an error if:

• the key is not tracked by this partial SMT.

pub fn add(&mut self, proof: SmtProof) -> Result<(), PartialAssetVaultError>

Adds an SmtProof to this PartialVault.

Errors

Returns an error if:

• the provided proof does not prove inclusion of valid Assets.
• the vault key of the proven asset does not match the vault key derived from the asset.
• the new root after the insertion of the leaf and the path does not match the existing root (except when the first leaf is added).

Trait Implementations

impl Clone for PartialVault

fn clone(&self) -> PartialVault

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PartialVault

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

Formats the value using the given formatter.

impl Default for PartialVault

fn default() -> PartialVault

Returns the “default value” for a type.

impl Deserializable for PartialVault

fn read_from<R: ByteReader>( source: &mut R, ) -> Result<Self, DeserializationError>

Reads a sequence of bytes from the provided source, attempts to deserialize these bytes into Self, and returns the result.

fn read_from_bytes(bytes: &[u8]) -> Result<Self, DeserializationError>

Attempts to deserialize the provided bytes into Self and returns the result.

impl From<&AssetVault> for PartialVault

fn from(value: &AssetVault) -> Self

Converts to this type from the input type.

impl PartialEq for PartialVault

fn eq(&self, other: &PartialVault) -> 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 Serializable for PartialVault

fn write_into<W: ByteWriter>(&self, target: &mut W)

Serializes self into bytes and writes these bytes into the target.

fn to_bytes(&self) -> Vec<u8>

Serializes self into a vector of bytes.

fn get_size_hint(&self) -> usize

Returns an estimate of how many bytes are needed to represent self.

impl Eq for PartialVault

impl StructuralPartialEq for PartialVault