live · mainnetoc · docs
specs · api · guides
docs / documentation

@orangecheck/nostr-core


@orangecheck/nostr-core / queryEvents

Function: queryEvents()

function queryEvents(
   filter: Filter, 
   relays?: readonly string[], 
timeoutMs?: number): Promise<QueryResult>;

Defined in: index.ts:301

Issue a NIP-01 REQ across all relays in parallel. Returns deduplicated events sorted newest-first plus per-relay status.

Default timeout 1500ms — short enough that a momentary blip on any one relay (including relay.ochk.io) never holds up the racing reads. Pass an explicit timeoutMs for slow filters or for use cases where waiting on the slowest relay matters.

Parameters

ParameterTypeDefault value
filterFilterundefined
relaysreadonly string[]DEFAULT_RELAYS
timeoutMsnumber1500

Returns

Promise&lt;QueryResult>