Struct exonum::runtime::ExecutionError

pub struct ExecutionError { /* fields omitted */ }

Result of unsuccessful runtime execution.

An execution error consists of:

• an error kind
• call information (runtime ID and, if appropriate, CallSite where the error has occurred)
• an optional description

Call information is added by the core automatically; it is impossible to add from the service code. It is possible to inspect the call info for an error that was returned by a service though.

The error kind and call info affect the blockchain state hash, while the description does not. Therefore descriptions are mostly used for developer purposes, not for interaction with users.

Methods

impl ExecutionError

pub fn service(code: u8, description: impl Into<String>) -> Self

Creates an execution error for use in service code.

pub fn to_match(&self) -> ErrorMatch

Converts an error to a matcher. The matcher expect the exact kind and description of this error, and does not check any other error fields.

pub fn kind(&self) -> ErrorKind

The kind of error that indicates in which module and with which code the error occurred.

pub fn description(&self) -> &str

Human-readable error description. May be empty.

pub fn runtime_id(&self) -> Option<u32>

Returns the ID of a runtime in which this error has occurred. If the runtime is not known (e.g., the error originates in the core code), returns None.

pub fn call_site(&self) -> Option<&CallSite>

Returns the call site of the error.

Trait Implementations

impl BinaryValue for ExecutionError

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 ExecutionError

fn clone(&self) -> ExecutionError

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for ExecutionError

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ExecutionError

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

Deserialize this value from the given Serde deserializer.

impl Display for ExecutionError

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

Formats the value using the given formatter.

impl Error for ExecutionError

fn source(&self) -> Option<&(dyn Error + 'static)>

The lower-level source of this error, if any.

fn backtrace(&self) -> Option<&Backtrace>

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

Returns a stack backtrace, if available, of where this error occurred.

fn description(&self) -> &str

Deprecated since 1.42.0:

use the Display impl or to_string()

if let Err(e) = "xc".parse::<u32>() { // Print e itself, no need for description(). eprintln!("Error: {}", e); }

fn cause(&self) -> Option<&dyn Error>

Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

impl From<ArtifactReqError> for ExecutionError

fn from(err: ArtifactReqError) -> Self

Performs the conversion.

impl From<CommonError> for ExecutionError

fn from(inner: CommonError) -> Self

Performs the conversion.

impl From<CoreError> for ExecutionError

fn from(inner: CoreError) -> Self

Performs the conversion.

impl From<InitMigrationError> for ExecutionError

fn from(err: InitMigrationError) -> Self

Performs the conversion.

impl PartialEq<ErrorMatch> for ExecutionError

fn eq(&self, error_match: &ErrorMatch) -> bool

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

#[must_use]fn ne(&self, other: &Rhs) -> bool

This method tests for !=.

impl PartialEq<ExecutionError> for ErrorMatch

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

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

#[must_use]fn ne(&self, other: &Rhs) -> bool

This method tests for !=.

impl ProtobufConvert for ExecutionError

type ProtoStruct = ExecutionError

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 ExecutionError

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

Serialize this value into the given Serde serializer.