Struct sc_client_db::light::LightStorage

source · [−]

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

Expand description

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

Implementations

source

impl<Block: BlockT> LightStorage<Block>

source

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

Create new storage with given settings.

Trait Implementations

source

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

source

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

source

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

Query auxiliary data from key-value store.

source

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

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

source

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

Get blockchain info.

source

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

Get block status.

source

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.

source

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.

source

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.

source

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.

source

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

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

source

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.

source

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.

source

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

type Error = ClientError

Error used in case the header metadata is not found.

source

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

source

fn insert_header_metadata(
 &self,
 hash: Block::Hash,
 metadata: CachedHeaderMetadata<Block>
)

source

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

source

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

source

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.

source

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.

source

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

source

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

source

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

Set an existing block as new best block.

source

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

Mark historic header as finalized.

source

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

Get last finalized header.

source

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

Get storage cache.

source

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

Get storage usage statistics.

Auto Trait Implementations

impl<Block> !RefUnwindSafe for LightStorage<Block>

impl<Block> Send for LightStorage<Block>

impl<Block> Sync for LightStorage<Block>

impl<Block> Unpin for LightStorage<Block> where
<Block as Block>::Hash: Unpin,
<<Block as Block>::Header as Header>::Number: Unpin,

impl<Block> !UnwindSafe for LightStorage<Block>

Blanket Implementations

source

impl<T> Any for T where
T: 'static + ?Sized,

source

pub fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more

source

impl<T> Borrow<T> for T where
T: ?Sized,

const: unstable · source

pub fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more

source

impl<T> BorrowMut<T> for T where
T: ?Sized,

const: unstable · source

pub fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more

source

impl<T> CheckedConversion for T

source

fn checked_from<T>(t: T) -> Option<Self> where
Self: TryFrom<T>,

Convert from a value of T into an equivalent instance of Option<Self>. Read more

source

fn checked_into<T>(self) -> Option<T> where
Self: TryInto<T>,

Consume self to return Some equivalent value of Option<T>. Read more

source

impl<T> From<T> for T

const: unstable · source

pub fn from(t: T) -> T

Returns the argument unchanged.

source

impl<T> Instrument for T

source

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more

source

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more

source

impl<T> Instrument for T

source

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more

source

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more

source

impl<T, U> Into for T where
U: From<T>,

const: unstable · source

pub fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

source

impl<T, Outer> IsWrappedBy<Outer> for T where
Outer: AsRef<T> + AsMut<T> + From<T>,
T: From<Outer>,

source

pub fn from_ref(outer: &Outer) -> &T

Get a reference to the inner from the outer.

source

pub fn from_mut(outer: &mut Outer) -> &mut T

Get a mutable reference to the inner from the outer.

source

impl<T> Pointable for T

source

pub const ALIGN: usize

The alignment of pointer.

type Init = T

The type for initializers.

source

pub unsafe fn init(init: <T as Pointable>::Init) -> usize

Initializes a with the given initializer. Read more

source

pub unsafe fn deref<'a>(ptr: usize) -> &'a T

Dereferences the given pointer. Read more

source

pub unsafe fn deref_mut<'a>(ptr: usize) -> &'a mut T

Mutably dereferences the given pointer. Read more

source

pub unsafe fn drop(ptr: usize)

Drops the object pointed to by the given pointer. Read more

source

impl<T> Same<T> for T

type Output = T

Should always be Self

source

impl<T> SaturatedConversion for T

source

fn saturated_from<T>(t: T) -> Self where
Self: UniqueSaturatedFrom<T>,

Convert from a value of T into an equivalent instance of Self. Read more

source

fn saturated_into<T>(self) -> T where
Self: UniqueSaturatedInto<T>,

Consume self to return an equivalent value of T. Read more

source

impl<T, U> TryFrom for T where
U: Into<T>,

type Error = Infallible

The type returned in the event of a conversion error.

const: unstable · source

pub fn try_from(value: U) -> Result<T, <T as TryFrom>::Error>

Performs the conversion.

source

impl<T, U> TryInto for T where
U: TryFrom<T>,

type Error = >::Error

The type returned in the event of a conversion error.

const: unstable · source

pub fn try_into(self) -> Result<U, >::Error>

Performs the conversion.

source

impl<S, T> UncheckedInto<T> for S where
T: UncheckedFrom<S>,

source

pub fn unchecked_into(self) -> T

The counterpart to unchecked_from.

source

impl<T, S> UniqueSaturatedInto<T> for S where
T: Bounded,
S: TryInto<T>,

