Struct sc_light::blockchain::Blockchain

source · [−]

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

Expand description

Light client blockchain.

Implementations

source

impl<S> Blockchain<S>

source

pub fn new(storage: S) -> Self

Create new light blockchain backed with given storage.

source

pub fn storage(&self) -> &S

Get storage reference.

Trait Implementations

source

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

source

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

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

source

fn justification(
&self,
_id: BlockId<Block>
) -> ClientResult<Option<Justification>>

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

source

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

Get last finalized block hash.

source

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

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

source

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

source

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.

source

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

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

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

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

source

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

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

source

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

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

source

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

Get block header.

Auto Trait Implementations

impl<S> RefUnwindSafe for Blockchain<S> where
S: RefUnwindSafe,

impl<S> Send for Blockchain<S> where
S: Send,

impl<S> Sync for Blockchain<S> where
S: Sync,

impl<S> Unpin for Blockchain<S> where
S: Unpin,

impl<S> UnwindSafe for Blockchain<S> where
S: UnwindSafe,

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_light::blockchain::Blockchain

Implementations

impl<S> Blockchain<S>

pub fn new(storage: S) -> Self

pub fn storage(&self) -> &S

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

fn justification( &self, _id: BlockId<Block>) -> ClientResult<Option<Justification>>

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

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

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

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

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

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: <<Block as BlockT>::Header as HeaderT>::Number) -> 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<S, Block> HeaderMetadata<Block> for Blockchain<S> where Block: BlockT, S: Storage<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<S: Storage<Block>, Block: BlockT> ProvideCache<Block> for Blockchain<S>

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

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

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

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

Auto Trait Implementations

impl<S> RefUnwindSafe for Blockchain<S> where S: RefUnwindSafe,

impl<S> Send for Blockchain<S> where S: Send,

impl<S> Sync for Blockchain<S> where S: Sync,

impl<S> Unpin for Blockchain<S> where S: Unpin,

impl<S> UnwindSafe for Blockchain<S> where S: UnwindSafe,

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

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

fn justification(
&self,
_id: BlockId<Block>
) -> ClientResult<Option<Justification>>

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

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

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

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

impl<S> RefUnwindSafe for Blockchain<S> where
S: RefUnwindSafe,

impl<S> Send for Blockchain<S> where
S: Send,

impl<S> Sync for Blockchain<S> where
S: Sync,

impl<S> Unpin for Blockchain<S> where
S: Unpin,

impl<S> UnwindSafe for Blockchain<S> where
S: UnwindSafe,

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

impl<T> MaybeRefUnwindSafe for T where
T: RefUnwindSafe,