Enum StdError

pub enum StdError {
    VerificationErr {
        source: VerificationError,
        backtrace: BT,
    },
    RecoverPubkeyErr {
        source: RecoverPubkeyError,
        backtrace: BT,
    },
    GenericErr {
        msg: String,
        backtrace: BT,
    },
    InvalidBase64 {
        msg: String,
        backtrace: BT,
    },
    InvalidDataSize {
        expected: u64,
        actual: u64,
        backtrace: BT,
    },
    InvalidHex {
        msg: String,
        backtrace: BT,
    },
    InvalidUtf8 {
        msg: String,
        backtrace: BT,
    },
    NotFound {
        kind: String,
        backtrace: BT,
    },
    ParseErr {
        target_type: String,
        msg: String,
        backtrace: BT,
    },
    SerializeErr {
        source_type: String,
        msg: String,
        backtrace: BT,
    },
    Overflow {
        source: OverflowError,
        backtrace: BT,
    },
    DivideByZero {
        source: DivideByZeroError,
        backtrace: BT,
    },
    ConversionOverflow {
        source: ConversionOverflowError,
        backtrace: BT,
    },
}

Structured error type for init, execute and query.

This can be serialized and passed over the Wasm/VM boundary, which allows us to use structured error types in e.g. integration tests. In that process backtraces are stripped off.

The prefix “Std” means “the standard error within the standard library”. This is not the only result/error type in cosmwasm-std.

When new cases are added, they should describe the problem rather than what was attempted (e.g. InvalidBase64 is preferred over Base64DecodingErr). In the long run this allows us to get rid of the duplication in “StdError::FooErr”.

Checklist for adding a new error:

• Add enum case
• Add creator function in std_error_helpers.rs

Variants

VerificationErr

Fields

source: VerificationError

backtrace: BT

RecoverPubkeyErr

Fields

source: RecoverPubkeyError

backtrace: BT

GenericErr

Whenever there is no specific error type available

Fields

msg: String

backtrace: BT

InvalidBase64

Fields

msg: String

backtrace: BT

InvalidDataSize

Fields

expected: u64

actual: u64

backtrace: BT

InvalidHex

Fields

msg: String

backtrace: BT

InvalidUtf8

Whenever UTF-8 bytes cannot be decoded into a unicode string, e.g. in String::from_utf8 or str::from_utf8.

Fields

msg: String

backtrace: BT

NotFound

Fields

kind: String

backtrace: BT

ParseErr

Fields

target_type: String

the target type that was attempted

msg: String

backtrace: BT

SerializeErr

Fields

source_type: String

the source type that was attempted

msg: String

backtrace: BT

Overflow

Fields

source: OverflowError

backtrace: BT

DivideByZero

Fields

source: DivideByZeroError

backtrace: BT

ConversionOverflow

Fields

source: ConversionOverflowError

backtrace: BT

Implementations

impl StdError

pub fn verification_err(source: VerificationError) -> Self

pub fn recover_pubkey_err(source: RecoverPubkeyError) -> Self

pub fn generic_err(msg: impl Into<String>) -> Self

pub fn invalid_base64(msg: impl ToString) -> Self

pub fn invalid_data_size(expected: usize, actual: usize) -> Self

pub fn invalid_hex(msg: impl ToString) -> Self

pub fn invalid_utf8(msg: impl ToString) -> Self

pub fn not_found(kind: impl Into<String>) -> Self

pub fn parse_err(target: impl Into<String>, msg: impl ToString) -> Self

pub fn serialize_err(source: impl Into<String>, msg: impl ToString) -> Self

pub fn overflow(source: OverflowError) -> Self

pub fn divide_by_zero(source: DivideByZeroError) -> Self

Trait Implementations

impl Debug for StdError

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

Formats the value using the given formatter.

impl Display for StdError

fn fmt(&self, __formatter: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Error for StdError

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

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0: use the Display impl or to_string()

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

👎Deprecated since 1.33.0: replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

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

Provides type-based access to context intended for error reports.

impl From<CoinFromStrError> for StdError

fn from(value: CoinFromStrError) -> Self

Converts to this type from the input type.

impl From<CoinsError> for StdError

fn from(value: CoinsError) -> Self

Converts to this type from the input type.

impl From<ConversionOverflowError> for StdError

fn from(err: ConversionOverflowError) -> Self

Converts to this type from the input type.

impl From<DivideByZeroError> for StdError

fn from(source: DivideByZeroError) -> Self

Converts to this type from the input type.

impl From<FromUtf8Error> for StdError

fn from(source: FromUtf8Error) -> Self

Converts to this type from the input type.

impl From<OverflowError> for StdError

fn from(source: OverflowError) -> Self

Converts to this type from the input type.

impl From<RecoverPubkeyError> for StdError

fn from(source: RecoverPubkeyError) -> Self

Converts to this type from the input type.

impl From<Utf8Error> for StdError

fn from(source: Utf8Error) -> Self

Converts to this type from the input type.

impl From<VerificationError> for StdError

fn from(source: VerificationError) -> Self

Converts to this type from the input type.

impl PartialEq for StdError

fn eq(&self, rhs: &StdError) -> bool

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.