@secondlayer/sdk 6.33.1 → 6.35.0

package/dist/index.d.ts

@@ -574,9 +574,34 @@ type StreamsEventsSubscribeParams = {
 * It is the position to advance to: `next_cursor` normally, or the last
 * finalized event when `finalizedOnly` is set.
 */
-type StreamsBatchContext = {
+/**
+* What the loop knows at the end of a page, handed to `onBatch`.
+*
+* `cursor` is the position to commit. The rest answers "how far along am I,
+* and am I still moving" — the question every deployed consumer has to expose
+* for a health check.
+*
+* Progress is reported here rather than left to callers because only the loop
+* can get it right: `height` has to survive empty pages (normal at the tip)
+* and has to roll back to `fork_point_height - 1` after a reorg rewind.
+* Deriving it from `cursor` is wrong — `Cursor.atHeight` encodes the foot of a
+* block as `${height - 1}:<sentinel>`, so a rewound cursor parses to a
+* position that was never reached.
+*/
+type ConsumerBatchContext = {
+	/** Checkpoint to commit alongside your rows. */
 	cursor: string | null
-};
+	/** Highest canonical block the sweep has reached. `null` before the first
+	*  row of a fresh consume. */
+	height: number | null
+	/** Chain tip as of this page's read. */
+	tipHeight: number
+	/** `tipHeight - height`, floored at 0. `null` until `height` is known. */
+	blocksBehind: number | null
+};
+/** @deprecated Use {@link ConsumerBatchContext} — the Index and Streams loops
+*  share one shape now. Kept as an alias so existing annotations compile. */
+type StreamsBatchContext = ConsumerBatchContext;
 /**
 * The checkpoint for a reorg rollback. Persist `cursor` (the rewind position)
 * inside the same transaction as your rollback so the two commit atomically.
@@ -843,9 +868,7 @@ type IndexConsumeOptions<
 	*  never reorgs, so `onReorg` is skipped entirely. */
 	finalizedOnly?: boolean
 	batchSize?: number
-	onBatch: (items: TItem[], envelope: TEnvelope, ctx: {
-		cursor: string | null
-	}) => void | string | null | undefined | Promise<void> | Promise<string | null | undefined>
+	onBatch: (items: TItem[], envelope: TEnvelope, ctx: ConsumerBatchContext) => void | string | null | undefined | Promise<void> | Promise<string | null | undefined>
 	onReorg?: (reorg: IndexReorg, ctx: {
 		cursor: string
 	}) => Promise<void> | void
@@ -1084,19 +1107,27 @@ type IndexPrint = IndexEventBase & {
 /** Decoded chain event, discriminated by `event_type`. */
 type IndexEvent = IndexFtTransfer | IndexNftTransfer | IndexStxTransfer | IndexStxMint | IndexStxBurn | IndexStxLock | IndexFtMint | IndexFtBurn | IndexNftMint | IndexNftBurn | IndexPrint;
 type IndexEventType = IndexEvent["event_type"];
-type EventsEnvelope = {
-	events: IndexEvent[]
+type EventsEnvelope<T extends IndexEventType = IndexEventType> = {
+	events: IndexEventOf<T>[]
 	next_cursor: string | null
 	tip: IndexTip
 	reorgs: IndexReorg[]
 };
-type EventsListParams = {
-	/** Required. One of the decoded event types. */
-	eventType: IndexEventType
+/** The single decoded-event member matching one `event_type` literal.
+*  `IndexEventOf<"ft_transfer">` is `IndexFtTransfer`. */
+type IndexEventOf<T extends IndexEventType> = Extract<IndexEvent, {
+	event_type: T
+}>;
+type EventsListParams<T extends IndexEventType = IndexEventType> = {
+	/** Required. One of the decoded event types. Passing a literal narrows the
+	*  rows every surface hands back to that event's own shape. */
+	eventType: T
 	cursor?: string | null
 	fromCursor?: string | null
 	limit?: number
-	contractId?: string
+	/** One id, or several to scope the sweep to a set of contracts (max 20).
+	*  Mutually exclusive with `trait`. */
+	contractId?: string | readonly string[]
 	assetIdentifier?: string
 	sender?: string
 	recipient?: string
@@ -1111,11 +1142,11 @@ type EventsListParams = {
 	*  the only source of the submitting sender. */
 	txContext?: boolean
 };
-type EventsWalkParams = Omit<EventsListParams, "limit"> & {
+type EventsWalkParams<T extends IndexEventType = IndexEventType> = Omit<EventsListParams<T>, "limit"> & {
 	batchSize?: number
 	signal?: AbortSignal
 };
-type EventsConsumeParams = Omit<EventsListParams, "cursor" | "fromCursor" | "limit"> & IndexConsumeOptions<IndexEvent, EventsEnvelope>;
+type EventsConsumeParams<T extends IndexEventType = IndexEventType> = Omit<EventsListParams<T>, "cursor" | "fromCursor" | "limit"> & IndexConsumeOptions<IndexEventOf<T>, EventsEnvelope<T>>;
 type IndexContractCall = {
 	cursor: string
 	block_height: number
@@ -1140,7 +1171,9 @@ type ContractCallsListParams = {
 	cursor?: string | null
 	fromCursor?: string | null
 	limit?: number
-	contractId?: string
+	/** One id, or several to scope the sweep to a set of contracts (max 20).
+	*  Mutually exclusive with `trait`. */
+	contractId?: string | readonly string[]
 	functionName?: string
 	sender?: string
 	fromHeight?: number
@@ -1626,12 +1659,21 @@ type SbtcEventsWalkParams = Omit<SbtcEventsListParams, "limit"> & {
 	batchSize?: number
 	signal?: AbortSignal
 };
+type SbtcEventsConsumeParams = Omit<SbtcEventsListParams, "cursor" | "fromCursor" | "limit"> & IndexConsumeOptions<IndexSbtcEvent, SbtcEventsEnvelope>;
+type SbtcDepositsConsumeParams = Omit<SbtcDepositsListParams, "cursor" | "fromCursor" | "limit"> & IndexConsumeOptions<IndexSbtcDeposit, SbtcDepositsEnvelope>;
 /** `index.sbtc` — the decoded sBTC peg surface (deposits, withdrawals, raw
 *  events, scoreboard). The only productized decoded sBTC peg feed on Stacks. */
 interface SbtcResource {
 	deposits: {
 		list(params?: SbtcDepositsListParams): Promise<SbtcDepositsEnvelope>
 		walk(params?: SbtcDepositsWalkParams): AsyncIterable<IndexSbtcDeposit>
+		/** Checkpointed sweep of completed deposits — append-only, so safe to
+		*  mirror. See {@link IndexConsumeOptions}. */
+		consume(params: SbtcDepositsConsumeParams): Promise<{
+			cursor: string | null
+			pages: number
+			emptyPolls: number
+		}>
 		/** Fetch a completed deposit by Bitcoin txid; 404 → null. */
 		get(bitcoinTxid: string): Promise<SbtcDepositEnvelope | null>
 	};
@@ -1644,6 +1686,13 @@ interface SbtcResource {
 	events: {
 		list(params?: SbtcEventsListParams): Promise<SbtcEventsEnvelope>
 		walk(params?: SbtcEventsWalkParams): AsyncIterable<IndexSbtcEvent>
+		/** Checkpointed sweep of the raw peg event log — append-only across all
+		*  six topics. See {@link IndexConsumeOptions}. */
+		consume(params: SbtcEventsConsumeParams): Promise<{
+			cursor: string | null
+			pages: number
+			emptyPolls: number
+		}>
 	};
 	/** The peg scoreboard — a single all-time aggregate (no pagination). */
 	summary(): Promise<SbtcSummaryEnvelope>;
@@ -1786,10 +1835,10 @@ interface NftTransfersResource {
 }
 /** `index.events` — callable shorthand for `.list()`; `eventType` is required. */
 interface IndexEventsResource {
-	(params: EventsListParams): Promise<EventsEnvelope>;
-	list(params: EventsListParams): Promise<EventsEnvelope>;
-	walk(params: EventsWalkParams): AsyncIterable<IndexEvent>;
-	consume(params: EventsConsumeParams): Promise<{
+	<T extends IndexEventType>(params: EventsListParams<T>): Promise<EventsEnvelope<T>>;
+	list<T extends IndexEventType>(params: EventsListParams<T>): Promise<EventsEnvelope<T>>;
+	walk<T extends IndexEventType>(params: EventsWalkParams<T>): AsyncIterable<IndexEventOf<T>>;
+	consume<T extends IndexEventType>(params: EventsConsumeParams<T>): Promise<{
 		cursor: string | null
 		pages: number
 		emptyPolls: number
@@ -2846,4 +2895,4 @@ declare function toJsonSafe(value: unknown): unknown;
 /** Decode a hex-encoded Clarity value to JSON-safe JS (uints as strings,
 *  buffers as `0x…` hex, tuples as objects). Returns the input hex on failure. */
 declare function decodeClarityValue(hex: string): unknown;
-export { withX402, verifyWebhookSignature, verifyTransactionProof, verify as verifyStandardWebhooksHeaders, verifySecondlayerSignature, trigger, toJsonSafe, selectOffer, resolveApiKey, resolveAccountNonce, readX402Receipt, readX402Challenge, payAndRetry, isStxTransfer, isStxMint, isStxLock, isStxBurn, isPrint, isNftTransfer, isNftMint, isNftBurn, isFtTransfer, isFtMint, isFtBurn, getSubgraph, fetchRewardSet, decodeStxTransfer, decodeStxMint, decodeStxLock, decodeStxBurn, decodePrint, decodeNftTransfer, decodeNftMint, decodeNftBurn, decodeFtTransfer, decodeFtMint, decodeFtBurn, decodeClarityValue, decodeChainWebhook, createX402Client, createStreamsClient, consumeIndexFeed, buildSignedX402Payment, X402SpendGuardError, X402Result, X402Receipt, X402Fetch, X402ClientOptions, X402Client, X402Challenge, X402Accept, WithX402Options, WebhookHeaderInput, VersionConflictError, ValidationError, UpdateSubscriptionRequest2 as UpdateSubscriptionRequest, UpdateProjectParams, TransactionsWalkParams, TransactionsListParams, TransactionsEnvelope, TransactionProofVerifyResult, TransactionProof, TransactionEnvelope, Subscriptions, SubscriptionSummary2 as SubscriptionSummary, SubscriptionStatus, SubscriptionRuntime, SubscriptionKind, SubscriptionFormat, SubscriptionDetail2 as SubscriptionDetail, Subgraphs, SubgraphSpecOptions3 as SubgraphSpecOptions, SubgraphSpecFormat2 as SubgraphSpecFormat, SubgraphOperationStatus, SubgraphAgentSchema3 as SubgraphAgentSchema, StreamsUsage, StreamsTip, StreamsSignatureError, StreamsServerError, StreamsReorgsListParams, StreamsReorgsListEnvelope, StreamsReorgContext, StreamsReorg, StreamsEventsSubscribeParams, StreamsEventsStreamParams, StreamsEventsListParams, StreamsEventsListEnvelope, StreamsEventsEnvelope, StreamsEventsConsumeResult, StreamsEventsConsumeParams, StreamsEventType, StreamsEventPayload, StreamsEvent, StreamsDumpsManifest, StreamsDumps, StreamsDumpFile, StreamsConsumeParams, StreamsClient, StreamsCanonicalBlock, StreamsBatchContext, StreamsBatch, StandardWebhooksHeaders2 as StandardWebhooksHeaders, StackingWalkParams, StackingListParams, StackingEnvelope, SelectOfferOptions, SecondLayerOptions, SecondLayer, ScopedKeyProduct, SbtcWithdrawalsWalkParams, SbtcWithdrawalsListParams, SbtcWithdrawalsEnvelope, SbtcWithdrawalSweptConfirmedEvent, SbtcWithdrawalStatus, SbtcWithdrawalEvent, SbtcWithdrawalEnvelope, SbtcSummaryEnvelope, SbtcResource, SbtcEventsWalkParams, SbtcEventsListParams, SbtcEventsEnvelope, SbtcEventTopic, SbtcDepositsWalkParams, SbtcDepositsListParams, SbtcDepositsEnvelope, SbtcDepositEvent, SbtcDepositEnvelope, RotateSecretResponse2 as RotateSecretResponse, RewardSet2 as RewardSet, ReplayResult2 as ReplayResult, RateLimitError, Projects, ProjectTeamMember, ProjectTeam, ProjectInvitation, Project, PrintSchemaResponse, PoxResource, PoxCyclesWalkParams, PoxCyclesListParams, PoxCyclesEnvelope, PoxCycleEnvelope, Pox5Resource, Pox5EventsWalkParams, Pox5EventsListParams, Pox5EventsEnvelope, PayAndRetryOptions, NftTransfersWalkParams, NftTransfersResource, NftTransfersListParams, NftTransfersEnvelope, NftTransferPayload, NftTransferEvent, NftTransfer, MempoolWalkParams, MempoolTransactionEnvelope, MempoolListParams, MempoolEnvelope, IndexUsage, IndexTransaction, IndexTip, IndexStxTransfer, IndexStxMint, IndexStxLock, IndexStxBurn, IndexStackingAction, IndexSbtcWithdrawalPhase, IndexSbtcWithdrawalDetail, IndexSbtcWithdrawal, IndexSbtcSummary, IndexSbtcEvent, IndexSbtcDepositDetail, IndexSbtcDeposit, IndexReorg, IndexPrint, IndexPoxFunctionCount, IndexPoxCycle, IndexPox5EventTopic, IndexPox5Event, IndexPostCondition, IndexNftTransfer, IndexNftMint, IndexNftBurn, IndexMempoolTransaction, IndexFtTransfer, IndexFtMint, IndexFtBurn, IndexFeedItem, IndexFeedFetcher, IndexFeedEnvelope, IndexEventsResource, IndexEventTypeFilters, IndexEventType, IndexEvent, IndexDiscovery, IndexContractCall, IndexConsumeOptions, IndexCanonicalBlock, IndexBlock, Index, FtTransfersWalkParams, FtTransfersResource, FtTransfersListParams, FtTransfersEnvelope, FtTransferPayload, FtTransferEvent, FtTransfer, FetchLike2 as FetchLike, EventsWalkParams, EventsListParams, EventsEnvelope, EventsConsumeParams, DeliveryRow2 as DeliveryRow, DecodedStxTransferPayload, DecodedStxTransfer, DecodedStxMintPayload, DecodedStxMint, DecodedStxLockPayload, DecodedStxLock, DecodedStxBurnPayload, DecodedStxBurn, DecodedPrintValue, DecodedPrintPayload, DecodedPrint, DecodedNftTransferPayload, DecodedNftTransfer, DecodedNftMintPayload, DecodedNftMint, DecodedNftBurnPayload, DecodedNftBurn, DecodedFtTransferPayload, DecodedFtTransfer, DecodedFtMintPayload, DecodedFtMint, DecodedFtBurnPayload, DecodedFtBurn, DecodedEventRow, DecodedEventColumns, DeadRow2 as DeadRow, DEFAULT_PREFER_ASSETS, Cursor, CreateSubscriptionResponse2 as CreateSubscriptionResponse, CreateSubscriptionRequest2 as CreateSubscriptionRequest, CreateProjectParams, CreateApiKeyResponse, CreateApiKeyParams, ContractsListParams, ContractsEnvelope, Contracts, ContractSummary, ContractConformance, ContractCallsWalkParams, ContractCallsListParams, ContractCallsEnvelope, ContractCallsConsumeParams, ContextSnapshot, ContextProject, ContextApiKey, ContextAccount, ChainWebhookEnvelope, ChainWebhookDelivery2 as ChainWebhookDelivery, ChainTxLevelEvent, ChainTriggerType, ChainTrigger, ChainTestDelivery, ChainStxTransferData, ChainStxMintData, ChainStxLockData, ChainStxBurnData, ChainReorgRollbackEnvelope, ChainReorgRollbackDelivery, ChainReorgOrphanedEntry, ChainPrintEventData, ChainNftTransferData, ChainNftMintData, ChainNftBurnData, ChainFtTransferData, ChainFtMintData, ChainFtBurnData, ChainEventEnvelope, ChainApplyEnvelopeOf, ChainApplyEnvelope, ChainApplyDeliveryOf, CanonicalWalkParams, CanonicalListParams, CanonicalEnvelope, ByoBreakingChangeError, ByoBreakingChangeDetails, BuildSignedX402PaymentOptions, BlocksWalkParams, BlocksListParams, BlocksEnvelope, BlockEnvelope, AuthError, ApiKeys, ApiKeySummary, ApiError, ActiveSubgraphOperation };
+export { withX402, verifyWebhookSignature, verifyTransactionProof, verify as verifyStandardWebhooksHeaders, verifySecondlayerSignature, trigger, toJsonSafe, selectOffer, resolveApiKey, resolveAccountNonce, readX402Receipt, readX402Challenge, payAndRetry, isStxTransfer, isStxMint, isStxLock, isStxBurn, isPrint, isNftTransfer, isNftMint, isNftBurn, isFtTransfer, isFtMint, isFtBurn, getSubgraph, fetchRewardSet, decodeStxTransfer, decodeStxMint, decodeStxLock, decodeStxBurn, decodePrint, decodeNftTransfer, decodeNftMint, decodeNftBurn, decodeFtTransfer, decodeFtMint, decodeFtBurn, decodeClarityValue, decodeChainWebhook, createX402Client, createStreamsClient, consumeIndexFeed, buildSignedX402Payment, X402SpendGuardError, X402Result, X402Receipt, X402Fetch, X402ClientOptions, X402Client, X402Challenge, X402Accept, WithX402Options, WebhookHeaderInput, VersionConflictError, ValidationError, UpdateSubscriptionRequest2 as UpdateSubscriptionRequest, UpdateProjectParams, TransactionsWalkParams, TransactionsListParams, TransactionsEnvelope, TransactionProofVerifyResult, TransactionProof, TransactionEnvelope, Subscriptions, SubscriptionSummary2 as SubscriptionSummary, SubscriptionStatus, SubscriptionRuntime, SubscriptionKind, SubscriptionFormat, SubscriptionDetail2 as SubscriptionDetail, Subgraphs, SubgraphSpecOptions3 as SubgraphSpecOptions, SubgraphSpecFormat2 as SubgraphSpecFormat, SubgraphOperationStatus, SubgraphAgentSchema3 as SubgraphAgentSchema, StreamsUsage, StreamsTip, StreamsSignatureError, StreamsServerError, StreamsReorgsListParams, StreamsReorgsListEnvelope, StreamsReorgContext, StreamsReorg, StreamsEventsSubscribeParams, StreamsEventsStreamParams, StreamsEventsListParams, StreamsEventsListEnvelope, StreamsEventsEnvelope, StreamsEventsConsumeResult, StreamsEventsConsumeParams, StreamsEventType, StreamsEventPayload, StreamsEvent, StreamsDumpsManifest, StreamsDumps, StreamsDumpFile, StreamsConsumeParams, StreamsClient, StreamsCanonicalBlock, StreamsBatchContext, StreamsBatch, StandardWebhooksHeaders2 as StandardWebhooksHeaders, StackingWalkParams, StackingListParams, StackingEnvelope, SelectOfferOptions, SecondLayerOptions, SecondLayer, ScopedKeyProduct, SbtcWithdrawalsWalkParams, SbtcWithdrawalsListParams, SbtcWithdrawalsEnvelope, SbtcWithdrawalSweptConfirmedEvent, SbtcWithdrawalStatus, SbtcWithdrawalEvent, SbtcWithdrawalEnvelope, SbtcSummaryEnvelope, SbtcResource, SbtcEventsWalkParams, SbtcEventsListParams, SbtcEventsEnvelope, SbtcEventsConsumeParams, SbtcEventTopic, SbtcDepositsWalkParams, SbtcDepositsListParams, SbtcDepositsEnvelope, SbtcDepositsConsumeParams, SbtcDepositEvent, SbtcDepositEnvelope, RotateSecretResponse2 as RotateSecretResponse, RewardSet2 as RewardSet, ReplayResult2 as ReplayResult, RateLimitError, Projects, ProjectTeamMember, ProjectTeam, ProjectInvitation, Project, PrintSchemaResponse, PoxResource, PoxCyclesWalkParams, PoxCyclesListParams, PoxCyclesEnvelope, PoxCycleEnvelope, Pox5Resource, Pox5EventsWalkParams, Pox5EventsListParams, Pox5EventsEnvelope, PayAndRetryOptions, NftTransfersWalkParams, NftTransfersResource, NftTransfersListParams, NftTransfersEnvelope, NftTransferPayload, NftTransferEvent, NftTransfer, MempoolWalkParams, MempoolTransactionEnvelope, MempoolListParams, MempoolEnvelope, IndexUsage, IndexTransaction, IndexTip, IndexStxTransfer, IndexStxMint, IndexStxLock, IndexStxBurn, IndexStackingAction, IndexSbtcWithdrawalPhase, IndexSbtcWithdrawalDetail, IndexSbtcWithdrawal, IndexSbtcSummary, IndexSbtcEvent, IndexSbtcDepositDetail, IndexSbtcDeposit, IndexReorg, IndexPrint, IndexPoxFunctionCount, IndexPoxCycle, IndexPox5EventTopic, IndexPox5Event, IndexPostCondition, IndexNftTransfer, IndexNftMint, IndexNftBurn, IndexMempoolTransaction, IndexFtTransfer, IndexFtMint, IndexFtBurn, IndexFeedItem, IndexFeedFetcher, IndexFeedEnvelope, IndexEventsResource, IndexEventTypeFilters, IndexEventType, IndexEventOf, IndexEvent, IndexDiscovery, IndexContractCall, IndexConsumeOptions, IndexCanonicalBlock, IndexBlock, Index, FtTransfersWalkParams, FtTransfersResource, FtTransfersListParams, FtTransfersEnvelope, FtTransferPayload, FtTransferEvent, FtTransfer, FetchLike2 as FetchLike, EventsWalkParams, EventsListParams, EventsEnvelope, EventsConsumeParams, DeliveryRow2 as DeliveryRow, DecodedStxTransferPayload, DecodedStxTransfer, DecodedStxMintPayload, DecodedStxMint, DecodedStxLockPayload, DecodedStxLock, DecodedStxBurnPayload, DecodedStxBurn, DecodedPrintValue, DecodedPrintPayload, DecodedPrint, DecodedNftTransferPayload, DecodedNftTransfer, DecodedNftMintPayload, DecodedNftMint, DecodedNftBurnPayload, DecodedNftBurn, DecodedFtTransferPayload, DecodedFtTransfer, DecodedFtMintPayload, DecodedFtMint, DecodedFtBurnPayload, DecodedFtBurn, DecodedEventRow, DecodedEventColumns, DeadRow2 as DeadRow, DEFAULT_PREFER_ASSETS, Cursor, CreateSubscriptionResponse2 as CreateSubscriptionResponse, CreateSubscriptionRequest2 as CreateSubscriptionRequest, CreateProjectParams, CreateApiKeyResponse, CreateApiKeyParams, ContractsListParams, ContractsEnvelope, Contracts, ContractSummary, ContractConformance, ContractCallsWalkParams, ContractCallsListParams, ContractCallsEnvelope, ContractCallsConsumeParams, ContextSnapshot, ContextProject, ContextApiKey, ContextAccount, ConsumerBatchContext, ChainWebhookEnvelope, ChainWebhookDelivery2 as ChainWebhookDelivery, ChainTxLevelEvent, ChainTriggerType, ChainTrigger, ChainTestDelivery, ChainStxTransferData, ChainStxMintData, ChainStxLockData, ChainStxBurnData, ChainReorgRollbackEnvelope, ChainReorgRollbackDelivery, ChainReorgOrphanedEntry, ChainPrintEventData, ChainNftTransferData, ChainNftMintData, ChainNftBurnData, ChainFtTransferData, ChainFtMintData, ChainFtBurnData, ChainEventEnvelope, ChainApplyEnvelopeOf, ChainApplyEnvelope, ChainApplyDeliveryOf, CanonicalWalkParams, CanonicalListParams, CanonicalEnvelope, ByoBreakingChangeError, ByoBreakingChangeDetails, BuildSignedX402PaymentOptions, BlocksWalkParams, BlocksListParams, BlocksEnvelope, BlockEnvelope, AuthError, ApiKeys, ApiKeySummary, ApiError, ActiveSubgraphOperation };

package/dist/index.js

@@ -494,6 +494,14 @@ var Cursor = {
 function reorgKey(reorg) {
   return `${reorg.detected_at}|${reorg.fork_point_height}|${reorg.new_canonical_tip}`;
 }
+function batchContext(cursor, height, tipHeight) {
+  return {
+    cursor,
+    height,
+    tipHeight,
+    blocksBehind: height === null ? null : Math.max(0, tipHeight - height)
+  };
+}
 async function defaultSleep(ms, signal) {
   if (signal?.aborted)
     return;
@@ -518,6 +526,7 @@ async function consumeStreamsEvents(opts) {
   const handledReorgs = new Set;
   let pages = 0;
   let emptyPolls = 0;
+  let height = null;
   while (pages < maxPages && emptyPolls < maxEmptyPolls && !opts.signal?.aborted) {
     const envelope = await opts.fetchEvents({
       cursor,
@@ -540,15 +549,15 @@ async function consumeStreamsEvents(opts) {
           handledReorgs.add(reorgKey(reorg));
         }
         cursor = rewind;
+        height = forkPoint > 0 ? forkPoint - 1 : null;
         emptyPolls = 0;
         continue;
       }
     }
     const emitted = finalizedOnly ? envelope.events.filter((event) => event.finalized) : envelope.events;
     const checkpoint = finalizedOnly ? emitted.at(-1)?.cursor ?? cursor : envelope.next_cursor;
-    const returnedCursor = await opts.onBatch(emitted, envelope, {
-      cursor: checkpoint
-    });
+    height = emitted.at(-1)?.block_height ?? height;
+    const returnedCursor = await opts.onBatch(emitted, envelope, batchContext(checkpoint, height, envelope.tip.block_height));
     const nextCursor = returnedCursor ?? checkpoint;
     if (nextCursor && nextCursor !== cursor) {
       cursor = nextCursor;
@@ -654,6 +663,7 @@ async function consumeIndexFeed(opts) {
   const handledReorgs = new Set;
   let pages = 0;
   let emptyPolls = 0;
+  let height = null;
   while (pages < maxPages && emptyPolls < maxEmptyPolls && !opts.signal?.aborted) {
     const envelope = await opts.fetchPage({
       cursor,
@@ -671,6 +681,7 @@ async function consumeIndexFeed(opts) {
           handledReorgs.add(reorg.id);
         }
         cursor = rewind;
+        height = forkPoint > 0 ? forkPoint - 1 : null;
         emptyPolls = 0;
         continue;
       }
@@ -678,9 +689,8 @@ async function consumeIndexFeed(opts) {
     const items = opts.itemsOf(envelope);
     const emitted = finalizedOnly ? items.filter((item) => item.block_height <= envelope.tip.finalized_height) : items;
     const checkpoint = finalizedOnly ? emitted.at(-1)?.cursor ?? cursor : envelope.next_cursor;
-    const returnedCursor = await opts.onBatch(emitted, envelope, {
-      cursor: checkpoint
-    });
+    height = emitted.at(-1)?.block_height ?? height;
+    const returnedCursor = await opts.onBatch(emitted, envelope, batchContext(checkpoint, height, envelope.tip.block_height));
     const nextCursor = returnedCursor ?? checkpoint;
     if (nextCursor && nextCursor !== cursor) {
       cursor = nextCursor;
@@ -797,6 +807,19 @@ class Index extends BaseClient {
     deposits: {
       list: (params = {}) => this.listSbtcDeposits(params),
       walk: (params = {}) => this.walkSbtcDeposits(params),
+      consume: (params) => consumeIndexFeed({
+        ...params,
+        fetchPage: ({ cursor, fromHeight, limit }) => this.listSbtcDeposits({
+          confirmed: params.confirmed,
+          sender: params.sender,
+          bitcoinTxid: params.bitcoinTxid,
+          toHeight: params.toHeight,
+          cursor,
+          fromHeight,
+          limit
+        }),
+        itemsOf: (envelope) => envelope.deposits
+      }),
       get: (bitcoinTxid) => this.getSbtcDeposit(bitcoinTxid)
     },
     withdrawals: {
@@ -806,7 +829,22 @@ class Index extends BaseClient {
     },
     events: {
       list: (params = {}) => this.listSbtcEvents(params),
-      walk: (params = {}) => this.walkSbtcEvents(params)
+      walk: (params = {}) => this.walkSbtcEvents(params),
+      consume: (params) => consumeIndexFeed({
+        ...params,
+        fetchPage: ({ cursor, fromHeight, limit }) => this.listSbtcEvents({
+          confirmed: params.confirmed,
+          topic: params.topic,
+          sender: params.sender,
+          requestId: params.requestId,
+          bitcoinTxid: params.bitcoinTxid,
+          toHeight: params.toHeight,
+          cursor,
+          fromHeight,
+          limit
+        }),
+        itemsOf: (envelope) => envelope.events
+      })
     },
     summary: () => this.getSbtcSummary()
   };
@@ -2458,5 +2496,5 @@ export {
   ApiError
 };
 
-//# debugId=F9D80F765EDFA6CE64756E2164756E21
+//# debugId=D5B171025CDFC80A64756E2164756E21
 //# sourceMappingURL=index.js.map