@secondlayer/sdk 6.10.0 → 6.12.0

package/dist/index.d.ts

@@ -337,6 +337,27 @@ type IndexTip = {
 	block_height: number
 	lag_seconds: number
 };
+/**
+* A chain reorg overlapping a returned page's height range. Height-keyed feeds
+* (`/transactions`, `/contract-calls`, `/stacking`) populate this so a consumer
+* can reconcile: roll back the rows whose `block_height:tx_index` cursor falls in
+* `orphaned_range`, then re-fetch from `new_canonical_tip`. Empty when the page
+* spans no reorg.
+*/
+type IndexReorg = {
+	id: string
+	detected_at: string
+	fork_point_height: number
+	old_index_block_hash: string | null
+	new_index_block_hash: string | null
+	/** Orphaned cursor span `<block_height>:<tx_index>`, inclusive. */
+	orphaned_range: {
+		from: string
+		to: string
+	}
+	/** New canonical tip cursor to resume from. */
+	new_canonical_tip: string
+};
 type IndexUsage = {
 	product: "index"
 	tier: string
@@ -365,7 +386,7 @@ type FtTransfersEnvelope = {
 	events: FtTransfer[]
 	next_cursor: string | null
 	tip: IndexTip
-	reorgs: never[]
+	reorgs: IndexReorg[]
 };
 type FtTransfersListParams = {
 	cursor?: string | null
@@ -398,7 +419,7 @@ type NftTransfersEnvelope = {
 	events: NftTransfer[]
 	next_cursor: string | null
 	tip: IndexTip
-	reorgs: never[]
+	reorgs: IndexReorg[]
 };
 type NftTransfersListParams = {
 	cursor?: string | null
@@ -502,7 +523,7 @@ type EventsEnvelope = {
 	events: IndexEvent[]
 	next_cursor: string | null
 	tip: IndexTip
-	reorgs: never[]
+	reorgs: IndexReorg[]
 };
 type EventsListParams = {
 	/** Required. One of the decoded event types. */
@@ -539,7 +560,7 @@ type ContractCallsEnvelope = {
 	contract_calls: IndexContractCall[]
 	next_cursor: string | null
 	tip: IndexTip
-	reorgs: never[]
+	reorgs: IndexReorg[]
 };
 type ContractCallsListParams = {
 	cursor?: string | null
@@ -682,7 +703,7 @@ type TransactionsEnvelope = {
 	transactions: IndexTransaction[]
 	next_cursor: string | null
 	tip: IndexTip
-	reorgs: never[]
+	reorgs: IndexReorg[]
 };
 type TransactionEnvelope = {
 	transaction: IndexTransaction
@@ -731,7 +752,7 @@ type StackingEnvelope = {
 	stacking: IndexStackingAction[]
 	next_cursor: string | null
 	tip: IndexTip
-	reorgs: never[]
+	reorgs: IndexReorg[]
 	/** Present only when the PoX-4 decoder is disabled, explaining an empty feed. */
 	notes?: string
 };
@@ -1365,8 +1386,10 @@ type CreateStreamsClientOptions = {
 	}
 	/**
 	* Verify the bulk dumps manifest's ed25519 signature in `client.dumps.list()`
-	* before trusting any file sha256 (default off). Uses the same key source as
-	* `verify`. Default off until historical manifests carry signatures.
+	* before trusting any file sha256 (default ON). Uses the same key source as
+	* `verify` (fetches `/public/streams/signing-key`, or a pinned PEM). Pass
+	* `false` to opt out. A missing or invalid signature throws
+	* `StreamsSignatureError`.
 	*/
 	verifyDumpsManifest?: boolean
 };
@@ -1811,4 +1834,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 { verifyWebhookSignature, verifySecondlayerSignature, trigger, toJsonSafe, isStxTransfer, isStxMint, isStxLock, isStxBurn, isPrint, isNftTransfer, isNftMint, isNftBurn, isFtTransfer, isFtMint, isFtBurn, getSubgraph, decodeStxTransfer, decodeStxMint, decodeStxLock, decodeStxBurn, decodePrint, decodeNftTransfer, decodeNftMint, decodeNftBurn, decodeFtTransfer, decodeFtMint, decodeFtBurn, decodeClarityValue, createStreamsClient, VersionConflictError, ValidationError, UpdateSubscriptionRequest2 as UpdateSubscriptionRequest, TransactionsWalkParams, TransactionsListParams, TransactionsEnvelope, 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, StreamsClient, StreamsCanonicalBlock, StreamsBatchContext, StackingWalkParams, StackingListParams, StackingEnvelope, SecondLayerOptions, SecondLayer, ScopedKeyProduct, RotateSecretResponse2 as RotateSecretResponse, ReplayResult2 as ReplayResult, RateLimitError, Pox4CallsParams, NftTransfersWalkParams, NftTransfersListParams, NftTransfersEnvelope, NftTransferPayload, NftTransferEvent, NftTransfer, MempoolWalkParams, MempoolTransactionEnvelope, MempoolListParams, MempoolEnvelope, IndexUsage, IndexTransaction, IndexTip, IndexStackingAction, IndexPostCondition, IndexMempoolTransaction, IndexEventType, IndexEvent, IndexContractCall, IndexCanonicalBlock, IndexBlock, Index, FtTransfersWalkParams, FtTransfersListParams, FtTransfersEnvelope, FtTransferPayload, FtTransferEvent, FtTransfer, FetchLike2 as FetchLike, EventsWalkParams, EventsListParams, EventsEnvelope, 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, Datasets, DatasetRow, CursorListParams, CursorEnvelope, Cursor, CreateSubscriptionResponse2 as CreateSubscriptionResponse, CreateSubscriptionRequest2 as CreateSubscriptionRequest, CreateApiKeyResponse, CreateApiKeyParams, ContractsListParams, ContractsEnvelope, Contracts, ContractSummary, ContractConformance, ContractCallsWalkParams, ContractCallsListParams, ContractCallsEnvelope, ContextSnapshot, ContextAccount, ChainTriggerType, ChainTrigger, CanonicalWalkParams, CanonicalListParams, CanonicalEnvelope, CURSOR_SLUGS, BlocksWalkParams, BlocksListParams, BlocksEnvelope, BlockEnvelope, AuthError, ApiKeys, ApiError, ActiveSubgraphOperation };
+export { verifyWebhookSignature, verifySecondlayerSignature, trigger, toJsonSafe, isStxTransfer, isStxMint, isStxLock, isStxBurn, isPrint, isNftTransfer, isNftMint, isNftBurn, isFtTransfer, isFtMint, isFtBurn, getSubgraph, decodeStxTransfer, decodeStxMint, decodeStxLock, decodeStxBurn, decodePrint, decodeNftTransfer, decodeNftMint, decodeNftBurn, decodeFtTransfer, decodeFtMint, decodeFtBurn, decodeClarityValue, createStreamsClient, VersionConflictError, ValidationError, UpdateSubscriptionRequest2 as UpdateSubscriptionRequest, TransactionsWalkParams, TransactionsListParams, TransactionsEnvelope, 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, StreamsClient, StreamsCanonicalBlock, StreamsBatchContext, StackingWalkParams, StackingListParams, StackingEnvelope, SecondLayerOptions, SecondLayer, ScopedKeyProduct, RotateSecretResponse2 as RotateSecretResponse, ReplayResult2 as ReplayResult, RateLimitError, Pox4CallsParams, NftTransfersWalkParams, NftTransfersListParams, NftTransfersEnvelope, NftTransferPayload, NftTransferEvent, NftTransfer, MempoolWalkParams, MempoolTransactionEnvelope, MempoolListParams, MempoolEnvelope, IndexUsage, IndexTransaction, IndexTip, IndexStackingAction, IndexReorg, IndexPostCondition, IndexMempoolTransaction, IndexEventType, IndexEvent, IndexContractCall, IndexCanonicalBlock, IndexBlock, Index, FtTransfersWalkParams, FtTransfersListParams, FtTransfersEnvelope, FtTransferPayload, FtTransferEvent, FtTransfer, FetchLike2 as FetchLike, EventsWalkParams, EventsListParams, EventsEnvelope, 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, Datasets, DatasetRow, CursorListParams, CursorEnvelope, Cursor, CreateSubscriptionResponse2 as CreateSubscriptionResponse, CreateSubscriptionRequest2 as CreateSubscriptionRequest, CreateApiKeyResponse, CreateApiKeyParams, ContractsListParams, ContractsEnvelope, Contracts, ContractSummary, ContractConformance, ContractCallsWalkParams, ContractCallsListParams, ContractCallsEnvelope, ContextSnapshot, ContextAccount, ChainTriggerType, ChainTrigger, CanonicalWalkParams, CanonicalListParams, CanonicalEnvelope, CURSOR_SLUGS, BlocksWalkParams, BlocksListParams, BlocksEnvelope, BlockEnvelope, AuthError, ApiKeys, ApiError, ActiveSubgraphOperation };

package/dist/index.js

@@ -1342,7 +1342,7 @@ function createStreamsClient(options) {
   const dumps = createStreamsDumps({
     baseUrl: options.dumpsBaseUrl,
     fetchImpl,
-    verifyManifest: options.verifyDumpsManifest ?? false,
+    verifyManifest: options.verifyDumpsManifest ?? true,
     loadPublicKeyPem: async () => (await loadKey()).publicKeyPem
   });
   async function request(path) {
@@ -2013,5 +2013,5 @@ export {
   ApiError
 };
 
-//# debugId=30831F6F187A1F5A64756E2164756E21
+//# debugId=7E891A303DCCD65B64756E2164756E21
 //# sourceMappingURL=index.js.map