@babylonlabs-io/ts-sdk 0.19.0 → 0.20.1

package/dist/tbv/core/services/deposit/peginState.d.ts

@@ -0,0 +1,93 @@
+/**
+ * Vault status — combines on-chain contract status (0-4) with indexer-derived
+ * statuses (5-7). The contract enum (BTCVaultRegistry.sol BTCVaultStatus) only
+ * has: Pending(0), Verified(1), Active(2), Redeemed(3), Expired(4).
+ * The indexer maps these and adds extra statuses for UI display.
+ *
+ * IMPORTANT: With the new contract architecture:
+ * - Core vault status (BTCVaultRegistry) does NOT change when used by applications
+ * - Vaults remain at ACTIVE status even when used in DeFi positions
+ * - Application usage status is tracked separately by each integration controller
+ */
+export declare enum ContractStatus {
+    /** Status 0: Request submitted, waiting for ACKs */
+    PENDING = 0,
+    /** Status 1: All ACKs collected, ready for secret activation */
+    VERIFIED = 1,
+    /** Status 2: HTLC secret revealed, vault is active and usable (stays here even when used by apps) */
+    ACTIVE = 2,
+    /** Status 3: Vault has been redeemed, BTC is claimable */
+    REDEEMED = 3,
+    /** Status 4 (indexer-only): Vault was liquidated (collateral seized due to unpaid debt) */
+    LIQUIDATED = 4,
+    /** Status 5 (indexer-only): Vault is invalid — BTC UTXOs were spent in a different transaction */
+    INVALID = 5,
+    /** Status 6 (indexer-only): Depositor has withdrawn their BTC (redemption complete) */
+    DEPOSITOR_WITHDRAWN = 6,
+    /** Status 7 (indexer-only): Vault expired due to AckTimeout or ActivationTimeout */
+    EXPIRED = 7
+}
+/** Reason why a vault expired */
+export type ExpirationReason = "ack_timeout" | "proof_timeout" | "activation_timeout";
+/**
+ * Available actions user can take
+ */
+export declare enum PeginAction {
+    /** Submit WOTS key (re-enter mnemonic) */
+    SUBMIT_WOTS_KEY = "SUBMIT_WOTS_KEY",
+    /** Sign payout transactions */
+    SIGN_PAYOUT_TRANSACTIONS = "SIGN_PAYOUT_TRANSACTIONS",
+    /** Sign and broadcast peg-in transaction to Bitcoin */
+    SIGN_AND_BROADCAST_TO_BITCOIN = "SIGN_AND_BROADCAST_TO_BITCOIN",
+    /** Reveal HTLC secret on Ethereum to activate vault */
+    ACTIVATE_VAULT = "ACTIVATE_VAULT",
+    /** Sign and broadcast HTLC refund transaction for an expired vault */
+    REFUND_HTLC = "REFUND_HTLC"
+}
+/**
+ * Protocol-level peg-in state (framework-agnostic)
+ */
+export interface PeginProtocolState {
+    /** Smart contract status (source of truth for on-chain state) */
+    contractStatus: ContractStatus;
+    /** Available user actions (empty array when no action is available) */
+    availableActions: PeginAction[];
+}
+/**
+ * Options for getPeginProtocolState function.
+ *
+ * All fields represent protocol-level state from the vault provider or
+ * on-chain contracts. Client-side tracking (localStorage, polling state)
+ * is NOT included — consumers handle that in their own layer.
+ */
+export interface GetPeginProtocolStateOptions {
+    /** Whether claim/payout transactions are ready from VP */
+    transactionsReady?: boolean;
+    /** Whether the vault provider is waiting for the depositor's WOTS public key */
+    needsWotsKey?: boolean;
+    /** Whether the vault provider hasn't ingested this peg-in yet */
+    pendingIngestion?: boolean;
+    /** Whether the depositor can refund the HTLC (Pre-PegIn tx available) */
+    canRefund?: boolean;
+    /** Whether the vault provider reported a terminal failure */
+    hasProviderTerminalFailure?: boolean;
+}
+/**
+ * Determine the current protocol state and available actions based on contract
+ * status and vault provider state. Framework-agnostic: returns only
+ * protocol-level data with no display labels, messages, or UI concerns.
+ *
+ * Client-side tracking overrides (e.g. suppressing actions after the user
+ * has already acted but on-chain state hasn't caught up) are the caller's
+ * responsibility.
+ *
+ * @param contractStatus - On-chain contract status (source of truth)
+ * @param options - Vault provider state
+ * @returns Protocol state with available actions
+ */
+export declare function getPeginProtocolState(contractStatus: ContractStatus, options?: GetPeginProtocolStateOptions): PeginProtocolState;
+/**
+ * Check if a specific action is available in the current state
+ */
+export declare function canPerformAction(state: PeginProtocolState, action: PeginAction): boolean;
+//# sourceMappingURL=peginState.d.ts.map

