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,
    justifications: Option<Justifications>,
    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 justifications(&self, id: BlockId<Block>) -> Result<Option<Justifications>>

Get block justifications. Returns None if no justification exists.

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 indexed_transaction(&self, _hash: &Block::Hash) -> Result<Option<Vec<u8>>>

Get single indexed transaction by content hash. Note that this will only fetch transactions that are indexed by the runtime with storage_index_transaction.

fn block_indexed_body(
    &self,
    _id: BlockId<Block>
) -> Result<Option<Vec<Vec<u8>>>>

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.

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

Check if indexed transaction exists.

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

fn clone(&self) -> Self

Returns a copy of the value.

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.

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.

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.

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

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

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.

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.