Struct StdError

pub struct StdError(/* private fields */);

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

Implementations

impl StdError

pub fn msg<D>(msg: D) -> Self

where D: Display,

pub fn backtrace(&self) -> &BT

pub fn is<T>(&self) -> bool

where T: Error + 'static,

pub fn kind(&self) -> ErrorKind

pub fn with_kind(self, kind: ErrorKind) -> Self

Trait Implementations

impl AsRef<dyn Error + Sync + Send> for StdError

fn as_ref(&self) -> &(dyn Error + Send + Sync + 'static)

Converts this type into a shared reference of the (usually inferred) input type.

impl Debug for StdError

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

Formats the value using the given formatter.

impl Deref for StdError

type Target = dyn Error + Sync + Send

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.

impl Display for StdError

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

Formats the value using the given formatter.

impl<E> From<E> for StdError

where E: Error + Send + Sync + 'static,

fn from(value: E) -> Self

Converts to this type from the input type.