Struct sc_client_api::in_mem::Blockchain

source · [−]

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

Expand description

In-memory blockchain. Supports concurrent reads.

Implementations

source

impl<Block: BlockT> Blockchain<Block>

source

pub fn id(&self, id: BlockId<Block>) -> Option<Block::Hash>

Get header hash of given block.

source

pub fn new() -> Blockchain<Block>

Create new in-memory blockchain storage.

source

pub fn insert(
 &self,
 hash: Block::Hash,
 header: <Block as BlockT>::Header,
 justification: Option<Justification>,
 body: Option<Vec<<Block as BlockT>::Extrinsic>>,
 new_state: NewBlockState
) -> Result<()>

Insert a block header and associated data.

source

pub fn blocks_count(&self) -> usize

Get total number of blocks.

source

pub fn equals_to(&self, other: &Self) -> bool

Compare this blockchain with another in-mem blockchain

source

pub fn canon_equals_to(&self, other: &Self) -> bool

Compare canonical chain to other canonical chain.

source

pub fn insert_cht_root(&self, block: NumberFor<Block>, cht_root: Block::Hash)

Insert header CHT root.

source

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

Set an existing block as head.

Trait Implementations

source

impl<Block: BlockT> AuxStore for Blockchain<Block>

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

Insert auxiliary data into key-value store. Read more

source

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

Query auxiliary data from key-value store.

source

impl<Block: BlockT> Backend<Block> for Blockchain<Block>

source

fn body(
&self,
id: BlockId<Block>
) -> Result<Option<Vec<<Block as BlockT>::Extrinsic>>>

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

source

fn justification(&self, id: BlockId<Block>) -> Result<Option<Justification>>

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

source

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

Get last finalized block hash.

source

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

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

source

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

source

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.

source

fn extrinsic(
&self,
_hash: &Block::Hash
) -> Result<Option<<Block as BlockT>::Extrinsic>>

Get single extrinsic by hash.

source

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

source

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

Check if extrinsic exists.

source

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

source

fn clone(&self) -> Self

Returns a copy of the value. Read more

1.0.0 · source

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source. Read more

source

impl<Block: BlockT> Default for Blockchain<Block>

source

fn default() -> Self

Returns the “default value” for a type. Read more

source

impl<Block: BlockT> HeaderBackend<Block> for Blockchain<Block>

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

source

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

Get blockchain info.

source

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

Get block status.

source

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.

source

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.

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

type Error = Error

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

source

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

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

source

impl<Block: BlockT> ProvideChtRoots<Block> for Blockchain<Block>

source

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.

source

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.

source

impl<Block: BlockT> Storage<Block> for Blockchain<Block> where
Block::Hash: From<[u8 ; 32]>,

source

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

source

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

Set an existing block as new best block.

source

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

Get last finalized header.

source

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

Mark historic header as finalized.

source

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

Get storage cache.

source

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

Get storage usage statistics.

Auto Trait Implementations

impl<Block> !RefUnwindSafe for Blockchain<Block>

impl<Block> Send for Blockchain<Block>

impl<Block> Sync for Blockchain<Block>

impl<Block> Unpin for Blockchain<Block>

impl<Block> !UnwindSafe for Blockchain<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

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> ToOwned for T where
T: Clone,

type Owned = T

The resulting type after obtaining ownership.

source

pub fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more

source

pub fn clone_into(&self, target: &mut T)

🔬 This is a nightly-only experimental API. (toowned_clone_into)

Uses borrowed data to replace owned data, usually by cloning. 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

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

source

pub fn vzip(self) -> V

source

impl<T> WithSubscriber for 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

Struct sc_client_api::in_mem::Blockchain

Implementations

impl<Block: BlockT> Blockchain<Block>

pub fn id(&self, id: BlockId<Block>) -> Option<Block::Hash>

pub fn new() -> Blockchain<Block>

pub fn insert( &self, hash: Block::Hash, header: <Block as BlockT>::Header, justification: Option<Justification>, body: Option<Vec<<Block as BlockT>::Extrinsic>>, new_state: NewBlockState) -> Result<()>

pub fn blocks_count(&self) -> usize

pub fn equals_to(&self, other: &Self) -> bool

pub fn canon_equals_to(&self, other: &Self) -> bool

pub fn insert_cht_root(&self, block: NumberFor<Block>, cht_root: Block::Hash)

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

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

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

impl<Block: BlockT> Backend<Block> for Blockchain<Block>

fn body( &self, id: BlockId<Block>) -> Result<Option<Vec<<Block as BlockT>::Extrinsic>>>

fn justification(&self, id: BlockId<Block>) -> Result<Option<Justification>>

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

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

fn leaves(&self) -> Result<Vec<Block::Hash>>

fn children(&self, _parent_hash: Block::Hash) -> Result<Vec<Block::Hash>>

fn extrinsic( &self, _hash: &Block::Hash) -> Result<Option<<Block as BlockT>::Extrinsic>>

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>

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

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

fn clone(&self) -> Self

fn clone_from(&mut self, source: &Self)

impl<Block: BlockT> Default for Blockchain<Block>

fn default() -> Self

impl<Block: BlockT> HeaderBackend<Block> for Blockchain<Block>

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

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

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

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

fn hash( &self, number: <<Block as BlockT>::Header as HeaderT>::Number) -> Result<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 Blockchain<Block>

type Error = Error

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

impl<Block: BlockT> ProvideChtRoots<Block> for Blockchain<Block>

fn header_cht_root( &self, _cht_size: NumberFor<Block>, block: NumberFor<Block>) -> Result<Option<Block::Hash>>

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

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

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

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

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

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

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

Auto Trait Implementations

impl<Block> !RefUnwindSafe for Blockchain<Block>

impl<Block> Send for Blockchain<Block>

impl<Block> Sync for Blockchain<Block>

impl<Block> Unpin for Blockchain<Block>

impl<Block> !UnwindSafe for Blockchain<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> DynClone for T where T: Clone,

pub fn __clone_box(&self, Private) -> *mut ()

impl<T> From<T> for T

pub fn from(t: T) -> T

impl<T> Instrument for T

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

pub fn insert(
&self,
hash: Block::Hash,
header: <Block as BlockT>::Header,
justification: Option<Justification>,
body: Option<Vec<<Block as BlockT>::Extrinsic>>,
new_state: NewBlockState
) -> Result<()>

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

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

fn body(
&self,
id: BlockId<Block>
) -> Result<Option<Vec<<Block as BlockT>::Extrinsic>>>

fn extrinsic(
&self,
_hash: &Block::Hash
) -> Result<Option<<Block as BlockT>::Extrinsic>>

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>

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

fn hash(
&self,
number: <<Block as BlockT>::Header as HeaderT>::Number
) -> Result<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>

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

fn insert_header_metadata(
&self,
_hash: Block::Hash,
_metadata: CachedHeaderMetadata<Block>
)

fn header_cht_root(
&self,
_cht_size: NumberFor<Block>,
block: NumberFor<Block>
) -> Result<Option<Block::Hash>>

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

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

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> DynClone for T where
T: Clone,

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> ToOwned for T where
T: Clone,

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