@somnia-chain/markets-sdk / index / ObservedReads

Interface: ObservedReads

Defined in: packages/sdk/src/observedReads.ts:164

Owner-derived observations sharing one independent head. Create a new capability to refresh that head. Each read captures its own response metadata. Concurrent reads cannot replace older observations. Owner/caller cancellation retains its abort reason. The capability has no polling or separate transport.

Properties

independentHead

readonly independentHead: IndependentHead

Defined in: packages/sdk/src/observedReads.ts:166

The independently measured head shared by these reads.

Methods

read()

read<K>(request): Promise<ObservedReadResult<Awaited<ReturnType<ObservedReadMethods[K]>>>>

Defined in: packages/sdk/src/observedReads.ts:176

Run one supported domain read with metadata from the same response.

Type Parameters

K

K extends ObservedReadOperation

Parameters

request

ObservedReadRequest<K>

Returns

Promise<ObservedReadResult<Awaited<ReturnType<ObservedReadMethods[K]>>>>

Throws

Indexer request or decoding failed.

Throws

Domain arguments or cursor are invalid.

Throws

A mixed-tier domain read needs missing chain configuration.

Throws

A mixed-tier chain read failed.

Throws

A mixed-tier contract read reverted.

Throws

A domain invariant failed.

batch()

batch<R>(requests): Promise<{ readonly [P in string | number | symbol]: ObservedReadResult<Awaited<ReturnType<ObservedReadMethods[R[P]["operation"]]>>> }>

Defined in: packages/sdk/src/observedReads.ts:189

Run several reads concurrently, sharing the head but not a database transaction. Result order matches request order. Each result keeps its own watermark and span.

Type Parameters

R

R extends readonly ObservedReadRequest<ObservedReadOperation>[]

Parameters

requests

R

Returns

Promise<{ readonly [P in string | number | symbol]: ObservedReadResult<Awaited<ReturnType<ObservedReadMethods[R[P]["operation"]]>>> }>

Throws

A member's indexer request failed.

Throws

A member's arguments are invalid.

Throws

A member needs missing chain configuration.

Throws

A member's chain read failed.

Throws

A member's contract read reverted.

Throws

A domain invariant failed.