source

pub fn unique_saturated_into(self) -> T

Consume self to return an equivalent value of T.

source

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self> where
S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more

source

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more

source

Struct sc_client_db::light::LightStorage

Implementations

impl<Block: BlockT> LightStorage<Block>

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

type Error = ClientError

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

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

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

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

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

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

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

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

Auto Trait Implementations

impl<Block> !RefUnwindSafe for LightStorage<Block>

impl<Block> Send for LightStorage<Block>

impl<Block> Sync for LightStorage<Block>

impl<Block> Unpin for LightStorage<Block> where <Block as Block>::Hash: Unpin, <<Block as Block>::Header as Header>::Number: Unpin,

impl<Block> !UnwindSafe for LightStorage<Block>

Blanket Implementations

impl<T> Any for T where T: 'static + ?Sized,

pub fn type_id(&self) -> TypeId

impl<T> Borrow<T> for T where T: ?Sized,

pub fn borrow(&self) -> &T

impl<T> BorrowMut<T> for T where T: ?Sized,

pub fn borrow_mut(&mut self) -> &mut T

impl<T> CheckedConversion for T

fn checked_from<T>(t: T) -> Option<Self> where Self: TryFrom<T>,

fn checked_into<T>(self) -> Option<T> where Self: TryInto<T>,

impl<T> From<T> for T

pub fn from(t: T) -> T

impl<T> Instrument for T

fn instrument(self, span: Span) -> Instrumented<Self>

fn in_current_span(self) -> Instrumented<Self>

impl<T> Instrument for T

fn instrument(self, span: Span) -> Instrumented<Self>

fn in_current_span(self) -> Instrumented<Self>

impl<T, U> Into<U> for T where U: From<T>,

pub fn into(self) -> U

impl<T, Outer> IsWrappedBy<Outer> for T where Outer: AsRef<T> + AsMut<T> + From<T>, T: From<Outer>,

pub fn from_ref(outer: &Outer) -> &T

pub fn from_mut(outer: &mut Outer) -> &mut T

impl<T> Pointable for T

pub const ALIGN: usize

type Init = T

pub unsafe fn init(init: <T as Pointable>::Init) -> usize

pub unsafe fn deref<'a>(ptr: usize) -> &'a T

pub unsafe fn deref_mut<'a>(ptr: usize) -> &'a mut T

pub unsafe fn drop(ptr: usize)

impl<T> Same<T> for T

type Output = T

impl<T> SaturatedConversion for T

fn saturated_from<T>(t: T) -> Self where Self: UniqueSaturatedFrom<T>,

fn saturated_into<T>(self) -> T where Self: UniqueSaturatedInto<T>,

impl<T, U> TryFrom<U> for T where U: Into<T>,

type Error = Infallible

pub fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

impl<T, U> TryInto<U> for T where U: TryFrom<T>,

type Error = <U as TryFrom<T>>::Error

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

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

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

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

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

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

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

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

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

fn insert_header_metadata(
&self,
hash: Block::Hash,
metadata: CachedHeaderMetadata<Block>
)

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

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

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

impl<Block> Unpin for LightStorage<Block> where
<Block as Block>::Hash: Unpin,
<<Block as Block>::Header as Header>::Number: Unpin,

impl<T> Any for T where
T: 'static + ?Sized,

impl<T> Borrow<T> for T where
T: ?Sized,

impl<T> BorrowMut<T> for T where
T: ?Sized,

fn checked_from<T>(t: T) -> Option<Self> where
Self: TryFrom<T>,

fn checked_into<T>(self) -> Option<T> where
Self: TryInto<T>,

impl<T, U> Into<U> for T where
U: From<T>,

impl<T, Outer> IsWrappedBy<Outer> for T where
Outer: AsRef<T> + AsMut<T> + From<T>,
T: From<Outer>,

fn saturated_from<T>(t: T) -> Self where
Self: UniqueSaturatedFrom<T>,

fn saturated_into<T>(self) -> T where
Self: UniqueSaturatedInto<T>,

impl<T, U> TryFrom<U> for T where
U: Into<T>,

impl<T, U> TryInto<U> for T where
U: TryFrom<T>,

impl<S, T> UncheckedInto<T> for S where
T: UncheckedFrom<S>,

impl<T, S> UniqueSaturatedInto<T> for S where
T: Bounded,
S: TryInto<T>,

impl<V, T> VZip<V> for T where
V: MultiLane<T>,

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self> where
S: Into<Dispatch>,