// Copyright 2020 Parity Technologies (UK) Ltd. // This file is part of Polkadot. // Polkadot 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. // Polkadot 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 Polkadot. If not, see . //! Polkadot test service only. #![warn(missing_docs)] mod chain_spec; pub use chain_spec::*; use futures::future::Future; use polkadot_overseer::OverseerHandler; use polkadot_primitives::v1::{Block, Id as ParaId, HeadData, ValidationCode}; use polkadot_runtime_common::BlockHashCount; use polkadot_service::{ new_full, NewFull, FullClient, AbstractClient, ClientHandle, ExecuteWithClient, }; use polkadot_test_runtime::{Runtime, SignedExtra, SignedPayload, VERSION, ParasSudoWrapperCall}; use polkadot_runtime_parachains::paras::ParaGenesisArgs; use sc_chain_spec::ChainSpec; use sc_client_api::{execution_extensions::ExecutionStrategies, BlockchainEvents}; use sc_executor::native_executor_instance; use sc_informant::OutputFormat; use sc_network::{ config::{NetworkConfiguration, TransportConfig}, multiaddr, }; use service::{ config::{DatabaseConfig, KeystoreConfig, MultiaddrWithPeerId, WasmExecutionMethod}, error::Error as ServiceError, RpcHandlers, TaskExecutor, TaskManager, }; use service::{BasePath, Configuration, Role, TFullBackend}; use sp_arithmetic::traits::SaturatedConversion; use sp_blockchain::HeaderBackend; use sp_keyring::Sr25519Keyring; use sp_runtime::{codec::Encode, generic}; use sp_state_machine::BasicExternalities; use std::sync::Arc; use substrate_test_client::{BlockchainEventsExt, RpcHandlersExt, RpcTransactionOutput, RpcTransactionError}; native_executor_instance!( pub PolkadotTestExecutor, polkadot_test_runtime::api::dispatch, polkadot_test_runtime::native_version, frame_benchmarking::benchmarking::HostFunctions, ); /// Create a new Polkadot test service for a full node. #[sc_cli::prefix_logs_with(config.network.node_name.as_str())] pub fn polkadot_test_new_full( config: Configuration, authority_discovery_disabled: bool, ) -> Result< NewFull>>, ServiceError, > { new_full::( config, authority_discovery_disabled, None, ).map_err(Into::into) } /// A wrapper for the test client that implements `ClientHandle`. pub struct TestClient(pub Arc>); impl ClientHandle for TestClient { fn execute_with(&self, t: T) -> T::Output { T::execute_with_client::<_, _, polkadot_service::FullBackend>(t, self.0.clone()) } } /// Create a Polkadot `Configuration`. /// /// By default an in-memory socket will be used, therefore you need to provide boot /// nodes if you want the future node to be connected to other nodes. /// /// The `storage_update_func` function will be executed in an externalities provided environment /// and can be used to make adjustements to the runtime genesis storage. pub fn node_config( storage_update_func: impl Fn(), task_executor: TaskExecutor, key: Sr25519Keyring, boot_nodes: Vec, ) -> Configuration { let base_path = BasePath::new_temp_dir().expect("could not create temporary directory"); let root = base_path.path(); let role = Role::Authority { sentry_nodes: Vec::new(), }; let key_seed = key.to_seed(); let mut spec = polkadot_local_testnet_config(); let mut storage = spec .as_storage_builder() .build_storage() .expect("could not build storage"); BasicExternalities::execute_with_storage(&mut storage, storage_update_func); spec.set_storage(storage); let mut network_config = NetworkConfiguration::new( key_seed.to_string(), "network/test/0.1", Default::default(), None, ); let informant_output_format = OutputFormat { enable_color: false, }; network_config.boot_nodes = boot_nodes; network_config.allow_non_globals_in_dht = true; network_config .listen_addresses .push(multiaddr::Protocol::Memory(rand::random()).into()); network_config.transport = TransportConfig::MemoryOnly; Configuration { impl_name: "polkadot-test-node".to_string(), impl_version: "0.1".to_string(), role, task_executor, transaction_pool: Default::default(), network: network_config, keystore: KeystoreConfig::Path { path: root.join("key"), password: None, }, database: DatabaseConfig::RocksDb { path: root.join("db"), cache_size: 128, }, state_cache_size: 16777216, state_cache_child_ratio: None, pruning: Default::default(), chain_spec: Box::new(spec), wasm_method: WasmExecutionMethod::Interpreted, // NOTE: we enforce the use of the native runtime to make the errors more debuggable execution_strategies: ExecutionStrategies { syncing: sc_client_api::ExecutionStrategy::NativeWhenPossible, importing: sc_client_api::ExecutionStrategy::NativeWhenPossible, block_construction: sc_client_api::ExecutionStrategy::NativeWhenPossible, offchain_worker: sc_client_api::ExecutionStrategy::NativeWhenPossible, other: sc_client_api::ExecutionStrategy::NativeWhenPossible, }, rpc_http: None, rpc_ws: None, rpc_ipc: None, rpc_ws_max_connections: None, rpc_cors: None, rpc_methods: Default::default(), prometheus_config: None, telemetry_endpoints: None, telemetry_external_transport: None, default_heap_pages: None, offchain_worker: Default::default(), force_authoring: false, disable_grandpa: false, dev_key_seed: Some(key_seed), tracing_targets: None, tracing_receiver: Default::default(), max_runtime_instances: 8, announce_block: true, base_path: Some(base_path), informant_output_format, } } /// Run a Polkadot test node using the Polkadot test runtime. /// /// The node will be using an in-memory socket, therefore you need to provide boot nodes if you /// want it to be connected to other nodes. /// /// The `storage_update_func` function will be executed in an externalities provided environment /// and can be used to make adjustements to the runtime genesis storage. pub fn run_test_node( task_executor: TaskExecutor, key: Sr25519Keyring, storage_update_func: impl Fn(), boot_nodes: Vec, ) -> PolkadotTestNode< TaskManager, impl AbstractClient>, > { let config = node_config(storage_update_func, task_executor, key, boot_nodes); let multiaddr = config.network.listen_addresses[0].clone(); let authority_discovery_disabled = true; let NewFull {task_manager, client, network, rpc_handlers, overseer_handler, ..} = polkadot_test_new_full(config, authority_discovery_disabled) .expect("could not create Polkadot test service"); let peer_id = network.local_peer_id().clone(); let addr = MultiaddrWithPeerId { multiaddr, peer_id }; PolkadotTestNode { task_manager, client, overseer_handler, addr, rpc_handlers, } } /// A Polkadot test node instance used for testing. pub struct PolkadotTestNode { /// TaskManager's instance. pub task_manager: S, /// Client's instance. pub client: Arc, /// The overseer handler. pub overseer_handler: OverseerHandler, /// The `MultiaddrWithPeerId` to this node. This is useful if you want to pass it as "boot node" to other nodes. pub addr: MultiaddrWithPeerId, /// RPCHandlers to make RPC queries. pub rpc_handlers: RpcHandlers, } impl PolkadotTestNode where C: HeaderBackend, { /// Send a transaction through RPCHandlers to call a function. pub async fn call_function( &self, function: impl Into, caller: Sr25519Keyring, ) -> Result { let function = function.into(); let current_block_hash = self.client.info().best_hash; let current_block = self.client.info().best_number.saturated_into(); let genesis_block = self.client.hash(0).unwrap().unwrap(); let nonce = 0; let period = BlockHashCount::get() .checked_next_power_of_two() .map(|c| c / 2) .unwrap_or(2) as u64; let tip = 0; let extra: SignedExtra = ( frame_system::CheckSpecVersion::::new(), frame_system::CheckTxVersion::::new(), frame_system::CheckGenesis::::new(), frame_system::CheckEra::::from(generic::Era::mortal(period, current_block)), frame_system::CheckNonce::::from(nonce), frame_system::CheckWeight::::new(), pallet_transaction_payment::ChargeTransactionPayment::::from(tip), ); let raw_payload = SignedPayload::from_raw( function.clone(), extra.clone(), ( VERSION.spec_version, VERSION.transaction_version, genesis_block, current_block_hash, (), (), (), ), ); let signature = raw_payload.using_encoded(|e| caller.sign(e)); let extrinsic = polkadot_test_runtime::UncheckedExtrinsic::new_signed( function.clone(), polkadot_test_runtime::Address::Id(caller.public().into()), polkadot_primitives::v0::Signature::Sr25519(signature.clone()), extra.clone(), ); self.rpc_handlers.send_transaction(extrinsic.into()).await } /// Register a parachain at this relay chain. pub async fn register_parachain( &self, id: ParaId, validation_code: ValidationCode, genesis_head: HeadData, ) -> Result<(), RpcTransactionError> { let call = ParasSudoWrapperCall::sudo_schedule_para_initialize( id, ParaGenesisArgs { genesis_head, validation_code, parachain: true, }, ); self.call_function(call, Sr25519Keyring::Alice).await.map(drop) } } impl PolkadotTestNode where C: BlockchainEvents, { /// Wait for `count` blocks to be imported in the node and then exit. This function will not return if no blocks /// are ever created, thus you should restrict the maximum amount of time of the test execution. pub fn wait_for_blocks(&self, count: usize) -> impl Future { self.client.wait_for_blocks(count) } }