Struct polymesh_api::polymesh::api::contracts::QueryApi

pub struct QueryApi<'api> { /* private fields */ }

Implementations

impl<'api> QueryApi<'api>

pub async fn pristine_code(&self, key_0: H256) -> Result<Option<Vec<u8>>>

A mapping from an original code hash to the original code, untouched by instrumentation.

pub async fn code_storage(&self, key_0: H256) -> Result<Option<PrefabWasmModule>>

A mapping between an original code hash and instrumented wasm code, ready for execution.

pub async fn owner_info_of(&self, key_0: H256) -> Result<Option<OwnerInfo>>

A mapping between an original code hash and its owner information.

pub async fn nonce(&self) -> Result<u64>

This is a monotonic counter incremented on contract instantiation.

This is used in order to generate unique trie ids for contracts. The trie id of a new contract is calculated from hash(account_id, nonce). The nonce is required because otherwise the following sequence would lead to a possible collision of storage:

1. Create a new contract.
2. Terminate the contract.
3. Immediately recreate the contract with the same account_id.

This is bad because the contents of a trie are deleted lazily and there might be storage of the old instantiation still in it when the new contract is created. Please note that we can’t replace the counter by the block number because the sequence above can happen in the same block. We also can’t keep the account counter in memory only because storage is the only way to communicate across different extrinsics in the same block.

Note

Do not use it to determine the number of contracts. It won’t be decremented if a contract is destroyed.

pub async fn contract_info_of(
    &self,
    key_0: AccountId
) -> Result<Option<RawContractInfo<H256, u128>>>

The code associated with a given account.

TWOX-NOTE: SAFE since AccountId is a secure hash.

pub async fn deletion_queue(&self) -> Result<Vec<DeletedContract>>

Evicted contracts that await child trie deletion.

Child trie deletion is a heavy operation depending on the amount of storage items stored in said trie. Therefore this operation is performed lazily in on_initialize.

Trait Implementations

impl<'api> Clone for QueryApi<'api>

fn clone(&self) -> QueryApi<'api>

Returns a copy of the value.

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

Performs copy-assignment from source.