Struct sp_state_machine::BasicExternalities

pub struct BasicExternalities { /* private fields */ }

Simple Map-based Externalities impl.

Implementations

impl BasicExternalities

pub fn new(inner: Storage) -> Self

Create a new instance of BasicExternalities

pub fn new_empty() -> Self

New basic externalities with empty storage.

pub fn insert(&mut self, k: StorageKey, v: StorageValue)

Insert key/value

pub fn into_storages(self) -> Storage

Consume self and returns inner storages

pub fn execute_with_storage<R>(storage: &mut Storage, f: impl FnOnce() -> R) -> R

Execute the given closure f with the externalities set and initialized with storage.

Returns the result of the closure and updates storage with all changes.

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.

pub fn extensions(&mut self) -> &mut Extensions

List of active extensions.

pub fn register_extension(&mut self, ext: impl Extension)

Register an extension.

Trait Implementations

impl Debug for BasicExternalities

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

Formats the value using the given formatter.

impl Default for BasicExternalities

fn default() -> Self

Returns the “default value” for a type.

impl ExtensionStore for BasicExternalities

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.

fn register_extension_with_type_id(
    &mut self,
    type_id: TypeId,
    extension: Box<dyn Extension>
) -> Result<(), Error>

Register extension extension with specified type_id.

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

Deregister extension with speicifed ‘type_id’ and drop it.

impl Externalities for BasicExternalities

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

Write a key value pair to the offchain storage database.

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

Read runtime storage.

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

Get storage value hash.

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

Read child runtime storage.

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

Get child storage value hash.

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

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

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.

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

fn place_child_storage(
    &mut self,
    child_info: &ChildInfo,
    key: StorageKey,
    value: Option<StorageValue>
)

Set or clear a child storage entry.

fn kill_child_storage(
    &mut self,
    child_info: &ChildInfo,
    _maybe_limit: Option<u32>,
    _maybe_cursor: Option<&[u8]>
) -> MultiRemovalResults

Clear an entire child storage.

fn clear_prefix(
    &mut self,
    prefix: &[u8],
    _maybe_limit: Option<u32>,
    _maybe_cursor: Option<&[u8]>
) -> MultiRemovalResults

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

fn clear_child_prefix(
    &mut self,
    child_info: &ChildInfo,
    prefix: &[u8],
    _maybe_limit: Option<u32>,
    _maybe_cursor: Option<&[u8]>
) -> MultiRemovalResults

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

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

Append storage item.

fn storage_root(&mut self, state_version: StateVersion) -> Vec<u8>

Get the trie root of the current storage map.

fn child_storage_root(
    &mut self,
    child_info: &ChildInfo,
    state_version: StateVersion
) -> Vec<u8>

Get the trie root of a child storage map.

fn storage_start_transaction(&mut self)

Start a new nested transaction.

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

Rollback the last transaction started by storage_start_transaction.

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

Commit the last transaction started by storage_start_transaction.

fn wipe(&mut self)

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

fn commit(&mut self)

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

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

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

fn reset_read_write_count(&mut self)

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

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

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

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

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

fn get_read_and_written_keys(&self) -> Vec<(Vec<u8>, u32, u32, bool)>

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

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

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

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

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, child_info: &ChildInfo, key: &[u8])

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

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

Whether a storage entry exists.

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

Whether a child storage entry exists.

fn storage_index_transaction(&mut self, _index: u32, _hash: &[u8], _size: u32)

Index specified transaction slice and store it.

fn storage_renew_transaction_index(&mut self, _index: u32, _hash: &[u8])

Renew existing piece of transaction storage.

fn proof_size(&self) -> Option<u32>

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

impl From<BTreeMap<Vec<u8, Global>, Vec<u8, Global>, Global>> for BasicExternalities

fn from(map: BTreeMap<StorageKey, StorageValue>) -> Self

Converts to this type from the input type.

impl FromIterator<(Vec<u8, Global>, Vec<u8, Global>)> for BasicExternalities

fn from_iter<I: IntoIterator<Item = (StorageKey, StorageValue)>>(
    iter: I
) -> Self

Creates a value from an iterator.

impl PartialEq<BasicExternalities> for BasicExternalities

fn eq(&self, other: &BasicExternalities) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.