Enumeration

BlockSourceError

Errors thrown by BlockSource conformers.

enum BlockSourceError

Overview

Covers the five common failure modes of fetching blockchain data from a remote source: malformed responses, missing data, unsupported operations, rate-limiting, and transport-layer failures. Designed so that a single catch let error as BlockSourceError in calling code is sufficient to handle every source-side failure category.

Inside BlockchainSync, any BlockSourceError thrown from a conformer is re-surfaced to the caller as a terminal BlockchainSync.Update.State.failed(_:) update carrying the error’s localized description — the sequence itself does not throw.

Topics

Enumeration Cases

case invalidResponse(String)
The source returned a response the client could not parse.
case network(underlying: any Error)
A transport-layer error occurred: DNS failure, TCP connection drop, TLS handshake failure, timeout, etc.
case notFound
The requested block, header, or height is not available on this source.
case notSupported
The source does not implement the requested method.
case rateLimited(retryAfter: Duration?)
The source is rate-limiting the client. Surfaces only after all built-in retries have been exhausted.