Struct sc_client_db::light::LightStorage

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

Light blockchain storage. Stores most recent headers + CHTs for older headers. Locks order: meta, cache.

Implementations

impl<Block: BlockT> LightStorage<Block>

pub fn new(config: DatabaseSettings) -> ClientResult<Self>

Create new storage with given settings.

pub fn new_test() -> Self

Create new memory-backed LightStorage for tests.

Trait Implementations

impl<Block> AuxStore for LightStorage<Block> where
    Block: BlockT, 

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
) -> ClientResult<()>

Insert auxiliary data into key-value store.

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

Query auxiliary data from key-value store.

impl<Block> HeaderBackend<Block> for LightStorage<Block> where
    Block: BlockT, 

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: NumberFor<Block>) -> 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<Block: BlockT> HeaderMetadata<Block> for LightStorage<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<Block> ProvideChtRoots<Block> for LightStorage<Block> where
    Block: BlockT, 

fn header_cht_root(
    &self,
    cht_size: NumberFor<Block>,
    block: NumberFor<Block>
) -> ClientResult<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>
) -> ClientResult<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> Storage<Block> for LightStorage<Block> where
    Block: BlockT, 

fn import_header(
    &self,
    header: Block::Header,
    cache_at: HashMap<Id, Vec<u8>>,
    leaf_state: NewBlockState,
    aux_ops: Vec<(Vec<u8>, Option<Vec<u8>>)>
) -> ClientResult<()>

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

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

Set an existing block as new best block.

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

Mark historic header as finalized.

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

Get last finalized header.

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

Get storage cache.

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

Get storage usage statistics.