Return nodes ordered by health for a specific API call. Healthy nodes come first (preserving original order), then unhealthy nodes as fallback.
Optionalapi: stringCheck if a node is considered healthy for a given API.
Optionalapi: stringCheck if a node is currently rate-limited (429 cooldown active).
Record an API/plugin-specific failure (e.g. "method not found", "plugin not enabled"). Only increments the per-API counter, NOT the global consecutive failure counter. This prevents a node with a disabled plugin from being penalized for all APIs.
Record a network-level failure (timeout, connection refused, HTTP error). Increments both the global consecutive failure counter and the API-specific counter.
Record that a node returned HTTP 429 (Too Many Requests). The node will be skipped until the rate limit expires.
OptionalretryAfterSeconds: number
Value from the Retry-After header, or undefined to use default.
Record a successful call to a node for a specific API. Clears consecutive failure counter and API-specific failures for this API.
Reset all health tracking data.
Update head block number for a node. Called passively when get_dynamic_global_properties responses are observed.
Get a snapshot of current health state for diagnostics.