@secondlayer/shared 6.37.1 → 6.39.0

package/dist/src/db/schema.d.ts

@@ -518,6 +518,29 @@ interface SbtcTokenEventsTable {
 	source_cursor: string;
 	created_at: Generated<Date>;
 }
+/**
+* BTC L1 settlement status for sBTC withdrawal sweeps. Filled by the indexer's
+* settlement-confirmer worker, which polls our own bitcoind for confirmations of
+* each `withdrawal-accept`'s `sweep_txid` and surfaces real settlement on the
+* withdrawal lifecycle (the API's `settlement.{btc_confirmations,
+* settlement_confirmed}` placeholder). Keyed on `sweep_txid` (not `request_id`):
+* a request can produce more than one sweep over its life (RBF/rebroadcast), so
+* each broadcast keeps its own confirmation history.
+*/
+interface SbtcSettlementsTable {
+	sweep_txid: string;
+	request_id: number;
+	btc_confirmations: Generated<number>;
+	settlement_confirmed: Generated<boolean>;
+	/** Confirming Bitcoin block — null while the sweep is unconfirmed. */
+	block_hash: string | null;
+	block_height: number | null;
+	first_seen_at: Generated<Date>;
+	last_checked_at: Generated<Date>;
+	/** Set once, when `settlement_confirmed` first flips true. */
+	confirmed_at: Date | null;
+	updated_at: Generated<Date>;
+}
 interface SbtcSupplySnapshotsTable {
 	date: string;
 	total_supply: Generated<string>;
@@ -665,6 +688,7 @@ interface Database {
 	burn_block_reward_slots: BurnBlockRewardSlotsTable;
 	sbtc_events: SbtcEventsTable;
 	sbtc_token_events: SbtcTokenEventsTable;
+	sbtc_settlements: SbtcSettlementsTable;
 	sbtc_supply_snapshots: SbtcSupplySnapshotsTable;
 	bns_name_events: BnsNameEventsTable;
 	bns_namespace_events: BnsNamespaceEventsTable;
@@ -955,7 +979,10 @@ type InsertSubscriptionDelivery = Insertable<SubscriptionDeliveriesTable>;
 interface TriggerEvaluatorStateTable {
 	id: Generated<boolean>;
 	last_processed_block: ColumnType<bigint, bigint | number | undefined, bigint | number>;
+	/** Watermark for the async sBTC settlement-confirmed webhook scan; null until
+	*  the evaluator fast-forwards it on first run. */
+	last_settlement_scan_at: ColumnType<Date | null, Date | null | undefined, Date | null>;
 	updated_at: Generated<Date>;
 }
 type TriggerEvaluatorState = Selectable<TriggerEvaluatorStateTable>;
-export { X402PaymentsTable, X402BalancesTable, UsageSnapshotsTable, UsageSnapshot, UsageDailyTable, UsageDaily, UpdateTransaction, UpdateTenantUsageMonthly, UpdateTenantComputeAddon, UpdateTenant, UpdateSubscriptionOutbox, UpdateSubscription, UpdateSubgraphOperation, UpdateSubgraph, UpdateProject, UpdateIndexProgress, UpdateEvent, UpdateContract, UpdateBlock, UpdateApiKey, UpdateAccountSpendCap, UpdateAccountCredits, TriggerEvaluatorStateTable, TriggerEvaluatorState, TransactionsTable, TransactionsArchiveTable, Transaction, TenantsTable, TenantUsageMonthlyTable, TenantUsageMonthly, TenantStatus, TenantComputeAddonsTable, TenantComputeAddon, Tenant, TeamMembersTable, TeamMember, TeamInvitationsTable, TeamInvitation, SubscriptionsTable, SubscriptionStatus, SubscriptionRuntime, SubscriptionOutboxTable, SubscriptionOutbox, SubscriptionKind, SubscriptionFormat, SubscriptionDelivery, SubscriptionDeliveriesTable, Subscription, SubgraphsTable, SubgraphUsageDailyTable, SubgraphUsageDaily, SubgraphTableSnapshotsTable, SubgraphProcessingStatsTable, SubgraphOperationsTable, SubgraphOperationStatus, SubgraphOperationKind, SubgraphOperation, SubgraphHealthSnapshotsTable, SubgraphHealthSnapshot, SubgraphGapsTable, SubgraphGap, Subgraph, SessionsTable, Session, ServiceHeartbeatsTable, SbtcTokenEventsTable, SbtcTokenEventType, SbtcSupplySnapshotsTable, SbtcEventsTable, SbtcEventTopic, ProvisioningAuditStatus, ProvisioningAuditLogTable, ProvisioningAuditLog, ProvisioningAuditEvent, ProjectsTable, Project, ProcessedStripeEventsTable, Pox4SignersDailyTable, Pox4FunctionName, Pox4CyclesDailyTable, Pox4CallsTable, OutboxStatus, MempoolTransactionsTable, MempoolTransaction, MagicLinksTable, MagicLink, InsertTransaction, InsertTenantUsageMonthly, InsertTenantComputeAddon, InsertTenant, InsertTeamMember, InsertTeamInvitation, InsertSubscriptionOutbox, InsertSubscriptionDelivery, InsertSubscription, InsertSubgraphUsageDaily, InsertSubgraphOperation, InsertSubgraphHealthSnapshot, InsertSubgraphGap, InsertSubgraph, InsertSession, InsertProvisioningAuditLog, InsertProject, InsertMempoolTransaction, InsertMagicLink, InsertIndexProgress, InsertEvent, InsertContract, InsertClaimToken, InsertBlock, InsertApiKey, InsertAccountSpendCap, InsertAccountInsight, InsertAccountCredits, InsertAccountAgentRun, InsertAccount, IndexProgressTable, IndexProgress, EventsTable, EventsArchiveTable, Event, DecoderCheckpointsTable, DecodedEventsTable, DeadLetterEventsTable, Database, ContractsTable, Contract, ClaimTokensTable, ClaimToken, ChainReorgsTable, BurnBlockRewardsTable, BurnBlockRewardSlotsTable, BnsNamespacesTable, BnsNamespaceEventsTable, BnsNamespaceEventStatus, BnsNamesTable, BnsNameEventsTable, BnsNameEventTopic, BnsMarketplaceEventsTable, BnsMarketplaceAction, BlocksTable, Block, ApiKeysTable, ApiKey, AccountsTable, AccountSpendCapsTable, AccountSpendCap, AccountInsightsTable, AccountInsight, AccountCreditsTable, AccountCredits, AccountAgentRunsTable, AccountAgentRun, Account };
+export { X402PaymentsTable, X402BalancesTable, UsageSnapshotsTable, UsageSnapshot, UsageDailyTable, UsageDaily, UpdateTransaction, UpdateTenantUsageMonthly, UpdateTenantComputeAddon, UpdateTenant, UpdateSubscriptionOutbox, UpdateSubscription, UpdateSubgraphOperation, UpdateSubgraph, UpdateProject, UpdateIndexProgress, UpdateEvent, UpdateContract, UpdateBlock, UpdateApiKey, UpdateAccountSpendCap, UpdateAccountCredits, TriggerEvaluatorStateTable, TriggerEvaluatorState, TransactionsTable, TransactionsArchiveTable, Transaction, TenantsTable, TenantUsageMonthlyTable, TenantUsageMonthly, TenantStatus, TenantComputeAddonsTable, TenantComputeAddon, Tenant, TeamMembersTable, TeamMember, TeamInvitationsTable, TeamInvitation, SubscriptionsTable, SubscriptionStatus, SubscriptionRuntime, SubscriptionOutboxTable, SubscriptionOutbox, SubscriptionKind, SubscriptionFormat, SubscriptionDelivery, SubscriptionDeliveriesTable, Subscription, SubgraphsTable, SubgraphUsageDailyTable, SubgraphUsageDaily, SubgraphTableSnapshotsTable, SubgraphProcessingStatsTable, SubgraphOperationsTable, SubgraphOperationStatus, SubgraphOperationKind, SubgraphOperation, SubgraphHealthSnapshotsTable, SubgraphHealthSnapshot, SubgraphGapsTable, SubgraphGap, Subgraph, SessionsTable, Session, ServiceHeartbeatsTable, SbtcTokenEventsTable, SbtcTokenEventType, SbtcSupplySnapshotsTable, SbtcSettlementsTable, SbtcEventsTable, SbtcEventTopic, ProvisioningAuditStatus, ProvisioningAuditLogTable, ProvisioningAuditLog, ProvisioningAuditEvent, ProjectsTable, Project, ProcessedStripeEventsTable, Pox4SignersDailyTable, Pox4FunctionName, Pox4CyclesDailyTable, Pox4CallsTable, OutboxStatus, MempoolTransactionsTable, MempoolTransaction, MagicLinksTable, MagicLink, InsertTransaction, InsertTenantUsageMonthly, InsertTenantComputeAddon, InsertTenant, InsertTeamMember, InsertTeamInvitation, InsertSubscriptionOutbox, InsertSubscriptionDelivery, InsertSubscription, InsertSubgraphUsageDaily, InsertSubgraphOperation, InsertSubgraphHealthSnapshot, InsertSubgraphGap, InsertSubgraph, InsertSession, InsertProvisioningAuditLog, InsertProject, InsertMempoolTransaction, InsertMagicLink, InsertIndexProgress, InsertEvent, InsertContract, InsertClaimToken, InsertBlock, InsertApiKey, InsertAccountSpendCap, InsertAccountInsight, InsertAccountCredits, InsertAccountAgentRun, InsertAccount, IndexProgressTable, IndexProgress, EventsTable, EventsArchiveTable, Event, DecoderCheckpointsTable, DecodedEventsTable, DeadLetterEventsTable, Database, ContractsTable, Contract, ClaimTokensTable, ClaimToken, ChainReorgsTable, BurnBlockRewardsTable, BurnBlockRewardSlotsTable, BnsNamespacesTable, BnsNamespaceEventsTable, BnsNamespaceEventStatus, BnsNamesTable, BnsNameEventsTable, BnsNameEventTopic, BnsMarketplaceEventsTable, BnsMarketplaceAction, BlocksTable, Block, ApiKeysTable, ApiKey, AccountsTable, AccountSpendCapsTable, AccountSpendCap, AccountInsightsTable, AccountInsight, AccountCreditsTable, AccountCredits, AccountAgentRunsTable, AccountAgentRun, Account };

package/dist/src/index.d.ts

@@ -518,6 +518,29 @@ interface SbtcTokenEventsTable {
 	source_cursor: string;
 	created_at: Generated<Date>;
 }
+/**
+* BTC L1 settlement status for sBTC withdrawal sweeps. Filled by the indexer's
+* settlement-confirmer worker, which polls our own bitcoind for confirmations of
+* each `withdrawal-accept`'s `sweep_txid` and surfaces real settlement on the
+* withdrawal lifecycle (the API's `settlement.{btc_confirmations,
+* settlement_confirmed}` placeholder). Keyed on `sweep_txid` (not `request_id`):
+* a request can produce more than one sweep over its life (RBF/rebroadcast), so
+* each broadcast keeps its own confirmation history.
+*/
+interface SbtcSettlementsTable {
+	sweep_txid: string;
+	request_id: number;
+	btc_confirmations: Generated<number>;
+	settlement_confirmed: Generated<boolean>;
+	/** Confirming Bitcoin block — null while the sweep is unconfirmed. */
+	block_hash: string | null;
+	block_height: number | null;
+	first_seen_at: Generated<Date>;
+	last_checked_at: Generated<Date>;
+	/** Set once, when `settlement_confirmed` first flips true. */
+	confirmed_at: Date | null;
+	updated_at: Generated<Date>;
+}
 interface SbtcSupplySnapshotsTable {
 	date: string;
 	total_supply: Generated<string>;
@@ -665,6 +688,7 @@ interface Database {
 	burn_block_reward_slots: BurnBlockRewardSlotsTable;
 	sbtc_events: SbtcEventsTable;
 	sbtc_token_events: SbtcTokenEventsTable;
+	sbtc_settlements: SbtcSettlementsTable;
 	sbtc_supply_snapshots: SbtcSupplySnapshotsTable;
 	bns_name_events: BnsNameEventsTable;
 	bns_namespace_events: BnsNamespaceEventsTable;
@@ -955,6 +979,9 @@ type InsertSubscriptionDelivery = Insertable<SubscriptionDeliveriesTable>;
 interface TriggerEvaluatorStateTable {
 	id: Generated<boolean>;
 	last_processed_block: ColumnType<bigint, bigint | number | undefined, bigint | number>;
+	/** Watermark for the async sBTC settlement-confirmed webhook scan; null until
+	*  the evaluator fast-forwards it on first run. */
+	last_settlement_scan_at: ColumnType<Date | null, Date | null | undefined, Date | null>;
 	updated_at: Generated<Date>;
 }
 type TriggerEvaluatorState = Selectable<TriggerEvaluatorStateTable>;
@@ -1832,6 +1859,7 @@ declare const TABLE_TO_DB: {
 	burn_block_reward_slots: string
 	sbtc_events: string
 	sbtc_token_events: string
+	sbtc_settlements: string
 	sbtc_supply_snapshots: string
 	bns_name_events: string
 	bns_namespace_events: string
@@ -2379,7 +2407,7 @@ declare const SubscriptionFilterPrimitiveSchema: z4.ZodType<SubscriptionFilterPr
 declare const SubscriptionFilterOperatorSchema: z4.ZodType<SubscriptionFilterOperator>;
 declare const SubscriptionFilterClauseSchema: z4.ZodType<SubscriptionFilterClause>;
 declare const SubscriptionFilterSchema: z4.ZodType<SubscriptionFilter>;
-declare const CHAIN_TRIGGER_TYPES: readonly ["stx_transfer", "stx_mint", "stx_burn", "stx_lock", "ft_transfer", "ft_mint", "ft_burn", "nft_transfer", "nft_mint", "nft_burn", "contract_call", "contract_deploy", "print_event", "sbtc_deposit", "sbtc_withdrawal_create", "sbtc_withdrawal_accept", "sbtc_withdrawal_reject"];
+declare const CHAIN_TRIGGER_TYPES: readonly ["stx_transfer", "stx_mint", "stx_burn", "stx_lock", "ft_transfer", "ft_mint", "ft_burn", "nft_transfer", "nft_mint", "nft_burn", "contract_call", "contract_deploy", "print_event", "sbtc_deposit", "sbtc_withdrawal_create", "sbtc_withdrawal_accept", "sbtc_withdrawal_reject", "sbtc_withdrawal_swept_confirmed"];
 /**
 * Per-type accepted filter fields for chain triggers, DERIVED from
 * {@link ChainTriggerSchema} so the agent-facing reference can never drift behind
@@ -2498,6 +2526,10 @@ type ChainTrigger = {
 } | {
 	type: "sbtc_withdrawal_reject"
 	requestId?: number
+} | {
+	type: "sbtc_withdrawal_swept_confirmed"
+	requestId?: number
+	sweepTxid?: string
 };
 interface CreateSubscriptionRequest {
 	name: string;
@@ -2776,18 +2808,33 @@ interface SbtcDepositEvent {
 	block_height: number;
 	tx_id: string;
 }
-/** Payload for `sbtc_withdrawal_create`, `sbtc_withdrawal_accept`, `sbtc_withdrawal_reject`. */
+/** Payload for `sbtc_withdrawal_create`, `sbtc_withdrawal_accept`, `sbtc_withdrawal_reject` —
+*  the on-Stacks lifecycle events. `settlement_confirmed` is always false here; the
+*  BTC L1 confirmation is delivered separately as `SbtcWithdrawalSweptConfirmedEvent`. */
 interface SbtcWithdrawalEvent {
 	topic: "withdrawal-create" | "withdrawal-accept" | "withdrawal-reject";
 	request_id: number;
 	sender: string | null;
 	amount: string | null;
 	sweep_txid: string | null;
-	/** Always false until the BTC L1 confirmer ships. */
 	settlement_confirmed: false;
 	block_height: number;
 	tx_id: string;
 }
+/** Payload for `sbtc_withdrawal_swept_confirmed` — fired once when a peg-out's
+*  committed BTC sweep crosses the confirmation threshold on Bitcoin. Anchored to
+*  the Stacks `withdrawal-accept` event (block_height/tx_id in the envelope); the
+*  Bitcoin-side specifics live here. */
+interface SbtcWithdrawalSweptConfirmedEvent {
+	topic: "withdrawal-swept-confirmed";
+	request_id: number;
+	sweep_txid: string;
+	btc_confirmations: number;
+	btc_block_height: number | null;
+	confirmed_at: string | null;
+	amount: string | null;
+	sender: string | null;
+}
 /**
 * Delivered when a matched chain event lands in a canonical block
 * (`event_type: "chain.<trigger>.apply"`). Tx-level triggers (contract_call /
@@ -2803,7 +2850,7 @@ interface ChainApplyEnvelope {
 	canonical: true;
 	/** The chain-trigger type that matched. */
 	trigger: ChainTrigger["type"];
-	event: SbtcDepositEvent | SbtcWithdrawalEvent | Record<string, unknown>;
+	event: SbtcDepositEvent | SbtcWithdrawalEvent | SbtcWithdrawalSweptConfirmedEvent | Record<string, unknown>;
 }
 /** One orphaned delivery recalled by a reorg rollback. */
 interface ChainReorgOrphanedEntry {
@@ -2825,4 +2872,185 @@ interface ChainReorgRollbackEnvelope {
 }
 /** Any chain-subscription webhook body. Discriminate on `action`. */
 type ChainWebhookEnvelope = ChainApplyEnvelope | ChainReorgRollbackEnvelope;
-export { validateSubscriptionFilterForTable, sql, setMigrationRole, parseJsonb, onControlPlane, onChainPlane, logger, jsonb, isPox4DecoderEnabled, getTargetDb, getSourceDb, getRawClientFor, getRawClient, getMigrationRole, getErrorMessage, getEnv, getDbSplitStatus, getDb, generateSubgraphSpec, generateSubgraphOpenApi, generateSubgraphMarkdown, generateSubgraphAgentSchema, formatSubscriptionSchemaErrors, finalizedBurnHeight, encodeStreamsCursor, exports_ed25519 as ed25519, decodeStreamsCursor, exports_hmac as crypto, closeDb, assertDbSplit, X402PaymentsTable, X402BalancesTable, VersionConflictError, ValidationError, UsageSnapshotsTable, UsageSnapshot, UsageDailyTable, UsageDaily, UpdateTransaction, UpdateTenantUsageMonthly, UpdateTenantComputeAddon, UpdateTenant, UpdateSubscriptionRequestSchema, UpdateSubscriptionRequest, UpdateSubscriptionOutbox, UpdateSubscription, UpdateSubgraphOperation, UpdateSubgraph, UpdateProject, UpdateIndexProgress, UpdateEvent, UpdateContract, UpdateBlock, UpdateApiKey, UpdateAccountSpendCap, UpdateAccountCredits, TriggerEvaluatorStateTable, TriggerEvaluatorState, TransactionsTable, TransactionsArchiveTable, Transaction, TenantsTable, TenantUsageMonthlyTable, TenantUsageMonthly, TenantSuspendedError, TenantStatus, TenantComputeAddonsTable, TenantComputeAddon, Tenant, TeamMembersTable, TeamMember, TeamInvitationsTable, TeamInvitation, TABLE_TO_DB, SubscriptionsTable, SubscriptionSummary, SubscriptionStatusSchema, SubscriptionStatus, SubscriptionSchemaTables, SubscriptionSchemaTable, SubscriptionSchemaColumn, SubscriptionRuntimeSchema, SubscriptionRuntime, SubscriptionOutboxTable, SubscriptionOutbox, SubscriptionKind, SubscriptionFormatSchema, SubscriptionFormat, SubscriptionFilterSchema, SubscriptionFilterPrimitiveSchema, SubscriptionFilterPrimitive, SubscriptionFilterOperatorSchema, SubscriptionFilterOperator, SubscriptionFilterClauseSchema, SubscriptionFilterClause, SubscriptionFilter, SubscriptionDetail, SubscriptionDelivery, SubscriptionDeliveriesTable, Subscription, SubgraphsTable, SubgraphUsageDailyTable, SubgraphUsageDaily, SubgraphTableSnapshotsTable, SubgraphSyncInfo, SubgraphSummary, SubgraphSpecOptions, SubgraphSpecFormat, SubgraphResourceWarning, SubgraphQueryParams, SubgraphProcessingStatsTable, SubgraphOperationsTable, SubgraphOperationStatus, SubgraphOperationKind, SubgraphOperation, SubgraphHealthSnapshotsTable, SubgraphHealthSnapshot, SubgraphGapsTable, SubgraphGapsResponse, SubgraphGapRange, SubgraphGapEntry, SubgraphGap, SubgraphDetail, SubgraphAggregateResponse, SubgraphAggregateParams, SubgraphAgentSchema, Subgraph, StxTransferFilterSchema, StxTransferFilter, StxMintFilterSchema, StxMintFilter, StxLockFilterSchema, StxLockFilter, StxBurnFilterSchema, StxBurnFilter, StreamsEventType, StreamsDbEventType, StreamsCursor, SessionsTable, Session, ServiceHeartbeatsTable, SecondLayerError, SbtcWithdrawalEvent, SbtcTokenEventsTable, SbtcTokenEventType, SbtcSupplySnapshotsTable, SbtcEventsTable, SbtcEventTopic, SbtcDepositEvent, SUBSCRIPTION_STATUSES, SUBSCRIPTION_RUNTIMES, SUBSCRIPTION_FORMATS, SUBSCRIPTION_FILTER_OPERATORS, STREAMS_TO_DB_EVENT_TYPES, STREAMS_EVENT_TYPES, STREAMS_DB_EVENT_TYPES, SOURCE_READ_TYPES, SOURCE_READ_PKS, SOURCE_READ_COLUMNS, RotateSecretResponse, ReplaySubscriptionRequestSchema, ReplaySubscriptionRequest, ReplayResult, ReindexResponse, RateLimitError, ProvisioningAuditStatus, ProvisioningAuditLogTable, ProvisioningAuditLog, ProvisioningAuditEvent, ProjectsTable, Project, ProcessedStripeEventsTable, PrintEventFilterSchema, PrintEventFilter, Pox4SignersDailyTable, Pox4FunctionName, Pox4CyclesDailyTable, Pox4CallsTable, PaymentRequiredError, ParsedUpdateSubscriptionRequest, ParsedReplaySubscriptionRequest, ParsedCreateSubscriptionRequest, OutboxStatus, NumericAsText, NotFoundError, NftTransferFilterSchema, NftTransferFilter, NftMintFilterSchema, NftMintFilter, NftBurnFilterSchema, NftBurnFilter, MigrationRole, MempoolTransactionsTable, MempoolTransaction, MagicLinksTable, MagicLink, KeyRotatedError, InsertTransaction, InsertTenantUsageMonthly, InsertTenantComputeAddon, InsertTenant, InsertTeamMember, InsertTeamInvitation, InsertSubscriptionOutbox, InsertSubscriptionDelivery, InsertSubscription, InsertSubgraphUsageDaily, InsertSubgraphOperation, InsertSubgraphHealthSnapshot, InsertSubgraphGap, InsertSubgraph, InsertSession, InsertProvisioningAuditLog, InsertProject, InsertMempoolTransaction, InsertMagicLink, InsertIndexProgress, InsertEvent, InsertContract, InsertClaimToken, InsertBlock, InsertApiKey, InsertAccountSpendCap, InsertAccountInsight, InsertAccountCredits, InsertAccountAgentRun, InsertAccount, IndexProgressTable, IndexProgress, IndexPrimaryKey, IndexColumnType, IndexColumn, FtTransferFilterSchema, FtTransferFilter, FtMintFilterSchema, FtMintFilter, FtBurnFilterSchema, FtBurnFilter, ForbiddenError, EventsTable, EventsArchiveTable, EventFilterSchema, EventFilter, Event, ErrorCodes, ErrorCode, Env, EMPTY_RANGE_EVENT_INDEX_SENTINEL, DeploySubgraphResponse, DeploySubgraphRequestSchema, DeploySubgraphRequest, DeliveryRow, DecoderCheckpointsTable, DecodedEventsTable, DecodedEventType, DeadRow, DeadLetterEventsTable, DbSplitStatus, DbReadRow, DbPlane, DatabaseError, Database, DEFAULT_BTC_CONFIRMATIONS, DECODED_EVENT_TYPES, DB_TO_STREAMS_EVENT_TYPE, CreateSubscriptionResponse, CreateSubscriptionRequestSchema, CreateSubscriptionRequest, ContractsTable, ContractDeployFilterSchema, ContractDeployFilter, ContractCallFilterSchema, ContractCallFilter, Contract, ClaimTokensTable, ClaimToken, ChainWebhookEnvelope, ChainReorgsTable, ChainReorgRollbackEnvelope, ChainReorgOrphanedEntry, ChainApplyEnvelope, CODE_TO_STATUS, CHAIN_TRIGGER_TYPES, CHAIN_TRIGGER_FIELDS, ByoBreakingChangeDetails, BurnBlockRewardsTable, BurnBlockRewardSlotsTable, BnsNamespacesTable, BnsNamespaceEventsTable, BnsNamespaceEventStatus, BnsNamesTable, BnsNameEventsTable, BnsNameEventTopic, BnsMarketplaceEventsTable, BnsMarketplaceAction, BlocksTable, Block, AuthorizationError, AuthenticationError, ApiKeysTable, ApiKey, AccountsTable, AccountSpendCapsTable, AccountSpendCap, AccountInsightsTable, AccountInsight, AccountCreditsTable, AccountCredits, AccountAgentRunsTable, AccountAgentRun, Account };
+/** `event.data` for a `stx_transfer` delivery. */
+interface ChainStxTransferData {
+	sender?: string;
+	recipient?: string;
+	amount: string;
+	/** Always present; `""` when the transfer carried no memo. */
+	memo: string;
+}
+/** `event.data` for a `stx_mint` delivery. */
+interface ChainStxMintData {
+	recipient?: string;
+	amount: string;
+}
+/** `event.data` for a `stx_burn` delivery. */
+interface ChainStxBurnData {
+	sender?: string;
+	amount: string;
+}
+/** `event.data` for a `stx_lock` delivery. */
+interface ChainStxLockData {
+	locked_address: string;
+	locked_amount: string;
+	unlock_height: string | null;
+}
+/** `event.data` for an `ft_transfer` delivery. */
+interface ChainFtTransferData {
+	asset_identifier: string;
+	sender?: string;
+	recipient?: string;
+	amount: string;
+}
+/** `event.data` for an `ft_mint` delivery. */
+interface ChainFtMintData {
+	asset_identifier: string;
+	recipient?: string;
+	amount: string;
+}
+/** `event.data` for an `ft_burn` delivery. */
+interface ChainFtBurnData {
+	asset_identifier: string;
+	sender?: string;
+	amount: string;
+}
+/**
+* `event.data` for an `nft_transfer` delivery. Unlike Streams' `NftTransferPayload`,
+* there is no decoded `value` field — only the canonical hex of the token-id
+* Clarity value (`raw_value`).
+*/
+interface ChainNftTransferData {
+	asset_identifier: string;
+	sender?: string;
+	recipient?: string;
+	raw_value: string;
+}
+/** `event.data` for an `nft_mint` delivery. See {@link ChainNftTransferData}. */
+interface ChainNftMintData {
+	asset_identifier: string;
+	recipient?: string;
+	raw_value: string;
+}
+/** `event.data` for an `nft_burn` delivery. See {@link ChainNftTransferData}. */
+interface ChainNftBurnData {
+	asset_identifier: string;
+	sender?: string;
+	raw_value: string;
+}
+/**
+* `event.data` for a `print_event` delivery. Note the field is
+* `contract_identifier` — Streams' `PrintPayload` uses `contract_id` for the
+* same contract, which is NOT the field name delivered here.
+*/
+interface ChainPrintEventData {
+	topic: string | null;
+	contract_identifier: string;
+	value: unknown;
+	raw_value: string | null;
+}
+/**
+* Wrapper around an event-level trigger's matched event. `type` is the node's
+* suffixed event-kind (`"stx_transfer_event"`, `"ft_mint_event"`, …) — EXCEPT
+* `print_event` triggers, whose `event.type` is `"contract_event"` (the node's
+* raw name for a print event), not `"print_event_event"`.
+*/
+interface ChainEventEnvelope<
+	TType extends string,
+	TData
+> {
+	tx_id: string;
+	type: TType;
+	event_index: number;
+	data: TData;
+}
+/**
+* A tx-level trigger's matched event (`contract_call` / `contract_deploy`) —
+* flat, no nested `data` key. `function_args` are RAW (undecoded) Clarity-value
+* hex strings in call order, not decoded values.
+*/
+interface ChainTxLevelEvent {
+	tx_id: string;
+	/** Stacks tx type, e.g. `"contract_call"` for a `contract_call` trigger or
+	*  `"smart_contract"` for a `contract_deploy` trigger — NOT `"contract_deploy"`. */
+	type: string;
+	sender: string;
+	status: string;
+	contract_id: string | null;
+	function_name: string | null;
+	/** Raw (undecoded) Clarity-value hex strings, in call order. */
+	function_args: string[] | null;
+	/** Raw hex of the tx's Clarity return value. */
+	result_hex: string | null;
+}
+/** One `apply` envelope, generic over its trigger literal + matched-event shape. */
+interface ChainApplyEnvelopeOf<
+	TTrigger extends ChainTrigger["type"],
+	TEvent
+> {
+	action: "apply";
+	block_hash: string;
+	block_height: number;
+	tx_id: string;
+	canonical: true;
+	trigger: TTrigger;
+	event: TEvent;
+}
+type ChainApplyDeliveryOf<
+	TTrigger extends ChainTrigger["type"],
+	TEvent
+> = {
+	type: `chain.${TTrigger}.apply`
+	timestamp: string
+	data: ChainApplyEnvelopeOf<TTrigger, TEvent>
+};
+/** Delivered once per affected subscription on a reorg (`type: "chain.reorg.rollback"`). */
+interface ChainReorgRollbackDelivery {
+	type: "chain.reorg.rollback";
+	timestamp: string;
+	data: ChainReorgRollbackEnvelope;
+}
+/** The `POST /subscriptions/:id/test` ping (`type: "chain.test.apply"`) — not a real chain event. */
+interface ChainTestDelivery {
+	type: "chain.test.apply";
+	timestamp: string;
+	data: {
+		test: true
+		message: string
+		subscription_id: string
+		sent_at: string
+	};
+}
+/**
+* The full wire body of a chain-subscription webhook delivery, as sent to a
+* `format: "standard-webhooks"` subscription (the default) — `{ type,
+* timestamp, data }`. Discriminate on `data.trigger` (or the top-level `type`)
+* to narrow `data.event`:
+*
+* ```ts
+* const delivery = decodeChainWebhook(rawBody);
+* if (delivery.data.action === "apply") {
+*   switch (delivery.data.trigger) {
+*     case "stx_transfer":
+*       delivery.data.event.data.amount; // typed
+*       break;
+*     case "contract_call":
+*       delivery.data.event.function_name; // typed, flat (no nested `.data`)
+*       break;
+*   }
+* }
+* ```
+*
+* NOTE: this is the DELIVERED webhook body, not a Streams/Index event — those
+* have an unrelated `{ event_type, payload }` shape (see `StreamsEvent` in
+* `@secondlayer/sdk`). Do not parse a chain-subscription delivery as a Streams
+* event or vice versa — mixing them up is the exact bug this type exists to
+* prevent.
+*
+* Other subscription `format`s (`raw`, `cloudevents`, `inngest`, `trigger`,
+* `cloudflare`) carry the same `data` value (a `ChainApplyEnvelope` /
+* `ChainReorgRollbackEnvelope`) under a different outer envelope — see the
+* "Chain subscription webhook payloads" doc.
+*/
+type ChainWebhookDelivery = ChainApplyDeliveryOf<"stx_transfer", ChainEventEnvelope<"stx_transfer_event", ChainStxTransferData>> | ChainApplyDeliveryOf<"stx_mint", ChainEventEnvelope<"stx_mint_event", ChainStxMintData>> | ChainApplyDeliveryOf<"stx_burn", ChainEventEnvelope<"stx_burn_event", ChainStxBurnData>> | ChainApplyDeliveryOf<"stx_lock", ChainEventEnvelope<"stx_lock_event", ChainStxLockData>> | ChainApplyDeliveryOf<"ft_transfer", ChainEventEnvelope<"ft_transfer_event", ChainFtTransferData>> | ChainApplyDeliveryOf<"ft_mint", ChainEventEnvelope<"ft_mint_event", ChainFtMintData>> | ChainApplyDeliveryOf<"ft_burn", ChainEventEnvelope<"ft_burn_event", ChainFtBurnData>> | ChainApplyDeliveryOf<"nft_transfer", ChainEventEnvelope<"nft_transfer_event", ChainNftTransferData>> | ChainApplyDeliveryOf<"nft_mint", ChainEventEnvelope<"nft_mint_event", ChainNftMintData>> | ChainApplyDeliveryOf<"nft_burn", ChainEventEnvelope<"nft_burn_event", ChainNftBurnData>> | ChainApplyDeliveryOf<"print_event", ChainEventEnvelope<"contract_event", ChainPrintEventData>> | ChainApplyDeliveryOf<"contract_call", ChainTxLevelEvent> | ChainApplyDeliveryOf<"contract_deploy", ChainTxLevelEvent> | ChainApplyDeliveryOf<"sbtc_deposit", SbtcDepositEvent> | ChainApplyDeliveryOf<"sbtc_withdrawal_create", SbtcWithdrawalEvent> | ChainApplyDeliveryOf<"sbtc_withdrawal_accept", SbtcWithdrawalEvent> | ChainApplyDeliveryOf<"sbtc_withdrawal_reject", SbtcWithdrawalEvent> | ChainApplyDeliveryOf<"sbtc_withdrawal_swept_confirmed", SbtcWithdrawalSweptConfirmedEvent> | ChainReorgRollbackDelivery | ChainTestDelivery;
+export { validateSubscriptionFilterForTable, sql, setMigrationRole, parseJsonb, onControlPlane, onChainPlane, logger, jsonb, isPox4DecoderEnabled, getTargetDb, getSourceDb, getRawClientFor, getRawClient, getMigrationRole, getErrorMessage, getEnv, getDbSplitStatus, getDb, generateSubgraphSpec, generateSubgraphOpenApi, generateSubgraphMarkdown, generateSubgraphAgentSchema, formatSubscriptionSchemaErrors, finalizedBurnHeight, encodeStreamsCursor, exports_ed25519 as ed25519, decodeStreamsCursor, exports_hmac as crypto, closeDb, assertDbSplit, X402PaymentsTable, X402BalancesTable, VersionConflictError, ValidationError, UsageSnapshotsTable, UsageSnapshot, UsageDailyTable, UsageDaily, UpdateTransaction, UpdateTenantUsageMonthly, UpdateTenantComputeAddon, UpdateTenant, UpdateSubscriptionRequestSchema, UpdateSubscriptionRequest, UpdateSubscriptionOutbox, UpdateSubscription, UpdateSubgraphOperation, UpdateSubgraph, UpdateProject, UpdateIndexProgress, UpdateEvent, UpdateContract, UpdateBlock, UpdateApiKey, UpdateAccountSpendCap, UpdateAccountCredits, TriggerEvaluatorStateTable, TriggerEvaluatorState, TransactionsTable, TransactionsArchiveTable, Transaction, TenantsTable, TenantUsageMonthlyTable, TenantUsageMonthly, TenantSuspendedError, TenantStatus, TenantComputeAddonsTable, TenantComputeAddon, Tenant, TeamMembersTable, TeamMember, TeamInvitationsTable, TeamInvitation, TABLE_TO_DB, SubscriptionsTable, SubscriptionSummary, SubscriptionStatusSchema, SubscriptionStatus, SubscriptionSchemaTables, SubscriptionSchemaTable, SubscriptionSchemaColumn, SubscriptionRuntimeSchema, SubscriptionRuntime, SubscriptionOutboxTable, SubscriptionOutbox, SubscriptionKind, SubscriptionFormatSchema, SubscriptionFormat, SubscriptionFilterSchema, SubscriptionFilterPrimitiveSchema, SubscriptionFilterPrimitive, SubscriptionFilterOperatorSchema, SubscriptionFilterOperator, SubscriptionFilterClauseSchema, SubscriptionFilterClause, SubscriptionFilter, SubscriptionDetail, SubscriptionDelivery, SubscriptionDeliveriesTable, Subscription, SubgraphsTable, SubgraphUsageDailyTable, SubgraphUsageDaily, SubgraphTableSnapshotsTable, SubgraphSyncInfo, SubgraphSummary, SubgraphSpecOptions, SubgraphSpecFormat, SubgraphResourceWarning, SubgraphQueryParams, SubgraphProcessingStatsTable, SubgraphOperationsTable, SubgraphOperationStatus, SubgraphOperationKind, SubgraphOperation, SubgraphHealthSnapshotsTable, SubgraphHealthSnapshot, SubgraphGapsTable, SubgraphGapsResponse, SubgraphGapRange, SubgraphGapEntry, SubgraphGap, SubgraphDetail, SubgraphAggregateResponse, SubgraphAggregateParams, SubgraphAgentSchema, Subgraph, StxTransferFilterSchema, StxTransferFilter, StxMintFilterSchema, StxMintFilter, StxLockFilterSchema, StxLockFilter, StxBurnFilterSchema, StxBurnFilter, StreamsEventType, StreamsDbEventType, StreamsCursor, SessionsTable, Session, ServiceHeartbeatsTable, SecondLayerError, SbtcWithdrawalSweptConfirmedEvent, SbtcWithdrawalEvent, SbtcTokenEventsTable, SbtcTokenEventType, SbtcSupplySnapshotsTable, SbtcSettlementsTable, SbtcEventsTable, SbtcEventTopic, SbtcDepositEvent, SUBSCRIPTION_STATUSES, SUBSCRIPTION_RUNTIMES, SUBSCRIPTION_FORMATS, SUBSCRIPTION_FILTER_OPERATORS, STREAMS_TO_DB_EVENT_TYPES, STREAMS_EVENT_TYPES, STREAMS_DB_EVENT_TYPES, SOURCE_READ_TYPES, SOURCE_READ_PKS, SOURCE_READ_COLUMNS, RotateSecretResponse, ReplaySubscriptionRequestSchema, ReplaySubscriptionRequest, ReplayResult, ReindexResponse, RateLimitError, ProvisioningAuditStatus, ProvisioningAuditLogTable, ProvisioningAuditLog, ProvisioningAuditEvent, ProjectsTable, Project, ProcessedStripeEventsTable, PrintEventFilterSchema, PrintEventFilter, Pox4SignersDailyTable, Pox4FunctionName, Pox4CyclesDailyTable, Pox4CallsTable, PaymentRequiredError, ParsedUpdateSubscriptionRequest, ParsedReplaySubscriptionRequest, ParsedCreateSubscriptionRequest, OutboxStatus, NumericAsText, NotFoundError, NftTransferFilterSchema, NftTransferFilter, NftMintFilterSchema, NftMintFilter, NftBurnFilterSchema, NftBurnFilter, MigrationRole, MempoolTransactionsTable, MempoolTransaction, MagicLinksTable, MagicLink, KeyRotatedError, InsertTransaction, InsertTenantUsageMonthly, InsertTenantComputeAddon, InsertTenant, InsertTeamMember, InsertTeamInvitation, InsertSubscriptionOutbox, InsertSubscriptionDelivery, InsertSubscription, InsertSubgraphUsageDaily, InsertSubgraphOperation, InsertSubgraphHealthSnapshot, InsertSubgraphGap, InsertSubgraph, InsertSession, InsertProvisioningAuditLog, InsertProject, InsertMempoolTransaction, InsertMagicLink, InsertIndexProgress, InsertEvent, InsertContract, InsertClaimToken, InsertBlock, InsertApiKey, InsertAccountSpendCap, InsertAccountInsight, InsertAccountCredits, InsertAccountAgentRun, InsertAccount, IndexProgressTable, IndexProgress, IndexPrimaryKey, IndexColumnType, IndexColumn, FtTransferFilterSchema, FtTransferFilter, FtMintFilterSchema, FtMintFilter, FtBurnFilterSchema, FtBurnFilter, ForbiddenError, EventsTable, EventsArchiveTable, EventFilterSchema, EventFilter, Event, ErrorCodes, ErrorCode, Env, EMPTY_RANGE_EVENT_INDEX_SENTINEL, DeploySubgraphResponse, DeploySubgraphRequestSchema, DeploySubgraphRequest, DeliveryRow, DecoderCheckpointsTable, DecodedEventsTable, DecodedEventType, DeadRow, DeadLetterEventsTable, DbSplitStatus, DbReadRow, DbPlane, DatabaseError, Database, DEFAULT_BTC_CONFIRMATIONS, DECODED_EVENT_TYPES, DB_TO_STREAMS_EVENT_TYPE, CreateSubscriptionResponse, CreateSubscriptionRequestSchema, CreateSubscriptionRequest, ContractsTable, ContractDeployFilterSchema, ContractDeployFilter, ContractCallFilterSchema, ContractCallFilter, Contract, ClaimTokensTable, ClaimToken, ChainWebhookEnvelope, ChainWebhookDelivery, ChainTxLevelEvent, ChainTestDelivery, ChainStxTransferData, ChainStxMintData, ChainStxLockData, ChainStxBurnData, ChainReorgsTable, ChainReorgRollbackEnvelope, ChainReorgRollbackDelivery, ChainReorgOrphanedEntry, ChainPrintEventData, ChainNftTransferData, ChainNftMintData, ChainNftBurnData, ChainFtTransferData, ChainFtMintData, ChainFtBurnData, ChainEventEnvelope, ChainApplyEnvelopeOf, ChainApplyEnvelope, CODE_TO_STATUS, CHAIN_TRIGGER_TYPES, CHAIN_TRIGGER_FIELDS, ByoBreakingChangeDetails, BurnBlockRewardsTable, BurnBlockRewardSlotsTable, BnsNamespacesTable, BnsNamespaceEventsTable, BnsNamespaceEventStatus, BnsNamesTable, BnsNameEventsTable, BnsNameEventTopic, BnsMarketplaceEventsTable, BnsMarketplaceAction, BlocksTable, Block, AuthorizationError, AuthenticationError, ApiKeysTable, ApiKey, AccountsTable, AccountSpendCapsTable, AccountSpendCap, AccountInsightsTable, AccountInsight, AccountCreditsTable, AccountCredits, AccountAgentRunsTable, AccountAgentRun, Account };

package/dist/src/index.js

@@ -665,6 +665,7 @@ var TABLE_TO_DB = {
   burn_block_reward_slots: "source",
   sbtc_events: "source",
   sbtc_token_events: "source",
+  sbtc_settlements: "source",
   sbtc_supply_snapshots: "source",
   bns_name_events: "source",
   bns_namespace_events: "source",
@@ -1180,7 +1181,8 @@ var CHAIN_TRIGGER_TYPES = [
   "sbtc_deposit",
   "sbtc_withdrawal_create",
   "sbtc_withdrawal_accept",
-  "sbtc_withdrawal_reject"
+  "sbtc_withdrawal_reject",
+  "sbtc_withdrawal_swept_confirmed"
 ];
 var triggerAmount = z4.union([
   z4.string().trim().regex(/^\d+$/, "must be a non-negative integer string"),
@@ -1293,6 +1295,11 @@ var ChainTriggerSchema = z4.discriminatedUnion("type", [
   z4.object({
     type: z4.literal("sbtc_withdrawal_reject"),
     requestId: z4.number().int().nonnegative().optional()
+  }).strict(),
+  z4.object({
+    type: z4.literal("sbtc_withdrawal_swept_confirmed"),
+    requestId: z4.number().int().nonnegative().optional(),
+    sweepTxid: triggerPattern.optional()
   }).strict()
 ]);
 var ChainTriggersSchema = z4.array(ChainTriggerSchema).min(1).max(50);
@@ -1417,6 +1424,10 @@ var trigger = {
   sbtcWithdrawalReject: (f = {}) => ({
     type: "sbtc_withdrawal_reject",
     ...f
+  }),
+  sbtcWithdrawalSweptConfirmed: (f = {}) => ({
+    type: "sbtc_withdrawal_swept_confirmed",
+    ...f
   })
 };
 var SCALAR_COLUMN_TYPES = new Set([
@@ -2143,5 +2154,5 @@ export {
   AuthenticationError
 };
 
-//# debugId=34B8177BC0CB5AEB64756E2164756E21
+//# debugId=39B8FB62F71153DE64756E2164756E21
 //# sourceMappingURL=index.js.map