@secondlayer/sdk 6.29.1 → 6.31.0

package/dist/index.d.ts

@@ -1691,6 +1691,73 @@ interface PoxResource {
 		get(rewardCycle: number): Promise<PoxCycleEnvelope | null>
 	};
 }
+/** The decoded `pox-5` boot-contract print topics (SIP-045 Bitcoin Staking).
+*  Declared locally rather than imported from the server packages — the SDK is
+*  published and owns its own dependency surface (same as {@link SbtcEventTopic}). */
+type IndexPox5EventTopic = "set-bond-admin" | "set-pause-admin" | "pause-rewards" | "setup-bond" | "add-to-allowlist" | "register-for-bond" | "update-bond-registration" | "register-signer" | "stake" | "stake-update" | "announce-l1-early-exit" | "unstake-sbtc" | "unstake" | "calculate-rewards" | "bond-distribution" | "claim-rewards" | "claim-staker-rewards-for-signer" | "grant-signer-key" | "revoke-signer-grant";
+/** A raw decoded PoX-5 print event. Promoted fields cover the hot query paths;
+*  `data` always carries the full decoded tuple, including nested shapes
+*  (`btc-lockup`, `bond-rewards`, `bond-periods`) that have no flat column. */
+type IndexPox5Event = {
+	cursor: string
+	block_height: number
+	block_time: string | null
+	tx_id: string
+	tx_index: number
+	event_index: number
+	topic: IndexPox5EventTopic
+	staker: string | null
+	signer: string | null
+	signer_manager: string | null
+	bond_index: number | null
+	/** ustx, bigint-safe string. */
+	amount_ustx: string | null
+	/** sats, bigint-safe string. */
+	amount_sats: string | null
+	reward_cycle: number | null
+	first_reward_cycle: number | null
+	unlock_cycle: number | null
+	unlock_burn_height: number | null
+	is_l1_lock: boolean | null
+	signer_key: string | null
+	/** The full decoded print tuple as JSON. */
+	data: unknown
+};
+type Pox5EventsEnvelope = {
+	events: IndexPox5Event[]
+	next_cursor: string | null
+	tip: IndexTip
+	reorgs: IndexReorg[]
+	/** Present only when the PoX-5 decoder is disabled, explaining an empty feed. */
+	notes?: string
+};
+type Pox5EventsListParams = {
+	cursor?: string | null
+	fromCursor?: string | null
+	limit?: number
+	/** Clamp to the finality boundary — only rows past the reorg margin. */
+	confirmed?: boolean
+	topic?: IndexPox5EventTopic
+	staker?: string
+	signer?: string
+	signerManager?: string
+	bondIndex?: number
+	rewardCycle?: number
+	fromHeight?: number
+	toHeight?: number
+};
+type Pox5EventsWalkParams = Omit<Pox5EventsListParams, "limit"> & {
+	batchSize?: number
+	signal?: AbortSignal
+};
+/** `index.pox5` — decoded PoX-5 print events, the staking primitive from the
+*  epoch 4.0 hard fork onward (PoX-4's `index.stacking` stream ends there). */
+interface Pox5Resource {
+	events: {
+		list(params?: Pox5EventsListParams): Promise<Pox5EventsEnvelope>
+		walk(params?: Pox5EventsWalkParams): AsyncIterable<IndexPox5Event>
+	};
+}
 /**
 * `index.ftTransfers` — callable shorthand for `.list()`, with `.list`/`.walk`
 * still available: `await sl.index.ftTransfers({ contractId })`.
@@ -1805,6 +1872,9 @@ declare class Index extends BaseClient {
 	/** PoX reward-cycle aggregates. Distinct from `stacking` (per-call PoX-4
 	*  actions); `cycles` is the reward-cycle rollup. */
 	readonly pox: PoxResource;
