Struct sp_state_machine::ReadOnlyExternalities

pub struct ReadOnlyExternalities<'a, H: Hasher, B: 'a + Backend<H>> { /* fields omitted */ }

Simple read-only externalities for any backend.

To be used in test for state inspection. Will panic if something writes to the storage.

Implementations

impl<'a, H: Hasher, B: 'a + Backend<H>> ReadOnlyExternalities<'a, H, B>

pub fn execute_with<R>(&mut self, f: impl FnOnce() -> R) -> R

Execute the given closure while self is set as externalities.

Returns the result of the given closure.

Trait Implementations

impl<'a, H: Debug + Hasher, B: Debug + 'a + Backend<H>> Debug for ReadOnlyExternalities<'a, H, B>

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

Formats the value using the given formatter.

impl<'a, H: Hasher, B: 'a + Backend<H>> ExtensionStore for ReadOnlyExternalities<'a, H, B>

pub 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.

pub fn register_extension_with_type_id(
    &mut self,
    _type_id: TypeId,
    _extension: Box<dyn Extension>
) -> Result<(), Error>

Register extension extension with speciifed type_id.

pub fn deregister_extension_by_type_id(
    &mut self,
    _type_id: TypeId
) -> Result<(), Error>

Deregister extension with speicifed 'type_id' and drop it.

impl<'a, H: Hasher, B: 'a + Backend<H>> Externalities for ReadOnlyExternalities<'a, H, B>

pub fn set_offchain_storage(&mut self, _key: &[u8], _value: Option<&[u8]>)

Write a key value pair to the offchain storage database.

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

Read runtime storage.

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

Get storage value hash.

pub fn child_storage(
    &self,
    child_info: &ChildInfo,
    key: &[u8]
) -> Option<StorageValue>

Read child runtime storage.

pub fn child_storage_hash(
    &self,
    child_info: &ChildInfo,
    key: &[u8]
) -> Option<Vec<u8>>

Get child storage value hash.

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

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

pub fn next_child_storage_key(
    &self,
    child_info: &ChildInfo,
    key: &[u8]
) -> Option<StorageKey>

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

pub fn place_storage(
    &mut self,
    _key: StorageKey,
    _maybe_value: Option<StorageValue>
)

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

pub fn place_child_storage(
    &mut self,
    _child_info: &ChildInfo,
    _key: StorageKey,
    _value: Option<StorageValue>
)

Set or clear a child storage entry.

pub fn kill_child_storage(&mut self, _child_info: &ChildInfo)

Clear an entire child storage.

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

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

pub fn clear_child_prefix(&mut self, _child_info: &ChildInfo, _prefix: &[u8])

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

pub fn storage_append(&mut self, _key: Vec<u8>, _value: Vec<u8>)

Append storage item.

pub fn chain_id(&self) -> u64

Get the identity of the chain.

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

Get the trie root of the current storage map.

pub fn child_storage_root(&mut self, _child_info: &ChildInfo) -> Vec<u8>

Get the trie root of a child storage map.

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

Get the changes trie root of the current storage overlay at a block with given parent.

pub fn storage_start_transaction(&mut self)

Start a new nested transaction.

pub fn storage_rollback_transaction(&mut self) -> Result<(), ()>

Rollback the last transaction started by storage_start_transaction.

pub fn storage_commit_transaction(&mut self) -> Result<(), ()>

Commit the last transaction started by storage_start_transaction.

pub fn wipe(&mut self)

!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! Benchmarking related functionality and shouldn't be used anywhere else! !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!

pub fn commit(&mut self)

!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! Benchmarking related functionality and shouldn't be used anywhere else! !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!

pub fn read_write_count(&self) -> (u32, u32, u32, u32)

!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! Benchmarking related functionality and shouldn't be used anywhere else! !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!

pub fn reset_read_write_count(&mut self)

!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! Benchmarking related functionality and shouldn't be used anywhere else! !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!

pub fn get_whitelist(&self) -> Vec<TrackedStorageKey>

!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! Benchmarking related functionality and shouldn't be used anywhere else! !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!

pub fn set_whitelist(&mut self, _: Vec<TrackedStorageKey>)

!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! Benchmarking related functionality and shouldn't be used anywhere else! !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!

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

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

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

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

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

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

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

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

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

Whether a storage entry exists.

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

Whether a child storage entry exists.

impl<'a, H: Hasher, B: 'a + Backend<H>> From<&'a B> for ReadOnlyExternalities<'a, H, B>

pub fn from(backend: &'a B) -> Self

Performs the conversion.