@valve-tech/chain-source 0.14.0 → 0.16.0

package/CHANGELOG.md

@@ -6,6 +6,105 @@ this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/).
 
+## [0.16.0] — 2026-05-15
+
+### Added
+
+- **Adaptive polling.** Replaces the static `setInterval(pollIntervalMs)`
+  with a recursive `setTimeout` chain that schedules each subsequent
+  tick based on the measured block time + exponential backoff. On
+  start, the source samples `latest` + `latest - 256` to derive the
+  chain's average block time. After each head-move tick the next is
+  scheduled at that expected interval; when the head hasn't moved on
+  schedule, backoff (2s → 4s → 8s → 16s → 30s capped) kicks in
+  until movement resumes. The existing `eth_blockNumber` head-probe
+  gate is preserved — combined effect is dramatic RPC traffic
+  reduction on idle chains while consumer-observed event cadence
+  (one `subscribeBlocks` emit per actual new block) stays identical.
+- **`AdaptivePollOptions`** — tuning knobs via
+  `CreateChainSourceOptions.adaptivePolling`:
+  - `estimationLookbackBlocks` (default 256) — sample size for the
+    block-time estimate.
+  - `retryInitialMs` (default 2_000) — initial backoff when head
+    doesn't move.
+  - `retryMaxMs` (default 30_000) — cap on exponential backoff.
+  - `enabled` (default true) — pass `false` to revert to v0.15
+    dumb-interval semantics.
+- **`estimateBlockTimeMs(client, lookback?, onError?)`** — new
+  transport-layer helper exported from the package root. Samples
+  `latest` + `latest - lookback` and returns the average ms/block,
+  or `null` on transport error / insufficient history / invalid
+  timestamps / non-positive lookback. Stateless, safe to call
+  independently of the source.
+- **`Logger`** type and **`logger`** option on
+  `CreateChainSourceOptions` — `(level, message, meta?) => void`
+  single-callback shape. Called at narrowly-chosen decision points:
+  source start/stop, capability probe completion, block-time
+  estimation outcome, adaptive scheduler decisions (next-tick-in-Xms),
+  WS subscription open/close/failure. RPC-call-level logging stays
+  on the viem transport layer (see README).
+
+### Changed
+
+- Removed two unreachable defensive branches that previously hurt
+  coverage without protecting any real failure mode:
+  - The `Number.isFinite(ms) || ms <= 0` post-check in
+    `estimateBlockTimeMs` was preceded by guards (`latestTs > oldTs`,
+    `lookback > 0`) that ensure the result is always a finite
+    positive number. Replaced by an entry-time `lookback <= 0`
+    guard that the rest of the function depends on.
+  - The first `if (!started) return` in
+    `runAdaptiveTickAndSchedule` was redundant — `start()` sets
+    `started = true` before invoking the function synchronously, and
+    setTimeout callbacks queued after stop() are explicitly cleared.
+    The post-await guard at the same name stays (the one that
+    catches `stop()` happening during the tick's async work).
+
+### Notes
+
+- New README section "Overriding RPC dispatch" documents that
+  consumers control RPC dispatch via viem's `Transport` when
+  constructing the `PublicClient` — `http(url, { onFetchRequest,
+  onFetchResponse, retryCount, ... })`, `webSocket()`, `fallback([])`,
+  custom auth headers. The toolkit does not wrap or replace this; viem
+  is the single point of RPC control. No new toolkit-level transport
+  option needed.
+- 21 new tests covering adaptive scheduler behavior, estimator edge
+  cases, logger plumbing, and the WS handleHeadNotification fresh-
+  path emit branch. 128 total chain-source tests (was 107). Coverage
+  remains 100/100/100/100.
+
+## [0.15.0] — 2026-05-14
+
+### Added
+
+- **`Capabilities.ready?: boolean`** — new optional field on the
+  Capabilities interface. `false` while the initial `probeCapabilities`
+  run is in flight; `true` after it resolves (and stays `true` across
+  `reprobeOnReconnect` re-probes — re-probes update field values in
+  place without flipping back). Distinguishes "probe not yet completed"
+  from "upstream RPC genuinely doesn't support this method," which
+  pre-v0.15 were collapsed into one value via the conservative
+  pre-probe defaults.
+  Optional for backward compatibility: synthetic Capabilities literals
+  in tests and consumer stubs that omit it should be read as "probe
+  already completed" (i.e., authoritative field values). Downstream
+  gates should use `caps.ready === false` (specific loose-equality) to
+  detect the probing state; `undefined` is treated as "ready."
+
+### Notes
+
+- Motivated by a tx-tracker cold-start ergonomic issue:
+  `runReceiptPollFallback`'s `receiptByHash !== 'available'` gate
+  would fire its "permanently unavailable" warning during the
+  pre-probe window for RPCs that ultimately supported the method.
+  tx-tracker v0.15 now reads `caps.ready === false` and skips silently
+  until the probe completes.
+- The change is purely additive — existing TypeScript consumers that
+  destructure or pass Capabilities continue to compile. No consumer-
+  visible runtime change beyond the new field appearing on returned
+  snapshots.
+
 ## [0.14.0] — 2026-05-14
 
 ### Changed

package/README.md

@@ -99,6 +99,130 @@ tracker.start()
 Stopping a derived view does not stop the source — the consumer that
 constructed the source is the one who calls `source.stop()`.
 
+## Overriding RPC dispatch
+
+`createChainSource` does not wrap or replace your viem client — it
+calls `client.request(...)` (and the higher-level viem methods built
+on it) directly. **All RPC dispatch goes through your viem
+`PublicClient`**, so the override seam is the viem `Transport` you
+construct, not a chain-source-level option.
+
+Common things consumers want here, and how to do them via viem:
+
+```ts
+import { createPublicClient, http, webSocket, fallback } from 'viem'
+
+// 1. Log every RPC request/response.
+const client = createPublicClient({
+  chain: mainnet,
+  transport: http(rpcUrl, {
+    onFetchRequest: (req) => logger.debug('rpc request', { url: req.url }),
+    onFetchResponse: (res) => logger.debug('rpc response', { status: res.status }),
+  }),
+})
+
+// 2. Retry + timeout policy at the transport layer.
+const client = createPublicClient({
+  chain: mainnet,
+  transport: http(rpcUrl, {
+    retryCount: 3,
+    retryDelay: 250, // ms
+    timeout: 8_000,
+  }),
+})
+
+// 3. Multi-RPC fan-out (try primary, fall back to backups).
+const client = createPublicClient({
+  chain: mainnet,
+  transport: fallback([
+    http(primaryUrl),
+    http(backupUrl1),
+    http(backupUrl2),
+  ]),
+})
+
+// 4. Custom auth headers / cookies.
+const client = createPublicClient({
+  chain: mainnet,
+  transport: http(rpcUrl, {
+    fetchOptions: {
+      headers: { authorization: `Bearer ${token}` },
+    },
+  }),
+})
+
+// 5. Mixed WS + HTTP (WS preferred, HTTP fallback). chain-source
+//    auto-detects WS capability and opens a `newHeads` subscription
+//    when available; `fallback` keeps the source running on HTTP if
+//    the WS connection drops.
+const client = createPublicClient({
+  chain: mainnet,
+  transport: fallback([
+    webSocket(wsUrl),
+    http(httpUrl),
+  ]),
+})
+```
+
+The chain-source surface above this (block subscription, mempool
+snapshot, on-demand RPCs) is consistent regardless of which transport
+you choose — the source picks WS-vs-HTTP behavior based on the
+capability probe (`source.capabilities()`), not on what kind of
+transport you constructed.
+
+For toolkit-level events that don't correspond to individual RPC calls
+(capability probe outcomes, adaptive scheduler decisions, subscription
+lifecycle), pass a `logger` to `createChainSource` directly — see the
+"Logger" section below.
+
+## Logger
+
+Optional `logger` callback for observability above the RPC layer:
+
+```ts
+const source = createChainSource({
+  client,
+  logger: (level, message, meta) => {
+    console.log(`[chain-source ${level}]`, message, meta)
+  },
+})
+```
+
+Signature: `(level: 'debug' | 'info' | 'warn' | 'error', message: string, meta?: Record<string, unknown>) => void`.
+
+The toolkit calls this at narrowly-chosen decision points — capability
+probe completion, block-time estimation, adaptive scheduler intervals,
+WS subscription open/close, head-probe gate skips. RPC-call-level
+logging belongs on your viem transport (see above); the chain-source
+logger covers the "what is the source deciding right now" question.
+
+## Adaptive polling
+
+When push subscriptions aren't available (RPC doesn't expose
+`eth_subscribe('newHeads')`), the source falls back to a poll loop.
+Since v0.16 this loop is adaptive: at construction the source samples
+`latest` + `latest - 256` to estimate the chain's block time, then
+schedules each subsequent poll around the expected next-block moment.
+If the head doesn't move on schedule, exponential backoff kicks in
+(2s → 4s → 8s → … capped at 30s) until a new block lands, then resets.
+
+Tune via `adaptivePolling`:
+
+```ts
+createChainSource({
+  client,
+  adaptivePolling: {
+    estimationLookbackBlocks: 512,  // larger sample, smoother estimate
+    retryInitialMs: 1_000,           // tighter initial retry
+    retryMaxMs: 15_000,              // shorter cap
+  },
+})
+```
+
+Set `adaptivePolling: { enabled: false }` to revert to the v0.15
+dumb-interval behavior (one tick per `pollIntervalMs` regardless of
+chain state).
+
 ## License
 
 MIT