+	/** Decoded PoX-5 print events (SIP-045 Bitcoin Staking) — the raw pox-5
+	*  boot-contract log, all 19 topics. Distinct from `stacking` (PoX-4 era). */
+	readonly pox5: Pox5Resource;
 	private listFtTransfers;
 	private listNftTransfers;
 	/** Shared keyset-pagination loop for every `walk*` feed: seed the cursor from
@@ -1846,6 +1916,8 @@ declare class Index extends BaseClient {
 	private listSbtcEvents;
 	private walkSbtcEvents;
 	private getSbtcSummary;
+	private listPox5Events;
+	private walkPox5Events;
 	private listPoxCycles;
 	private walkPoxCycles;
 	private getPoxCycle;
@@ -2603,7 +2675,10 @@ declare class ByoBreakingChangeError extends ApiError {
 	readonly details: ByoBreakingChangeDetails;
 	constructor(message: string, details: ByoBreakingChangeDetails);
 }
+import { ChainWebhookDelivery } from "@secondlayer/shared";
 import { StandardWebhooksHeaders } from "@secondlayer/shared/crypto/standard-webhooks";
+import { StandardWebhooksHeaders as StandardWebhooksHeaders2, verify } from "@secondlayer/shared/crypto/standard-webhooks";
+import { ChainApplyDeliveryOf, ChainApplyEnvelope, ChainApplyEnvelopeOf, ChainEventEnvelope, ChainFtBurnData, ChainFtMintData, ChainFtTransferData, ChainNftBurnData, ChainNftMintData, ChainNftTransferData, ChainPrintEventData, ChainReorgOrphanedEntry, ChainReorgRollbackDelivery, ChainReorgRollbackEnvelope, ChainStxBurnData, ChainStxLockData, ChainStxMintData, ChainStxTransferData, ChainTestDelivery, ChainTxLevelEvent, ChainWebhookDelivery as ChainWebhookDelivery2, ChainWebhookEnvelope, SbtcDepositEvent, SbtcWithdrawalEvent, SbtcWithdrawalSweptConfirmedEvent } from "@secondlayer/shared";
 type HeaderLookup = (name: string) => string | null | undefined;
 type WebhookHeaderInput = HeaderLookup | StandardWebhooksHeaders | Record<string, string | string[] | undefined> | {
 	get: (name: string) => string | null
@@ -2717,6 +2792,45 @@ declare function verifyWebhookSignature(rawBody: string, headers: WebhookHeaderI
 * ```
 */
 declare function verifySecondlayerSignature(rawBody: string, headers: WebhookHeaderInput, publicKeyPem: string): boolean;
+/**
+* Decode + narrow a chain-subscription webhook delivery body into a typed
+* {@link ChainWebhookDelivery}. Verify the signature first with
+* {@link verifyWebhookSignature} (or {@link verifySecondlayerSignature}), then
+* decode the same raw body — this does not check authenticity, only shape.
+*
+* Only understands the `format: "standard-webhooks"` envelope (`{ type,
+* timestamp, data }`) — the subscription default, and the only format
+* `verifyWebhookSignature` covers. Other formats (`raw`, `cloudevents`, …)
+* carry the same `data` value under a different envelope; see the "Chain
+* subscription webhook payloads" doc for how to unwrap those.
+*
+* A chain-subscription delivery is NOT a Streams/Index event — do not run this
+* over a `StreamsEvent` body (`{ event_type, payload }`) or vice versa.
+*
+* @param rawBody The raw request body string (same bytes passed to
+*                {@link verifyWebhookSignature}).
+* @throws {Error} if the body isn't a `chain.*` delivery, or the envelope is
+*         internally inconsistent (e.g. `type` and `data.trigger` disagree —
+*         a sign the wire shape drifted from this decoder).
+*
+* @example
+* ```ts
+* import { decodeChainWebhook, verifyWebhookSignature } from "@secondlayer/sdk";
+*
+* app.post("/webhook", async (c) => {
+*   const raw = await c.req.text();
+*   if (!verifyWebhookSignature(raw, c.req.raw.headers, process.env.SIGNING_SECRET!)) {
+*     return c.text("Invalid signature", 401);
+*   }
+*   const delivery = decodeChainWebhook(raw);
+*   if (delivery.data.action === "apply" && delivery.data.trigger === "stx_transfer") {
+*     delivery.data.event.data.amount; // typed
+*   }
+*   return c.body(null, 204);
+* });
+* ```
+*/
+declare function decodeChainWebhook(rawBody: string): ChainWebhookDelivery;
 import { RewardSet as RewardSet2 } from "@secondlayer/shared/node/consensus";
 /** Make a cvToValue result JSON-serializable: Clarity (u)ints decode to bigint,
 *  which JSON.stringify can't handle — convert recursively to strings. */
