Struct sc_light::blockchain::Blockchain

pub struct Blockchain<S> { /* fields omitted */ }

Light client blockchain.

Implementations

impl<S> Blockchain<S>

pub fn new(storage: S) -> Self

Create new light blockchain backed with given storage.

pub fn storage(&self) -> &S

Get storage reference.

Trait Implementations

impl<S, Block> Backend<Block> for Blockchain<S> where
    Block: BlockT,
    S: Storage<Block>, 

fn body(
    &self,
    _id: BlockId<Block>
) -> ClientResult<Option<Vec<Block::Extrinsic>>>

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

fn justifications(
    &self,
    _id: BlockId<Block>
) -> ClientResult<Option<Justifications>>

Get block justifications. Returns None if no justification exists.

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

Get last finalized block hash.

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

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

fn leaves(&self) -> ClientResult<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) -> ClientResult<Vec<Block::Hash>>

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

fn indexed_transaction(
    &self,
    _hash: &Block::Hash
) -> ClientResult<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<S, Block> HeaderBackend<Block> for Blockchain<S> where
    Block: BlockT,
    S: Storage<Block>, 

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

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

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

Get blockchain info.

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

Get block status.

fn number(&self, hash: Block::Hash) -> ClientResult<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
) -> ClientResult<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<S, Block> HeaderMetadata<Block> for Blockchain<S> where
    Block: BlockT,
    S: Storage<Block>, 

type Error = ClientError

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<S: Storage<Block>, Block: BlockT> ProvideCache<Block> for Blockchain<S>

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

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

impl<S: Storage<Block>, Block: BlockT> ProvideChtRoots<Block> for Blockchain<S>

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<S, Block: BlockT> RemoteBlockchain<Block> for Blockchain<S> where
    S: Storage<Block>, 

fn header(
    &self,
    id: BlockId<Block>
) -> ClientResult<LocalOrRemote<Block::Header, RemoteHeaderRequest<Block::Header>>>

Get block header.