package/dist/index.d.ts

@@ -24,10 +24,10 @@
  *   source.start()
  */
 export { createChainSource } from './source.js';
-export type { ChainSource, CreateChainSourceOptions } from './source.js';
+export type { AdaptivePollOptions, ChainSource, CreateChainSourceOptions, Logger, } from './source.js';
 export { Subscriptions } from './subscriptions.js';
 export { normalizeMempool } from './mempool.js';
 export { probeCapabilities } from './capabilities.js';
-export { safeRequest, fetchBlock, fetchBlockByHash, fetchHeadBlockNumber, fetchFeeHistory, fetchTxPool, fetchReceipt, fetchTransaction, zeroHash, } from './transport.js';
+export { safeRequest, estimateBlockTimeMs, fetchBlock, fetchBlockByHash, fetchHeadBlockNumber, fetchFeeHistory, fetchTxPool, fetchReceipt, fetchTransaction, zeroHash, } from './transport.js';
 export type { BlockResult, Capabilities, EventSource, FeeHistoryResult, NormalizedMempool, PollOptions, RawTx, TransactionReceipt, TxPoolContent, } from './types.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAC/C,YAAY,EAAE,WAAW,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAA;AAExE,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAElD,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AAE/C,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAA;AAErD,OAAO,EACL,WAAW,EACX,UAAU,EACV,gBAAgB,EAChB,oBAAoB,EACpB,eAAe,EACf,WAAW,EACX,YAAY,EACZ,gBAAgB,EAChB,QAAQ,GACT,MAAM,gBAAgB,CAAA;AAEvB,YAAY,EACV,WAAW,EACX,YAAY,EACZ,WAAW,EACX,gBAAgB,EAChB,iBAAiB,EACjB,WAAW,EACX,KAAK,EACL,kBAAkB,EAClB,aAAa,GACd,MAAM,YAAY,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAC/C,YAAY,EACV,mBAAmB,EACnB,WAAW,EACX,wBAAwB,EACxB,MAAM,GACP,MAAM,aAAa,CAAA;AAEpB,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAElD,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AAE/C,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAA;AAErD,OAAO,EACL,WAAW,EACX,mBAAmB,EACnB,UAAU,EACV,gBAAgB,EAChB,oBAAoB,EACpB,eAAe,EACf,WAAW,EACX,YAAY,EACZ,gBAAgB,EAChB,QAAQ,GACT,MAAM,gBAAgB,CAAA;AAEvB,YAAY,EACV,WAAW,EACX,YAAY,EACZ,WAAW,EACX,gBAAgB,EAChB,iBAAiB,EACjB,WAAW,EACX,KAAK,EACL,kBAAkB,EAClB,aAAa,GACd,MAAM,YAAY,CAAA"}

package/dist/index.js

@@ -27,5 +27,5 @@ export { createChainSource } from './source.js';
 export { Subscriptions } from './subscriptions.js';
 export { normalizeMempool } from './mempool.js';
 export { probeCapabilities } from './capabilities.js';
