f55974a64b
This is the equivalent of `keychain_tracker_example_cli` that works with the redesigned structures.
26 lines
828 B
Rust
26 lines
828 B
Rust
use crate::BlockId;
|
|
|
|
/// Represents a service that tracks the blockchain.
|
|
///
|
|
/// The main method is [`is_block_in_chain`] which determines whether a given block of [`BlockId`]
|
|
/// is an ancestor of another "static block".
|
|
///
|
|
/// [`is_block_in_chain`]: Self::is_block_in_chain
|
|
pub trait ChainOracle {
|
|
/// Error type.
|
|
type Error: core::fmt::Debug;
|
|
|
|
/// Determines whether `block` of [`BlockId`] exists as an ancestor of `chain_tip`.
|
|
///
|
|
/// If `None` is returned, it means the implementation cannot determine whether `block` exists
|
|
/// under `chain_tip`.
|
|
fn is_block_in_chain(
|
|
&self,
|
|
block: BlockId,
|
|
chain_tip: BlockId,
|
|
) -> Result<Option<bool>, Self::Error>;
|
|
|
|
/// Get the best chain's chain tip.
|
|
fn get_chain_tip(&self) -> Result<Option<BlockId>, Self::Error>;
|
|
}
|