package/dist/tbv/core/services/deposit/peginState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"peginState.d.ts","sourceRoot":"","sources":["../../../../../src/tbv/core/services/deposit/peginState.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;GAUG;AACH,oBAAY,cAAc;IACxB,oDAAoD;IACpD,OAAO,IAAI;IACX,gEAAgE;IAChE,QAAQ,IAAI;IACZ,qGAAqG;IACrG,MAAM,IAAI;IACV,0DAA0D;IAC1D,QAAQ,IAAI;IACZ,2FAA2F;IAC3F,UAAU,IAAI;IACd,kGAAkG;IAClG,OAAO,IAAI;IACX,uFAAuF;IACvF,mBAAmB,IAAI;IACvB,oFAAoF;IACpF,OAAO,IAAI;CACZ;AAED,iCAAiC;AACjC,MAAM,MAAM,gBAAgB,GACxB,aAAa,GACb,eAAe,GACf,oBAAoB,CAAC;AAMzB;;GAEG;AACH,oBAAY,WAAW;IACrB,0CAA0C;IAC1C,eAAe,oBAAoB;IACnC,+BAA+B;IAC/B,wBAAwB,6BAA6B;IACrD,uDAAuD;IACvD,6BAA6B,kCAAkC;IAC/D,uDAAuD;IACvD,cAAc,mBAAmB;IACjC,sEAAsE;IACtE,WAAW,gBAAgB;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,iEAAiE;IACjE,cAAc,EAAE,cAAc,CAAC;IAC/B,uEAAuE;IACvE,gBAAgB,EAAE,WAAW,EAAE,CAAC;CACjC;AAED;;;;;;GAMG;AACH,MAAM,WAAW,4BAA4B;IAC3C,0DAA0D;IAC1D,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,gFAAgF;IAChF,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,iEAAiE;IACjE,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,yEAAyE;IACzE,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,6DAA6D;IAC7D,0BAA0B,CAAC,EAAE,OAAO,CAAC;CACtC;AAMD;;;;;;;;;;;;GAYG;AACH,wBAAgB,qBAAqB,CACnC,cAAc,EAAE,cAAc,EAC9B,OAAO,GAAE,4BAAiC,GACzC,kBAAkB,CA6EpB;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,kBAAkB,EACzB,MAAM,EAAE,WAAW,GAClB,OAAO,CAET"}

package/dist/tbv/core/services/deposit/validation.d.ts

@@ -0,0 +1,114 @@
+/**
+ * Pure validation functions for deposit operations.
+ *
+ * All validations return a consistent {@link ValidationResult} format or throw
+ * on critical failures (e.g. missing protocol participants).
+ *
+ * Business rules (single-provider limit, max vault count) and form-flow
+ * checks (wallet connected) belong in the consumer layer.
+ *
+ * @module tbv/core/services/deposit/validation
+ */
+export interface ValidationResult {
+    valid: boolean;
+    error?: string;
+    warnings?: string[];
+}
+/**
+ * Parameters for checking if a deposit form is valid.
+ */
+export interface DepositFormValidityParams {
+    /** Deposit amount in satoshis */
+    amountSats: bigint;
+    /** Minimum deposit from protocol params */
+    minDeposit: bigint;
+    /** Maximum deposit from protocol params (optional) */
+    maxDeposit?: bigint;
+    /** User's available BTC balance in satoshis */
+    btcBalance: bigint;
+    /** Estimated transaction fee in satoshis */
+    estimatedFeeSats?: bigint;
+    /** Depositor claim value in satoshis (required output for challenge transactions) */
+    depositorClaimValue?: bigint;
+}
+export interface RemainingCapacityParams {
+    /** Requested deposit amount in satoshis */
+    amount: bigint;
+    /**
+     * Effective remaining capacity in satoshis (min of protocol-total and
+     * per-address remaining). `null` means no cap applies.
+     */
+    effectiveRemaining: bigint | null;
+}
+/** Narrow structural type for UTXO — avoids importing vault-specific types. */
+interface UtxoLike {
+    txid: string;
+    vout: number;
+    value: number;
+}
+/**
+ * Parameters for validating multi-vault deposit flow inputs.
+ *
+ * Callers must resolve any async loading states before calling — the SDK
+ * validates resolved data, not React hook state.
+ *
+ * Form-flow checks (wallet connected, provider selected) are the caller's
+ * responsibility and are NOT performed here.
+ */
+export interface MultiVaultDepositFlowInputs {
+    vaultAmounts: bigint[];
+    confirmedUTXOs: UtxoLike[];
+    vaultProviderBtcPubkey: string;
+    vaultKeeperBtcPubkeys: string[];
+    universalChallengerBtcPubkeys: string[];
+    /** Protocol minimum deposit per vault (satoshis) */
+    minDeposit: bigint;
+    /** Protocol maximum deposit per vault (satoshis) */
+    maxDeposit?: bigint;
+    /** Number of HTLC secret hexes — must match vaultAmounts.length */
+    htlcSecretHexesLength: number;
+    /** Number of depositor secret hashes — must match vaultAmounts.length */
+    depositorSecretHashesLength: number;
+}
+/**
+ * Check if deposit amount is within valid range and affordable.
+ *
+ * Returns false when fees/claim value are not yet known (still loading),
+ * and includes them in the balance check once available.
+ */
+export declare function isDepositAmountValid(params: DepositFormValidityParams): boolean;
+/**
+ * Validate deposit amount against minimum and maximum constraints.
+ */
+export declare function validateDepositAmount(amount: bigint, minDeposit: bigint, maxDeposit?: bigint): ValidationResult;
+/**
+ * Validate that the requested deposit fits within the effective remaining cap.
+ */
+export declare function validateRemainingCapacity(params: RemainingCapacityParams): ValidationResult;
+/**
+ * Validate that selected providers exist in the available set.
+ *
+ * Business rules (e.g. single-provider limit) are the caller's responsibility.
+ */
+export declare function validateProviderSelection(selectedProviders: string[], availableProviders: string[]): ValidationResult;
+/**
+ * Validate vault amounts array for multi-vault deposits.
+ * Checks count, positivity, and per-vault min/max protocol limits.
+ *
+ * Max vault count limits are the caller's responsibility.
+ */
+export declare function validateVaultAmounts(amounts: bigint[], minDeposit?: bigint, maxDeposit?: bigint): ValidationResult;
+/**
+ * Validate vault provider BTC public key format.
+ */
+export declare function validateVaultProviderPubkey(pubkey: string): ValidationResult;
+/**
+ * Validate protocol-level multi-vault deposit inputs.
+ * Throws an error if any validation fails.
+ *
+ * Form-flow checks (wallet connections, provider selection) must be
+ * performed by the caller before invoking this function.
+ */
+export declare function validateMultiVaultDepositInputs(params: MultiVaultDepositFlowInputs): void;
+export {};
+//# sourceMappingURL=validation.d.ts.map

