# 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