mirror of
https://github.com/pezkuwichain/pezkuwi-subxt.git
synced 2026-05-01 00:47:55 +00:00
Benjamin Kampmann
927e13c13a
* Adding script for rename, could be applicable for nodes on top of it, too * add stderr and gitlab ci features * apply script * fix now minor details in expected stderr * Update the Cargo.lock * fix name: sc-transaction -> sc-tracing * fix rename in script, too
56 lines
2.4 KiB
Rust
56 lines
2.4 KiB
Rust
// Copyright 2019 Parity Technologies (UK) Ltd.
|
|
// This file is part of Substrate Consensus Common.
|
|
|
|
// Substrate Demo 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 Consensus Common 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 Consensus Common. If not, see <http://www.gnu.org/licenses/>.
|
|
|
|
use crate::error::Error;
|
|
use sp_runtime::traits::{Block as BlockT, NumberFor};
|
|
|
|
|
|
/// The SelectChain trait defines the strategy upon which the head is chosen
|
|
/// if multiple forks are present for an opaque definition of "best" in the
|
|
/// specific chain build.
|
|
///
|
|
/// The Strategy can be customised for the two use cases of authoring new blocks
|
|
/// upon the best chain or which fork to finalise. Unless implemented differently
|
|
/// by default finalisation methods fall back to use authoring, so as a minimum
|
|
/// `_authoring`-functions must be implemented.
|
|
///
|
|
/// Any particular user must make explicit, however, whether they intend to finalise
|
|
/// or author through the using the right function call, as these might differ in
|
|
/// some implementations.
|
|
///
|
|
/// Non-deterministicly finalising chains may only use the `_authoring` functions.
|
|
pub trait SelectChain<Block: BlockT>: Sync + Send + Clone {
|
|
|
|
/// Get all leaves of the chain: block hashes that have no children currently.
|
|
/// Leaves that can never be finalized will not be returned.
|
|
fn leaves(&self) -> Result<Vec<<Block as BlockT>::Hash>, Error>;
|
|
|
|
/// Among those `leaves` deterministically pick one chain as the generally
|
|
/// best chain to author new blocks upon and probably finalize.
|
|
fn best_chain(&self) -> Result<<Block as BlockT>::Header, Error>;
|
|
|
|
/// Get the best descendent of `target_hash` that we should attempt to
|
|
/// finalize next, if any. It is valid to return the given `target_hash`
|
|
/// itself if no better descendent exists.
|
|
fn finality_target(
|
|
&self,
|
|
target_hash: <Block as BlockT>::Hash,
|
|
_maybe_max_number: Option<NumberFor<Block>>
|
|
) -> Result<Option<<Block as BlockT>::Hash>, Error> {
|
|
Ok(Some(target_hash))
|
|
}
|
|
}
|