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 justification(
    &self,
    _id: BlockId<Block>
) -> ClientResult<Option<Justification>>

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

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 extrinsic(
    &self,
    _hash: &Block::Hash
) -> ClientResult<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<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.

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<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.