@secondlayer/sdk 10.3.0 → 10.4.0

package/README.md

@@ -21,7 +21,7 @@ const sl = new SecondLayer({
 
 Auth, once: `sl.index`, `sl.streams`, `sl.subgraphs.rows`, and the typed
 `subscribe` read `/v1`, which is open on loopback and needs `INSTANCE_TOKEN`
-once the API is bound beyond it. Everything under `sl.subgraphs.*` and `sl.subscriptions.*` calls
+once the API is bound beyond it. Everything under `sl.subgraphs.*` and `sl.webhooks.*` calls
 `/api`, which needs `INSTANCE_TOKEN` as soon as one is configured, loopback
 included, and `secondlayer init` always configures one. Every client, including
 `createStreamsClient`, reads `INSTANCE_TOKEN` from the env when `apiKey` is
@@ -412,7 +412,7 @@ Exported types: `TransactionProof`, `TransactionProofVerifyResult`, `RewardSet`.
 
 Deploy and query app-specific tables.
 
-Subgraphs and subscriptions live on the instance API alongside Streams and Index. Everything here except `rows` and the typed `subscribe` calls `/api`, which needs `INSTANCE_TOKEN` once one is configured (init always configures one), loopback included.
+Subgraphs and webhooks live on the instance API alongside Streams and Index. Everything here except `rows` and the typed `subscribe` calls `/api`, which needs `INSTANCE_TOKEN` once one is configured (init always configures one), loopback included.
 
 ```typescript
 // List
@@ -482,9 +482,11 @@ tail only. A dropped connection reconnects from the last delivered row's
 `_block_height`, so rows at that height can arrive twice: key durable writes
 by `_id`.
 
-## Subscriptions
+## Webhooks
 
-Signed HTTP webhooks. Subscriptions are polymorphic — pick one kind:
+Deprecated aliases (`sl.subscriptions`, `Subscriptions`) keep working for one release cycle.
+
+Signed HTTP POSTs. Webhooks are polymorphic — pick one kind:
 
 - **subgraph** — fires on rows written to a deployed subgraph table.
 - **chain** — fires on raw chain events with no subgraph. Forward-looking: it
@@ -493,12 +495,12 @@ Signed HTTP webhooks. Subscriptions are polymorphic — pick one kind:
 
 ```typescript
 // List / get
-const { data } = await sl.subscriptions.list();
-const sub = await sl.subscriptions.get(id);
+const { data } = await sl.webhooks.list();
+const hook = await sl.webhooks.get(id);
 
-// Create a SUBGRAPH subscription — sink a subgraph table to a signed endpoint.
+// Create a SUBGRAPH webhook — sink a subgraph table to a signed endpoint.
 // `signingSecret` is returned ONCE; store it in the receiver's env.
-const { subscription, signingSecret } = await sl.subscriptions.create({
+const { webhook, signingSecret } = await sl.webhooks.create({
   name: "whale-alerts",
   subgraphName: "transfers",
   tableName: "events",
@@ -507,7 +509,7 @@ const { subscription, signingSecret } = await sl.subscriptions.create({
 });
 ```
 
-### Chain subscriptions
+### Chain webhooks
 
 Pass `triggers` instead of `subgraphName`/`tableName`. The `trigger.*` builders
 are optional sugar — you can also pass raw objects (e.g.
@@ -521,7 +523,7 @@ import { SecondLayer, trigger } from "@secondlayer/sdk";
 
 const sl = new SecondLayer({ apiKey: process.env.INSTANCE_TOKEN });
 
-const { subscription, signingSecret } = await sl.subscriptions.create({
+const { webhook, signingSecret } = await sl.webhooks.create({
   name: "amm-swaps",
   url: "https://my-app.com/webhook",
   triggers: [
@@ -542,29 +544,29 @@ body `{ action: "apply", block_hash, block_height, tx_id, canonical, trigger,
 event }`. On reorg you get `chain.reorg.rollback` with `{ action: "rollback",
 fork_point_height, orphaned: [{ tx_id, event }] }`. Delivery is at-least-once: a
 tx surviving a reorg re-delivers an apply under its new `block_hash`, so key
-consumer state on `(tx_id, block_hash)`. Per-subscription HMAC signing (Standard
+consumer state on `(tx_id, block_hash)`. Per-webhook HMAC signing (Standard
 Webhooks) is unchanged for both kinds.
 
 ```typescript
 // Lifecycle (both kinds)
-await sl.subscriptions.update(id, { filter: { amount: { gte: "1000000" } } });
-await sl.subscriptions.pause(id);
-await sl.subscriptions.resume(id);
-await sl.subscriptions.rotateSecret(id); // returns new signing secret once
-const { data: deliveries } = await sl.subscriptions.deliveries(id);
+await sl.webhooks.update(id, { filter: { amount: { gte: "1000000" } } });
+await sl.webhooks.pause(id);
+await sl.webhooks.resume(id);
+await sl.webhooks.rotateSecret(id); // returns new signing secret once
+const { data: deliveries } = await sl.webhooks.deliveries(id);
 
 // Replay historical block range
-await sl.subscriptions.replay(id, { fromBlock: 180000, toBlock: 181000 });
+await sl.webhooks.replay(id, { fromBlock: 180000, toBlock: 181000 });
 
 // Dead-letter inspection + requeue
-const { data: dead } = await sl.subscriptions.dead(id);
-await sl.subscriptions.requeue(id, outboxId);
+const { data: dead } = await sl.webhooks.dead(id);
+await sl.webhooks.requeue(id, outboxId);
 ```
 
 ### Verifying deliveries
 
 Every delivery — any kind, any `format` — also carries a universal authenticity
-signature you can verify with one published key, no per-subscription secret. The
+signature you can verify with one published key, no per-webhook secret. The
 headers are `webhook-id`, `x-secondlayer-signature`, and
 `x-secondlayer-signature-keyid`; the signed content is `` `${webhook-id}.${rawBody}` ``
 (ed25519). Fetch the public key from `GET /public/streams/signing-key`.
@@ -590,7 +592,7 @@ verifySecondlayerSignature(
 ): boolean;
 ```
 
-Prefer the per-subscription HMAC (Standard Webhooks) secret instead? Use
+Prefer the per-webhook HMAC (Standard Webhooks) secret instead? Use
 `verifyWebhookSignature(rawBody, headers, secret)` — raw body first.
 
 ## x402 pay-per-call (accountless)

package/dist/index.d.ts

@@ -277,6 +277,7 @@ type ArchiveVerifyResult = {
 	reason?: string;
 };
 import { RangeDigest } from "@secondlayer/shared/archive/range-digest";
+import { ArchiveStatus } from "@secondlayer/shared/archive/status";
 type ArchiveDataset = "blocks" | "transactions" | "events";
 type ArchiveFlow = "bootstrap" | "repair";
 type ArchivePartition = {
@@ -346,7 +347,7 @@ type ArchiveLoadOptions = {
 type ArchiveClient = {
 	latest(against?: string, opts?: ArchiveLoadOptions): Promise<LoadedArchive>;
 	load(against: string, opts?: ArchiveLoadOptions): Promise<LoadedArchive>;
-	status(): Promise<unknown>;
+	status(): Promise<ArchiveStatus>;
 	partitions(ref: LoadedArchive, filter?: {
 		dataset?: ArchiveDataset;
 		fromBlock?: number;
@@ -2563,25 +2564,43 @@ declare class Index extends BaseClient {
 	private walkPoxCycles;
 	private getPoxCycle;
 }
-import { CreateSubscriptionRequest, CreateSubscriptionResponse, DeadRow, DeliveryRow, ReplayResult, RotateSecretResponse, SubscriptionDetail, SubscriptionSummary, SubscriptionTestResult, UpdateSubscriptionRequest } from "@secondlayer/shared/schemas/subscriptions";
-import { ChainTrigger, ChainTriggerType, CreateSubscriptionRequest as CreateSubscriptionRequest2, CreateSubscriptionResponse as CreateSubscriptionResponse2, DeadRow as DeadRow2, DeliveryRow as DeliveryRow2, ReplayResult as ReplayResult2, RotateSecretResponse as RotateSecretResponse2, SubscriptionDetail as SubscriptionDetail2, SubscriptionFormat, SubscriptionKind, SubscriptionRuntime, SubscriptionStatus, SubscriptionSummary as SubscriptionSummary2, UpdateSubscriptionRequest as UpdateSubscriptionRequest2 } from "@secondlayer/shared/schemas/subscriptions";
-import { trigger } from "@secondlayer/shared/schemas/subscriptions";
-declare class Subscriptions extends BaseClient {
+import { CreateWebhookRequest, CreateWebhookResponse, DeadRow, DeliveryRow, ReplayResult, RotateSecretResponse, UpdateWebhookRequest, WebhookDetail, WebhookFormat, WebhookKind, WebhookRuntime, WebhookStatus, WebhookSummary, WebhookTestResult } from "@secondlayer/shared/schemas/webhooks";
+import { ChainTrigger, ChainTriggerType, CreateWebhookRequest as CreateWebhookRequest2, CreateWebhookResponse as CreateWebhookResponse2, DeadRow as DeadRow2, DeliveryRow as DeliveryRow2, ReplayResult as ReplayResult2, RotateSecretResponse as RotateSecretResponse2, WebhookDetail as WebhookDetail2, WebhookFormat as WebhookFormat2, WebhookKind as WebhookKind2, WebhookRuntime as WebhookRuntime2, WebhookStatus as WebhookStatus2, WebhookSummary as WebhookSummary2, WebhookTestResult as WebhookTestResult2, UpdateWebhookRequest as UpdateWebhookRequest2 } from "@secondlayer/shared/schemas/webhooks";
+import { trigger } from "@secondlayer/shared/schemas/webhooks";
+/** @deprecated Use webhook type. Removed next minor. */
+type CreateSubscriptionRequest = CreateWebhookRequest;
+/** @deprecated Use webhook type. Removed next minor. */
+type CreateSubscriptionResponse = CreateWebhookResponse;
+/** @deprecated Use webhook type. Removed next minor. */
+type UpdateSubscriptionRequest = UpdateWebhookRequest;
+/** @deprecated Use webhook type. Removed next minor. */
+type SubscriptionDetail = WebhookDetail;
+/** @deprecated Use webhook type. Removed next minor. */
+type SubscriptionSummary = WebhookSummary;
+/** @deprecated Use webhook type. Removed next minor. */
+type SubscriptionFormat = WebhookFormat;
+/** @deprecated Use webhook type. Removed next minor. */
+type SubscriptionKind = WebhookKind;
+/** @deprecated Use webhook type. Removed next minor. */
+type SubscriptionRuntime = WebhookRuntime;
+/** @deprecated Use webhook type. Removed next minor. */
+type SubscriptionStatus = WebhookStatus;
+declare class Webhooks extends BaseClient {
 	list(): Promise<{
-		data: SubscriptionSummary[];
+		data: WebhookSummary[];
 	}>;
-	get(id: string): Promise<SubscriptionDetail>;
-	create(input: CreateSubscriptionRequest): Promise<CreateSubscriptionResponse>;
-	update(id: string, patch: UpdateSubscriptionRequest): Promise<SubscriptionDetail>;
-	pause(id: string): Promise<SubscriptionDetail>;
-	resume(id: string): Promise<SubscriptionDetail>;
+	get(id: string): Promise<WebhookDetail>;
+	create(input: CreateWebhookRequest): Promise<CreateWebhookResponse>;
+	update(id: string, patch: UpdateWebhookRequest): Promise<WebhookDetail>;
+	pause(id: string): Promise<WebhookDetail>;
+	resume(id: string): Promise<WebhookDetail>;
 	delete(id: string): Promise<{
 		ok: true;
 	}>;
 	rotateSecret(id: string): Promise<RotateSecretResponse>;
-	/** Send a one-off test webhook to the subscription's URL (built for its
+	/** Send a one-off test webhook to the webhook's URL (built for its
 	*  format, SSRF-guarded). Logged as a delivery row, visible via deliveries. */
-	test(id: string): Promise<SubscriptionTestResult>;
+	test(id: string): Promise<WebhookTestResult>;
 	/** The last 100 delivery attempts, newest first. The server caps the window;
 	*  there is nothing to page. */
 	deliveries(id: string): Promise<{
@@ -2601,6 +2620,10 @@ declare class Subscriptions extends BaseClient {
 		ok: true;
 	}>;
 }
+/** @deprecated Use {@link Webhooks}. Removed in the next minor. */
+declare const Subscriptions: typeof Webhooks;
+/** @deprecated Use {@link Webhooks}. Removed in the next minor. */
+type Subscriptions = Webhooks;
 interface ContextAccount {
 	email: string;
 }
@@ -2642,6 +2665,11 @@ interface ContextSnapshot {
 	streamsTip: ContextField<StreamsTip>;
 	indexTip: ContextField<IndexTip>;
 	subgraphs: ContextField<SubgraphSummary2[]>;
+	webhooks: ContextField<{
+		count: number;
+		byStatus: Record<string, number>;
+	}>;
+	/** @deprecated Use {@link ContextSnapshot.webhooks}. Removed next minor. */
 	subscriptions: ContextField<{
 		count: number;
 		byStatus: Record<string, number>;
@@ -2660,9 +2688,11 @@ declare class SecondLayer extends BaseClient {
 	readonly index: Index;
 	readonly contracts: Contracts;
 	readonly subgraphs: Subgraphs;
-	readonly subscriptions: Subscriptions;
+	readonly webhooks: Webhooks;
 	readonly archive: SecondLayerArchive;
 	readonly instance: InstanceClient;
+	/** @deprecated Use `webhooks`. Removed next minor. */
+	get subscriptions(): Webhooks;
 	constructor(options?: Partial<SecondLayerOptions>);
 	/**
 	* Up to 10 public reads in one round trip (`POST /v1/batch`). Each item
@@ -2988,7 +3018,7 @@ type WebhookHeaderInput = HeaderLookup | StandardWebhooksHeaders | Record<string
 /**
 * Verify a Secondlayer webhook delivery signature.
 *
-* Every delivery whose subscription `format` is `"standard-webhooks"` (the
+* Every delivery whose webhook `format` is `"standard-webhooks"` (the
 * default) carries three Standard Webhooks headers:
 *
 *   webhook-id         — UUID for the delivery (stable across retries; use as
@@ -2997,7 +3027,7 @@ type WebhookHeaderInput = HeaderLookup | StandardWebhooksHeaders | Record<string
 *   webhook-signature  — space-separated list of `v1,<base64-hmac>` tuples
 *
 * The signed content is `${id}.${timestamp}.${rawBody}` HMAC-SHA256 with the
-* signing secret. Secrets returned by `sl subscriptions create` (or
+* signing secret. Secrets returned by `secondlayer webhooks create` (or
 * `rotate-secret`) are a bare 64-character hex string used directly as the
 * HMAC key (its UTF-8 bytes) — this helper handles that. A `whsec_`-prefixed
 * base64 secret (the Svix convention) is also accepted and base64-decoded after
@@ -3018,7 +3048,7 @@ type WebhookHeaderInput = HeaderLookup | StandardWebhooksHeaders | Record<string
 *                        a header value by name. Header name matching is
 *                        case-insensitive.
 * @param secret          The signing secret returned by
-*                        `sl subscriptions create` / `rotateSecret` (a bare
+*                        `secondlayer webhooks create` / `rotateSecret` (a bare
 *                        64-char hex string). Pass it through verbatim — the
 *                        helper accepts both bare hex and `whsec_`-prefixed
 *                        base64 secrets.
@@ -3068,7 +3098,7 @@ declare function verifyWebhookSignature(rawBody: string, headers: WebhookHeaderI
 * Verify the universal Secondlayer authenticity signature that every delivery
 * carries, regardless of body format (`raw`, `cloudevents`, `standard-webhooks`,
 * …). This is the format-agnostic alternative to {@link verifyWebhookSignature}:
-* instead of a per-subscription HMAC secret, it checks an ed25519 signature over
+* instead of a per-webhook HMAC secret, it checks an ed25519 signature over
 * `${webhook-id}.${rawBody}` against Secondlayer's published public key — so one
 * key proves authenticity for any format.
 *
@@ -3095,18 +3125,18 @@ 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
+* Decode + narrow a chain 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
+* timestamp, data }`) — the webhook 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.
+* webhook payloads" doc for how to unwrap those.
 *
-* A chain-subscription delivery is NOT a Streams/Index event — do not run this
+* A chain webhook 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
@@ -3135,4 +3165,4 @@ declare function verifySecondlayerSignature(rawBody: string, headers: WebhookHea
 declare function decodeChainWebhook(rawBody: string): ChainWebhookDelivery;
 import { RewardSet as RewardSet2 } from "@secondlayer/shared/node/consensus";
 import { decodeClarityValue, toJsonSafe } from "@secondlayer/shared/streams-rows";
-export { verifyWebhookSignature, verifyTransactionProof, verify as verifyStandardWebhooksHeaders, verifySecondlayerSignature, trigger, toJsonSafe, shutdownSignal, resolveBaseUrl, resolveApiKey, resolveAccountKey, parseRetryAfter, 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, decode, createStreamsClient, createArchiveClient, contextField, consumerHealth, consumeIndexFeed, WithSinkTx, WebhookHeaderInput, WalkOptions, ValidationError, UpdateSubscriptionRequest2 as UpdateSubscriptionRequest, 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, StreamsTip, StreamsSubscription, 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, SinkTx, SecondLayerOptions, SecondLayerErrorOptions, SecondLayerError, SecondLayerArchive, SecondLayer, SbtcWithdrawalsWalkParams, SbtcWithdrawalsListParams, SbtcWithdrawalsEnvelope, SbtcWithdrawalSweptConfirmedEvent, SbtcWithdrawalStatus, SbtcWithdrawalEvent, SbtcWithdrawalEnvelope, SbtcSummaryEnvelope, SbtcResource, SbtcEventsWalkParams, SbtcEventsListParams, SbtcEventsEnvelope, SbtcEventsConsumeParams, SbtcEventTopic2 as SbtcEventTopic, SbtcDepositsWalkParams, SbtcDepositsListParams, SbtcDepositsEnvelope, SbtcDepositsConsumeParams, SbtcDepositEvent, SbtcDepositEnvelope, RotateSecretResponse2 as RotateSecretResponse, RewardSet2 as RewardSet, RequestOptions, ReplayResult2 as ReplayResult, RateLimitError, PublicStatus2 as PublicStatus, PrintSchemaResponse, PoxResource, PoxCyclesWalkParams, PoxCyclesListParams, PoxCyclesEnvelope, PoxCycleEnvelope, Pox5Resource, Pox5EventsWalkParams, Pox5EventsListParams, Pox5EventsEnvelope, NftTransfersWalkParams, NftTransfersResource, NftTransfersListParams, NftTransfersEnvelope, NftTransferPayload2 as NftTransferPayload, NftTransferEvent, NftTransfer, MempoolWalkParams, MempoolTransactionEnvelope, MempoolListParams, MempoolEnvelope, LoadedArchive, LOCAL_API_URL, InsufficientArchiveCreditsError, InstanceStatus, InstanceState, InstanceIssue, InstanceDiagnosis3 as InstanceDiagnosis, InstanceClient, 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, IndexEventFields, IndexEvent, IndexDiscovery, IndexContractCall, IndexConsumeOptions, IndexCanonicalBlock, IndexBlock, IndexAlwaysFields, Index, INSTANCE_TOKEN_ENV, INDEX_MAX_PAGE_SIZE, FtTransfersWalkParams, FtTransfersResource, FtTransfersListParams, FtTransfersEnvelope, FtTransferPayload2 as 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_REQUEST_TIMEOUT_MS, Cursor, CreateSubscriptionResponse2 as CreateSubscriptionResponse, CreateSubscriptionRequest2 as CreateSubscriptionRequest, CreateArchiveClientOptions, ContractsListParams, ContractsEnvelope, Contracts, ContractSummary, ContractConformance, ContractCallsWalkParams, ContractCallsListParams, ContractCallsEnvelope, ContractCallsConsumeParams, ContextSnapshot, ContextFieldError, ContextField, ContextAccount, ConsumerSink, ConsumerHealth, 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, BlocksWalkParams, BlocksListParams, BlocksEnvelope, BlockEnvelope, AuthError, ArchiveVerifyResult, ArchiveVerifyRangeStatus, ArchiveVerifyInput, ArchiveSignatureError, ArchiveQuote, ArchivePartition, ArchiveManifest, ArchiveLoadOptions, ArchiveGateNotConfiguredError, ArchiveFlow, ArchiveFetchResult, ArchiveFetchItem, ArchiveDataset, ArchiveCreditsBalance, ArchiveClient, ArchiveAuthError, ApiError, ActiveSubgraphOperation, ACCOUNT_KEY_ENV };
+export { verifyWebhookSignature, verifyTransactionProof, verify as verifyStandardWebhooksHeaders, verifySecondlayerSignature, trigger, toJsonSafe, shutdownSignal, resolveBaseUrl, resolveApiKey, resolveAccountKey, parseRetryAfter, 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, decode, createStreamsClient, createArchiveClient, contextField, consumerHealth, consumeIndexFeed, WithSinkTx, Webhooks, WebhookTestResult2 as WebhookTestResult, WebhookSummary2 as WebhookSummary, WebhookStatus2 as WebhookStatus, WebhookRuntime2 as WebhookRuntime, WebhookKind2 as WebhookKind, WebhookHeaderInput, WebhookFormat2 as WebhookFormat, WebhookDetail2 as WebhookDetail, WalkOptions, ValidationError, UpdateWebhookRequest2 as UpdateWebhookRequest, UpdateSubscriptionRequest, TransactionsWalkParams, TransactionsListParams, TransactionsEnvelope, TransactionProofVerifyResult, TransactionProof, TransactionEnvelope, Subscriptions, SubscriptionSummary, SubscriptionStatus, SubscriptionRuntime, SubscriptionKind, SubscriptionFormat, SubscriptionDetail, Subgraphs, SubgraphSpecOptions3 as SubgraphSpecOptions, SubgraphSpecFormat2 as SubgraphSpecFormat, SubgraphOperationStatus, SubgraphAgentSchema3 as SubgraphAgentSchema, StreamsTip, StreamsSubscription, 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, SinkTx, SecondLayerOptions, SecondLayerErrorOptions, SecondLayerError, SecondLayerArchive, SecondLayer, SbtcWithdrawalsWalkParams, SbtcWithdrawalsListParams, SbtcWithdrawalsEnvelope, SbtcWithdrawalSweptConfirmedEvent, SbtcWithdrawalStatus, SbtcWithdrawalEvent, SbtcWithdrawalEnvelope, SbtcSummaryEnvelope, SbtcResource, SbtcEventsWalkParams, SbtcEventsListParams, SbtcEventsEnvelope, SbtcEventsConsumeParams, SbtcEventTopic2 as SbtcEventTopic, SbtcDepositsWalkParams, SbtcDepositsListParams, SbtcDepositsEnvelope, SbtcDepositsConsumeParams, SbtcDepositEvent, SbtcDepositEnvelope, RotateSecretResponse2 as RotateSecretResponse, RewardSet2 as RewardSet, RequestOptions, ReplayResult2 as ReplayResult, RateLimitError, PublicStatus2 as PublicStatus, PrintSchemaResponse, PoxResource, PoxCyclesWalkParams, PoxCyclesListParams, PoxCyclesEnvelope, PoxCycleEnvelope, Pox5Resource, Pox5EventsWalkParams, Pox5EventsListParams, Pox5EventsEnvelope, NftTransfersWalkParams, NftTransfersResource, NftTransfersListParams, NftTransfersEnvelope, NftTransferPayload2 as NftTransferPayload, NftTransferEvent, NftTransfer, MempoolWalkParams, MempoolTransactionEnvelope, MempoolListParams, MempoolEnvelope, LoadedArchive, LOCAL_API_URL, InsufficientArchiveCreditsError, InstanceStatus, InstanceState, InstanceIssue, InstanceDiagnosis3 as InstanceDiagnosis, InstanceClient, 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, IndexEventFields, IndexEvent, IndexDiscovery, IndexContractCall, IndexConsumeOptions, IndexCanonicalBlock, IndexBlock, IndexAlwaysFields, Index, INSTANCE_TOKEN_ENV, INDEX_MAX_PAGE_SIZE, FtTransfersWalkParams, FtTransfersResource, FtTransfersListParams, FtTransfersEnvelope, FtTransferPayload2 as 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_REQUEST_TIMEOUT_MS, Cursor, CreateWebhookResponse2 as CreateWebhookResponse, CreateWebhookRequest2 as CreateWebhookRequest, CreateSubscriptionResponse, CreateSubscriptionRequest, CreateArchiveClientOptions, ContractsListParams, ContractsEnvelope, Contracts, ContractSummary, ContractConformance, ContractCallsWalkParams, ContractCallsListParams, ContractCallsEnvelope, ContractCallsConsumeParams, ContextSnapshot, ContextFieldError, ContextField, ContextAccount, ConsumerSink, ConsumerHealth, 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, BlocksWalkParams, BlocksListParams, BlocksEnvelope, BlockEnvelope, AuthError, ArchiveVerifyResult, ArchiveVerifyRangeStatus, ArchiveVerifyInput, ArchiveStatus, ArchiveSignatureError, ArchiveQuote, ArchivePartition, ArchiveManifest, ArchiveLoadOptions, ArchiveGateNotConfiguredError, ArchiveFlow, ArchiveFetchResult, ArchiveFetchItem, ArchiveDataset, ArchiveCreditsBalance, ArchiveClient, ArchiveAuthError, ApiError, ActiveSubgraphOperation, ACCOUNT_KEY_ENV };

package/dist/index.js

@@ -983,7 +983,7 @@ function createArchiveClient(options = {}) {
     if (!response.ok) {
       throw new ApiError(response.status, `Could not fetch archive status (${response.status}).`);
     }
-    return response.json();
+    return await response.json();
   }
   function partitions(ref, filter) {
     let list = ref.manifest.partitions ?? [];
@@ -2448,50 +2448,51 @@ function createStreamsClient(options) {
   };
 }
 
-// src/subscriptions/client.ts
-import { trigger } from "@secondlayer/shared/schemas/subscriptions";
+// src/webhooks/client.ts
+import { trigger } from "@secondlayer/shared/schemas/webhooks";
 
-class Subscriptions extends BaseClient {
+class Webhooks extends BaseClient {
   async list() {
-    return this.request("GET", "/api/subscriptions");
+    return this.request("GET", "/api/webhooks");
   }
   async get(id) {
-    return this.request("GET", `/api/subscriptions/${seg(id)}`);
+    return this.request("GET", `/api/webhooks/${seg(id)}`);
   }
   async create(input) {
-    return this.request("POST", "/api/subscriptions", input);
+    return this.request("POST", "/api/webhooks", input);
   }
   async update(id, patch) {
-    return this.request("PATCH", `/api/subscriptions/${seg(id)}`, patch);
+    return this.request("PATCH", `/api/webhooks/${seg(id)}`, patch);
   }
   async pause(id) {
-    return this.request("POST", `/api/subscriptions/${seg(id)}/pause`);
+    return this.request("POST", `/api/webhooks/${seg(id)}/pause`);
   }
   async resume(id) {
-    return this.request("POST", `/api/subscriptions/${seg(id)}/resume`);
+    return this.request("POST", `/api/webhooks/${seg(id)}/resume`);
   }
   async delete(id) {
-    return this.request("DELETE", `/api/subscriptions/${seg(id)}`);
+    return this.request("DELETE", `/api/webhooks/${seg(id)}`);
   }
   async rotateSecret(id) {
-    return this.request("POST", `/api/subscriptions/${seg(id)}/rotate-secret`);
+    return this.request("POST", `/api/webhooks/${seg(id)}/rotate-secret`);
   }
   async test(id) {
-    return this.request("POST", `/api/subscriptions/${seg(id)}/test`);
+    return this.request("POST", `/api/webhooks/${seg(id)}/test`);
   }
   async deliveries(id) {
-    return this.request("GET", `/api/subscriptions/${seg(id)}/deliveries`);
+    return this.request("GET", `/api/webhooks/${seg(id)}/deliveries`);
   }
   async replay(id, range) {
-    return this.request("POST", `/api/subscriptions/${seg(id)}/replay`, range);
+    return this.request("POST", `/api/webhooks/${seg(id)}/replay`, range);
   }
   async dead(id) {
-    return this.request("GET", `/api/subscriptions/${seg(id)}/dead`);
+    return this.request("GET", `/api/webhooks/${seg(id)}/dead`);
   }
   async requeue(id, outboxId) {
-    return this.request("POST", `/api/subscriptions/${seg(id)}/dead/${seg(outboxId)}/requeue`);
+    return this.request("POST", `/api/webhooks/${seg(id)}/dead/${seg(outboxId)}/requeue`);
   }
 }
+var Subscriptions = Webhooks;
 
 // src/client.ts
 async function contextField(read) {
@@ -2524,9 +2525,12 @@ class SecondLayer extends BaseClient {
   index;
   contracts;
   subgraphs;
-  subscriptions;
+  webhooks;
   archive;
   instance;
+  get subscriptions() {
+    return this.webhooks;
+  }
   constructor(options = {}) {
     super(options);
     this.streams = createStreamsClient({
@@ -2541,7 +2545,7 @@ class SecondLayer extends BaseClient {
     this.index = new Index(options);
     this.contracts = new Contracts(options);
     this.subgraphs = new Subgraphs(options);
-    this.subscriptions = new Subscriptions(options);
+    this.webhooks = new Webhooks(options);
     const request = (method, path, body) => this.request(method, path, body);
     this.archive = {
       ...createArchiveClient({
@@ -2558,36 +2562,29 @@ class SecondLayer extends BaseClient {
     return this.request("POST", "/v1/batch", { requests });
   }
   async context() {
-    const [
-      account,
-      streamsTip,
-      indexEnv,
-      subgraphsRes,
-      subscriptionsRes,
-      instance
-    ] = await Promise.all([
+    const [account, streamsTip, indexEnv, subgraphsRes, webhooksRes, instance] = await Promise.all([
       contextField(this.request("GET", "/api/accounts/me")),
       contextField(this.streams.tip()),
       contextField(this.index.canonical.list({ limit: 1 })),
       contextField(this.subgraphs.list()),
-      contextField(this.subscriptions.list()),
+      contextField(this.webhooks.list()),
       contextField(this.instance.diagnose())
     ]);
     const subgraphs = {
       value: subgraphsRes.value?.data ?? null,
       ...subgraphsRes.error ? { error: subgraphsRes.error } : {}
     };
-    const subscriptions = {
+    const webhooks = {
       value: null,
-      ...subscriptionsRes.error ? { error: subscriptionsRes.error } : {}
+      ...webhooksRes.error ? { error: webhooksRes.error } : {}
     };
-    if (subscriptionsRes.value) {
+    if (webhooksRes.value) {
       const byStatus = {};
-      for (const s of subscriptionsRes.value.data) {
+      for (const s of webhooksRes.value.data) {
         byStatus[s.status] = (byStatus[s.status] ?? 0) + 1;
       }
-      subscriptions.value = {
-        count: subscriptionsRes.value.data.length,
+      webhooks.value = {
+        count: webhooksRes.value.data.length,
         byStatus
       };
     }
@@ -2622,7 +2619,8 @@ class SecondLayer extends BaseClient {
         ...indexEnv.error ? { error: indexEnv.error } : {}
       },
       subgraphs,
-      subscriptions,
+      webhooks,
+      subscriptions: webhooks,
       activeOperations,
       instance
     };
@@ -2710,7 +2708,7 @@ function shutdownSignal(options = {}) {
   }
   return controller.signal;
 }
-// src/webhooks.ts
+// src/webhooks/verify.ts
 import { verifySecondlayerSignatureValues } from "@secondlayer/shared/crypto/secondlayer-webhook";
 import {
   verify
@@ -2762,10 +2760,10 @@ function verifySecondlayerSignature(rawBody, headers, 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 }");
+    throw new Error("decodeChainWebhook: not a chain webhook delivery — expected { type, timestamp, data }");
   }
   if (!parsed.type.startsWith("chain.")) {
-    throw new Error(`decodeChainWebhook: not a chain-subscription delivery (type "${parsed.type}")`);
+    throw new Error(`decodeChainWebhook: not a chain webhook delivery (type "${parsed.type}")`);
   }
   const data = parsed.data;
   if (parsed.type === "chain.test.apply") {
@@ -2911,6 +2909,7 @@ export {
   contextField,
   consumerHealth,
   consumeIndexFeed,
+  Webhooks,
   ValidationError,
   Subscriptions,
   Subgraphs,
@@ -2935,5 +2934,5 @@ export {
   ACCOUNT_KEY_ENV
 };
 
-//# debugId=4C4D7DCC9A7B5FE064756E2164756E21
+//# debugId=6F925903665843A164756E2164756E21
 //# sourceMappingURL=index.js.map