package/dist/tbv/core/services/deposit/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../../../../src/tbv/core/services/deposit/validation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAWH,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,iCAAiC;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,2CAA2C;IAC3C,UAAU,EAAE,MAAM,CAAC;IACnB,sDAAsD;IACtD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,+CAA+C;IAC/C,UAAU,EAAE,MAAM,CAAC;IACnB,4CAA4C;IAC5C,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,qFAAqF;IACrF,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,uBAAuB;IACtC,2CAA2C;IAC3C,MAAM,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;CACnC;AAED,+EAA+E;AAC/E,UAAU,QAAQ;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,2BAA2B;IAC1C,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,cAAc,EAAE,QAAQ,EAAE,CAAC;IAC3B,sBAAsB,EAAE,MAAM,CAAC;IAC/B,qBAAqB,EAAE,MAAM,EAAE,CAAC;IAChC,6BAA6B,EAAE,MAAM,EAAE,CAAC;IACxC,oDAAoD;IACpD,UAAU,EAAE,MAAM,CAAC;IACnB,oDAAoD;IACpD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,mEAAmE;IACnE,qBAAqB,EAAE,MAAM,CAAC;IAC9B,yEAAyE;IACzE,2BAA2B,EAAE,MAAM,CAAC;CACrC;AAcD;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,yBAAyB,GAChC,OAAO,CAoBT;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAClB,UAAU,CAAC,EAAE,MAAM,GAClB,gBAAgB,CAuBlB;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,uBAAuB,GAC9B,gBAAgB,CAmBlB;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CACvC,iBAAiB,EAAE,MAAM,EAAE,EAC3B,kBAAkB,EAAE,MAAM,EAAE,GAC3B,gBAAgB,CAuBlB;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,MAAM,EAAE,EACjB,UAAU,CAAC,EAAE,MAAM,EACnB,UAAU,CAAC,EAAE,MAAM,GAClB,gBAAgB,CA+BlB;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,MAAM,GAAG,gBAAgB,CAU5E;AAqCD;;;;;;GAMG;AACH,wBAAgB,+BAA+B,CAC7C,MAAM,EAAE,2BAA2B,GAClC,IAAI,CA4CN"}

package/dist/tbv/core/services/index.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const t=require("../../../index-BgnxXV5G.cjs");exports.computeHashlock=t.computeHashlock;exports.pollAndSignPayouts=t.pollAndSignPayouts;exports.signDepositorGraph=t.signDepositorGraph;exports.submitWotsPublicKey=t.submitWotsPublicKey;exports.validateSecretAgainstHashlock=t.validateSecretAgainstHashlock;exports.waitForPeginStatus=t.waitForPeginStatus;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const t=require("../../../buildAndBroadcastRefund-DWEQvj9T.cjs"),a=require("../../../signing-cl-lowxV.cjs");exports.BIP68NotMatureError=t.BIP68NotMatureError;exports.ClaimerPegoutStatusValue=t.ClaimerPegoutStatusValue;exports.activateVault=t.activateVault;exports.buildAndBroadcastRefund=t.buildAndBroadcastRefund;exports.computeHashlock=t.computeHashlock;exports.isDepositAmountValid=t.isDepositAmountValid;exports.isPegoutTerminalStatus=t.isPegoutTerminalStatus;exports.isRecognizedPegoutStatus=t.isRecognizedPegoutStatus;exports.pollAndSignPayouts=t.pollAndSignPayouts;exports.signDepositorGraph=t.signDepositorGraph;exports.submitWotsPublicKey=t.submitWotsPublicKey;exports.validateDepositAmount=t.validateDepositAmount;exports.validateMultiVaultDepositInputs=t.validateMultiVaultDepositInputs;exports.validateProviderSelection=t.validateProviderSelection;exports.validateRemainingCapacity=t.validateRemainingCapacity;exports.validateSecretAgainstHashlock=t.validateSecretAgainstHashlock;exports.validateVaultAmounts=t.validateVaultAmounts;exports.validateVaultProviderPubkey=t.validateVaultProviderPubkey;exports.waitForPeginStatus=t.waitForPeginStatus;exports.ContractStatus=a.ContractStatus;exports.PeginAction=a.PeginAction;exports.canPerformAction=a.canPerformAction;exports.getPeginProtocolState=a.getPeginProtocolState;
 //# sourceMappingURL=index.cjs.map

