very fast at protocol indexer with flexible filtering, xrpc queries, cursor-backed event stream, and more, built on fjall
hydrant docs api firehose.md

--- title: firehose management --- ## GET /firehose/sources list all known firehose sources, including offline ones waiting for the retry loop. returns a JSON array of: ```json { "url": "ws://127.0.0.1:9000/", "is_pds": true, "running": false, "failing": true, "throttled": true, "consecutive_failures": 3, "throttled_until": 1717240000, "retry_in_secs": 42, "last_failure": { "at": 1717239958, "kind": "tcp_refused", "detail": "connection refused" }, "stats": { "connection_attempts": 2, "successful_connections": 1, "connect_errors": 1, "stream_errors": 0, "frames_read": 1200, "bytes_read": 22000000, "messages_decoded": 1200, "messages_forwarded": 1198, "messages_skipped": 2, "forward_errors": 0, "throttle_waits": 0, "throttle_wait_micros": 0, "should_process_micros": 8800, "send_waits": 1198, "send_wait_micros": 64000, "connect_elapsed_micros": 410000, "max_send_wait_micros": 9000, "max_should_process_micros": 1200, "max_throttle_wait_micros": 0, "last_connect_attempt_at": 1717239900, "last_connected_at": 1717239901, "last_frame_at": 1717239958, "last_decoded_at": 1717239958, "last_forwarded_at": 1717239958, "last_start_cursor": 123, "last_seq": 1322, "max_seq": 1322, "message_kinds": { "commit": 1197, "sync": 0, "identity": 0, "account": 3, "info": 0 } }, "host_status": "offline", "pds": { "host": "127.0.0.1", "seq": 0, "account_count": 0, "status": "offline" } } ``` `is_pds: true` means the source is a direct PDS connection with host authority enforcement enabled. `host_status` and `pds` are only present for PDS sources. `last_failure` is present while hydrant has recorded failure/backoff state for a source. `kind` is a compact category such as `dns`, `tcp_refused`, `tcp_timeout`, `tls`, `http_upgrade`, `websocket`, `decode`, `relay_error`, or `config`; `detail` contains the underlying error text. `stats` is…