-export { safeRequest, fetchBlock, fetchBlockByHash, fetchHeadBlockNumber, fetchFeeHistory, fetchTxPool, fetchReceipt, fetchTransaction, zeroHash, } from './transport.js';
+export { safeRequest, estimateBlockTimeMs, fetchBlock, fetchBlockByHash, fetchHeadBlockNumber, fetchFeeHistory, fetchTxPool, fetchReceipt, fetchTransaction, zeroHash, } from './transport.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAG/C,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAElD,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AAE/C,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAA;AAErD,OAAO,EACL,WAAW,EACX,UAAU,EACV,gBAAgB,EAChB,oBAAoB,EACpB,eAAe,EACf,WAAW,EACX,YAAY,EACZ,gBAAgB,EAChB,QAAQ,GACT,MAAM,gBAAgB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAQ/C,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAElD,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AAE/C,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAA;AAErD,OAAO,EACL,WAAW,EACX,mBAAmB,EACnB,UAAU,EACV,gBAAgB,EAChB,oBAAoB,EACpB,eAAe,EACf,WAAW,EACX,YAAY,EACZ,gBAAgB,EAChB,QAAQ,GACT,MAAM,gBAAgB,CAAA"}

package/dist/source.d.ts

@@ -47,14 +47,76 @@
  */
 import type { PublicClient } from 'viem';
 import type { BlockResult, Capabilities, FeeHistoryResult, NormalizedMempool, PollOptions, RawTx, TransactionReceipt } from './types.js';