package/dist/tbv/core/services/index.d.ts

@@ -6,6 +6,9 @@
  *
  * @module services
  */
+export * from './activation';
 export * from './deposit';
 export * from './htlc';
+export * from './pegout';
+export * from './refund';
 //# sourceMappingURL=index.d.ts.map

package/dist/tbv/core/services/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/tbv/core/services/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,cAAc,WAAW,CAAC;AAC1B,cAAc,QAAQ,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/tbv/core/services/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC"}

package/dist/tbv/core/services/index.js

@@ -1,10 +1,28 @@
-import { c as t, p as o, a as i, s as e, v as c, w as l } from "../../../index-BX-V3C9t.js";
+import { B as s, C as e, a as i, m as o, h as u, i as l, l as r, k as n, p as d, b as c, s as P, v as g, g as m, d as p, c as v, j as S, e as A, f as V, w as b } from "../../../buildAndBroadcastRefund-DnTQkCgG.js";
+import { C, P as h, a as k, g as y } from "../../../signing-DeWVBl7m.js";
 export {
-  t as computeHashlock,
-  o as pollAndSignPayouts,
-  i as signDepositorGraph,
-  e as submitWotsPublicKey,
-  c as validateSecretAgainstHashlock,
-  l as waitForPeginStatus
+  s as BIP68NotMatureError,
+  e as ClaimerPegoutStatusValue,
+  C as ContractStatus,
+  h as PeginAction,
+  i as activateVault,
+  o as buildAndBroadcastRefund,
+  k as canPerformAction,
+  u as computeHashlock,
+  y as getPeginProtocolState,
+  l as isDepositAmountValid,
+  r as isPegoutTerminalStatus,
+  n as isRecognizedPegoutStatus,
+  d as pollAndSignPayouts,
+  c as signDepositorGraph,
+  P as submitWotsPublicKey,
+  g as validateDepositAmount,
+  m as validateMultiVaultDepositInputs,
+  p as validateProviderSelection,
+  v as validateRemainingCapacity,
+  S as validateSecretAgainstHashlock,
+  A as validateVaultAmounts,
+  V as validateVaultProviderPubkey,
+  b as waitForPeginStatus
 };
 //# sourceMappingURL=index.js.map

package/dist/tbv/core/services/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";"}
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;"}

package/dist/tbv/core/services/pegout/__tests__/state.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=state.test.d.ts.map

package/dist/tbv/core/services/pegout/__tests__/state.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.test.d.ts","sourceRoot":"","sources":["../../../../../../src/tbv/core/services/pegout/__tests__/state.test.ts"],"names":[],"mappings":""}

package/dist/tbv/core/services/pegout/index.d.ts

@@ -0,0 +1,2 @@
+export { ClaimerPegoutStatusValue, isRecognizedPegoutStatus, isPegoutTerminalStatus, } from './state';
+//# sourceMappingURL=index.d.ts.map

package/dist/tbv/core/services/pegout/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/tbv/core/services/pegout/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wBAAwB,EACxB,wBAAwB,EACxB,sBAAsB,GACvB,MAAM,SAAS,CAAC"}

package/dist/tbv/core/services/pegout/state.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Pegout state definitions and protocol-level terminal checks.
+ *
+ * Maps VP-reported pegout statuses from `vaultProvider_getPegoutStatus`
+ * to protocol lifecycle states.
+ *
+ * Lifecycle:
+ *   ClaimEventReceived -> ClaimBroadcast -> AssertBroadcast -> PayoutBroadcast (success)
+ *                                                             > ChallengeAssertObserved -> WronglyChallengedBroadcast -> PayoutBroadcast
+ *                                                             > ChallengeAssertObserved -> Failed (challenger won)
+ */
+/** Claimer-side pegout statuses reported by the VP. */
+export declare enum ClaimerPegoutStatusValue {
+    CLAIM_EVENT_RECEIVED = "ClaimEventReceived",
+    CLAIM_BROADCAST = "ClaimBroadcast",
+    ASSERT_BROADCAST = "AssertBroadcast",
+    CHALLENGE_ASSERT_OBSERVED = "ChallengeAssertObserved",
+    WRONGLY_CHALLENGED_BROADCAST = "WronglyChallengedBroadcast",
+    PAYOUT_BROADCAST = "PayoutBroadcast",
+    FAILED = "Failed"
+}
+/** Whether a claimer status string maps to a known pegout state. */
+export declare function isRecognizedPegoutStatus(status: string): boolean;
+/**
+ * Whether a claimer status is a hard-terminal pegout status
+ * (PayoutBroadcast or Failed). Soft-terminal conditions (polling
+ * thresholds) are a consumer-side concern.
+ */
+export declare function isPegoutTerminalStatus(claimerStatus: string | undefined): boolean;
+//# sourceMappingURL=state.d.ts.map

