Struct exonum::blockchain::BlockchainMut

pub struct BlockchainMut { /* fields omitted */ }

Mutable blockchain capable of processing transactions.

BlockchainMut combines Blockchain resources with a service dispatcher. The resulting combination cannot be cloned (unlike Blockchain), but can be sent across threads. It is possible to extract a Blockchain reference from BlockchainMut via AsRef trait.

Methods

impl BlockchainMut

pub fn immutable_view(&self) -> Blockchain

Returns a copy of immutable blockchain view.

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

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

pub fn fork(&self) -> Fork

Creates a snapshot of the current storage state that can be later committed into the storage via the merge method.

pub fn merge(&mut self, patch: Patch) -> StorageResult<()>

Commits changes from the patch to the blockchain storage. See Fork for details.

pub fn create_patch(
    &self,
    proposer_id: ValidatorId,
    height: Height,
    tx_hashes: &[Hash],
    tx_cache: &mut BTreeMap<Hash, Verified<AnyTx>>
) -> (Hash, Patch)

Executes the given transactions from the pool. Then collects the resulting changes from the current storage state and returns them with the hash of the resulting block.

pub fn commit<I>(
    &mut self,
    patch: Patch,
    block_hash: Hash,
    precommits: I,
    tx_cache: &mut BTreeMap<Hash, Verified<AnyTx>>
) -> Result<(), Error> where
    I: IntoIterator<Item = Verified<Precommit>>, 

Commits to the blockchain a new block with the indicated changes (patch), hash and Precommit messages. After that invokes after_commit for each service in the increasing order of their identifiers.

pub fn check_tx(&self, 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.

pub fn shutdown(&mut self)

Shuts down the dispatcher. This should be the last operation performed on this instance.

pub fn remove_peer_with_pubkey(&mut self, key: &PublicKey)

Removes from the cache the Connect message from a peer.

Trait Implementations

impl AsRef<Blockchain> for BlockchainMut

fn as_ref(&self) -> &Blockchain

Performs the conversion.

impl Debug for BlockchainMut

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

Formats the value using the given formatter.