Crate brk_error 

brk_error

Unified error types for the Bitcoin Research Kit.

Core API

• Error - Comprehensive enum covering all error cases across the stack
• Result<T> - Convenience alias for Result<T, Error>

Error Categories

External integrations: Bitcoin RPC, consensus encoding, address parsing, JSON serialization, database (fjall, vecdb), HTTP requests (minreq), async runtime (tokio)

Domain-specific: Invalid addresses, unknown TXIDs, unsupported types, metric lookup failures with fuzzy suggestions, request weight limits

Network intelligence: is_network_permanently_blocked() distinguishes transient failures (timeouts, rate limits) from permanent blocks (DNS failure, connection refused, TLS errors) to enable smart retry logic

Structs

SeriesNotFound

Enums

Error

Traits

OptionData

Convert Option<T> → Result<T> without panicking.

Functions

truncate_series_name

Truncate a user-supplied series name for inclusion in an error message, appending an ellipsis if it exceeds the display cap. Used for both SeriesNotFound and SeriesUnsupportedIndex so far-too-long names don’t blow up the response body.

Type Aliases

Result