Phase 1 of repo reorg (#719)

* Remove unneeded script * Rename Substrate Demo -> Substrate * Rename demo -> node * Build wasm from last rename. * Merge ed25519 into substrate-primitives * Minor tweak * Rename substrate -> core * Move substrate-runtime-support to core/runtime/support * Rename/move substrate-runtime-version * Move codec up a level * Rename substrate-codec -> parity-codec * Move environmental up a level * Move pwasm-* up to top, ready for removal * Remove requirement of s-r-support from s-r-primitives * Move core/runtime/primitives into core/runtime-primitives * Remove s-r-support dep from s-r-version * Remove dep of s-r-support from bft * Remove dep of s-r-support from node/consensus * Sever all other core deps from s-r-support * Forgot the no_std directive * Rename non-SRML modules to sr-* to avoid match clashes * Move runtime/* to srml/* * Rename substrate-runtime-* -> srml-* * Move srml to top-level
2026-06-14 16:51:03 +00:00 · 2018-09-12 11:13:31 +02:00
parent 8fe5aa4c81
commit 1e01162505
374 changed files with 2845 additions and 2902 deletions
@@ -0,0 +1,256 @@
+// Copyright 2017 Parity Technologies (UK) Ltd.
+// This file is part of Substrate.
+
+// Substrate 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.
+
+// Substrate 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 Substrate.  If not, see <http://www.gnu.org/licenses/>.
+
+//! Polkadot service components.
+
+use std::fmt;
+use std::sync::Arc;
+use std::marker::PhantomData;
+use serde::{Serialize, de::DeserializeOwned};
+use chain_spec::ChainSpec;
+use client_db;
+use client::{self, Client};
+use error;
+use network::{self, OnDemand};
+use substrate_executor::{NativeExecutor, NativeExecutionDispatch};
+use extrinsic_pool::{self, Options as ExtrinsicPoolOptions, Pool as ExtrinsicPool};
+use runtime_primitives::{traits::Block as BlockT, traits::Header as HeaderT, BuildStorage};
+use config::Configuration;
+use primitives::{Blake2Hasher, RlpCodec, H256};
+
+// Type aliases.
+// These exist mainly to avoid typing `<F as Factory>::Foo` all over the code.
+/// Network service type for a factory.
+pub type NetworkService<F> = network::Service<
+	<F as ServiceFactory>::Block,
+	<F as ServiceFactory>::NetworkProtocol,
+	<F as ServiceFactory>::ExtrinsicHash,
+>;
+
+/// Code executor type for a factory.
+pub type CodeExecutor<F> = NativeExecutor<<F as ServiceFactory>::RuntimeDispatch>;
+
+/// Full client backend type for a factory.
+pub type FullBackend<F> = client_db::Backend<<F as ServiceFactory>::Block>;
+
+/// Full client executor type for a factory.
+pub type FullExecutor<F> = client::LocalCallExecutor<
+	client_db::Backend<<F as ServiceFactory>::Block>,
+	CodeExecutor<F>,
+>;
+
+/// Light client backend type for a factory.
+pub type LightBackend<F> = client::light::backend::Backend<
+	client_db::light::LightStorage<<F as ServiceFactory>::Block>,
+	network::OnDemand<<F as ServiceFactory>::Block, NetworkService<F>>,
+>;
+
+/// Light client executor type for a factory.
+pub type LightExecutor<F> = client::light::call_executor::RemoteCallExecutor<
+	client::light::blockchain::Blockchain<
+		client_db::light::LightStorage<<F as ServiceFactory>::Block>,
+		network::OnDemand<<F as ServiceFactory>::Block, NetworkService<F>>
+	>,
+	network::OnDemand<<F as ServiceFactory>::Block, NetworkService<F>>,
+	Blake2Hasher,
+	RlpCodec,
+>;
+
+/// Full client type for a factory.
+pub type FullClient<F> = Client<FullBackend<F>, FullExecutor<F>, <F as ServiceFactory>::Block>;
+
+/// Light client type for a factory.
+pub type LightClient<F> = Client<LightBackend<F>, LightExecutor<F>, <F as ServiceFactory>::Block>;
+
+/// `ChainSpec` specialization for a factory.
+pub type FactoryChainSpec<F> = ChainSpec<<F as ServiceFactory>::Genesis>;
+
+/// `Genesis` specialization for a factory.
+pub type FactoryGenesis<F> = <F as ServiceFactory>::Genesis;
+
+/// `Block` type for a factory.
+pub type FactoryBlock<F> = <F as ServiceFactory>::Block;
+
+/// `Number` type for a factory.
+pub type FactoryBlockNumber<F> = <<FactoryBlock<F> as BlockT>::Header as HeaderT>::Number;
+
+/// Full `Configuration` type for a factory.
+pub type FactoryFullConfiguration<F> = Configuration<<F as ServiceFactory>::Configuration, FactoryGenesis<F>>;
+
+/// Client type for `Components`.
+pub type ComponentClient<C> = Client<
+	<C as Components>::Backend,
+	<C as Components>::Executor,
+	FactoryBlock<<C as Components>::Factory>
+>;
+
+/// Block type for `Components`
+pub type ComponentBlock<C> = <<C as Components>::Factory as ServiceFactory>::Block;
+
+/// Extrinsic hash type for `Components`
+pub type ComponentExHash<C> = <<C as Components>::ExtrinsicPoolApi as extrinsic_pool::ChainApi>::Hash;
+
+/// Extrinsic type.
+pub type ComponentExtrinsic<C> = <ComponentBlock<C> as BlockT>::Extrinsic;
+
+/// Extrinsic pool API type for `Components`.
+pub type PoolApi<C> = <C as Components>::ExtrinsicPoolApi;
+
+/// A set of traits for the runtime genesis config.
+pub trait RuntimeGenesis: Serialize + DeserializeOwned + BuildStorage {}
+impl<T: Serialize + DeserializeOwned + BuildStorage> RuntimeGenesis for T {}
+
+/// A collection of types and methods to build a service on top of the substrate service.
+pub trait ServiceFactory: 'static {
+	/// Block type.
+	type Block: BlockT;
+	/// Extrinsic hash type.
+	type ExtrinsicHash: ::std::hash::Hash + Eq + Copy + fmt::Debug + fmt::LowerHex + Serialize + DeserializeOwned + ::std::str::FromStr + Send + Sync + Default + 'static;
+	/// Network protocol extensions.
+	type NetworkProtocol: network::specialization::Specialization<Self::Block>;
+	/// Chain runtime.
+	type RuntimeDispatch: NativeExecutionDispatch + Send + Sync + 'static;
+	/// Extrinsic pool backend type for the full client.
+	type FullExtrinsicPoolApi: extrinsic_pool::ChainApi<Hash=Self::ExtrinsicHash, Block=Self::Block> + Send + 'static;
+	/// Extrinsic pool backend type for the light client.
+	type LightExtrinsicPoolApi: extrinsic_pool::ChainApi<Hash=Self::ExtrinsicHash, Block=Self::Block> + 'static;
+	/// Genesis configuration for the runtime.
+	type Genesis: RuntimeGenesis;
+	/// Other configuration for service members.
+	type Configuration: Default;
+
+	/// Network protocol id.
+	const NETWORK_PROTOCOL_ID: network::ProtocolId;
+
+	//TODO: replace these with a constructor trait. that ExtrinsicPool implements.
+	/// Extrinsic pool constructor for the full client.
+	fn build_full_extrinsic_pool(config: ExtrinsicPoolOptions, client: Arc<FullClient<Self>>)
+		-> Result<ExtrinsicPool<Self::FullExtrinsicPoolApi>, error::Error>;
+	/// Extrinsic pool constructor for the light client.
+	fn build_light_extrinsic_pool(config: ExtrinsicPoolOptions, client: Arc<LightClient<Self>>)
+		-> Result<ExtrinsicPool<Self::LightExtrinsicPoolApi>, error::Error>;
+
+	/// Build network protocol.
+	fn build_network_protocol(config: &FactoryFullConfiguration<Self>)
+		-> Result<Self::NetworkProtocol, error::Error>;
+}
+
+/// A collection of types and function to generalise over full / light client type.
+pub trait Components: 'static {
+	/// Associated service factory.
+	type Factory: ServiceFactory;
+	/// Client backend.
+	type Backend: 'static + client::backend::Backend<FactoryBlock<Self::Factory>, Blake2Hasher, RlpCodec>;
+	/// Client executor.
+	type Executor: 'static + client::CallExecutor<FactoryBlock<Self::Factory>, Blake2Hasher, RlpCodec> + Send + Sync;
+	/// Extrinsic pool type.
+	type ExtrinsicPoolApi: 'static + extrinsic_pool::ChainApi<Hash=<Self::Factory as ServiceFactory>::ExtrinsicHash, Block=FactoryBlock<Self::Factory>>;
+
+	/// Create client.
+	fn build_client(
+		config: &FactoryFullConfiguration<Self::Factory>,
+		executor: CodeExecutor<Self::Factory>,
+	)
+		-> Result<(
+			Arc<ComponentClient<Self>>,
+			Option<Arc<OnDemand<FactoryBlock<Self::Factory>, NetworkService<Self::Factory>>>>
+		), error::Error>;
+
+	/// Create extrinsic pool.
+	fn build_extrinsic_pool(config: ExtrinsicPoolOptions, client: Arc<ComponentClient<Self>>)
+		-> Result<ExtrinsicPool<Self::ExtrinsicPoolApi>, error::Error>;
+}
+
+/// A struct that implement `Components` for the full client.
+pub struct FullComponents<Factory: ServiceFactory> {
+	_factory: PhantomData<Factory>,
+}
+
+impl<Factory: ServiceFactory> Components for FullComponents<Factory> {
+	type Factory = Factory;
+	type Executor = FullExecutor<Factory>;
+	type Backend = FullBackend<Factory>;
+	type ExtrinsicPoolApi = <Factory as ServiceFactory>::FullExtrinsicPoolApi;
+
+	fn build_client(
+		config: &FactoryFullConfiguration<Factory>,
+		executor: CodeExecutor<Self::Factory>,
+	)
+		-> Result<(
+			Arc<ComponentClient<Self>>,
+			Option<Arc<OnDemand<FactoryBlock<Self::Factory>, NetworkService<Self::Factory>>>>
+		), error::Error>
+	{
+		let db_settings = client_db::DatabaseSettings {
+			cache_size: None,
+			path: config.database_path.as_str().into(),
+			pruning: config.pruning.clone(),
+		};
+		Ok((Arc::new(client_db::new_client(db_settings, executor, &config.chain_spec, config.execution_strategy)?), None))
+	}
+
+	fn build_extrinsic_pool(config: ExtrinsicPoolOptions, client: Arc<ComponentClient<Self>>)
+		-> Result<ExtrinsicPool<Self::ExtrinsicPoolApi>, error::Error>
+	{
+		Factory::build_full_extrinsic_pool(config, client)
+	}
+}
+
+/// A struct that implement `Components` for the light client.
+pub struct LightComponents<Factory: ServiceFactory> {
+	_factory: PhantomData<Factory>,
+}
+
+impl<Factory: ServiceFactory> Components for LightComponents<Factory>
+	where
+		<<Factory as ServiceFactory>::Block as BlockT>::Hash: From<H256>,
+		H256: From<<<Factory as ServiceFactory>::Block as BlockT>::Hash>,
+{
+	type Factory = Factory;
+	type Executor = LightExecutor<Factory>;
+	type Backend = LightBackend<Factory>;
+	type ExtrinsicPoolApi = <Factory as ServiceFactory>::LightExtrinsicPoolApi;
+
+	fn build_client(
+		config: &FactoryFullConfiguration<Factory>,
+		executor: CodeExecutor<Self::Factory>,
+	)
+		-> Result<(
+			Arc<ComponentClient<Self>>,
+			Option<Arc<OnDemand<FactoryBlock<Self::Factory>,
+			NetworkService<Self::Factory>>>>
+		), error::Error>
+	{
+		let db_settings = client_db::DatabaseSettings {
+			cache_size: None,
+			path: config.database_path.as_str().into(),
+			pruning: config.pruning.clone(),
+		};
+		let db_storage = client_db::light::LightStorage::new(db_settings)?;
+		let light_blockchain = client::light::new_light_blockchain(db_storage);
+		let fetch_checker = Arc::new(client::light::new_fetch_checker::<_, Blake2Hasher, RlpCodec>(executor));
+		let fetcher = Arc::new(network::OnDemand::new(fetch_checker));
+		let client_backend = client::light::new_light_backend(light_blockchain, fetcher.clone());
+		let client = client::light::new_light(client_backend, fetcher.clone(), &config.chain_spec)?;
+		Ok((Arc::new(client), Some(fetcher)))
+	}
+
+	fn build_extrinsic_pool(config: ExtrinsicPoolOptions, client: Arc<ComponentClient<Self>>)
+		-> Result<ExtrinsicPool<Self::ExtrinsicPoolApi>, error::Error>
+	{
+		Factory::build_light_extrinsic_pool(config, client)
+	}
+}