Struct ContractStoreOverlay 

pub struct ContractStoreOverlay(SledDbOverlayPtr);

Overlay structure over a ContractStore instance.

Tuple Fields

0: SledDbOverlayPtr

Implementations

impl ContractStoreOverlay

pub fn new(overlay: &SledDbOverlayPtr) -> Result<Self>

pub fn get(&self, contract_id: ContractId) -> Result<Vec<u8>>

Fetches the bincode for a given ContractId from the overlay’s wasm tree. Returns an error if the bincode is not found.

pub fn insert(&self, contract_id: ContractId, bincode: &[u8]) -> Result<()>

Inserts or replaces the bincode for a given ContractId into the overlay’s wasm tree.

pub fn init( &self, contract_id: &ContractId, tree_name: &str, ) -> Result<[u8; 32]>

Try to initialize a new contract state. Contracts can create a number of trees, separated by tree_name, which they can then use from the smart contract API. init() will look into the main ContractStateStoreOverlay tree to check if the smart contract was already deployed, and if so it will fetch a vector of these states that were initialized. If the state was already found, this function will return an error, because in this case the handle should be fetched using lookup(). If the tree was not initialized previously, it will be appended to the main ContractStateStoreOverlay tree and a handle to it will be returned.

pub fn lookup( &self, contract_id: &ContractId, tree_name: &str, ) -> Result<[u8; 32]>

Do a lookup of an existing contract state. In order to succeed, the state must have been previously initialized with init(). If the state has been found, a handle to it will be returned. Otherwise, we return an error.

pub fn get_zkas( &self, contract_id: &ContractId, zkas_ns: &str, ) -> Result<(ZkBinary, VerifyingKey)>

Abstraction function for fetching a ZkBinary and its respective VerifyingKey from a contract’s zkas sled tree.

pub fn get_state_monotree(&self) -> Result<Monotree<MemoryDb>>

Generate a Monotree(SMT) containing all contracts states roots, along with the wasm bincodes monotree roots. Be carefull as this will open all states monotrees in the overlay, and all contract state trees if their monotrees need rebuild.

Note: native contracts zkas tree and wasm bincodes are excluded.

pub fn update_state_monotree( &self, diff: &SledDbOverlayStateDiff, tree: &mut Monotree<MemoryDb>, ) -> Result<()>

Retrieve all updated contracts states and wasm bincodes from provided overlay diff, update their monotrees in the overlay and their records in the provided Monotree(SMT).

Note: native contracts zkas tree and wasm bincodes are excluded.