Enum ethers_contract::ContractError

pub enum ContractError<M: Middleware> {
    DecodingError(Error),
    AbiError(AbiError),
    DetokenizationError(InvalidOutputType),
    MiddlewareError {
        e: M::Error,
    },
    ProviderError {
        e: ProviderError,
    },
    Revert(Bytes),
    ConstructorError,
    ContractNotDeployed,
}

Available on crate feature providers only.

An Error which is thrown when interacting with a smart contract

Variants

DecodingError(Error)

Thrown when the ABI decoding fails

AbiError(AbiError)

Thrown when the internal BaseContract errors

DetokenizationError(InvalidOutputType)

Thrown when detokenizing an argument

MiddlewareError

Fields

e: M::Error

The underlying error

Thrown when a middleware call fails

ProviderError

Fields

e: ProviderError

The underlying error

Thrown when a provider call fails

Revert(Bytes)

Contract reverted

ConstructorError

Thrown during deployment if a constructor argument was passed in the deploy call but a constructor was not present in the ABI

ContractNotDeployed

Thrown if a contract address is not found in the deployment transaction’s receipt

Implementations

impl<M: Middleware> ContractError<M>

pub fn as_revert(&self) -> Option<&Bytes>

If this ContractError is a revert, this method will retrieve a reference to the underlying revert data. This ABI-encoded data could be a String, or a custom Solidity error type.

Returns

None if the error is not a revert Some(data) with the revert data, if the error is a revert

Note

To skip this step, consider using ContractError::decode_revert

pub fn is_revert(&self) -> bool

True if the error is a revert, false otherwise

pub fn decode_revert<Err: EthError>(&self) -> Option<Err>

Decode revert data into an EthError type. Returns None if decoding fails, or if this is not a revert

pub fn decode_contract_revert<Err: ContractRevert>(&self) -> Option<Err>

Decode revert data into a ContractRevert type. Returns None if decoding fails, or if this is not a revert

This is intended to be used with error enum outputs from abigen! contracts

pub fn from_middleware_error(e: M::Error) -> Self

Convert a MiddlewareError to a ContractError

pub fn as_middleware_error(&self) -> Option<&M::Error>

Convert a ContractError to a MiddlewareError if possible.

pub fn is_middleware_error(&self) -> bool

True if the error is a middleware error

pub fn as_provider_error(&self) -> Option<&ProviderError>

Convert a ContractError to a ProviderError if possible.

pub fn is_provider_error(&self) -> bool

True if the error is a provider error

Trait Implementations

impl<M: Debug + Middleware> Debug for ContractError<M>

where M::Error: Debug,

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

Formats the value using the given formatter.

impl<M: Middleware> Display for ContractError<M>

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

Formats the value using the given formatter.

impl<M: Middleware> Error for ContractError<M>

where Self: Debug + Display,

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

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<M: Middleware> From<AbiError> for ContractError<M>

fn from(source: AbiError) -> Self

Converts to this type from the input type.

impl<M: Middleware> From<ContractError<M>> for MulticallError<M>

Available on crate feature abigen only.

fn from(source: ContractError<M>) -> Self

Converts to this type from the input type.

impl<M: Middleware> From<Error> for ContractError<M>

fn from(source: Error) -> Self

Converts to this type from the input type.

impl<M: Middleware> From<InvalidOutputType> for ContractError<M>

fn from(source: InvalidOutputType) -> Self

Converts to this type from the input type.

impl<M: Middleware> From<ProviderError> for ContractError<M>

fn from(e: ProviderError) -> Self

Converts to this type from the input type.