package/dist/tbv/core/services/pegout/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../../../../src/tbv/core/services/pegout/state.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,uDAAuD;AACvD,oBAAY,wBAAwB;IAClC,oBAAoB,uBAAuB;IAC3C,eAAe,mBAAmB;IAClC,gBAAgB,oBAAoB;IACpC,yBAAyB,4BAA4B;IACrD,4BAA4B,+BAA+B;IAC3D,gBAAgB,oBAAoB;IACpC,MAAM,WAAW;CAClB;AAOD,oEAAoE;AACpE,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAIhE;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,aAAa,EAAE,MAAM,GAAG,SAAS,GAChC,OAAO,CAET"}

package/dist/tbv/core/services/refund/__tests__/buildAndBroadcastRefund.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=buildAndBroadcastRefund.test.d.ts.map

package/dist/tbv/core/services/refund/__tests__/buildAndBroadcastRefund.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildAndBroadcastRefund.test.d.ts","sourceRoot":"","sources":["../../../../../../src/tbv/core/services/refund/__tests__/buildAndBroadcastRefund.test.ts"],"names":[],"mappings":""}

package/dist/tbv/core/services/refund/buildAndBroadcastRefund.d.ts

@@ -0,0 +1,103 @@
+import { Network } from '@babylonlabs-io/babylon-tbv-rust-wasm';
+import { Address, Hex } from 'viem';
+import { SignPsbtOptions } from '../../../../shared/wallets/interfaces/BitcoinWallet';
+/**
+ * Authoritative vault fields needed to build a refund. Versioning fields,
+ * the hashlock, and htlcVout must come from the on-chain contract (never the
+ * indexer). The amount + `unsignedPrePeginTxHex` + `depositorBtcPubkey` can
+ * come from the indexer since they are not security-critical for signing
+ * (the PSBT builder re-derives the HTLC script from on-chain params).
+ */
+export interface VaultRefundData {
+    hashlock: Hex;
+    htlcVout: number;
+    offchainParamsVersion: number;
+    appVaultKeepersVersion: number;
+    universalChallengersVersion: number;
+    vaultProvider: Address;
+    applicationEntryPoint: Address;
+    /** Pre-PegIn HTLC output value in satoshis. */
+    amount: bigint;
+    /** Funded (but pre-witness) Pre-PegIn transaction hex. 0x prefix optional. */
+    unsignedPrePeginTxHex: string;
+    /** Depositor's BTC public key (x-only or compressed hex; 0x prefix optional). */
+    depositorBtcPubkey: string;
+}
+/**
+ * Version-resolved protocol context that parameterises the HTLC's taproot
+ * scripts. The *signer-set* fields (`vaultKeeperPubkeys`,
+ * `universalChallengerPubkeys`) and the version-locked numeric protocol
+ * params **must** be sourced from the on-chain contract at the version
+ * pinned in {@link VaultRefundData} — this is the trust boundary.
+ * `vaultProviderPubkey` today is sourced from the GraphQL indexer via
+ * `fetchVaultProviderById`; the caller is responsible for any additional
+ * cross-check it requires. Keeper and challenger pubkey arrays must be
+ * pre-sorted the same way the Rust protocol sorts them (canonical for
+ * script derivation).
+ */
+export interface RefundPrePeginContext {
+    vaultProviderPubkey: string;
+    vaultKeeperPubkeys: readonly string[];
+    universalChallengerPubkeys: readonly string[];
+    timelockRefund: number;
+    feeRate: bigint;
+    numLocalChallengers: number;
+    councilQuorum: number;
+    councilSize: number;
+    network: Network;
+}
+/** Minimum shape required from a broadcast result. */
+export interface BtcBroadcastResult {
+    txId: string;
+}
+export type BtcBroadcaster<R extends BtcBroadcastResult = BtcBroadcastResult> = (signedTxHex: string) => Promise<R>;
+export type RefundPsbtSigner = (psbtHex: string, opts: SignPsbtOptions) => Promise<string>;
+export interface RefundInput<R extends BtcBroadcastResult = BtcBroadcastResult> {
+    vaultId: Hex;
+    /**
+     * Fetch authoritative on-chain + indexer vault data. The SDK passes no
+     * arguments — the caller closes over `vaultId` (or any other context it
+     * needs).
+     */
+    readVault: () => Promise<VaultRefundData>;
+    /**
+     * Fetch the version-pinned refund context (sorted pubkeys, timelock, etc.)
+     * derived from the vault's locked versions.
+     */
+    readPrePeginContext: (vault: VaultRefundData) => Promise<RefundPrePeginContext>;
+    /**
+     * Mempool-derived sat/vB fee rate to use for the refund tx (positive
+     * number). Caller fetches this before invoking — it does not depend on
+     * any value the SDK computes, and folding it into the call keeps the
+     * orchestration honest.
+     */
+    feeRate: number;
+    /** BTC wallet signer; receives a PSBT hex + taproot script-path options. */
+    signPsbt: RefundPsbtSigner;
+    /** Broadcast callback — returns whatever shape the caller needs. */
+    broadcastTx: BtcBroadcaster<R>;
+    /** Checked at every async boundary. */
+    signal?: AbortSignal;
+}
+/**
+ * Build, sign, and broadcast a refund transaction for an expired vault.
+ *
+ * Trust boundary: `readVault` must source the hashlock, htlcVout, and
+ * versioning fields from the on-chain contract — an indexer-only path
+ * leaves the refund flow open to signer-set substitution. The SDK does
+ * not enforce this; it is the caller's responsibility.
+ *
+ * The broadcast transport is expected to surface Bitcoin's `non-BIP68-final`
+ * policy rejection as an `Error` whose message contains that string; when
+ * it does, the SDK wraps it in {@link BIP68NotMatureError}. All other
+ * transport errors propagate unchanged.
+ *
+ * @returns whatever the injected `broadcastTx` returns (generic pass-through)
+ * @throws `Error` if any validation fails
+ * @throws {@link BIP68NotMatureError} if the broadcast is rejected because
+ *         the refund CSV timelock has not yet matured
+ * @throws anything `readVault`, `readPrePeginContext`,
+ *         `signPsbt`, or `broadcastTx` throws
+ */
+export declare function buildAndBroadcastRefund<R extends BtcBroadcastResult = BtcBroadcastResult>(input: RefundInput<R>): Promise<R>;
+//# sourceMappingURL=buildAndBroadcastRefund.d.ts.map

