Enum ServerError 

pub enum ServerError {
    RequestFailed(Status),
    InvalidFrontier(Error),
    InvalidTransaction(Error),
    InvalidSubtreeRoot,
    ChainVerificationError,
    FetcherDropped,
    GenesisBlockOnly,
    TreeStateNotServed {
        pool: PoolType,
        height: BlockHeight,
    },
    UnsupportedProtocolVersion {
        version: String,
    },
    ChainHeightBelowScanRange {
        chain_height: BlockHeight,
        scan_range_end: BlockHeight,
    },
}

Server errors.

Errors associated with connecting to the server and receiving invalid data.

Variants

RequestFailed(Status)

Server request failed.

InvalidFrontier(Error)

Server returned invalid frontier.

InvalidTransaction(Error)

Server returned invalid transaction.

InvalidSubtreeRoot

Server returned invalid subtree root.

ChainVerificationError

Server returned blocks that could not be verified against wallet block data. Exceeded max verification window.

FetcherDropped

Fetcher task was dropped.

GenesisBlockOnly

Server reports only the genesis block exists.

TreeStateNotServed

Server did not return a shielded pool’s note commitment tree state for a height at or above the pool’s activation height.

Fields

pool: PoolType

The pool whose tree state was omitted.

height: BlockHeight

The requested block height.

UnsupportedProtocolVersion

Server’s lightwallet protocol version is too old to serve the transparent and Ironwood data in compact blocks required for sync.

Fields

version: String

The lightwallet protocol version reported by the server. Empty if the server does not report one.

ChainHeightBelowScanRange

Fetching a scan range failed and the server’s chain height is below the last block of the scan range. A re-org lowered the chain height after the scan range was selected, or the server is behind the chain tip.

Fields

chain_height: BlockHeight

The chain height reported by the server.

scan_range_end: BlockHeight

The height of the last block in the scan range.

Implementations

impl ServerError

pub fn recommend_same_server(&self) -> bool

Returns true if this server error is likely transient.

gRPC requests that failed to network weather (timeouts, connection drops) are recommend_same_server. Other request failures and invalid data from the server suggest a bad server that should be avoided rather than retried.

impl ServerError

pub fn recovery_recommendation(&self) -> SyncRecoveryObservables

Returns the recommended recovery action for this server error.

Trait Implementations

impl Debug for ServerError

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

Formats the value using the given formatter.

impl Display for ServerError

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

Formats the value using the given formatter.

impl Error for ServerError

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<E> From<ServerError> for SyncError<E>

where E: Debug + Display,

fn from(source: ServerError) -> Self

Converts to this type from the input type.

impl From<ServerError> for MempoolError

fn from(source: ServerError) -> Self

Converts to this type from the input type.

impl From<ServerError> for ScanError

fn from(source: ServerError) -> Self

Converts to this type from the input type.

impl From<Status> for ServerError

fn from(source: Status) -> Self

Converts to this type from the input type.