// Copyright 2015-2018 Parity Technologies (UK) Ltd. // This file is part of Parity. // Parity 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. // Parity 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 Parity. If not, see . //! Creates and registers client and network services. use std::sync::Arc; use std::path::Path; use std::time::Duration; use ansi_term::Colour; use io::{IoContext, TimerToken, IoHandler, IoService, IoError}; use stop_guard::StopGuard; use sync::PrivateTxHandler; use ethcore::{BlockChainDB, BlockChainDBHandler}; use ethcore::client::{Client, ClientConfig, ChainNotify, ClientIoMessage}; use ethcore::miner::Miner; use ethcore::snapshot::service::{Service as SnapshotService, ServiceParams as SnapServiceParams}; use ethcore::snapshot::{SnapshotService as _SnapshotService, RestorationStatus}; use ethcore::spec::Spec; use ethcore::account_provider::AccountProvider; use ethcore_private_tx::{self, Importer}; use Error; pub struct PrivateTxService { provider: Arc, } impl PrivateTxService { fn new(provider: Arc) -> Self { PrivateTxService { provider, } } /// Returns underlying provider. pub fn provider(&self) -> Arc { self.provider.clone() } } impl PrivateTxHandler for PrivateTxService { fn import_private_transaction(&self, rlp: &[u8]) -> Result<(), String> { self.provider.import_private_transaction(rlp).map_err(|e| e.to_string()) } fn import_signed_private_transaction(&self, rlp: &[u8]) -> Result<(), String> { self.provider.import_signed_private_transaction(rlp).map_err(|e| e.to_string()) } } /// Client service setup. Creates and registers client and network services with the IO subsystem. pub struct ClientService { io_service: Arc>, client: Arc, snapshot: Arc, private_tx: Arc, database: Arc, _stop_guard: StopGuard, } impl ClientService { /// Start the `ClientService`. pub fn start( config: ClientConfig, spec: &Spec, blockchain_db: Arc, snapshot_path: &Path, restoration_db_handler: Box, _ipc_path: &Path, miner: Arc, account_provider: Arc, encryptor: Box, private_tx_conf: ethcore_private_tx::ProviderConfig, ) -> Result { let io_service = IoService::::start()?; info!("Configured for {} using {} engine", Colour::White.bold().paint(spec.name.clone()), Colour::Yellow.bold().paint(spec.engine.name())); let pruning = config.pruning; let client = Client::new(config, &spec, blockchain_db.clone(), miner.clone(), io_service.channel())?; let snapshot_params = SnapServiceParams { engine: spec.engine.clone(), genesis_block: spec.genesis_block(), restoration_db_handler: restoration_db_handler, pruning: pruning, channel: io_service.channel(), snapshot_root: snapshot_path.into(), db_restore: client.clone(), }; let snapshot = Arc::new(SnapshotService::new(snapshot_params)?); let provider = Arc::new(ethcore_private_tx::Provider::new( client.clone(), miner, account_provider, encryptor, private_tx_conf, io_service.channel(), )); let private_tx = Arc::new(PrivateTxService::new(provider)); let client_io = Arc::new(ClientIoHandler { client: client.clone(), snapshot: snapshot.clone(), }); io_service.register_handler(client_io)?; spec.engine.register_client(Arc::downgrade(&client) as _); let stop_guard = StopGuard::new(); Ok(ClientService { io_service: Arc::new(io_service), client: client, snapshot: snapshot, private_tx, database: blockchain_db, _stop_guard: stop_guard, }) } /// Get general IO interface pub fn register_io_handler(&self, handler: Arc + Send>) -> Result<(), IoError> { self.io_service.register_handler(handler) } /// Get client interface pub fn client(&self) -> Arc { self.client.clone() } /// Get snapshot interface. pub fn snapshot_service(&self) -> Arc { self.snapshot.clone() } /// Get private transaction service. pub fn private_tx_service(&self) -> Arc { self.private_tx.clone() } /// Get network service component pub fn io(&self) -> Arc> { self.io_service.clone() } /// Set the actor to be notified on certain chain events pub fn add_notify(&self, notify: Arc) { self.client.add_notify(notify); } /// Get a handle to the database. pub fn db(&self) -> Arc { self.database.clone() } /// Shutdown the Client Service pub fn shutdown(&self) { self.snapshot.shutdown(); } } /// IO interface for the Client handler struct ClientIoHandler { client: Arc, snapshot: Arc, } const CLIENT_TICK_TIMER: TimerToken = 0; const SNAPSHOT_TICK_TIMER: TimerToken = 1; const CLIENT_TICK: Duration = Duration::from_secs(5); const SNAPSHOT_TICK: Duration = Duration::from_secs(10); impl IoHandler for ClientIoHandler { fn initialize(&self, io: &IoContext) { io.register_timer(CLIENT_TICK_TIMER, CLIENT_TICK).expect("Error registering client timer"); io.register_timer(SNAPSHOT_TICK_TIMER, SNAPSHOT_TICK).expect("Error registering snapshot timer"); } fn timeout(&self, _io: &IoContext, timer: TimerToken) { trace_time!("service::read"); match timer { CLIENT_TICK_TIMER => { use ethcore::snapshot::SnapshotService; let snapshot_restoration = if let RestorationStatus::Ongoing{..} = self.snapshot.status() { true } else { false }; self.client.tick(snapshot_restoration) }, SNAPSHOT_TICK_TIMER => self.snapshot.tick(), _ => warn!("IO service triggered unregistered timer '{}'", timer), } } fn message(&self, _io: &IoContext, net_message: &ClientIoMessage) { trace_time!("service::message"); use std::thread; match *net_message { ClientIoMessage::BlockVerified => { self.client.import_verified_blocks(); } ClientIoMessage::BeginRestoration(ref manifest) => { if let Err(e) = self.snapshot.init_restore(manifest.clone(), true) { warn!("Failed to initialize snapshot restoration: {}", e); } } ClientIoMessage::FeedStateChunk(ref hash, ref chunk) => { self.snapshot.feed_state_chunk(*hash, chunk) } ClientIoMessage::FeedBlockChunk(ref hash, ref chunk) => { self.snapshot.feed_block_chunk(*hash, chunk) } ClientIoMessage::TakeSnapshot(num) => { let client = self.client.clone(); let snapshot = self.snapshot.clone(); let res = thread::Builder::new().name("Periodic Snapshot".into()).spawn(move || { if let Err(e) = snapshot.take_snapshot(&*client, num) { warn!("Failed to take snapshot at block #{}: {}", num, e); } }); if let Err(e) = res { debug!(target: "snapshot", "Failed to initialize periodic snapshot thread: {:?}", e); } }, ClientIoMessage::Execute(ref exec) => { (*exec.0)(&self.client); } _ => {} // ignore other messages } } } #[cfg(test)] mod tests { use std::sync::Arc; use std::{time, thread}; use tempdir::TempDir; use ethcore::account_provider::AccountProvider; use ethcore::client::ClientConfig; use ethcore::miner::Miner; use ethcore::spec::Spec; use ethcore::db::NUM_COLUMNS; use ethcore::test_helpers; use kvdb_rocksdb::{DatabaseConfig, CompactionProfile}; use super::*; use ethcore_private_tx; #[test] fn it_can_be_started() { let tempdir = TempDir::new("").unwrap(); let client_path = tempdir.path().join("client"); let snapshot_path = tempdir.path().join("snapshot"); let client_config = ClientConfig::default(); let mut client_db_config = DatabaseConfig::with_columns(NUM_COLUMNS); client_db_config.memory_budget = client_config.db_cache_size; client_db_config.compaction = CompactionProfile::auto(&client_path); client_db_config.wal = client_config.db_wal; let client_db_handler = test_helpers::restoration_db_handler(client_db_config.clone()); let client_db = client_db_handler.open(&client_path).unwrap(); let restoration_db_handler = test_helpers::restoration_db_handler(client_db_config); let spec = Spec::new_test(); let service = ClientService::start( ClientConfig::default(), &spec, client_db, &snapshot_path, restoration_db_handler, tempdir.path(), Arc::new(Miner::new_for_tests(&spec, None)), Arc::new(AccountProvider::transient_provider()), Box::new(ethcore_private_tx::NoopEncryptor), Default::default(), ); assert!(service.is_ok()); drop(service.unwrap()); thread::park_timeout(time::Duration::from_millis(100)); } }