package/dist/tbv/core/services/refund/buildAndBroadcastRefund.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildAndBroadcastRefund.d.ts","sourceRoot":"","sources":["../../../../../src/tbv/core/services/refund/buildAndBroadcastRefund.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uCAAuC,CAAC;AAErE,OAAO,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,MAAM,CAAC;AAEzC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qDAAqD,CAAC;AA4C3F;;;;;;GAMG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,GAAG,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,sBAAsB,EAAE,MAAM,CAAC;IAC/B,2BAA2B,EAAE,MAAM,CAAC;IACpC,aAAa,EAAE,OAAO,CAAC;IACvB,qBAAqB,EAAE,OAAO,CAAC;IAC/B,+CAA+C;IAC/C,MAAM,EAAE,MAAM,CAAC;IACf,8EAA8E;IAC9E,qBAAqB,EAAE,MAAM,CAAC;IAC9B,iFAAiF;IACjF,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,qBAAqB;IACpC,mBAAmB,EAAE,MAAM,CAAC;IAC5B,kBAAkB,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,0BAA0B,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9C,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,sDAAsD;AACtD,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,MAAM,cAAc,CACxB,CAAC,SAAS,kBAAkB,GAAG,kBAAkB,IAC/C,CAAC,WAAW,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;AAExC,MAAM,MAAM,gBAAgB,GAAG,CAC7B,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,eAAe,KAClB,OAAO,CAAC,MAAM,CAAC,CAAC;AAErB,MAAM,WAAW,WAAW,CAC1B,CAAC,SAAS,kBAAkB,GAAG,kBAAkB;IAEjD,OAAO,EAAE,GAAG,CAAC;IACb;;;;OAIG;IACH,SAAS,EAAE,MAAM,OAAO,CAAC,eAAe,CAAC,CAAC;IAC1C;;;OAGG;IACH,mBAAmB,EAAE,CACnB,KAAK,EAAE,eAAe,KACnB,OAAO,CAAC,qBAAqB,CAAC,CAAC;IACpC;;;;;OAKG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB,4EAA4E;IAC5E,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,oEAAoE;IACpE,WAAW,EAAE,cAAc,CAAC,CAAC,CAAC,CAAC;IAC/B,uCAAuC;IACvC,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAqGD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,uBAAuB,CAC3C,CAAC,SAAS,kBAAkB,GAAG,kBAAkB,EACjD,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAuEnC"}

package/dist/tbv/core/services/refund/errors.d.ts

