@somnia-chain/markets-sdk


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

Type Alias: IndexedVenue

IndexedVenue = object

Defined in: packages/sdk/src/operatorAdmin.ts:506

A venue as the indexer sees it (mirror of the Venue entity).

Properties

venueId

venueId: string

Defined in: packages/sdk/src/operatorAdmin.ts:508

Opaque bytes32 venue id (== entity id); NOT a human label.


operatorId

operatorId: number

Defined in: packages/sdk/src/operatorAdmin.ts:510

The operator the venue belongs to.


marketType

marketType: string

Defined in: packages/sdk/src/operatorAdmin.ts:512

bytes4 market-type id the venue is pinned to, forever (hex).


feeParams

feeParams: string

Defined in: packages/sdk/src/operatorAdmin.ts:514

Type-specific fee params, opaque to the registry (bytes hex).


feeRecipientOverride

feeRecipientOverride: string

Defined in: packages/sdk/src/operatorAdmin.ts:516

Per-venue fee recipient override (lowercased); zero-address falls back to the operator's.


policy

policy: string

Defined in: packages/sdk/src/operatorAdmin.ts:518

Per-venue IVenuePolicy (lowercased); zero-address = none.


signer

signer: string

Defined in: packages/sdk/src/operatorAdmin.ts:520

Per-venue EIP-712 signer (lowercased); non-zero ⇒ creation requires a venue sig.


creationEnabled

creationEnabled: boolean

Defined in: packages/sdk/src/operatorAdmin.ts:522

Whether new markets may currently be created under the venue.


context

context: string

Defined in: packages/sdk/src/operatorAdmin.ts:527

Opaque venue-supplied metadata bytes (hex, 0x-prefixed; '0x' when empty). The chain attaches no semantics — off-chain data only.


createdAtTimestamp

createdAtTimestamp: string

Defined in: packages/sdk/src/operatorAdmin.ts:529

Timestamp (unix seconds) the venue was created.


updatedAtTimestamp

updatedAtTimestamp: string

Defined in: packages/sdk/src/operatorAdmin.ts:533

Timestamp (unix seconds) of the last update to the row. Somnia blocks are ~100ms, so roughly ten consecutive blocks share one value — use updatedAtBlock when you need to tell two writes apart.


updatedAtBlock

updatedAtBlock: bigint

Defined in: packages/sdk/src/operatorAdmin.ts:559

Block number of the last CONTROL-PLANE update to the row — NON-DECREASING, and finer-grained than the second-granularity timestamp beside it, which about ten consecutive Somnia blocks share.

Not every write to the row moves it, and a consumer must not read it as "the row was not written". The indexer stamps it on VenueCreated, VenueUpdated and VenueEnabledChanged — and on NO operator event. An ownership transfer or an operator update moves IndexedOperator.updatedAtBlock and leaves this marker exactly where it was, so do not difference a venue marker expecting to see one. It is NOT stamped on the denormalized rollups either — market counts, cumulative volume, collected fees — which rewrite the row with this column carried through unchanged.

It is not a write counter and does not identify a write: two updates in the SAME block carry the same number, so this distinguishes updates ACROSS blocks and nothing narrower. A consumer that must not miss a write in a single block needs the events, not this column.

bigint, unlike the raw-string columns beside it, because SDK-TYPE-007 requires protocol integers to be exact at the boundary — the generated wire string is mapped here rather than exposed. The neighbouring strings predate that seam.


marketCount

marketCount: number

Defined in: packages/sdk/src/operatorAdmin.ts:561

Number of markets created under the venue.


cumulativeQuoteVolume

cumulativeQuoteVolume: string

Defined in: packages/sdk/src/operatorAdmin.ts:563

Cumulative binary quote/collateral volume across the venue's markets (raw).


protocolFeesCollected

protocolFeesCollected: string

Defined in: packages/sdk/src/operatorAdmin.ts:565

Cumulative protocol fees collected across the venue's markets (raw).


settlementFeesCollected

settlementFeesCollected: string

Defined in: packages/sdk/src/operatorAdmin.ts:567

Cumulative settlement fees collected across the venue's markets (raw).


builderFeesCollected

builderFeesCollected: string

Defined in: packages/sdk/src/operatorAdmin.ts:569

Cumulative builder fees routed across the venue's markets (raw).