Repository navigation
v1.6.8 — 2026-11-09
Highlights
Integrators upgrading to version 1.6.8 must account for several breaking changes across connection limits, caching, GraphQL handling, and health reporting. First, operators routing traffic through external proxies like CDNs must configure the new --websocket-trusted-proxies flag with their proxy IP ranges, because --limit-parallel-websocket-connections-per-ip now counts strictly by client address rather than a combination of address, X-Forwarded-For, and User-Agent. Second, requests containing lava-select-provider, lava-stickiness, or lava-providers-block headers now bypass all cache tiers to guarantee node execution, eliminating the need to append lava-force-cache-refresh. Third, the router enforces stricter GraphQL validation, returning HTTP 400 with a GraphQL error document instead of HTTP 500 for requests exceeding depth or field limits, and refusing payloads with duplicate fields, mismatched casing, or mixed mutation and query operations. Fourth, provider verification backoffs now retry nodes offline for over 16 minutes every 15 minutes instead of 3—reducing the frequency of retry: provider verification still failing log lines—while smartrouter health now reports PartialFail for failing add-on checks, removes URLs on explicit Fail states, and exposes new scope="none" and scope="service" metric series. Beyond these breaking changes, this release introduces GET /debug/verification to expose state transitions alongside GET /debug/relay-errors for tracking node and protocol error counts, and refines upstream error handling by correctly parsing Solana JSON-RPC errors during chain tracking, classifying XRP "not found" errors for proper retries, and respecting rate-limit wait times requested via gRPC headers or trailers.
Changes
⚠ Breaking changes
- fix(chainlib)!: answer a GraphQL request the router refuses by its own limit with a client error and a GraphQL error document (MAG-4577) (#598)
2d99d4b- a GraphQL request refused by the router's own limits (more than 256 levels of depth, more than 300 root fields, or more than 32 nested fragments) now gets HTTP 400 with a GraphQL error document instead of HTTP 500 with the error inside a JSON string.
- feat!: say what a failed verification costs (Fail, PartialFail, Warning), and publish every failing check (MAG-3950) (#580)
67eeebasmartrouter healthreportsPartialFailfor add-on and archive checks that readFail; a url naming an undefined add-on is admitted with the name inrefusedServicesinstead of refused; an explicit"Fail"on an add-on check now takes the url out; both verification metrics gainscope="none"series andscope="service"series keyed by undefined add-on names.
- feat!: retry each failing verification on its own backoff, log its transitions, serve GET /debug/verification (MAG-3950) (#582)
2ab221f- a provider out for ~16 min or more is retried every 15 min (+jitter) instead of every 3 min; the url grace's second strike comes ~30s after the first instead of at the next epoch, so a blip that outlasts the retry delay demotes the provider; Loki rules counting
retry: provider verification still failinglines see about one line per 15 min.
- a provider out for ~16 min or more is retried every 15 min (+jitter) instead of every 3 min; the url grace's second strike comes ~30s after the first instead of at the next epoch, so a blip that outlasts the retry delay demotes the provider; Loki rules counting
- fix(chainlib)!: count the websocket connection limit per client address, read through trusted proxies (MAG-3083) (#665)
104aead- --limit-parallel-websocket-connections-per-ip counts connections per client address instead of per address, X-Forwarded-For and User-Agent. Behind a proxy whose address is not loopback or private, such as a CDN, add its ranges to the new --websocket-trusted-proxies flag, or every client behind it shares one allowance.
- fix(chainlib)!: refuse a GraphQL request whose wrapper the router and the node would read differently (MAG-4908) (#655)
46f4f4b- a GraphQL request body that repeats
query,operationName,variablesorextensions, or spells one of them in a different letter case, is refused by the router with HTTP 400 instead of being relayed to a node. A GraphQL document that holds a mutation beside a query or a subscription is refused with HTTP 400 instead of running the operation operationName names.
- a GraphQL request body that repeats
- fix(cache)!: never answer a pinned, sticky or node-excluding request from the cache (MAG-3520, MAG-3864) (#663)
b9b4af3- a request carrying lava-select-provider, lava-stickiness or lava-providers-block is no longer answered from the cache, by either tier; it always reaches a node, and the node's answer is still cached for other requests. Sending lava-force-cache-refresh next to a pin is no longer needed for this.
Dependency updates
New Features
- feat!: say what a failed verification costs (Fail, PartialFail, Warning), and publish every failing check (MAG-3950) (#580)
67eeeba - feat!: retry each failing verification on its own backoff, log its transitions, serve GET /debug/verification (MAG-3950) (#582)
2ab221f - feat(debug): GET /debug/relay-errors reports node-error and protocol-error counts (MAG-4718) (#626)
e709626
Bug fixes
- fix(chainlib)!: answer a GraphQL request the router refuses by its own limit with a client error and a GraphQL error document (MAG-4577) (#598)
2d99d4b - fix(chaintracker): count a Solana latest-block poll answered with a JSON-RPC error as a failed poll (MAG-4613) (#579)
c19b414 - fix(provideroptimizer): log one debug record per pick, whatever the number of candidates (MAG-3152) (#674)
7c4f843 - fix(chainlib): keep the catch-all node url when two urls share a method list (MAG-3081) (#673)
8116cca - fix(rpcsmartrouter): answer a refused JSON-RPC 429 without lava-identified-node-error (MAG-3030) (#679)
52a648e - fix(rpcsmartrouter): never cache node-local Bitcoin-family or walletd reads (MAG-4207, MAG-4793) (#672)
57dd388 - fix(chainlib,common): an XRP error inside result is a node error on every method (MAG-4817) (#649)
d1ad560 - fix(common): retry every XRP "not found" and classify the rest of rippled's errors (MAG-4817) (#649)
3603080 - fix(common): keep a node that does not serve pending state switched on, and ask a peer (MAG-5021) (#667)
22e12a1 - fix(rpcsmartrouter): send the lava-* headers when a request's budget runs out unanswered (MAG-3980) (#671)
6afab23 - fix(chainlib): send the request headers a spec declares on JSON-RPC and Tendermint, as on REST and gRPC (MAG-3079) (#662)
c793ca7 - fix(chaintracker): resume polling when a hold-off clears and don't probe-score a held-off endpoint (MAG-4387) (#537)
628e1e5 - fix(grpc): a DEADLINE_EXCEEDED the node sends at the router's deadline is the router's timeout, not the node's answer (MAG-4925) (#656)
efc90a5 - fix(rpcsmartrouter): say why a write's outcome is unclear (MAG-4380) (#546)
e90f7e3 - fix(grpc): hold a rate-limited gRPC endpoint off for the wait it asked for, header or trailer (MAG-4914, MAG-4915) (#678)
0e8b9bc - fix(chainlib)!: count the websocket connection limit per client address, read through trusted proxies (MAG-3083) (#665)
104aead - fix(cache): never cache a null for a block at or below the router's tip (MAG-4124) (#668)
5b9f81e - fix(lavasession): release only a pinned request's own provider, and only a live one (MAG-4731) (#670)
4b1cc3c - fix(chainlib)!: refuse a GraphQL request whose wrapper the router and the node would read differently (MAG-4908) (#655)
46f4f4b - fix(chainstate): let a single-endpoint tip follow its endpoint through a block storm (MAG-4964) (#669)
9ec894f - fix(rpcsmartrouter): tell the caller when an archive request degrades to a non-archive node (MAG-4729) (#675)
cc118a2 - fix(version): report the toolchain's VCS revision when -ldflags left no commit (MAG-3298) (#658)
f6f3214 - fix(cache)!: never answer a pinned, sticky or node-excluding request from the cache (MAG-3520, MAG-3864) (#663)
b9b4af3