@@ -0,0 +1,13 @@
+import { Hex } from 'viem';
+/**
+ * Thrown when the broadcast transport rejects the refund tx because the CSV
+ * timelock has not yet matured (BIP68 non-final). Callers can surface a
+ * friendly "wait until block N" message; the original transport error is
+ * available via {@link cause}.
+ */
+export declare class BIP68NotMatureError extends Error {
+    readonly vaultId: Hex;
+    readonly cause: Error;
+    constructor(vaultId: Hex, cause: Error);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/tbv/core/services/refund/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../../../src/tbv/core/services/refund/errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,MAAM,CAAC;AAEhC;;;;;GAKG;AACH,qBAAa,mBAAoB,SAAQ,KAAK;IAC5C,SAAgB,OAAO,EAAE,GAAG,CAAC;IAC7B,SAAyB,KAAK,EAAE,KAAK,CAAC;gBAE1B,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK;CAMvC"}

package/dist/tbv/core/services/refund/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Vault refund service — reclaim BTC from an expired Pre-PegIn HTLC.
+ *
+ * @module services/refund
+ */
+export { BIP68NotMatureError } from './errors';
+export { buildAndBroadcastRefund, type BtcBroadcastResult, type BtcBroadcaster, type RefundInput, type RefundPrePeginContext, type RefundPsbtSigner, type VaultRefundData, } from './buildAndBroadcastRefund';
+//# sourceMappingURL=index.d.ts.map

package/dist/tbv/core/services/refund/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/tbv/core/services/refund/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAC/C,OAAO,EACL,uBAAuB,EACvB,KAAK,kBAAkB,EACvB,KAAK,cAAc,EACnB,KAAK,WAAW,EAChB,KAAK,qBAAqB,EAC1B,KAAK,gBAAgB,EACrB,KAAK,eAAe,GACrB,MAAM,2BAA2B,CAAC"}

package/dist/tbv/core/utils/index.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const t=require("../../../constants-EiyZkXce.cjs"),e=require("../../../psbtInputFields-C0nKn_GD.cjs"),T=require("../../../fundPeginTransaction-EbrZzlrh.cjs"),_=require("../../../signing-Deg5lCoC.cjs");exports.BTC_DUST_SAT=t.BTC_DUST_SAT;exports.DUST_THRESHOLD=t.DUST_THRESHOLD;exports.FEE_SAFETY_MARGIN=t.FEE_SAFETY_MARGIN;exports.LOW_RATE_ESTIMATION_ACCURACY_BUFFER=t.LOW_RATE_ESTIMATION_ACCURACY_BUFFER;exports.MAX_NON_LEGACY_OUTPUT_SIZE=t.MAX_NON_LEGACY_OUTPUT_SIZE;exports.P2TR_INPUT_SIZE=t.P2TR_INPUT_SIZE;exports.PEGIN_FIXED_OUTPUTS=t.PEGIN_FIXED_OUTPUTS;exports.SPLIT_TX_FEE_SAFETY_MULTIPLIER=t.SPLIT_TX_FEE_SAFETY_MULTIPLIER;exports.TX_BUFFER_SIZE_OVERHEAD=t.TX_BUFFER_SIZE_OVERHEAD;exports.WALLET_RELAY_FEE_RATE_THRESHOLD=t.WALLET_RELAY_FEE_RATE_THRESHOLD;exports.getNetwork=t.getNetwork;exports.peginOutputCount=t.peginOutputCount;exports.rateBasedTxBufferFee=t.rateBasedTxBufferFee;exports.BitcoinScriptType=e.BitcoinScriptType;exports.calculateBtcTxHash=e.calculateBtcTxHash;exports.getDustThreshold=e.getDustThreshold;exports.getPsbtInputFields=e.getPsbtInputFields;exports.getScriptType=e.getScriptType;exports.selectUtxosForPegin=e.selectUtxosForPegin;exports.shouldAddChangeOutput=e.shouldAddChangeOutput;exports.fundPeginTransaction=T.fundPeginTransaction;exports.parseUnfundedWasmTransaction=T.parseUnfundedWasmTransaction;exports.createTaprootScriptPathSignOptions=_.createTaprootScriptPathSignOptions;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const T=require("../../../signing-cl-lowxV.cjs"),t=require("../../../fundPeginTransaction-DxNOeyNI.cjs"),e=require("../../../psbtInputFields-05ZrwRzf.cjs"),s=require("../../../bitcoin-CNnPFU6Y.cjs");exports.createTaprootScriptPathSignOptions=T.createTaprootScriptPathSignOptions;exports.BTC_DUST_SAT=t.BTC_DUST_SAT;exports.DUST_THRESHOLD=t.DUST_THRESHOLD;exports.FEE_SAFETY_MARGIN=t.FEE_SAFETY_MARGIN;exports.LOW_RATE_ESTIMATION_ACCURACY_BUFFER=t.LOW_RATE_ESTIMATION_ACCURACY_BUFFER;exports.MAX_NON_LEGACY_OUTPUT_SIZE=t.MAX_NON_LEGACY_OUTPUT_SIZE;exports.P2TR_INPUT_SIZE=t.P2TR_INPUT_SIZE;exports.PEGIN_FIXED_OUTPUTS=t.PEGIN_FIXED_OUTPUTS;exports.SPLIT_TX_FEE_SAFETY_MULTIPLIER=t.SPLIT_TX_FEE_SAFETY_MULTIPLIER;exports.TX_BUFFER_SIZE_OVERHEAD=t.TX_BUFFER_SIZE_OVERHEAD;exports.WALLET_RELAY_FEE_RATE_THRESHOLD=t.WALLET_RELAY_FEE_RATE_THRESHOLD;exports.fundPeginTransaction=t.fundPeginTransaction;exports.parseUnfundedWasmTransaction=t.parseUnfundedWasmTransaction;exports.peginOutputCount=t.peginOutputCount;exports.rateBasedTxBufferFee=t.rateBasedTxBufferFee;exports.BitcoinScriptType=e.BitcoinScriptType;exports.UtxoNotAvailableError=e.UtxoNotAvailableError;exports.assertUtxosAvailable=e.assertUtxosAvailable;exports.calculateBtcTxHash=e.calculateBtcTxHash;exports.collectReservedUtxoRefs=e.collectReservedUtxoRefs;exports.extractInputsFromTransaction=e.extractInputsFromTransaction;exports.getDustThreshold=e.getDustThreshold;exports.getPsbtInputFields=e.getPsbtInputFields;exports.getScriptType=e.getScriptType;exports.selectUtxosForDeposit=e.selectUtxosForDeposit;exports.selectUtxosForPegin=e.selectUtxosForPegin;exports.shouldAddChangeOutput=e.shouldAddChangeOutput;exports.validateUtxosAvailable=e.validateUtxosAvailable;exports.getNetwork=s.getNetwork;
 //# sourceMappingURL=index.cjs.map

package/dist/tbv/core/utils/index.js

@@ -1,30 +1,36 @@
-import { B as t, D as T, F as e, L as _, M as E, P as r, c as o, S, T as p, W as n, g as A, f as c, r as F } from "../../../constants-Q7v2O7Ps.js";
-import { B as I, c as U, g as u, d as P, b as R, s as g, a as L } from "../../../psbtInputFields-DO0ELwiv.js";
-import { f as d, p as f } from "../../../fundPeginTransaction-DpwnDslW.js";
-import { c as D } from "../../../signing-Drwr3bXB.js";
+import { c as t } from "../../../signing-DeWVBl7m.js";
+import { B as T, D as o, F as r, L as _, M as E, P as i, a as n, S as p, T as U, W as c, f as A, b as S, p as l, r as F } from "../../../fundPeginTransaction-BLYXxLBv.js";
+import { B as R, U as u, a as x, f as d, c as P, e as f, g, i as L, h as O, s as B, b as D, d as N, v as h } from "../../../psbtInputFields-r1ss6WLU.js";
+import { g as b } from "../../../bitcoin-nOOgeRyl.js";
 export {
-  t as BTC_DUST_SAT,
-  I as BitcoinScriptType,
-  T as DUST_THRESHOLD,
-  e as FEE_SAFETY_MARGIN,
+  T as BTC_DUST_SAT,
+  R as BitcoinScriptType,
+  o as DUST_THRESHOLD,
+  r as FEE_SAFETY_MARGIN,
   _ as LOW_RATE_ESTIMATION_ACCURACY_BUFFER,
   E as MAX_NON_LEGACY_OUTPUT_SIZE,
-  r as P2TR_INPUT_SIZE,
-  o as PEGIN_FIXED_OUTPUTS,
-  S as SPLIT_TX_FEE_SAFETY_MULTIPLIER,
-  p as TX_BUFFER_SIZE_OVERHEAD,
-  n as WALLET_RELAY_FEE_RATE_THRESHOLD,
-  U as calculateBtcTxHash,
-  D as createTaprootScriptPathSignOptions,
-  d as fundPeginTransaction,
-  u as getDustThreshold,
-  A as getNetwork,
-  P as getPsbtInputFields,
-  R as getScriptType,
-  f as parseUnfundedWasmTransaction,
-  c as peginOutputCount,
+  i as P2TR_INPUT_SIZE,
+  n as PEGIN_FIXED_OUTPUTS,
+  p as SPLIT_TX_FEE_SAFETY_MULTIPLIER,
+  U as TX_BUFFER_SIZE_OVERHEAD,
+  u as UtxoNotAvailableError,
+  c as WALLET_RELAY_FEE_RATE_THRESHOLD,
+  x as assertUtxosAvailable,
+  d as calculateBtcTxHash,
+  P as collectReservedUtxoRefs,
+  t as createTaprootScriptPathSignOptions,
+  f as extractInputsFromTransaction,
+  A as fundPeginTransaction,
+  g as getDustThreshold,
+  b as getNetwork,
+  L as getPsbtInputFields,
+  O as getScriptType,
+  S as parseUnfundedWasmTransaction,
+  l as peginOutputCount,
   F as rateBasedTxBufferFee,
-  g as selectUtxosForPegin,
-  L as shouldAddChangeOutput
+  B as selectUtxosForDeposit,
+  D as selectUtxosForPegin,
+  N as shouldAddChangeOutput,
+  h as validateUtxosAvailable
 };
 //# sourceMappingURL=index.js.map

package/dist/tbv/core/utils/transaction/fundPeginTransaction.d.ts

@@ -7,7 +7,7 @@ import { UTXO } from '../utxo/selectUtxos';
  * UTXO inputs and change outputs, creating a transaction ready for wallet signing.
  *
  * Transaction Flow:
- * 1. SDK buildPeginPsbt() → unfunded transaction (0 inputs, vault + depositor claim outputs)
+ * 1. SDK buildPrePeginPsbt() → unfunded Pre-PegIn tx (0 inputs, HTLC + CPFP outputs)
  * 2. selectUtxosForPegin() → select UTXOs and calculate fees
  * 3. fundPeginTransaction() → add inputs/change, create funded transaction
  *

package/dist/tbv/core/utils/utxo/__tests__/availability.test.d.ts

@@ -0,0 +1,3 @@
+/** Tests for UTXO availability validation. */
+export {};
+//# sourceMappingURL=availability.test.d.ts.map

package/dist/tbv/core/utils/utxo/__tests__/availability.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"availability.test.d.ts","sourceRoot":"","sources":["../../../../../../src/tbv/core/utils/utxo/__tests__/availability.test.ts"],"names":[],"mappings":"AAAA,8CAA8C"}

package/dist/tbv/core/utils/utxo/__tests__/reservation.test.d.ts

@@ -0,0 +1,3 @@
+/** Tests for UTXO reservation utilities. */
+export {};
+//# sourceMappingURL=reservation.test.d.ts.map

package/dist/tbv/core/utils/utxo/__tests__/reservation.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reservation.test.d.ts","sourceRoot":"","sources":["../../../../../../src/tbv/core/utils/utxo/__tests__/reservation.test.ts"],"names":[],"mappings":"AAAA,4CAA4C"}