Enum iota_types::error::IotaError

pub enum IotaError {
    UserInput {
        error: UserInputError,
    },
    IotaObjectResponse {
        error: IotaObjectResponseError,
    },
    UnexpectedOwnerType,
    TooManyTransactionsPendingExecution {
        queue_len: usize,
        threshold: usize,
    },
    TooManyTransactionsPendingConsensus,
    TooManyTransactionsPendingOnObject {
        object_id: ObjectID,
        queue_len: usize,
        threshold: usize,
    },
    TooOldTransactionPendingOnObject {
        object_id: ObjectID,
        txn_age_sec: u64,
        threshold: u64,
    },
    InvalidTxKindInSoftBundle,
    InvalidSignature {
        error: String,
    },
    SignerSignatureAbsent {
        expected: String,
        actual: Vec<String>,
    },
    SignerSignatureNumberMismatch {
        expected: usize,
        actual: usize,
    },
    IncorrectSigner {
        error: String,
    },
    UnknownSigner {
        signer: Option<String>,
        index: Option<u32>,
        committee: Box<Committee>,
    },
    StakeAggregatorRepeatedSigner {
        signer: AuthorityName,
        conflicting_sig: bool,
    },
    PotentiallyTemporarilyInvalidSignature {
        error: String,
    },
    WrongEpoch {
        expected_epoch: EpochId,
        actual_epoch: EpochId,
    },
    CertificateRequiresQuorum,
    ErrorWhileProcessingCertificate {
        err: String,
    },
    QuorumFailedToGetEffectsQuorumWhenProcessingTransaction {
        effects_map: BTreeMap<TransactionEffectsDigest, (Vec<AuthorityName>, StakeUnit)>,
    },
    FailedToVerifyTxCertWithExecutedEffects {
        validator_name: AuthorityName,
        error: String,
    },
    TxAlreadyFinalizedWithDifferentUserSigs,
    InvalidAuthenticator,
    InvalidAddress,
    InvalidTransactionDigest,
    InvalidDigestLength {
        expected: usize,
        actual: usize,
    },
    InvalidDkgMessageSize,
    UnexpectedMessage,
    ModuleVerificationFailure {
        error: String,
    },
    ModuleDeserializationFailure {
        error: String,
    },
    ModulePublishFailure {
        error: String,
    },
    ModuleBuildFailure {
        error: String,
    },
    FunctionNotFound {
        error: String,
    },
    ModuleNotFound {
        module_name: String,
    },
    Type {
        error: String,
    },
    CircularObjectOwnership,
    ObjectLockAlreadyInitialized {
        refs: Vec<ObjectRef>,
    },
    ObjectLockConflict {
        obj_ref: ObjectRef,
        pending_transaction: TransactionDigest,
    },
    ObjectLockedAtFutureEpoch {
        obj_refs: Vec<ObjectRef>,
        locked_epoch: EpochId,
        new_epoch: EpochId,
        locked_by_tx: TransactionDigest,
    },
    TransactionNotFound {
        digest: TransactionDigest,
    },
    TransactionsNotFound {
        digests: Vec<TransactionDigest>,
    },
    TransactionEventsNotFound {
        digest: TransactionEventsDigest,
    },
    TransactionAlreadyExecuted {
        digest: TransactionDigest,
    },
    BadObjectType {
        error: String,
    },
    FailObjectLayout {
        st: String,
    },
    ExecutionInvariantViolation,
    ByzantineAuthoritySuspicion {
        authority: AuthorityName,
        reason: String,
    },
    InvalidChildObjectAccess {
        object: ObjectID,
        given_parent: ObjectID,
        actual_owner: Owner,
    },
    GenericAuthority {
        error: String,
    },
    GenericBridge {
        error: String,
    },
    FailedToDispatchSubscription {
        error: String,
    },
    OwnerFailedToSerialize {
        error: String,
    },
    ExtraFieldFailedToDeserialize {
        error: String,
    },
    TransactionOrchestratorLocalExecution {
        error: String,
    },
    TransactionSerialization {
        error: String,
    },
    ObjectSerialization {
        error: String,
    },
    ObjectDeserialization {
        error: String,
    },
    NoEventStore,
    TooManyIncorrectAuthorities {
        errors: Vec<(AuthorityName, IotaError)>,
        action: String,
    },
    FullNodeInvalidTxRangeQuery {
        error: String,
    },
    FailedToSubmitToConsensus(String),
    ConsensusConnectionBroken(String),
    HandleConsensusTransactionFailure(String),
    SignatureKeyGen(String),
    KeyConversion(String),
    InvalidPrivateKey,
    FullNodeCantHandleCertificate,
    ValidatorHaltedAtEpochEnd,
    EpochEnded(EpochId),
    AdvanceEpoch {
        error: String,
    },
    TransactionExpired,
    Rpc(String, String),
    InvalidRpcMethod,
    UnsupportedFeature {
        error: String,
    },
    QuorumDriverCommunication {
        error: String,
    },
    Timeout,
    Execution(String),
    InvalidCommittee(String),
    MissingCommitteeAtEpoch(EpochId),
    IndexStoreNotAvailable,
    DynamicFieldRead(String),
    IotaSystemStateRead(String),
    IotaBridgeRead(String),
    UnexpectedVersion(String),
    WrongMessageVersion {
        error: String,
    },
    Unknown(String),
    FileIO(String),
    JWKRetrieval,
    Storage(String),
    ValidatorOverloadedRetryAfter {
        retry_after_secs: u64,
    },
    TooManyRequests,
    NoCertificateProvided,
}

