Reduce idle RPC usage by Jurij89 · Pull Request #1440 · OriginTrail/dkg

Jurij89 · 2026-07-04T19:43:47Z

Summary

Reduces idle JSON-RPC volume by giving counted ethers providers a static network after one live eth_chainId validation, eliminating repeated steady-state chain-id detection while still catching wrong-chain or unavailable RPC endpoints.
Splits chain event polling into independent lanes for publish confirmation, context graph discovery, VM reconciliation, collection updates, allow-list updates, and profile events; ChainEventLaneRunner owns cadence, cursor persistence, lazy lane restoration, and conservative legacy cursor compatibility.
Adds explicit cache primitives for hot chain reads: TtlValueCache retains bounded positive values, KeyedSingleFlight coalesces in-flight work with stale-write guards, PCA reverse-agent authorization is single-flight only for publish-critical freshness, and PCA write paths centralize post-success invalidation.
Adds a targeted devnet/rpc-quiet-window suite for idle rpc_usage budget validation.

Expected RPC impact

The investigation baseline from the Base mainnet node was 62,820 counted raw RPCs over about 218.5 minutes, or roughly 288 calls/minute. The largest steady-state contributors were eth_getLogs (26,819, about 123/minute), eth_chainId (16,777, about 77/minute), and eth_call (15,079, about 69/minute).

Expected quiet-window behavior after this PR:

eth_chainId: near-zero steady-state calls for numeric EVM chain configs after one validation per endpoint; the devnet budget is <=5/minute, a ~93% reduction versus the Base average and ~98% versus the observed 333/minute peak window.
eth_getLogs: most idle 12s ticks return before getBlockNumber; only due lanes scan, and context graph discovery moves to a slower independent cadence. The devnet budget is <=20/minute, an ~84% reduction versus the Base average and ~91% versus the observed 215/minute peak window.
Total quiet-window RPCs: the devnet gate budgets <=120 calls/minute per idle daemon, at least ~58% below the Base average before accounting for workload-specific eth_call cache wins.
eth_call: exact reduction is workload-dependent, but duplicate identity/PCA reads collapse to one in-flight request per key and short TTL window; RPC failures are not cached.

The Gnosis sample remains useful failover evidence, but its malformed hosts were an intentional failover test rather than the expected production baseline.

Scope note

This PR does not change random-sampling-specific code or the random sampling prover/bind implementation. Random sampling may indirectly benefit from shared chain-adapter provider behavior, but its core challenge/proof flow and random-sampling RPC logic are not intentionally modified here.

Consolidate compatible live-tail event lanes into shared scan groups #1448 Consolidate compatible live-tail event lanes into shared scan groups
Add direct dispatch coverage for allow-list and profile event lanes #1449 Add direct dispatch coverage for allow-list and profile event lanes
Use explicit single-flight for PCA agent lookups #1452 Use explicit single-flight for PCA agent lookups
Extract static-network validation into a validated RPC endpoint abstraction #1454 Extract static-network validation into a validated RPC endpoint abstraction
Add direct RpcFailoverClient write-path validation-hook tests #1455 Add direct RpcFailoverClient write-path validation-hook tests
Replace lane cursor policy flags with typed cursor strategies #1456 Replace lane cursor policy flags with typed cursor strategies
Decouple lane-runner tests from private poller and publish-handler internals #1457 Decouple lane-runner tests from private poller and publish-handler internals

Files changed

File	What
`packages/chain/src/rpc-usage.ts`	Allows counted providers to receive an optional static network
`packages/chain/src/evm-adapter-base.ts`	Parses configured chain ids, initializes static-network providers, validates chain id once, owns identity/PCA cache state and named PCA invalidators
`packages/chain/src/keyed-ttl-single-flight-cache.ts`	Adds separate `TtlValueCache` and `KeyedSingleFlight` primitives with non-storing zero-TTL semantics and epoch-guarded in-flight invalidation
`packages/chain/src/evm-adapter-identity.ts`	Adds positive identity caching, negative in-flight coalescing, and local seed/clear hooks
`packages/chain/src/evm-adapter-conviction.ts`	Composes PCA account-info caching, single-flight reverse-agent reads, and centralized PCA write invalidation
`packages/publisher/src/chain-event-lane-runner.ts`	Extracts lane scheduling, head seeding, lazy cursor restore, scanning, and persistence mechanics out of the poller
`packages/publisher/src/chain-event-poller.ts`	Defines lane descriptors and keeps event-domain dispatch/handler logic
`packages/chain/test/`, `packages/publisher/test/`	Adds static-network, cache primitive, identity/PCA cache, op-wallet mutation, poller lane, cursor, lazy-restore, legacy-save, and misc dispatch regression tests
`devnet/rpc-quiet-window/`, `devnet/suites.json`, `package.json`, `pnpm-`	Adds registered idle devnet RPC budget suite and workspace metadata

Note: investigation/planning artifacts remain local under ignored agent-docs/ for this Codex run, but are intentionally not part of the repository diff.