// This file is part of Bizinikiwi. // Copyright (C) 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 . use crate::{error, error::Error}; use codec::{Decode, IoReader as CodecIoReader}; use futures::{future, prelude::*}; use futures_timer::Delay; use log::{info, warn}; use pezsc_chain_spec::ChainSpec; use pezsc_client_api::HeaderBackend; use pezsc_consensus::import_queue::{ BlockImportError, BlockImportStatus, ImportQueue, IncomingBlock, Link, }; use serde_json::{de::IoRead as JsonIoRead, Deserializer, StreamDeserializer}; use pezsp_consensus::BlockOrigin; use pezsp_runtime::{ generic::SignedBlock, traits::{ Block as BlockT, CheckedDiv, Header, MaybeSerializeDeserialize, NumberFor, Saturating, Zero, }, }; use std::{ io::Read, pin::Pin, sync::{ atomic::{AtomicBool, AtomicU64, Ordering}, Arc, }, task::Poll, time::{Duration, Instant}, }; /// Number of blocks we will add to the queue before waiting for the queue to catch up. const MAX_PENDING_BLOCKS: u64 = 10_000; /// Number of milliseconds to wait until next poll. const DELAY_TIME: u64 = 200; /// Number of milliseconds that must have passed between two updates. const TIME_BETWEEN_UPDATES: u64 = 3_000; /// Build a chain spec json pub fn build_spec(spec: &dyn ChainSpec, raw: bool) -> error::Result { spec.as_json(raw).map_err(Into::into) } /// Helper enum that wraps either a binary decoder (from parity-scale-codec), or a JSON decoder /// (from serde_json). Implements the Iterator Trait, calling `next()` will decode the next /// SignedBlock and return it. enum BlockIter where R: std::io::Read, { Binary { // Total number of blocks we are expecting to decode. num_expected_blocks: u64, // Number of blocks we have decoded thus far. read_block_count: u64, // Reader to the data, used for decoding new blocks. reader: CodecIoReader, }, Json { // Number of blocks we have decoded thus far. read_block_count: u64, // Stream to the data, used for decoding new blocks. reader: StreamDeserializer<'static, JsonIoRead, SignedBlock>, }, } impl BlockIter where R: Read + 'static, B: BlockT + MaybeSerializeDeserialize, { fn new(input: R, binary: bool) -> Result { if binary { let mut reader = CodecIoReader(input); // If the file is encoded in binary format, it is expected to first specify the number // of blocks that are going to be decoded. We read it and add it to our enum struct. let num_expected_blocks: u64 = Decode::decode(&mut reader) .map_err(|e| format!("Failed to decode the number of blocks: {:?}", e))?; Ok(BlockIter::Binary { num_expected_blocks, read_block_count: 0, reader }) } else { let stream_deser = Deserializer::from_reader(input).into_iter::>(); Ok(BlockIter::Json { reader: stream_deser, read_block_count: 0 }) } } /// Returns the number of blocks read thus far. fn read_block_count(&self) -> u64 { match self { BlockIter::Binary { read_block_count, .. } | BlockIter::Json { read_block_count, .. } => *read_block_count, } } /// Returns the total number of blocks to be imported, if possible. fn num_expected_blocks(&self) -> Option { match self { BlockIter::Binary { num_expected_blocks, .. } => Some(*num_expected_blocks), BlockIter::Json { .. } => None, } } } impl Iterator for BlockIter where R: Read + 'static, B: BlockT + MaybeSerializeDeserialize, { type Item = Result, String>; fn next(&mut self) -> Option { match self { BlockIter::Binary { num_expected_blocks, read_block_count, reader } => { if read_block_count < num_expected_blocks { let block_result: Result, _> = SignedBlock::::decode(reader).map_err(|e| e.to_string()); *read_block_count += 1; Some(block_result) } else { // `read_block_count` == `num_expected_blocks` so we've read enough blocks. None } }, BlockIter::Json { reader, read_block_count } => { let res = Some(reader.next()?.map_err(|e| e.to_string())); *read_block_count += 1; res }, } } } /// Imports the SignedBlock to the queue. fn import_block_to_queue( signed_block: SignedBlock, queue: &mut TImpQu, force: bool, ) where TBl: BlockT + MaybeSerializeDeserialize, TImpQu: 'static + ImportQueue, { let (header, extrinsics) = signed_block.block.deconstruct(); let hash = header.hash(); // import queue handles verification and importing it into the client. queue.service_ref().import_blocks( BlockOrigin::File, vec![IncomingBlock:: { hash, header: Some(header), body: Some(extrinsics), indexed_body: None, justifications: signed_block.justifications, origin: None, allow_missing_state: false, import_existing: force, state: None, skip_execution: false, }], ); } /// Returns true if we have imported every block we were supposed to import, else returns false. fn importing_is_done( num_expected_blocks: Option, read_block_count: u64, imported_blocks: u64, ) -> bool { if let Some(num_expected_blocks) = num_expected_blocks { imported_blocks >= num_expected_blocks } else { imported_blocks >= read_block_count } } /// Structure used to log the block importing speed. struct Speedometer { best_number: NumberFor, last_number: Option>, last_update: Instant, } impl Speedometer { /// Creates a fresh Speedometer. fn new() -> Self { Self { best_number: NumberFor::::from(0u32), last_number: None, last_update: Instant::now(), } } /// Calculates `(best_number - last_number) / (now - last_update)` and /// logs the speed of import. fn display_speed(&self) { // Number of milliseconds elapsed since last time. let elapsed_ms = { let elapsed = self.last_update.elapsed(); let since_last_millis = elapsed.as_secs() * 1000; let since_last_subsec_millis = elapsed.subsec_millis() as u64; since_last_millis + since_last_subsec_millis }; // Number of blocks that have been imported since last time. let diff = match self.last_number { None => return, Some(n) => self.best_number.saturating_sub(n), }; if let Ok(diff) = TryInto::::try_into(diff) { // If the number of blocks can be converted to a regular integer, then it's easy: just // do the math and turn it into a `f64`. let speed = diff .saturating_mul(10_000) .checked_div(u128::from(elapsed_ms)) .map_or(0.0, |s| s as f64) / 10.0; info!("📦 Current best block: {} ({:4.1} bps)", self.best_number, speed); } else { // If the number of blocks can't be converted to a regular integer, then we need a more // algebraic approach and we stay within the realm of integers. let one_thousand = NumberFor::::from(1_000u32); let elapsed = NumberFor::::from(>::try_from(elapsed_ms).unwrap_or(u32::MAX)); let speed = diff .saturating_mul(one_thousand) .checked_div(&elapsed) .unwrap_or_else(Zero::zero); info!("📦 Current best block: {} ({} bps)", self.best_number, speed) } } /// Updates the Speedometer. fn update(&mut self, best_number: NumberFor) { self.last_number = Some(self.best_number); self.best_number = best_number; self.last_update = Instant::now(); } // If more than TIME_BETWEEN_UPDATES has elapsed since last update, // then print and update the speedometer. fn notify_user(&mut self, best_number: NumberFor) { let delta = Duration::from_millis(TIME_BETWEEN_UPDATES); if Instant::now().duration_since(self.last_update) >= delta { self.display_speed(); self.update(best_number); } } } /// Different State that the `import_blocks` future could be in. enum ImportState where R: Read + 'static, B: BlockT + MaybeSerializeDeserialize, { /// We are reading from the [`BlockIter`] structure, adding those blocks to the queue if /// possible. Reading { block_iter: BlockIter }, /// The queue is full (contains at least MAX_PENDING_BLOCKS blocks) and we are waiting for it /// to catch up. WaitingForImportQueueToCatchUp { block_iter: BlockIter, delay: Delay, block: SignedBlock, }, // We have added all the blocks to the queue but they are still being processed. WaitingForImportQueueToFinish { num_expected_blocks: Option, read_block_count: u64, delay: Delay, }, } /// Starts the process of importing blocks. pub fn import_blocks( client: Arc, mut import_queue: IQ, input: impl Read + Send + 'static, force: bool, binary: bool, ) -> Pin> + Send>> where C: HeaderBackend + Send + Sync + 'static, B: BlockT + for<'de> serde::Deserialize<'de>, IQ: ImportQueue + 'static, { struct WaitLink { imported_blocks: AtomicU64, has_error: AtomicBool, } impl WaitLink { fn new() -> WaitLink { WaitLink { imported_blocks: AtomicU64::new(0), has_error: AtomicBool::new(false) } } } impl Link for WaitLink { fn blocks_processed( &self, imported: usize, _num_expected_blocks: usize, results: Vec<(Result>, BlockImportError>, B::Hash)>, ) { self.imported_blocks.fetch_add(imported as u64, Ordering::AcqRel); for result in results { if let (Err(err), hash) = result { warn!("There was an error importing block with hash {:?}: {}", hash, err); self.has_error.store(true, Ordering::Release); break; } } } } let mut link = WaitLink::new(); let block_iter_res: Result, String> = BlockIter::new(input, binary); let block_iter = match block_iter_res { Ok(block_iter) => block_iter, Err(e) => { // We've encountered an error while creating the block iterator // so we can just return a future that returns an error. return future::ready(Err(Error::Other(e))).boxed(); }, }; let mut state = Some(ImportState::Reading { block_iter }); let mut speedometer = Speedometer::::new(); // Importing blocks is implemented as a future, because we want the operation to be // interruptible. // // Every time we read a block from the input or import a bunch of blocks from the import // queue, the `Future` re-schedules itself and returns `Poll::Pending`. // This makes it possible either to interleave other operations in-between the block imports, // or to stop the operation completely. let import = future::poll_fn(move |cx| { let client = &client; let queue = &mut import_queue; match state.take().expect("state should never be None; qed") { ImportState::Reading { mut block_iter } => { match block_iter.next() { None => { // The iterator is over: we now need to wait for the import queue to finish. let num_expected_blocks = block_iter.num_expected_blocks(); let read_block_count = block_iter.read_block_count(); let delay = Delay::new(Duration::from_millis(DELAY_TIME)); state = Some(ImportState::WaitingForImportQueueToFinish { num_expected_blocks, read_block_count, delay, }); }, Some(block_result) => { let read_block_count = block_iter.read_block_count(); match block_result { Ok(block) => { if read_block_count - link.imported_blocks.load(Ordering::Acquire) >= MAX_PENDING_BLOCKS { // The queue is full, so do not add this block and simply wait // until the queue has made some progress. let delay = Delay::new(Duration::from_millis(DELAY_TIME)); state = Some(ImportState::WaitingForImportQueueToCatchUp { block_iter, delay, block, }); } else { // Queue is not full, we can keep on adding blocks to the queue. import_block_to_queue(block, queue, force); state = Some(ImportState::Reading { block_iter }); } }, Err(e) => return Poll::Ready(Err(Error::Other(format!( "Error reading block #{}: {}", read_block_count, e )))), } }, } }, ImportState::WaitingForImportQueueToCatchUp { block_iter, mut delay, block } => { let read_block_count = block_iter.read_block_count(); if read_block_count - link.imported_blocks.load(Ordering::Acquire) >= MAX_PENDING_BLOCKS { // Queue is still full, so wait until there is room to insert our block. match Pin::new(&mut delay).poll(cx) { Poll::Pending => { state = Some(ImportState::WaitingForImportQueueToCatchUp { block_iter, delay, block, }); return Poll::Pending; }, Poll::Ready(_) => { delay.reset(Duration::from_millis(DELAY_TIME)); }, } state = Some(ImportState::WaitingForImportQueueToCatchUp { block_iter, delay, block, }); } else { // Queue is no longer full, so we can add our block to the queue. import_block_to_queue(block, queue, force); // Switch back to Reading state. state = Some(ImportState::Reading { block_iter }); } }, ImportState::WaitingForImportQueueToFinish { num_expected_blocks, read_block_count, mut delay, } => { // All the blocks have been added to the queue, which doesn't mean they // have all been properly imported. if importing_is_done( num_expected_blocks, read_block_count, link.imported_blocks.load(Ordering::Acquire), ) { // Importing is done, we can log the result and return. info!( "🎉 Imported {} blocks. Best: #{}", read_block_count, client.info().best_number ); return Poll::Ready(Ok(())); } else { // Importing is not done, we still have to wait for the queue to finish. // Wait for the delay, because we know the queue is lagging behind. match Pin::new(&mut delay).poll(cx) { Poll::Pending => { state = Some(ImportState::WaitingForImportQueueToFinish { num_expected_blocks, read_block_count, delay, }); return Poll::Pending; }, Poll::Ready(_) => { delay.reset(Duration::from_millis(DELAY_TIME)); }, } state = Some(ImportState::WaitingForImportQueueToFinish { num_expected_blocks, read_block_count, delay, }); } }, } queue.poll_actions(cx, &mut link); let best_number = client.info().best_number; speedometer.notify_user(best_number); if link.has_error.load(Ordering::Acquire) { return Poll::Ready(Err(Error::Other(format!( "Stopping after #{} blocks because of an error", link.imported_blocks.load(Ordering::Acquire) )))); } cx.waker().wake_by_ref(); Poll::Pending }); Box::pin(import) }