Struct sp_state_machine::Ext

pub struct Ext<'a, H, N, B, T> where
    H: Hasher<Out = H256>,
    B: 'a + Backend<H>,  {
    pub id: u16,
    // some fields omitted
}

Wraps a read-only backend, call executor, and current overlayed changes.

Fields

id: u16

Pseudo-unique id used for tracing.

Methods

impl<'a, H, N, B, T> Ext<'a, H, N, B, T> where
    H: Hasher<Out = H256>,
    B: 'a + Backend<H>,
    T: 'a + ChangesTrieStorage<H, N>,
    N: BlockNumber, 

pub fn new(
    overlay: &'a mut OverlayedChanges,
    backend: &'a B,
    changes_trie_storage: Option<&'a T>,
    extensions: Option<&'a mut Extensions>
) -> Self

Create a new Ext from overlayed changes and read-only backend

pub fn transaction(
    &mut self
) -> ((B::Transaction, H256), Option<ChangesTrieTransaction<H, N>>)

Get the transaction necessary to update the backend.

Trait Implementations

impl<'a, H, B, T, N> ExtensionStore for Ext<'a, H, N, B, T> where
    H: Hasher<Out = H256>,
    B: 'a + Backend<H>,
    T: 'a + ChangesTrieStorage<H, N>,
    N: BlockNumber, 

fn extension_by_type_id(&mut self, type_id: TypeId) -> Option<&mut dyn Any>

Tries to find a registered extension by the given type_id and returns it as a &mut dyn Any.

impl<'a, H, B, T, N> Externalities for Ext<'a, H, N, B, T> where
    H: Hasher<Out = H256>,
    B: 'a + Backend<H>,
    T: 'a + ChangesTrieStorage<H, N>,
    N: BlockNumber, 

fn storage(&self, key: &[u8]) -> Option<Vec<u8>>

Read runtime storage.

fn storage_hash(&self, key: &[u8]) -> Option<Vec<u8>>

Get storage value hash. This may be optimized for large values.

fn original_storage(&self, key: &[u8]) -> Option<Vec<u8>>

Read original runtime storage, ignoring any overlayed changes.

fn original_storage_hash(&self, key: &[u8]) -> Option<Vec<u8>>

Get original storage value hash, ignoring any overlayed changes. This may be optimized for large values.

fn child_storage(
    &self,
    storage_key: ChildStorageKey,
    child_info: ChildInfo,
    key: &[u8]
) -> Option<Vec<u8>>

Read child runtime storage.

fn child_storage_hash(
    &self,
    storage_key: ChildStorageKey,
    _child_info: ChildInfo,
    key: &[u8]
) -> Option<Vec<u8>>

Get child storage value hash. This may be optimized for large values.

fn original_child_storage(
    &self,
    storage_key: ChildStorageKey,
    child_info: ChildInfo,
    key: &[u8]
) -> Option<Vec<u8>>

Read original runtime child storage, ignoring any overlayed changes.

fn original_child_storage_hash(
    &self,
    storage_key: ChildStorageKey,
    child_info: ChildInfo,
    key: &[u8]
) -> Option<Vec<u8>>

Get original child storage value hash, ignoring any overlayed changes. This may be optimized for large values.

fn exists_storage(&self, key: &[u8]) -> bool

Whether a storage entry exists.

fn exists_child_storage(
    &self,
    storage_key: ChildStorageKey,
    child_info: ChildInfo,
    key: &[u8]
) -> bool

Whether a child storage entry exists.

fn next_storage_key(&self, key: &[u8]) -> Option<Vec<u8>>

Returns the key immediately following the given key, if it exists.

fn next_child_storage_key(
    &self,
    storage_key: ChildStorageKey,
    child_info: ChildInfo,
    key: &[u8]
) -> Option<Vec<u8>>

Returns the key immediately following the given key, if it exists, in child storage.

fn place_storage(&mut self, key: Vec<u8>, value: Option<Vec<u8>>)

Set or clear a storage entry (key) of current contract being called (effective immediately).

fn place_child_storage(
    &mut self,
    storage_key: ChildStorageKey,
    child_info: ChildInfo,
    key: Vec<u8>,
    value: Option<Vec<u8>>
)

Set or clear a child storage entry. Return whether the operation succeeds.

fn kill_child_storage(
    &mut self,
    storage_key: ChildStorageKey,
    child_info: ChildInfo
)

Clear an entire child storage.

fn clear_prefix(&mut self, prefix: &[u8])

Clear storage entries which keys are start with the given prefix.

fn clear_child_prefix(
    &mut self,
    storage_key: ChildStorageKey,
    child_info: ChildInfo,
    prefix: &[u8]
)

Clear child storage entries which keys are start with the given prefix.

fn chain_id(&self) -> u64

Get the identity of the chain.

fn storage_root(&mut self) -> Vec<u8>

Get the trie root of the current storage map. This will also update all child storage keys in the top-level storage map.

fn child_storage_root(&mut self, storage_key: ChildStorageKey) -> Vec<u8>

Get the trie root of a child storage map. This will also update the value of the child storage keys in the top-level storage map. If the storage root equals the default hash as defined by the trie, the key in the top-level storage map will be removed.

fn storage_changes_root(
    &mut self,
    parent_hash: &[u8]
) -> Result<Option<Vec<u8>>, ()>

Get the change trie root of the current storage overlay at a block with given parent. parent is expects a SCALE endcoded hash.

fn set_storage(&mut self, key: Vec<u8>, value: Vec<u8>)

Set storage entry key of current contract being called (effective immediately).

fn set_child_storage(
    &mut self,
    storage_key: ChildStorageKey,
    child_info: ChildInfo,
    key: Vec<u8>,
    value: Vec<u8>
)

Set child storage entry key of current contract being called (effective immediately).

fn clear_storage(&mut self, key: &[u8])

Clear a storage entry (key) of current contract being called (effective immediately).

fn clear_child_storage(
    &mut self,
    storage_key: ChildStorageKey,
    child_info: ChildInfo,
    key: &[u8]
)

Clear a child storage entry (key) of current contract being called (effective immediately).