@@ -2724,4 +2838,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, verifySecondlayerSignature, trigger, toJsonSafe, selectOffer, 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, createX402Client, createStreamsClient, consumeIndexFeed, buildSignedX402Payment, X402SpendGuardError, X402Result, X402Receipt, X402Fetch, X402ClientOptions, X402Client, X402Challenge, X402Accept, WithX402Options, 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, StackingWalkParams, StackingListParams, StackingEnvelope, SelectOfferOptions, SecondLayerOptions, SecondLayer, ScopedKeyProduct, SbtcWithdrawalsWalkParams, SbtcWithdrawalsListParams, SbtcWithdrawalsEnvelope, SbtcWithdrawalStatus, SbtcWithdrawalEnvelope, SbtcSummaryEnvelope, SbtcResource, SbtcEventsWalkParams, SbtcEventsListParams, SbtcEventsEnvelope, SbtcEventTopic, SbtcDepositsWalkParams, SbtcDepositsListParams, SbtcDepositsEnvelope, SbtcDepositEnvelope, RotateSecretResponse2 as RotateSecretResponse, RewardSet2 as RewardSet, ReplayResult2 as ReplayResult, RateLimitError, Projects, ProjectTeamMember, ProjectTeam, ProjectInvitation, Project, PrintSchemaResponse, PoxResource, PoxCyclesWalkParams, PoxCyclesListParams, PoxCyclesEnvelope, PoxCycleEnvelope, PayAndRetryOptions, NftTransfersWalkParams, NftTransfersResource, NftTransfersListParams, NftTransfersEnvelope, NftTransferPayload, NftTransferEvent, NftTransfer, MempoolWalkParams, MempoolTransactionEnvelope, MempoolListParams, MempoolEnvelope, IndexUsage, IndexTransaction, IndexTip, IndexStackingAction, IndexSbtcWithdrawalPhase, IndexSbtcWithdrawalDetail, IndexSbtcWithdrawal, IndexSbtcSummary, IndexSbtcEvent, IndexSbtcDepositDetail, IndexSbtcDeposit, IndexReorg, IndexPoxFunctionCount, IndexPoxCycle, IndexPostCondition, IndexMempoolTransaction, 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, ChainTriggerType, ChainTrigger, 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, 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, IndexStackingAction, IndexSbtcWithdrawalPhase, IndexSbtcWithdrawalDetail, IndexSbtcWithdrawal, IndexSbtcSummary, IndexSbtcEvent, IndexSbtcDepositDetail, IndexSbtcDeposit, IndexReorg, IndexPoxFunctionCount, IndexPoxCycle, IndexPox5EventTopic, IndexPox5Event, IndexPostCondition, IndexMempoolTransaction, 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 };

package/dist/index.js

@@ -810,6 +810,12 @@ class Index extends BaseClient {
       get: (rewardCycle) => this.getPoxCycle(rewardCycle)
     }
   };