Custom error type for Iota.

Variants

UserInput

Fields

error: UserInputError

IotaObjectResponse

Fields

error: IotaObjectResponseError

UnexpectedOwnerType

TooManyTransactionsPendingExecution

Fields

queue_len: usize

threshold: usize

TooManyTransactionsPendingConsensus

TooManyTransactionsPendingOnObject

Fields

object_id: ObjectID

queue_len: usize

threshold: usize

TooOldTransactionPendingOnObject

Fields

object_id: ObjectID

txn_age_sec: u64

threshold: u64

InvalidTxKindInSoftBundle

InvalidSignature

Fields

error: String

SignerSignatureAbsent

Fields

expected: String

actual: Vec<String>

SignerSignatureNumberMismatch

Fields

expected: usize

actual: usize

IncorrectSigner

Fields

error: String

UnknownSigner

Fields

signer: Option<String>

index: Option<u32>

committee: Box<Committee>

StakeAggregatorRepeatedSigner

Fields

signer: AuthorityName

conflicting_sig: bool

PotentiallyTemporarilyInvalidSignature

Fields

error: String

WrongEpoch

Fields

expected_epoch: EpochId

actual_epoch: EpochId

CertificateRequiresQuorum

ErrorWhileProcessingCertificate

Fields

err: String

QuorumFailedToGetEffectsQuorumWhenProcessingTransaction

Fields

effects_map: BTreeMap<TransactionEffectsDigest, (Vec<AuthorityName>, StakeUnit)>

FailedToVerifyTxCertWithExecutedEffects

Fields

validator_name: AuthorityName

error: String

TxAlreadyFinalizedWithDifferentUserSigs

InvalidAuthenticator

InvalidAddress

InvalidTransactionDigest

InvalidDigestLength

Fields

expected: usize

actual: usize

InvalidDkgMessageSize

UnexpectedMessage

ModuleVerificationFailure

Fields

error: String

ModuleDeserializationFailure

Fields

error: String

ModulePublishFailure

Fields

error: String

ModuleBuildFailure

Fields

error: String

FunctionNotFound

Fields

error: String

ModuleNotFound

Fields

module_name: String

Type

Fields

error: String

CircularObjectOwnership

ObjectLockAlreadyInitialized

Fields

refs: Vec<ObjectRef>

ObjectLockConflict

Fields

obj_ref: ObjectRef

pending_transaction: TransactionDigest

ObjectLockedAtFutureEpoch

Fields

obj_refs: Vec<ObjectRef>

locked_epoch: EpochId

new_epoch: EpochId

locked_by_tx: TransactionDigest

TransactionNotFound

Fields

digest: TransactionDigest

TransactionsNotFound

Fields

digests: Vec<TransactionDigest>

TransactionEventsNotFound

Fields

digest: TransactionEventsDigest

TransactionAlreadyExecuted

Fields

digest: TransactionDigest

BadObjectType

Fields

error: String

FailObjectLayout

Fields

st: String

ExecutionInvariantViolation

ByzantineAuthoritySuspicion

Fields

authority: AuthorityName

reason: String

InvalidChildObjectAccess

Fields

object: ObjectID

given_parent: ObjectID

actual_owner: Owner

GenericAuthority

Fields

error: String

GenericBridge

Fields

error: String

FailedToDispatchSubscription

Fields

error: String

OwnerFailedToSerialize

Fields

error: String

ExtraFieldFailedToDeserialize

Fields

error: String

TransactionOrchestratorLocalExecution

Fields

error: String

TransactionSerialization

Fields

error: String