+/**
+ * Logger callback shape — single function, level + message + optional
+ * meta. Caller decides routing and formatting; the toolkit just calls
+ * it at the decision points it cares about. Same shape used on
+ * `createChainSource` and `createTxTracker` so consumers wire one
+ * callback for both.
+ */
+export type Logger = (level: 'debug' | 'info' | 'warn' | 'error', message: string, meta?: Record<string, unknown>) => void;
+/**
+ * Tuning knobs for the v0.16+ adaptive tick scheduler. Replaces the
+ * dumb-interval `setInterval` from v0.15 and earlier. The new loop
+ * schedules each subsequent tick based on the chain's measured block
+ * time + a backoff schedule when the head hasn't moved on time.
+ *
+ * Default behavior (everything `undefined`): the source estimates
+ * block time on `start()` via `latest` + `latest - 256`. After each
+ * successful head-move, the next tick is scheduled at
+ * `estimatedBlockTimeMs` from now. When a tick fires and the head
+ * hasn't moved, the next interval applies exponential backoff
+ * (`retryInitialMs * 2^attempts`, capped at `retryMaxMs`) until the
+ * head moves again, then resets.
+ *
+ * For chains where block-time estimation fails (no historical depth,
+ * gated `eth_getBlockByNumber`), the scheduler falls back to the
+ * static `pollIntervalMs` and runs the v0.15 cadence — no regression
+ * from the prior behavior.
+ */
+export interface AdaptivePollOptions {
+    /**
+     * Number of blocks to sample when estimating block time at start.
+     * Default 256. Larger = smoother estimate, but reaches farther
+     * back where actual block time may have changed. Smaller = fresher
+     * but noisier.
+     */
+    estimationLookbackBlocks?: number;
+    /**
+     * Initial backoff in ms when the head doesn't move on the expected
+     * tick. Default 2_000. Doubles on each subsequent miss until
+     * capped at `retryMaxMs`.
+     */
+    retryInitialMs?: number;
+    /**
+     * Cap on the exponential retry backoff. Default 30_000. The
+     * scheduler never waits longer than this between attempts on a
+     * stuck head.
+     */
+    retryMaxMs?: number;
+    /**
+     * Set `false` to disable the adaptive scheduler entirely and use
+     * `pollIntervalMs` for every tick (matches v0.15 behavior). Default
+     * `true`. Useful for testing or for consumers who prefer dumb-
+     * interval semantics.
+     */
+    enabled?: boolean;
+}
 export interface CreateChainSourceOptions {
     /** viem PublicClient pointed at the upstream RPC. */
     client: PublicClient;
     /**
-     * Polling interval in ms when push subscriptions aren't available
-     * (or aren't preferred). Default 10_000.
+     * Polling interval in ms used as a fallback when adaptive scheduling
+     * is disabled OR when block-time estimation fails (e.g. RPC gates
+     * the historical lookup). Default 10_000.
      */
     pollIntervalMs?: number;
+    /**
+     * Adaptive scheduler knobs. See {@link AdaptivePollOptions}. Default
+     * behavior is adaptive on with sensible defaults; pass
+     * `{ enabled: false }` to revert to v0.15 dumb-interval behavior.
+     */
+    adaptivePolling?: AdaptivePollOptions;
     /**
      * Producer-side toggles: which RPCs the source's tick fans out.
      * Disabling `mempool` here disables `subscribeMempool` for every
@@ -70,6 +132,15 @@ export interface CreateChainSourceOptions {
      * (the source keeps running on partial data).
      */
     onError?: (method: string, err: unknown) => void;
+    /**
+     * Optional logger callback. See {@link Logger}. Receives non-fatal
+     * observability events the consumer might want to surface: capability
+     * probe outcomes, adaptive scheduler decisions, subscription
+     * lifecycle, head-probe-gate skips. Errors continue to flow through
+     * `onError`; the logger handles the "what's the source doing right
+     * now" question.
+     */
+    logger?: Logger;
 }
 export interface ChainSource {
     /** Begin the poll loop. Idempotent. */

package/dist/source.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"source.d.ts","sourceRoot":"","sources":["../src/source.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,MAAM,CAAA;AAcxC,OAAO,KAAK,EACV,WAAW,EACX,YAAY,EACZ,gBAAgB,EAChB,iBAAiB,EACjB,WAAW,EACX,KAAK,EACL,kBAAkB,EACnB,MAAM,YAAY,CAAA;AAoBnB,MAAM,WAAW,wBAAwB;IACvC,qDAAqD;IACrD,MAAM,EAAE,YAAY,CAAA;IACpB;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB;;;;;;;OAOG;IACH,IAAI,CAAC,EAAE,WAAW,CAAA;IAClB;;;;OAIG;IACH,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,KAAK,IAAI,CAAA;CACjD;AAED,MAAM,WAAW,WAAW;IAC1B,uCAAuC;IACvC,KAAK,EAAE,MAAM,IAAI,CAAA;IACjB,+EAA+E;IAC/E,IAAI,EAAE,MAAM,IAAI,CAAA;IAChB;;;;;;;;;;OAUG;IACH,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IAC7B;;;;;OAKG;IACH,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IAC1B,mEAAmE;IACnE,eAAe,EAAE,CAAC,EAAE,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,KAAK,MAAM,IAAI,CAAA;IACjE,oEAAoE;IACpE,gBAAgB,EAAE,CAAC,EAAE,EAAE,CAAC,QAAQ,EAAE,iBAAiB,KAAK,IAAI,KAAK,MAAM,IAAI,CAAA;IAC3E,2DAA2D;IAC3D,QAAQ,EAAE,CAAC,GAAG,EAAE,QAAQ,GAAG,MAAM,KAAK,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAAA;IACjE;;;;;;;OAOG;IACH,cAAc,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAAA;IAC7D,8BAA8B;IAC9B,aAAa,EAAE,CACb,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EAAE,KAClB,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAA;IACrC;;;;;OAKG;IACH,kBAAkB,EAAE,MAAM,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAAA;IAC3D,qCAAqC;IACrC,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAAA;IAChE,4EAA4E;IAC5E,cAAc,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC,CAAA;IACvD,yCAAyC;IACzC,YAAY,EAAE,MAAM,YAAY,CAAA;CACjC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,iBAAiB,GAC5B,SAAS,wBAAwB,KAChC,WAmUF,CAAA"}
+{"version":3,"file":"source.d.ts","sourceRoot":"","sources":["../src/source.ts"],"names":[],"mappings":"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"}

package/dist/source.js

@@ -48,7 +48,7 @@
 import { probeCapabilities } from './capabilities.js';
 import { normalizeMempool } from './mempool.js';
 import { Subscriptions } from './subscriptions.js';
-import { fetchBlock, fetchBlockByHash, fetchFeeHistory, fetchHeadBlockNumber, fetchReceipt, fetchTransaction, fetchTxPool, } from './transport.js';
+import { estimateBlockTimeMs, fetchBlock, fetchBlockByHash, fetchFeeHistory, fetchHeadBlockNumber, fetchReceipt, fetchTransaction, fetchTxPool, } from './transport.js';
 const DEFAULT_POLL_INTERVAL_MS = 10000;
 /**
  * Conservative capability default returned by `capabilities()` before
@@ -64,6 +64,7 @@ const PROBING_DEFAULT = {
     txpoolContent: 'gated',
     receiptByHash: 'unavailable',
     reprobeOnReconnect: false,
+    ready: false,
 };
 /**
  * Build a configured chain-source. The eager capability probe starts
@@ -86,11 +87,32 @@ const PROBING_DEFAULT = {
 export const createChainSource = (options) => {
     const pollIntervalMs = options.pollIntervalMs ?? DEFAULT_POLL_INTERVAL_MS;
     const fetchMempool = options.poll?.mempool !== false;
+    const adaptive = options.adaptivePolling;
+    const adaptiveEnabled = adaptive?.enabled !== false;
+    const estimationLookbackBlocks = adaptive?.estimationLookbackBlocks ?? 256;
+    const retryInitialMs = adaptive?.retryInitialMs ?? 2000;
+    const retryMaxMs = adaptive?.retryMaxMs ?? 30000;
+    // `log` always callable; consumers can omit `logger` without us
+    // peppering the code with optional-chaining. The toolkit calls this
+    // at narrowly-chosen points — see DEV_NOTES in the module docstring
+    // for the policy.
+    const log = options.logger ?? (() => { });
     const blockSubs = new Subscriptions();
     const mempoolSubs = new Subscriptions();
+    // The adaptive scheduler uses recursive setTimeout; the static
+    // fallback uses setInterval. We hold a single handle and clear
+    // whichever type was set on stop().
     let timer = null;
+    let timerKind = null;
     let started = false;
     let cachedCapabilities = PROBING_DEFAULT;
+    // Adaptive scheduler state. `estimatedBlockTimeMs` is `null` until
+    // estimation completes (or never, if estimation fails — the
+    // scheduler then falls back to `pollIntervalMs`). `retryAttempts`
+    // tracks consecutive head-didn't-move ticks for exponential backoff;
+    // resets to 0 on every successful head-move.
+    let estimatedBlockTimeMs = null;
+    let retryAttempts = 0;
     /**
      * Narrow the viem transport to its WebSocket-specific `subscribe` shape once.
      * viem's `Transport` type does not model this method; we structurally narrow
@@ -163,9 +185,13 @@ export const createChainSource = (options) => {
                 onData: () => void handleHeadNotification(),
                 onError: (err) => options.onError?.('eth_subscribe.newHeads', err),
             });
+            log('info', 'WS subscription opened', { type: 'newHeads' });
         }
         catch (err) {
             options.onError?.('eth_subscribe.newHeads', err);
+            log('warn', 'WS subscription failed; falling back to poll', {
+                type: 'newHeads',
+            });
             cachedCapabilities = { ...cachedCapabilities, newHeads: 'poll-only' };
         }
     };
@@ -234,9 +260,15 @@ export const createChainSource = (options) => {
                 },
                 onError: (err) => options.onError?.('eth_subscribe.newPendingTransactions', err),
             });
+            log('info', 'WS subscription opened', {
+                type: 'newPendingTransactions',
+            });
         }
         catch (err) {
             options.onError?.('eth_subscribe.newPendingTransactions', err);
+            log('warn', 'WS subscription failed; falling back to poll', {
+                type: 'newPendingTransactions',
+            });
             cachedCapabilities = {
                 ...cachedCapabilities,
                 newPendingTransactions: cachedCapabilities.txpoolContent === 'available'
@@ -250,7 +282,17 @@ export const createChainSource = (options) => {
     const readyPromise = probeCapabilities(options.client, {
         onError: options.onError,
     }).then((caps) => {
-        cachedCapabilities = caps;
+        // Flip `ready` to true on first probe completion. Subsequent
+        // re-probes (WS reconnect) preserve `ready: true` — the probe
+        // updates field values in place, no flipping back to "probing"
+        // since downstream gates would briefly stall.
+        cachedCapabilities = { ...caps, ready: true };
+        log('info', 'capability probe complete', {
+            newHeads: caps.newHeads,
+            newPendingTransactions: caps.newPendingTransactions,
+            txpoolContent: caps.txpoolContent,
+            receiptByHash: caps.receiptByHash,
+        });
     });
     // One poll cycle. Cheap `eth_blockNumber` probe + (optionally)
     // mempool fetch in parallel; if the probe shows the head has
@@ -276,6 +318,13 @@ export const createChainSource = (options) => {
         const block = headChanged
             ? await fetchBlock(options.client, 'latest', errSink('eth_getBlockByNumber'))
             : null;
+        // Track whether we actually saw a new canonical head this tick.
+        // The scheduler uses this to decide between the expected-block-
+        // time interval and the retry-backoff interval. We treat
+        // `headChanged && block !== null && block.hash !== lastEmittedBlockHash`
+        // as the "real head moved" criterion — the cheap eth_blockNumber
+        // probe alone isn't enough since it could be transiently wrong.
+        let headMoved = false;
         if (block) {
             // Update the gate state from the actually-fetched block, not
             // from the probe's number — keeps the gate consistent with
@@ -289,6 +338,7 @@ export const createChainSource = (options) => {
             }
             if (block.hash !== lastEmittedBlockHash) {
                 lastEmittedBlockHash = block.hash;
+                headMoved = true;
                 blockSubs.emit(block);
             }
         }
@@ -298,19 +348,108 @@ export const createChainSource = (options) => {
         if (txPool && fetchMempool) {
             mempoolSubs.emit(normalizeMempool(txPool));
         }
+        return { headMoved };
+    };
+    /**
+     * Adaptive scheduler — computes the next tick delay from current
+     * state and runs the tick. Recursive `setTimeout` chain rather than
+     * `setInterval` so we can pick a fresh delay each iteration based on
+     * whether the head moved.
+     *
+     * Delay rules:
+     *
+     *   - Head moved this tick → reset `retryAttempts = 0` and schedule
+     *     next at `estimatedBlockTimeMs` (or `pollIntervalMs` if
+     *     estimation failed).
+     *   - Head didn't move → increment `retryAttempts`, schedule next at
+     *     `min(retryInitialMs * 2^(retryAttempts-1), retryMaxMs)`.
+     *
+     * The exponential backoff hits the user's "request at t=10, retry at
+     * t=12 if nothing changed" pattern. With the default
+     * `retryInitialMs: 2000`, retry intervals are 2s → 4s → 8s → 16s →
+     * 30s (capped). Most chains recover well within the first 1-2
+     * retries; the cap protects against runaway tickers on a stalled
+     * chain.
+     */
+    const runAdaptiveTickAndSchedule = async () => {
+        // `tick()` is engineered to never throw — its inner fetches go
+        // through `safeRequest` (catches transport errors), `BigInt(...)`
+        // calls sit inside inner try/catch arms, and the `Subscriptions`
+        // pub/sub helper swallows per-subscriber throws. Wrapping the
+        // await in another try/catch would mask future regressions; if a
+        // change ever does cause tick to throw, we'd rather see the
+        // unhandled-rejection trail than silently retry under cover.
+        const result = await tick();
+        // `started` may have flipped to false during the await — `stop()`
+        // ran while the tick's inner fetches were in flight. Bailing here
+        // prevents the tick's already-mutated state from triggering a
+        // new setTimeout chain that races stop()'s cleared timer.
+        if (!started)
+            return;
+        let nextMs;
+        if (result.headMoved) {
+            retryAttempts = 0;
+            nextMs = estimatedBlockTimeMs ?? pollIntervalMs;
+            log('debug', 'tick: head moved, scheduling next at expected block time', {
+                nextMs,
+                usingEstimate: estimatedBlockTimeMs !== null,
+            });
+        }
+        else {
+            retryAttempts += 1;
+            const exp = retryInitialMs * Math.pow(2, retryAttempts - 1);
+            nextMs = Math.min(exp, retryMaxMs);
+            log('debug', 'tick: head did not move, backing off', {
+                attempt: retryAttempts,
+                nextMs,
+            });
+        }
+        timer = setTimeout(() => {
+            void runAdaptiveTickAndSchedule();
+        }, nextMs);
+        timerKind = 'timeout';
     };
     return {
         start: () => {
             if (started)
                 return;
             started = true;
-            // Fire the first tick immediately so consumers don't wait one
-            // full interval for their first event. The interval timer
-            // takes over from there.
-            void tick();
-            timer = setInterval(() => {
+            log('info', 'chain-source started', {
+                pollIntervalMs,
+                adaptiveEnabled,
+            });
+            if (adaptiveEnabled) {
+                // Kick off block-time estimation in parallel with the first
+                // tick. The first few ticks use `pollIntervalMs` (since
+                // `estimatedBlockTimeMs` is null until the estimate resolves);
+                // once estimation lands, subsequent ticks pick it up
+                // automatically because the scheduler reads the variable each
+                // iteration.
+                void estimateBlockTimeMs(options.client, estimationLookbackBlocks, options.onError).then((estimate) => {
+                    if (estimate !== null) {
+                        estimatedBlockTimeMs = estimate;
+                        log('info', 'block time estimated', {
+                            estimatedBlockTimeMs: estimate,
+                            lookbackBlocks: estimationLookbackBlocks,
+                        });
+                    }
+                    else {
+                        log('warn', 'block time estimation failed; using pollIntervalMs fallback', { pollIntervalMs });
+                    }
+                });
+                // Fire the first tick immediately so consumers don't wait one
+                // full interval for their first event. The scheduler chain
+                // takes over from there.
+                void runAdaptiveTickAndSchedule();
+            }
+            else {
+                // Legacy dumb-interval path — kept as an explicit opt-out.
                 void tick();
-            }, pollIntervalMs);
+                timer = setInterval(() => {
+                    void tick();
+                }, pollIntervalMs);
+                timerKind = 'interval';
+            }
             // Open WS subscribes lazily once the probe has landed. Fire-and-
             // forget; failures fall through to the existing poll loop.
             void readyPromise.then(() => tryOpenBlockSubscription());
@@ -336,8 +475,14 @@ export const createChainSource = (options) => {
                 mempoolSubscriptionHandle = null;
             }
             if (timer !== null) {
-                clearInterval(timer);
+                if (timerKind === 'interval') {
+                    clearInterval(timer);
+                }
+                else {
+                    clearTimeout(timer);
+                }
                 timer = null;
+                timerKind = null;
             }
             started = false;
             // Subscriber registry is intentionally preserved across stop —
@@ -350,8 +495,11 @@ export const createChainSource = (options) => {
             // (or reorged) during the pause.
             lastEmittedBlockHash = undefined;
             lastSeenBlockNumber = undefined;
+            // Retry attempts reset too — a fresh start shouldn't carry over
+            // backoff state from a paused session.
+            retryAttempts = 0;
         },
-        pollOnce: () => tick(),
+        pollOnce: () => tick().then(() => undefined),
         ready: () => readyPromise,
         subscribeBlocks: (cb) => blockSubs.subscribe(cb),
         subscribeMempool: (cb) => mempoolSubs.subscribe(cb),

package/dist/source.js.map

@@ -1 +1 @@
-{"version":3,"file":"source.js","sourceRoot":"","sources":["../src/source.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"source.js","sourceRoot":"","sources":["../src/source.ts"],"names":[],"mappings":"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"}

package/dist/transport.d.ts

@@ -95,4 +95,34 @@ export declare const fetchReceipt: (client: PublicClient, hash: string, onError?
  * tracker can detect a different hash with the same nonce mining).
  */
 export declare const fetchTransaction: (client: PublicClient, hash: string, onError?: (err: unknown) => void) => Promise<RawTx | null>;
+/**
+ * Estimate the average block time (ms/block) by sampling `latest` and
+ * `latest - lookback`. Returns null when either fetch fails, the
+ * sampled blocks don't decode, or the computed interval is non-positive
+ * (consumer is responsible for falling back to a static interval).
+ *
+ * Why this exists: the v0.15 source polled on a fixed `pollIntervalMs`,
+ * which is wasteful on chains where the actual block time is known —
+ * a tick that fires during the expected gap between blocks just hits
+ * `eth_blockNumber` to learn nothing has changed. The v0.16 adaptive
+ * scheduler uses this estimate to time the next tick around the
+ * expected next-block moment, with backoff retries when the head
+ * doesn't move on schedule.
+ *
+ * Implementation notes:
+ *
+ * - Both blocks fetched with `fullTransactions: false` (false because
+ *   we only need `number` + `timestamp`; the full tx list would be
+ *   wasted bytes). The shape we deserialize keeps only those two
+ *   fields rather than the full BlockResult.
+ * - 256 is the default lookback. Larger samples smooth out short-term
+ *   variance (mempool turmoil, validator outages) but stretch farther
+ *   back where average block time may have actually changed. For
+ *   chains with sub-block-second cadence (some L2s), the caller may
+ *   want a larger lookback; for chains with very slow blocks
+ *   (Bitcoin-style), smaller.
+ * - The same `onError` sink the consumer wires for other RPC calls
+ *   gets invoked here, tagged with the appropriate method name.
+ */
+export declare const estimateBlockTimeMs: (client: PublicClient, lookback?: number, onError?: (method: string, err: unknown) => void) => Promise<number | null>;
 //# sourceMappingURL=transport.d.ts.map

package/dist/transport.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../src/transport.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,MAAM,CAAA;AAExC,OAAO,KAAK,EACV,WAAW,EACX,gBAAgB,EAChB,KAAK,EACL,kBAAkB,EAClB,aAAa,EACd,MAAM,YAAY,CAAA;AAEnB,uEAAuE;AACvE,eAAO,MAAM,QAAQ,QAAyB,CAAA;AAE9C;;;;;;GAMG;AACH,eAAO,MAAM,WAAW,GAAU,CAAC,EACjC,QAAQ,YAAY,EACpB,QAAQ,MAAM,EACd,QAAQ,OAAO,EAAE,EACjB,UAAU,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,KAC/B,OAAO,CAAC,CAAC,GAAG,IAAI,CAWlB,CAAA;AAKD;;;;;;;;;GASG;AACH,eAAO,MAAM,oBAAoB,GAC/B,QAAQ,YAAY,EACpB,UAAU,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,KAC/B,OAAO,CAAC,MAAM,GAAG,IAAI,CAQvB,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,UAAU,GACrB,QAAQ,YAAY,EACpB,KAAK,QAAQ,GAAG,MAAM,EACtB,UAAU,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,KAC/B,OAAO,CAAC,WAAW,GAAG,IAAI,CAM1B,CAAA;AAEH;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,gBAAgB,GAC3B,QAAQ,YAAY,EACpB,MAAM,MAAM,EACZ,UAAU,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,KAC/B,OAAO,CAAC,WAAW,GAAG,IAAI,CAM1B,CAAA;AAEH;;;;GAIG;AACH,eAAO,MAAM,eAAe,GAC1B,QAAQ,YAAY,EACpB,YAAY,MAAM,EAClB,aAAa,MAAM,EAAE,EACrB,UAAU,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,KAC/B,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAM/B,CAAA;AAEH;;;;;GAKG;AACH,eAAO,MAAM,WAAW,GACtB,QAAQ,YAAY,EACpB,UAAU,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,KAC/B,OAAO,CAAC,aAAa,GAAG,IAAI,CACoC,CAAA;AAEnE;;;;GAIG;AACH,eAAO,MAAM,YAAY,GACvB,QAAQ,YAAY,EACpB,MAAM,MAAM,EACZ,UAAU,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,KAC/B,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAMjC,CAAA;AAEH;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,GAC3B,QAAQ,YAAY,EACpB,MAAM,MAAM,EACZ,UAAU,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,KAC/B,OAAO,CAAC,KAAK,GAAG,IAAI,CACkD,CAAA"}
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../src/transport.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,MAAM,CAAA;AAExC,OAAO,KAAK,EACV,WAAW,EACX,gBAAgB,EAChB,KAAK,EACL,kBAAkB,EAClB,aAAa,EACd,MAAM,YAAY,CAAA;AAEnB,uEAAuE;AACvE,eAAO,MAAM,QAAQ,QAAyB,CAAA;AAE9C;;;;;;GAMG;AACH,eAAO,MAAM,WAAW,GAAU,CAAC,EACjC,QAAQ,YAAY,EACpB,QAAQ,MAAM,EACd,QAAQ,OAAO,EAAE,EACjB,UAAU,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,KAC/B,OAAO,CAAC,CAAC,GAAG,IAAI,CAWlB,CAAA;AAKD;;;;;;;;;GASG;AACH,eAAO,MAAM,oBAAoB,GAC/B,QAAQ,YAAY,EACpB,UAAU,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,KAC/B,OAAO,CAAC,MAAM,GAAG,IAAI,CAQvB,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,UAAU,GACrB,QAAQ,YAAY,EACpB,KAAK,QAAQ,GAAG,MAAM,EACtB,UAAU,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,KAC/B,OAAO,CAAC,WAAW,GAAG,IAAI,CAM1B,CAAA;AAEH;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,gBAAgB,GAC3B,QAAQ,YAAY,EACpB,MAAM,MAAM,EACZ,UAAU,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,KAC/B,OAAO,CAAC,WAAW,GAAG,IAAI,CAM1B,CAAA;AAEH;;;;GAIG;AACH,eAAO,MAAM,eAAe,GAC1B,QAAQ,YAAY,EACpB,YAAY,MAAM,EAClB,aAAa,MAAM,EAAE,EACrB,UAAU,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,KAC/B,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAM/B,CAAA;AAEH;;;;;GAKG;AACH,eAAO,MAAM,WAAW,GACtB,QAAQ,YAAY,EACpB,UAAU,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,KAC/B,OAAO,CAAC,aAAa,GAAG,IAAI,CACoC,CAAA;AAEnE;;;;GAIG;AACH,eAAO,MAAM,YAAY,GACvB,QAAQ,YAAY,EACpB,MAAM,MAAM,EACZ,UAAU,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,KAC/B,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAMjC,CAAA;AAEH;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,GAC3B,QAAQ,YAAY,EACpB,MAAM,MAAM,EACZ,UAAU,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,KAC/B,OAAO,CAAC,KAAK,GAAG,IAAI,CACkD,CAAA;AAEzE;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,eAAO,MAAM,mBAAmB,GAC9B,QAAQ,YAAY,EACpB,WAAU,MAAY,EACtB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,KAAK,IAAI,KAC/C,OAAO,CAAC,MAAM,GAAG,IAAI,CAyDvB,CAAA"}

package/dist/transport.js

@@ -117,4 +117,81 @@ export const fetchReceipt = async (client, hash, onError) => safeRequest(client,
  * tracker can detect a different hash with the same nonce mining).
  */
 export const fetchTransaction = async (client, hash, onError) => safeRequest(client, 'eth_getTransactionByHash', [hash], onError);
+/**
+ * Estimate the average block time (ms/block) by sampling `latest` and
+ * `latest - lookback`. Returns null when either fetch fails, the
+ * sampled blocks don't decode, or the computed interval is non-positive
+ * (consumer is responsible for falling back to a static interval).
+ *
+ * Why this exists: the v0.15 source polled on a fixed `pollIntervalMs`,
+ * which is wasteful on chains where the actual block time is known —
+ * a tick that fires during the expected gap between blocks just hits
+ * `eth_blockNumber` to learn nothing has changed. The v0.16 adaptive
+ * scheduler uses this estimate to time the next tick around the
+ * expected next-block moment, with backoff retries when the head
+ * doesn't move on schedule.
+ *
+ * Implementation notes:
+ *
+ * - Both blocks fetched with `fullTransactions: false` (false because
+ *   we only need `number` + `timestamp`; the full tx list would be
+ *   wasted bytes). The shape we deserialize keeps only those two
+ *   fields rather than the full BlockResult.
+ * - 256 is the default lookback. Larger samples smooth out short-term
+ *   variance (mempool turmoil, validator outages) but stretch farther
+ *   back where average block time may have actually changed. For
+ *   chains with sub-block-second cadence (some L2s), the caller may
+ *   want a larger lookback; for chains with very slow blocks
+ *   (Bitcoin-style), smaller.
+ * - The same `onError` sink the consumer wires for other RPC calls
+ *   gets invoked here, tagged with the appropriate method name.
+ */
+export const estimateBlockTimeMs = async (client, lookback = 256, onError) => {
+    // Validate the caller's lookback up front — a zero or negative value
+    // would divide-by-zero or invert the math below. Better to fail
+    // cheaply here than mint Infinity / negative durations downstream.
+    if (!Number.isInteger(lookback) || lookback <= 0)
+        return null;
+    const sinkLatest = onError
+        ? (err) => onError('eth_getBlockByNumber:latest', err)
+        : undefined;
+    const latest = await safeRequest(client, 'eth_getBlockByNumber', ['latest', false], sinkLatest);
+    if (!latest || !latest.number || !latest.timestamp)
+        return null;
+    let latestNumber;
+    let latestTs;
+    try {
+        latestNumber = BigInt(latest.number);
+        latestTs = BigInt(latest.timestamp);
+    }
+    catch {
+        return null;
+    }
+    // The target block must exist. If lookback overshoots genesis,
+    // clamp to a positive height; if that's still 0 we can't sample.
+    const targetHeight = latestNumber - BigInt(lookback);
+    if (targetHeight <= 0n)
+        return null;
+    const sinkOld = onError
+        ? (err) => onError('eth_getBlockByNumber:lookback', err)
+        : undefined;
+    const old = await safeRequest(client, 'eth_getBlockByNumber', [`0x${targetHeight.toString(16)}`, false], sinkOld);
+    if (!old || !old.number || !old.timestamp)
+        return null;
+    let oldTs;
+    try {
+        oldTs = BigInt(old.timestamp);
+    }
+    catch {
+        return null;
+    }
+    if (latestTs <= oldTs)
+        return null;
+    // Both block timestamps are in seconds; convert to ms and divide by
+    // the lookback span (always `lookback` blocks since we asked by
+    // height — no gaps possible). Earlier guards ensure deltaSeconds > 0
+    // and lookback > 0, so `ms` is always a finite positive number.
+    const deltaSeconds = Number(latestTs - oldTs);
+    return (deltaSeconds * 1000) / lookback;
+};
 //# sourceMappingURL=transport.js.map

package/dist/transport.js.map

@@ -1 +1 @@
-{"version":3,"file":"transport.js","sourceRoot":"","sources":["../src/transport.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"transport.js","sourceRoot":"","sources":["../src/transport.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -166,5 +166,23 @@ export interface Capabilities {
     receiptByHash: 'available' | 'unavailable';
     /** Whether transport reconnection re-probes (WS reconnect, etc.). */
     reprobeOnReconnect: boolean;
+    /**
+     * `false` while the initial capability probe is in flight, `true` after
+     * it resolves (and stays `true` across `reprobeOnReconnect` re-probes —
+     * a re-probe updates field values in place without flipping back to
+     * `false`). Optional for backward compat — synthetic `Capabilities`
+     * literals in tests and consumer-side stubs that omit it should be
+     * read as "probe already completed" (i.e. authoritative field values).
+     *
+     * The conservative pre-probe defaults set every capability to its
+     * least-authoritative value, so a downstream gate like
+     * `caps.receiptByHash !== 'available'` cannot distinguish "the probe
+     * hasn't finished" from "the upstream RPC genuinely doesn't expose
+     * this method." Use `caps.ready === false` (loose-equality on the
+     * specific value) to skip such gates silently while the probe is in
+     * flight; once `ready === true` (or `undefined`, in synthetic
+     * literals), the field values are authoritative.
+     */
+    ready?: boolean;
 }
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,KAAK;IACpB,oBAAoB,CAAC,EAAE,MAAM,CAAA;IAC7B,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,aAAa,EAAE,MAAM,EAAE,CAAA;IACvB,MAAM,CAAC,EAAE,MAAM,EAAE,EAAE,CAAA;IACnB,YAAY,EAAE,MAAM,EAAE,CAAA;IACtB,WAAW,EAAE,MAAM,CAAA;CACpB;AAED;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,SAAS,EAAE,MAAM,CAAA;IACjB,aAAa,EAAE,MAAM,CAAA;IACrB,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,MAAM,CAAA;IACf,YAAY,EAAE,KAAK,EAAE,CAAA;IACrB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED;;;;;;;;;;GAUG;AACH,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAA;IAC9C,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAA;CAC9C;AAED;;;;;GAKG;AACH,MAAM,MAAM,iBAAiB,GAAG,aAAa,CAAA;AAE7C;;;;;;GAMG;AACH,MAAM,WAAW,kBAAkB;IACjC,eAAe,EAAE,MAAM,CAAA;IACvB,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW,EAAE,MAAM,CAAA;IACnB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACvB;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,WAAW;IAC1B,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,MAAM,WAAW,GACnB,cAAc,GACd,YAAY,GACZ,kBAAkB,GAClB,cAAc,CAAA;AAElB;;;;;;;;;;GAUG;AACH,MAAM,WAAW,YAAY;IAC3B,+DAA+D;IAC/D,QAAQ,EAAE,cAAc,GAAG,WAAW,GAAG,aAAa,CAAA;IACtD,4EAA4E;IAC5E,sBAAsB,EAAE,cAAc,GAAG,WAAW,GAAG,aAAa,CAAA;IACpE,oEAAoE;IACpE,aAAa,EAAE,WAAW,GAAG,OAAO,CAAA;IACpC,qEAAqE;IACrE,aAAa,EAAE,WAAW,GAAG,aAAa,CAAA;IAC1C,qEAAqE;IACrE,kBAAkB,EAAE,OAAO,CAAA;CAC5B"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,KAAK;IACpB,oBAAoB,CAAC,EAAE,MAAM,CAAA;IAC7B,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,aAAa,EAAE,MAAM,EAAE,CAAA;IACvB,MAAM,CAAC,EAAE,MAAM,EAAE,EAAE,CAAA;IACnB,YAAY,EAAE,MAAM,EAAE,CAAA;IACtB,WAAW,EAAE,MAAM,CAAA;CACpB;AAED;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,SAAS,EAAE,MAAM,CAAA;IACjB,aAAa,EAAE,MAAM,CAAA;IACrB,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,MAAM,CAAA;IACf,YAAY,EAAE,KAAK,EAAE,CAAA;IACrB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED;;;;;;;;;;GAUG;AACH,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAA;IAC9C,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAA;CAC9C;AAED;;;;;GAKG;AACH,MAAM,MAAM,iBAAiB,GAAG,aAAa,CAAA;AAE7C;;;;;;GAMG;AACH,MAAM,WAAW,kBAAkB;IACjC,eAAe,EAAE,MAAM,CAAA;IACvB,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW,EAAE,MAAM,CAAA;IACnB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACvB;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,WAAW;IAC1B,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,MAAM,WAAW,GACnB,cAAc,GACd,YAAY,GACZ,kBAAkB,GAClB,cAAc,CAAA;AAElB;;;;;;;;;;GAUG;AACH,MAAM,WAAW,YAAY;IAC3B,+DAA+D;IAC/D,QAAQ,EAAE,cAAc,GAAG,WAAW,GAAG,aAAa,CAAA;IACtD,4EAA4E;IAC5E,sBAAsB,EAAE,cAAc,GAAG,WAAW,GAAG,aAAa,CAAA;IACpE,oEAAoE;IACpE,aAAa,EAAE,WAAW,GAAG,OAAO,CAAA;IACpC,qEAAqE;IACrE,aAAa,EAAE,WAAW,GAAG,aAAa,CAAA;IAC1C,qEAAqE;IACrE,kBAAkB,EAAE,OAAO,CAAA;IAC3B;;;;;;;;;;;;;;;;OAgBG;IACH,KAAK,CAAC,EAAE,OAAO,CAAA;CAChB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@valve-tech/chain-source",
-  "version": "0.14.0",
+  "version": "0.16.0",
   "description": "Canonical EVM chain-observation primitive: a unified push-or-poll source for new blocks, mempool snapshots, on-demand receipt + tx lookups, and capability disclosure (HTTP / WS / per-method gating). Used as the shared foundation by @valve-tech/gas-oracle and @valve-tech/tx-tracker; consumable directly by anyone building their own derived view on chain state. viem-native. Part of the valve-tech/evm-toolkit synchronized release line — implementation lands in subsequent 0.3.x releases per docs/tx-tracker-spec.md.",
   "license": "MIT",
   "homepage": "https://github.com/valve-tech/evm-toolkit/tree/main/packages/chain-source#readme",