Struct exonum::blockchain::Blockchain

pub struct Blockchain { /* fields omitted */ }

Shared Exonum blockchain instance.

This is essentially a smart pointer to shared blockchain resources (storage, cryptographic keys, and a sender of transactions). It can be converted into a BlockchainMut instance, which combines these resources with behavior (i.e., a set of services).

Methods

impl Blockchain

pub fn new(
    database: impl Into<Arc<dyn Database>>,
    service_keypair: impl Into<KeyPair>,
    api_sender: ApiSender
) -> Self

Constructs a blockchain for the given database.

pub fn build_for_tests() -> Self

Creates a non-persisting blockchain, all data in which is irrevocably lost on drop.

The created blockchain cannot send transactions; an attempt to do so will result in an error.

pub fn snapshot(&self) -> Box<dyn Snapshot>

Creates a read-only snapshot of the current storage state.

pub fn last_hash(&self) -> Hash

Returns the hash of the latest committed block. If genesis block was not committed returns Hash::zero().

pub fn last_block(&self) -> Block

Returns the latest committed block.

pub fn sender(&self) -> &ApiSender

Returns reference to the transactions sender.

pub fn service_keypair(&self) -> &KeyPair

Returns reference to the service key pair of the current node.

pub fn check_tx(
    snapshot: &dyn Snapshot,
    tx: &Verified<AnyTx>
) -> Result<(), ExecutionError>

Performs several shallow checks that transaction is correct.

Returned Ok(()) value doesn't necessarily mean that transaction is correct and will be executed successfully, but returned Err(..) value means that this transaction is obviously incorrect and should be declined as early as possible.

Trait Implementations

impl AsRef<Blockchain> for BlockchainMut

fn as_ref(&self) -> &Blockchain

Performs the conversion.

impl Clone for Blockchain

fn clone(&self) -> Blockchain

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Blockchain

fn fmt(&self, f: &mut Formatter) -> Result

Formats the value using the given formatter.