Enum exonum::blockchain::CallInBlock

#[non_exhaustive]pub enum CallInBlock {
    BeforeTransactions {
        id: InstanceId,
    },
    Transaction {
        index: u32,
    },
    AfterTransactions {
        id: InstanceId,
    },
}

Location of an isolated call within a block.

Exonum isolates execution of the transactions included into the the block, and before_transactions / after_transactions hooks that are executed for each active service. If an isolated call ends with an error, all changes to the blockchain state made within a call are rolled back.

CallInBlock objects are ordered in the same way the corresponding calls would be performed within a block:

assert!(CallInBlock::before_transactions(3) < CallInBlock::transaction(0));
assert!(CallInBlock::transaction(0) < CallInBlock::transaction(1));
assert!(CallInBlock::transaction(1) < CallInBlock::after_transactions(0));
assert!(CallInBlock::after_transactions(0) < CallInBlock::after_transactions(1));

See also

Not to be confused with CallSite, which provides information about a call in which an error may occur. Since Exonum services may call each other's methods, CallSite is richer than CallInBlock.

One example of difference between these types is CallType::Constructor: since services are constructed outside of the block processing routine, this kind of errors cannot be represented as CallInBlock.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

BeforeTransactions

Call of before_transactions hook in a service.

Fields of BeforeTransactions

id: InstanceId

Numerical service identifier.

Transaction

Call of a transaction within the block.

Fields of Transaction

index: u32

Zero-based transaction index.

AfterTransactions

Call of after_transactions hook in a service.

Fields of AfterTransactions

id: InstanceId

Numerical service identifier.

Methods

impl CallInBlock

pub fn before_transactions(id: InstanceId) -> Self

Creates a location corresponding to a before_transactions call.

pub fn transaction(index: u32) -> Self

Creates a location corresponding to a transaction.

pub fn after_transactions(id: InstanceId) -> Self

Creates a location corresponding to a after_transactions call.

Trait Implementations

impl BinaryKey for CallInBlock

fn size(&self) -> usize

Returns the size of the serialized key in bytes.

fn write(&self, buffer: &mut [u8]) -> usize

Serializes the key into the specified buffer of bytes.

fn read(buffer: &[u8]) -> Self::Owned

Deserializes the key from the specified buffer of bytes.

impl BinaryValue for CallInBlock

fn to_bytes(&self) -> Vec<u8>

Serializes the given value to the vector of bytes.

fn from_bytes(value: Cow<[u8]>) -> Result<Self, Error>

Deserializes the value from the given bytes array.

fn into_bytes(self) -> Vec<u8>

Consumes and serializes the given value to the vector of bytes. This method is faster with the wrapped values, thus if you wouldn't use value after serialization use it.

impl Clone for CallInBlock

fn clone(&self) -> CallInBlock

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Copy for CallInBlock

impl Debug for CallInBlock

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for CallInBlock

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error> where
    __D: Deserializer<'de>, 

Deserialize this value from the given Serde deserializer.

impl Display for CallInBlock

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

Formats the value using the given formatter.

impl Eq for CallInBlock

impl Hash for CallInBlock

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given [Hasher].

fn hash_slice<H>(data: &[Self], state: &mut H) where
    H: Hasher, 

Feeds a slice of this type into the given [Hasher].

impl ObjectHash for CallInBlock

fn object_hash(&self) -> Hash

Returns a hash of the value.

impl Ord for CallInBlock

fn cmp(&self, other: &CallInBlock) -> Ordering

This method returns an [Ordering] between self and other.

#[must_use]fn max(self, other: Self) -> Self

Compares and returns the maximum of two values.

#[must_use]fn min(self, other: Self) -> Self

Compares and returns the minimum of two values.

#[must_use]fn clamp(self, min: Self, max: Self) -> Self

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

Restrict a value to a certain interval.

impl PartialEq<CallInBlock> for CallInBlock

fn eq(&self, other: &CallInBlock) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &CallInBlock) -> bool

This method tests for !=.

impl PartialOrd<CallInBlock> for CallInBlock

fn partial_cmp(&self, other: &CallInBlock) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, other: &CallInBlock) -> bool

This method tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &CallInBlock) -> bool

This method tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &CallInBlock) -> bool

This method tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &CallInBlock) -> bool

This method tests greater than or equal to (for self and other) and is used by the >= operator.

impl ProtobufConvert for CallInBlock

type ProtoStruct = CallInBlock

Type generated from the Protobuf definition.

fn to_pb(&self) -> Self::ProtoStruct

Performs conversion to the type generated from Protobuf.

fn from_pb(pb: Self::ProtoStruct) -> Result<Self>

Performs conversion from the type generated from Protobuf.

impl Serialize for CallInBlock

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error> where
    __S: Serializer, 

Serialize this value into the given Serde serializer.

impl StructuralEq for CallInBlock

impl StructuralPartialEq for CallInBlock