Function: readIndexerEvents()

readIndexerEvents(indexer, path, params): Promise<IndexerEventsPage>

Defined in: events.ts:449

GET <indexer.url>/<path>?<params> within the indexer's timeout and return its event page. The shared reader for every indexer listing (access_gate events here, sealed-content pointers in sealed-storage-client). The rows are untrusted: callers decode and type-check each one like a full-node event.

path must be relative to the indexer URL (no scheme, no leading //), redirects are refused and the body is size-capped while it is read.

A head page (no before param) must be fresh: its polledAt (epoch ms of the indexer's last successful poll) has to be a number no older than indexer.staleAfterMs (STALE_AFTER_MS), judged by this machine's clock; one up to CLOCK_SKEW_TOLERANCE_MS in the future counts as fresh. Older pages (with before) are immutable history and are not checked.

Parameters

indexer

IndexerSource

path

string

params

Record<string, string | undefined>

Returns

Promise<IndexerEventsPage>

Throws

if the URL is not https: (http: only for a loopback host), path leaves the indexer's origin, the request fails, is redirected or times out, the status is not 2xx, or the body is oversized, not JSON or not an event page, or a head page is stale (polledAt missing, null, old, or too far in the future).