+  pox5 = {
+    events: {
+      list: (params = {}) => this.listPox5Events(params),
+      walk: (params = {}) => this.walkPox5Events(params)
+    }
+  };
   async listFtTransfers(params = {}) {
     return this.request("GET", `/v1/index/ft-transfers${buildQuery({
       cursor: params.cursor,
@@ -1038,6 +1044,25 @@ class Index extends BaseClient {
   async getSbtcSummary() {
     return this.request("GET", "/v1/index/sbtc/summary");
   }
+  async listPox5Events(params = {}) {
+    return this.request("GET", `/v1/index/pox5/events${buildQuery({
+      cursor: params.cursor,
+      from_cursor: params.fromCursor,
+      limit: params.limit,
+      confirmed: params.confirmed,
+      topic: params.topic,
+      staker: params.staker,
+      signer: params.signer,
+      signer_manager: params.signerManager,
+      bond_index: params.bondIndex,
+      reward_cycle: params.rewardCycle,
+      from_height: params.fromHeight,
+      to_height: params.toHeight
+    })}`);
+  }
+  walkPox5Events(params = {}) {
+    return this.keysetWalk(params, (page) => this.listPox5Events({ ...params, ...page }), (e) => e.events);
+  }
   async listPoxCycles(params = {}) {
     return this.request("GET", `/v1/index/pox/cycles${buildQuery({
       cursor: params.cursor,
@@ -2260,6 +2285,33 @@ function verifySecondlayerSignature(rawBody, headers, publicKeyPem) {
   const signature = pickHeader(headers, "x-secondlayer-signature");
   return verifySecondlayerSignatureValues(rawBody, id, signature, publicKeyPem);
 }
+function decodeChainWebhook(rawBody) {
+  const parsed = JSON.parse(rawBody);
+  if (typeof parsed.type !== "string" || typeof parsed.timestamp !== "string" || typeof parsed.data !== "object" || parsed.data === null) {
+    throw new Error("decodeChainWebhook: not a chain-subscription delivery — expected { type, timestamp, data }");
+  }
+  if (!parsed.type.startsWith("chain.")) {
+    throw new Error(`decodeChainWebhook: not a chain-subscription delivery (type "${parsed.type}")`);
+  }
+  const data = parsed.data;
+  if (parsed.type === "chain.test.apply") {
+    if (data.test !== true) {
+      throw new Error('decodeChainWebhook: "chain.test.apply" body missing `data.test: true`');
+    }
+  } else if (parsed.type === "chain.reorg.rollback") {
+    if (data.action !== "rollback" || !Array.isArray(data.orphaned)) {
+      throw new Error('decodeChainWebhook: "chain.reorg.rollback" body missing `data.action`/`data.orphaned`');
+    }
+  } else {
+    if (data.action !== "apply" || typeof data.trigger !== "string") {
+      throw new Error("decodeChainWebhook: apply delivery missing `data.action`/`data.trigger`");
+    }
+    if (parsed.type !== `chain.${data.trigger}.apply`) {
+      throw new Error(`decodeChainWebhook: type "${parsed.type}" doesn't match data.trigger "${data.trigger}"`);
+    }
+  }
+  return parsed;
+}
 // src/proofs.ts
 import {
   verifySignerSignatures
@@ -2339,6 +2391,7 @@ export {
   withX402,
   verifyWebhookSignature,
   verifyTransactionProof,
+  verify2 as verifyStandardWebhooksHeaders,
   verifySecondlayerSignature,
   trigger,
   toJsonSafe,
@@ -2372,6 +2425,7 @@ export {
   decodeFtMint,
   decodeFtBurn,
   decodeClarityValue,
+  decodeChainWebhook,
   createX402Client,
   createStreamsClient,
   consumeIndexFeed,
@@ -2396,5 +2450,5 @@ export {
   ApiError
 };
 
-//# debugId=5E9E0D97F72D6DEB64756E2164756E21
+//# debugId=A3035E23B178A62A64756E2164756E21
 //# sourceMappingURL=index.js.map