Enum gclient::Error

pub enum Error {
    Anyhow(Error),
    GearSDK(Error),
    EventsSubscriptionNotFound,
    EventsStopped,
    Subxt(Error),
    EventNotFound,
    IO(Error),
    WrongBinaryExtension,
    BalanceOverflow,
    BlockDataNotFound,
    BlockHashNotFound,
    IncompleteBatchResult(usize, usize),
    MaxDepthReached,
    EventNotFoundInIterator,
    StorageNotFound,
    TimestampNotFound,
    Codec(Error),
    Hex(FromHexError),
    ProgramAlreadyExists(String),
    Node(Error),
    WSDomainInvalid,
    Url(ParseError),
    Module(ModuleError),
}

Common error type.

Variants

Anyhow(Error)

A wrapper around anyhow::Error.

GearSDK(Error)

A wrapper around [gsdk::Error].

EventsSubscriptionNotFound

Occurs when attempting to iterate events without a subscription.

EventsStopped

Occurs when events are stopped. Unreachable.

Subxt(Error)

A wrapper around [subxt::error::Error].

EventNotFound

Occurs when an event of the expected type cannot be found.

IO(Error)

A wrapper around std::io::Error.

WrongBinaryExtension

Occurs when trying to upload a Wasm binary with the wrong file extension (other than .wasm).

BalanceOverflow

Occurs when the balance reaches its maximum value.

BlockDataNotFound

Occurs when a block identified by the specified hash cannot be found.

BlockHashNotFound

Occurs when a hash of a block identified by the specified hash cannot be found.

IncompleteBatchResult(usize, usize)

Occurs when the batch hasn’t been fully processed.

MaxDepthReached

Occurs when a block cannot be found within the specified depth.

EventNotFoundInIterator

Occurs when an event cannot be found in pre-queried events.

StorageNotFound

Occurs when a storage entry with a specified address cannot be found.

TimestampNotFound

Occurs when a timestamp record cannot be found in the storage.

Codec(Error)

A wrapper around [parity_scale_codec::Error].

Hex(FromHexError)

Occurs when decoding hex string failed.

ProgramAlreadyExists(String)

Occurs when being migrated program already exists in destination node.

Node(Error)

Occurs when node spawning failed.

WSDomainInvalid

Occurs when parsing websocket domain failed.

Url(ParseError)

Occurs when parsing domain url failed.

Module(ModuleError)

A wrapper of module error gsdk::metadata::ModuleError.

Example

use gclient::{errors, Error, EventProcessor, GearApi};

#[tokio::test]
async fn test_upload_failed() -> anyhow::Result<()> {
    let api = GearApi::dev_from_path("../target/release/gear").await?;

    let err = api
        .upload_program(vec![], vec![], b"", u64::MAX, 0)
        .await
        .expect_err("Should fail");

    assert!(matches!(
        err,
        Error::Module(errors::ModuleError::Gear(errors::Gear::GasLimitTooHigh))
    ));

    Ok(())
}

Trait Implementations

impl Debug for Error

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

Formats the value using the given formatter.

impl Display for Error

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

Formats the value using the given formatter.

impl Error for Error

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 From<Error> for Error

fn from(e: GearSDKError) -> Self

Converts to this type from the input type.

impl From<Error> for Error

fn from(source: NodeError) -> Self

Converts to this type from the input type.

impl From<Error> for Error

fn from(e: SubxtError) -> Self

Converts to this type from the input type.

impl From<Error> for Error

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for Error

fn from(source: AError) -> Self

Converts to this type from the input type.

impl From<Error> for Error

fn from(source: IOError) -> Self

Converts to this type from the input type.

impl From<FromHexError> for Error

fn from(source: FromHexError) -> Self

Converts to this type from the input type.

impl From<ParseError> for Error

fn from(source: ParseError) -> Self

Converts to this type from the input type.