ObjectSerialization

Fields

error: String

ObjectDeserialization

Fields

error: String

NoEventStore

TooManyIncorrectAuthorities

Fields

errors: Vec<(AuthorityName, IotaError)>

action: String

FullNodeInvalidTxRangeQuery

Fields

error: String

FailedToSubmitToConsensus(String)

ConsensusConnectionBroken(String)

HandleConsensusTransactionFailure(String)

SignatureKeyGen(String)

KeyConversion(String)

InvalidPrivateKey

FullNodeCantHandleCertificate

ValidatorHaltedAtEpochEnd

EpochEnded(EpochId)

AdvanceEpoch

Fields

error: String

TransactionExpired

Rpc(String, String)

InvalidRpcMethod

UnsupportedFeature

Fields

error: String

QuorumDriverCommunication

Fields

error: String

Timeout

Execution(String)

InvalidCommittee(String)

MissingCommitteeAtEpoch(EpochId)

IndexStoreNotAvailable

DynamicFieldRead(String)

IotaSystemStateRead(String)

IotaBridgeRead(String)

UnexpectedVersion(String)

WrongMessageVersion

Fields

error: String

Unknown(String)

FileIO(String)

JWKRetrieval

Storage(String)

ValidatorOverloadedRetryAfter

Fields

retry_after_secs: u64

TooManyRequests

NoCertificateProvided

Implementations

impl IotaError

pub fn individual_error_indicates_epoch_change(&self) -> bool

pub fn is_retryable(&self) -> (bool, bool)

Returns if the error is retryable and if the error’s retryability is explicitly categorized. There should be only a handful of retryable errors. For now we list common non-retryable error below to help us find more retryable errors in logs.

pub fn is_object_or_package_not_found(&self) -> bool

pub fn is_overload(&self) -> bool

pub fn is_retryable_overload(&self) -> bool

pub fn retry_after_secs(&self) -> u64

Trait Implementations

impl AsRef<str> for IotaError

fn as_ref(&self) -> &str

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

impl Clone for IotaError

fn clone(&self) -> IotaError

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for IotaError

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for IotaError

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for IotaError

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

Formats the value using the given formatter.

impl Error for IotaError

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<'_derivative_strum> From<&'_derivative_strum IotaError> for &'static str

fn from(x: &'_derivative_strum IotaError) -> &'static str

Converts to this type from the input type.

impl From<&str> for IotaError

fn from(error: &str) -> Self

Converts to this type from the input type.

impl From<Error> for IotaError

fn from(error: Error) -> Self

Converts to this type from the input type.

impl From<Error> for IotaError

fn from(e: Error) -> Self

Converts to this type from the input type.

impl From<ExecutionError> for IotaError

fn from(error: ExecutionError) -> Self

Converts to this type from the input type.

impl From<ExecutionFailureStatus> for IotaError

fn from(kind: ExecutionErrorKind) -> Self

Converts to this type from the input type.

impl From<IotaError> for &'static str

fn from(x: IotaError) -> &'static str

Converts to this type from the input type.

impl From<IotaError> for Status

fn from(error: IotaError) -> Self

Converts to this type from the input type.

impl From<IotaObjectResponseError> for IotaError

fn from(error: IotaObjectResponseError) -> Self

Converts to this type from the input type.

impl From<Status> for IotaError

fn from(status: Status) -> Self

Converts to this type from the input type.

impl From<String> for IotaError

fn from(error: String) -> Self

Converts to this type from the input type.

impl From<TypedStoreError> for IotaError

fn from(e: TypedStoreError) -> Self

Converts to this type from the input type.

impl From<UserInputError> for IotaError

fn from(error: UserInputError) -> Self

Converts to this type from the input type.

impl Hash for IotaError

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl Ord for IotaError

fn cmp(&self, other: &Self) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized + PartialOrd,

Restrict a value to a certain interval.

impl PartialEq for IotaError

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

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

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

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

impl PartialOrd for IotaError

fn partial_cmp(&self, other: &Self) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

This method tests less than (for self and other) and is used by the < operator.

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

This method tests less than or equal to (for self and other) and is used by the <= operator.

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

This method tests greater than (for self and other) and is used by the > operator.

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

This method tests greater than or equal to (for self and other) and is used by the >= operator.

impl Serialize for IotaError

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl TryFrom<IotaError> for UserInputError

type Error = Error

The type returned in the event of a conversion error.

fn try_from(err: IotaError) -> Result<Self, Self::Error>

Performs the conversion.

impl Eq for IotaError

impl StructuralPartialEq for IotaError