Struct sc_client_api::in_mem::Blockchain

pub struct Blockchain<Block: BlockT> { /* fields omitted */ }

In-memory blockchain. Supports concurrent reads.

Implementations

impl<Block: BlockT> Blockchain<Block>

pub fn id(&self, id: BlockId<Block>) -> Option<Block::Hash>

Get header hash of given block.

pub fn new() -> Blockchain<Block>

Create new in-memory blockchain storage.

pub fn insert(
    &self,
    hash: Block::Hash,
    header: <Block as BlockT>::Header,
    justification: Option<Justification>,
    body: Option<Vec<<Block as BlockT>::Extrinsic>>,
    new_state: NewBlockState
) -> Result<()>

Insert a block header and associated data.

pub fn blocks_count(&self) -> usize

Get total number of blocks.

pub fn equals_to(&self, other: &Self) -> bool

Compare this blockchain with another in-mem blockchain

pub fn canon_equals_to(&self, other: &Self) -> bool

Compare canonical chain to other canonical chain.

pub fn insert_cht_root(&self, block: NumberFor<Block>, cht_root: Block::Hash)

Insert header CHT root.

pub fn set_head(&self, id: BlockId<Block>) -> Result<()>

Set an existing block as head.

Trait Implementations

impl<Block: BlockT> AuxStore for Blockchain<Block>

fn insert_aux<'a, 'b: 'a, 'c: 'a, I: IntoIterator<Item = &'a (&'c [u8], &'c [u8])>, D: IntoIterator<Item = &'a &'b [u8]>>(
    &self,
    insert: I,
    delete: D
) -> Result<()>

Insert auxiliary data into key-value store.

fn get_aux(&self, key: &[u8]) -> Result<Option<Vec<u8>>>

Query auxiliary data from key-value store.

impl<Block: BlockT> Backend<Block> for Blockchain<Block>

fn body(
    &self,
    id: BlockId<Block>
) -> Result<Option<Vec<<Block as BlockT>::Extrinsic>>>

Get block body. Returns None if block is not found.

fn justification(&self, id: BlockId<Block>) -> Result<Option<Justification>>

Get block justification. Returns None if justification does not exist.

fn last_finalized(&self) -> Result<Block::Hash>

Get last finalized block hash.

fn cache(&self) -> Option<Arc<dyn Cache<Block>>>

Returns data cache reference, if it is enabled on this backend.

fn leaves(&self) -> Result<Vec<Block::Hash>>

Returns hashes of all blocks that are leaves of the block tree. in other words, that have no children, are chain heads. Results must be ordered best (longest, highest) chain first.

fn children(&self, _parent_hash: Block::Hash) -> Result<Vec<Block::Hash>>

Return hashes of all blocks that are children of the block with parent_hash.

fn extrinsic(
    &self,
    _hash: &Block::Hash
) -> Result<Option<<Block as BlockT>::Extrinsic>>

Get single extrinsic by hash.

pub fn best_containing(
    &self,
    target_hash: <Block as Block>::Hash,
    maybe_max_number: Option<<<Block as Block>::Header as Header>::Number>,
    import_lock: &RwLock<RawRwLock, ()>
) -> Result<Option<<Block as Block>::Hash>, Error>

Get the most recent block hash of the best (longest) chains that contain block with the given target_hash.

pub fn have_extrinsic(
    &self,
    hash: &<Block as Block>::Hash
) -> Result<bool, Error>

Check if extrinsic exists.

impl<Block: BlockT + Clone> Clone for Blockchain<Block>

fn clone(&self) -> Self

Returns a copy of the value.

pub fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<Block: BlockT> Default for Blockchain<Block>

fn default() -> Self

Returns the “default value” for a type.

impl<Block: BlockT> HeaderBackend<Block> for Blockchain<Block>

fn header(
    &self,
    id: BlockId<Block>
) -> Result<Option<<Block as BlockT>::Header>>

Get block header. Returns None if block is not found.

fn info(&self) -> Info<Block>

Get blockchain info.

fn status(&self, id: BlockId<Block>) -> Result<BlockStatus>

Get block status.

fn number(&self, hash: Block::Hash) -> Result<Option<NumberFor<Block>>>

Get block number by hash. Returns None if the header is not in the chain.

fn hash(
    &self,
    number: <<Block as BlockT>::Header as HeaderT>::Number
) -> Result<Option<Block::Hash>>

Get block hash by number. Returns None if the header is not in the chain.

pub fn block_hash_from_id(
    &self,
    id: &BlockId<Block>
) -> Result<Option<<Block as Block>::Hash>, Error>

Convert an arbitrary block ID into a block hash.

pub fn block_number_from_id(
    &self,
    id: &BlockId<Block>
) -> Result<Option<<<Block as Block>::Header as Header>::Number>, Error>

Convert an arbitrary block ID into a block hash.

pub fn expect_header(
    &self,
    id: BlockId<Block>
) -> Result<<Block as Block>::Header, Error>

Get block header. Returns UnknownBlock error if block is not found.

pub fn expect_block_number_from_id(
    &self,
    id: &BlockId<Block>
) -> Result<<<Block as Block>::Header as Header>::Number, Error>

Convert an arbitrary block ID into a block number. Returns UnknownBlock error if block is not found.

pub fn expect_block_hash_from_id(
    &self,
    id: &BlockId<Block>
) -> Result<<Block as Block>::Hash, Error>

Convert an arbitrary block ID into a block hash. Returns UnknownBlock error if block is not found.

impl<Block: BlockT> HeaderMetadata<Block> for Blockchain<Block>

type Error = Error

Error used in case the header metadata is not found.

fn header_metadata(
    &self,
    hash: Block::Hash
) -> Result<CachedHeaderMetadata<Block>, Self::Error>

fn insert_header_metadata(
    &self,
    _hash: Block::Hash,
    _metadata: CachedHeaderMetadata<Block>
)

fn remove_header_metadata(&self, _hash: Block::Hash)

impl<Block: BlockT> ProvideCache<Block> for Blockchain<Block>

fn cache(&self) -> Option<Arc<dyn Cache<Block>>>

Returns data cache reference, if it is enabled on this backend.

impl<Block: BlockT> ProvideChtRoots<Block> for Blockchain<Block>

fn header_cht_root(
    &self,
    _cht_size: NumberFor<Block>,
    block: NumberFor<Block>
) -> Result<Option<Block::Hash>>

Get headers CHT root for given block. Returns None if the block is not a part of any CHT.

fn changes_trie_cht_root(
    &self,
    _cht_size: NumberFor<Block>,
    block: NumberFor<Block>
) -> Result<Option<Block::Hash>>

Get changes trie CHT root for given block. Returns None if the block is not a part of any CHT.

impl<Block: BlockT> Storage<Block> for Blockchain<Block> where
    Block::Hash: From<[u8; 32]>, 

fn import_header(
    &self,
    header: Block::Header,
    _cache: HashMap<CacheKeyId, Vec<u8>>,
    state: NewBlockState,
    aux_ops: Vec<(Vec<u8>, Option<Vec<u8>>)>
) -> Result<()>

Store new header. Should refuse to revert any finalized blocks.

fn set_head(&self, id: BlockId<Block>) -> Result<()>

Set an existing block as new best block.

fn last_finalized(&self) -> Result<Block::Hash>

Get last finalized header.

fn finalize_header(&self, id: BlockId<Block>) -> Result<()>

Mark historic header as finalized.

fn cache(&self) -> Option<Arc<dyn Cache<Block>>>

Get storage cache.

fn usage_info(&self) -> Option<UsageInfo>

Get storage usage statistics.