// This file is part of Substrate. // Copyright (C) 2020-2021 Parity Technologies (UK) Ltd. // SPDX-License-Identifier: GPL-3.0-or-later WITH Classpath-exception-2.0 // This program is free software: you can redistribute it and/or modify // it under the terms of the GNU General Public License as published by // the Free Software Foundation, either version 3 of the License, or // (at your option) any later version. // This program is distributed in the hope that it will be useful, // but WITHOUT ANY WARRANTY; without even the implied warranty of // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the // GNU General Public License for more details. // You should have received a copy of the GNU General Public License // along with this program. If not, see . //! Async externalities. use std::any::{TypeId, Any}; use sp_core::{ storage::{ChildInfo, TrackedStorageKey}, traits::{Externalities, SpawnNamed, TaskExecutorExt, RuntimeSpawnExt, RuntimeSpawn}, }; use sp_externalities::{Extensions, ExternalitiesExt as _}; /// Simple state-less externalities for use in async context. /// /// Will panic if anything is accessing the storage. #[derive(Debug)] pub struct AsyncExternalities { extensions: Extensions, } /// New Async externalities. pub fn new_async_externalities(scheduler: Box) -> Result { let mut res = AsyncExternalities { extensions: Default::default() }; let mut ext = &mut res as &mut dyn Externalities; ext.register_extension::(TaskExecutorExt(scheduler.clone())) .map_err(|_| "Failed to register task executor extension.")?; Ok(res) } impl AsyncExternalities { /// Extend async externalities with the ability to spawn wasm instances. pub fn with_runtime_spawn( mut self, runtime_ext: Box, ) -> Result { let mut ext = &mut self as &mut dyn Externalities; ext.register_extension::(RuntimeSpawnExt(runtime_ext)) .map_err(|_| "Failed to register task executor extension.")?; Ok(self) } } type StorageKey = Vec; type StorageValue = Vec; impl Externalities for AsyncExternalities { fn set_offchain_storage(&mut self, _key: &[u8], _value: Option<&[u8]>) { panic!("`set_offchain_storage`: should not be used in async externalities!") } fn storage(&self, _key: &[u8]) -> Option { panic!("`storage`: should not be used in async externalities!") } fn storage_hash(&self, _key: &[u8]) -> Option> { panic!("`storage_hash`: should not be used in async externalities!") } fn child_storage( &self, _child_info: &ChildInfo, _key: &[u8], ) -> Option { panic!("`child_storage`: should not be used in async externalities!") } fn child_storage_hash( &self, _child_info: &ChildInfo, _key: &[u8], ) -> Option> { panic!("`child_storage_hash`: should not be used in async externalities!") } fn next_storage_key(&self, _key: &[u8]) -> Option { panic!("`next_storage_key`: should not be used in async externalities!") } fn next_child_storage_key( &self, _child_info: &ChildInfo, _key: &[u8], ) -> Option { panic!("`next_child_storage_key`: should not be used in async externalities!") } fn place_storage(&mut self, _key: StorageKey, _maybe_value: Option) { panic!("`place_storage`: should not be used in async externalities!") } fn place_child_storage( &mut self, _child_info: &ChildInfo, _key: StorageKey, _value: Option, ) { panic!("`place_child_storage`: should not be used in async externalities!") } fn kill_child_storage( &mut self, _child_info: &ChildInfo, _limit: Option, ) -> bool { panic!("`kill_child_storage`: should not be used in async externalities!") } fn clear_prefix(&mut self, _prefix: &[u8]) { panic!("`clear_prefix`: should not be used in async externalities!") } fn clear_child_prefix( &mut self, _child_info: &ChildInfo, _prefix: &[u8], ) { panic!("`clear_child_prefix`: should not be used in async externalities!") } fn storage_append( &mut self, _key: Vec, _value: Vec, ) { panic!("`storage_append`: should not be used in async externalities!") } fn storage_root(&mut self) -> Vec { panic!("`storage_root`: should not be used in async externalities!") } fn child_storage_root( &mut self, _child_info: &ChildInfo, ) -> Vec { panic!("`child_storage_root`: should not be used in async externalities!") } fn storage_changes_root(&mut self, _parent: &[u8]) -> Result>, ()> { panic!("`storage_changes_root`: should not be used in async externalities!") } fn storage_start_transaction(&mut self) { unimplemented!("Transactions are not supported by AsyncExternalities"); } fn storage_rollback_transaction(&mut self) -> Result<(), ()> { unimplemented!("Transactions are not supported by AsyncExternalities"); } fn storage_commit_transaction(&mut self) -> Result<(), ()> { unimplemented!("Transactions are not supported by AsyncExternalities"); } fn wipe(&mut self) {} fn commit(&mut self) {} fn read_write_count(&self) -> (u32, u32, u32, u32) { unimplemented!("read_write_count is not supported in AsyncExternalities") } fn reset_read_write_count(&mut self) { unimplemented!("reset_read_write_count is not supported in AsyncExternalities") } fn get_whitelist(&self) -> Vec { unimplemented!("get_whitelist is not supported in AsyncExternalities") } fn set_whitelist(&mut self, _: Vec) { unimplemented!("set_whitelist is not supported in AsyncExternalities") } } impl sp_externalities::ExtensionStore for AsyncExternalities { fn extension_by_type_id(&mut self, type_id: TypeId) -> Option<&mut dyn Any> { self.extensions.get_mut(type_id) } fn register_extension_with_type_id( &mut self, type_id: TypeId, extension: Box, ) -> Result<(), sp_externalities::Error> { self.extensions.register_with_type_id(type_id, extension) } fn deregister_extension_by_type_id(&mut self, type_id: TypeId) -> Result<(), sp_externalities::Error> { if self.extensions.deregister(type_id) { Ok(()) } else { Err(sp_externalities::Error::ExtensionIsNotRegistered(type_id)) } } }