@babylonlabs-io/ts-sdk 0.0.0-semantic-release.2 → 0.1.0

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

@@ -0,0 +1,70 @@
+import { Buffer } from 'buffer';
+import { UTXO } from '../utxo/selectUtxos';
+/**
+ * Transaction Funding Utility for Peg-in Transactions
+ *
+ * This module funds an unfunded transaction template from the SDK by adding
+ * 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)
+ * 2. selectUtxosForPegin() → select UTXOs and calculate fees
+ * 3. fundPeginTransaction() → add inputs/change, create funded transaction
+ *
+ * Technical Note:
+ * We manually extract the vault output from SDK hex instead of using bitcoinjs-lib
+ * parsing because bitcoinjs-lib cannot parse 0-input transactions (even witness format).
+ */
+import * as bitcoin from "bitcoinjs-lib";
+export interface FundPeginTransactionParams {
+    /** Unfunded transaction hex from SDK (0 inputs, vault + depositor claim outputs) */
+    unfundedTxHex: string;
+    /** Selected UTXOs to use as inputs */
+    selectedUTXOs: UTXO[];
+    /** Change address (from wallet) */
+    changeAddress: string;
+    /** Change amount in satoshis */
+    changeAmount: bigint;
+    /** Bitcoin network */
+    network: bitcoin.Network;
+}
+/** A single parsed output from the unfunded WASM transaction */
+interface ParsedOutput {
+    value: number;
+    script: Buffer;
+}
+/** Parsed data from an unfunded WASM transaction */
+interface ParsedUnfundedTx {
+    version: number;
+    locktime: number;
+    outputs: ParsedOutput[];
+}
+/**
+ * Parses an unfunded transaction hex from WASM.
+ *
+ * WASM produces witness-format transactions with 0 inputs, which bitcoinjs-lib cannot parse.
+ * This function manually extracts the transaction components.
+ *
+ * Format: [version:4bytes][marker:0x00][flag:0x01][inputs:1byte=0x00][outputCount:1byte]
+ *         [output1: value:8bytes + scriptLen:1byte + script:N bytes]
+ *         [output2: ...]
+ *         [locktime:4bytes]
+ *
+ * @param unfundedTxHex - Raw transaction hex from WASM
+ * @returns Parsed transaction components
+ * @throws Error if transaction structure is invalid
+ */
+export declare function parseUnfundedWasmTransaction(unfundedTxHex: string): ParsedUnfundedTx;
+/**
+ * Funds an unfunded peg-in transaction by adding inputs and change output.
+ *
+ * Takes an unfunded transaction template (0 inputs, 1 vault output) from the SDK
+ * and adds UTXO inputs and a change output to create a funded transaction ready
+ * for wallet signing.
+ *
+ * @param params - Transaction funding parameters
+ * @returns Transaction hex string ready for wallet signing
+ */
+export declare function fundPeginTransaction(params: FundPeginTransactionParams): string;
+export { getNetwork } from '../../primitives/utils/bitcoin';
+//# sourceMappingURL=fundPeginTransaction.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fundPeginTransaction.d.ts","sourceRoot":"","sources":["../../../../../src/tbv/core/utils/transaction/fundPeginTransaction.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,OAAO,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAGhC,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAEhD,MAAM,WAAW,0BAA0B;IACzC,oFAAoF;IACpF,aAAa,EAAE,MAAM,CAAC;IACtB,sCAAsC;IACtC,aAAa,EAAE,IAAI,EAAE,CAAC;IACtB,mCAAmC;IACnC,aAAa,EAAE,MAAM,CAAC;IACtB,gCAAgC;IAChC,YAAY,EAAE,MAAM,CAAC;IACrB,sBAAsB;IACtB,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC;CAC1B;AAED,gEAAgE;AAChE,UAAU,YAAY;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,oDAAoD;AACpD,UAAU,gBAAgB;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,YAAY,EAAE,CAAC;CACzB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,4BAA4B,CAC1C,aAAa,EAAE,MAAM,GACpB,gBAAgB,CAmDlB;AAED;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,0BAA0B,GACjC,MAAM,CAgCR;AAGD,OAAO,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAC"}

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

@@ -0,0 +1,9 @@
+/**
+ * Transaction funding utilities
+ *
+ * @module utils/transaction
+ */
+export * from './fundPeginTransaction';
+export * from './btcTxHash';
+export * from './createSplitTransaction';
+//# sourceMappingURL=index.d.ts.map

package/dist/tbv/core/utils/transaction/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/tbv/core/utils/transaction/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,wBAAwB,CAAC;AACvC,cAAc,aAAa,CAAC;AAC5B,cAAc,0BAA0B,CAAC"}

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

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

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

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

package/dist/tbv/core/utils/utxo/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * UTXO selection utilities
+ *
+ * @module utils/utxo
+ */
+export * from './selectUtxos';
+//# sourceMappingURL=index.d.ts.map

package/dist/tbv/core/utils/utxo/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/tbv/core/utils/utxo/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,eAAe,CAAC"}

package/dist/tbv/core/utils/utxo/selectUtxos.d.ts

@@ -0,0 +1,65 @@
+/**
+ * UTXO selection utilities for peg-in transactions.
+ * Follows btc-staking-ts methodology with iterative fee calculation.
+ */
+/**
+ * Unspent Transaction Output (UTXO) for funding peg-in transactions.
+ */
+export interface UTXO {
+    /**
+     * Transaction ID of the UTXO (64-char hex without 0x prefix).
+     */
+    txid: string;
+    /**
+     * Output index within the transaction.
+     */
+    vout: number;
+    /**
+     * Value in satoshis.
+     */
+    value: number;
+    /**
+     * Script public key hex.
+     */
+    scriptPubKey: string;
+}
+export interface UTXOSelectionResult {
+    selectedUTXOs: UTXO[];
+    totalValue: bigint;
+    fee: bigint;
+    changeAmount: bigint;
+}
+/**
+ * Selects UTXOs to fund a peg-in transaction with iterative fee calculation.
+ *
+ * This function implements the btc-staking-ts approach:
+ * 1. Filter UTXOs for script validity (no minimum value filter)
+ * 2. Sort by value (largest first) to minimize number of inputs
+ * 3. Iteratively add UTXOs and recalculate fee until we have enough
+ *
+ * The fee recalculation is critical because:
+ * - Each UTXO added increases transaction size → increases fee
+ * - More fee needed might require another UTXO
+ * - Change output detection affects fee (adds output size if needed)
+ *
+ * @param availableUTXOs - All available UTXOs from wallet
+ * @param peginAmount - Amount to peg in (satoshis)
+ * @param feeRate - Fee rate (sat/vbyte)
+ * @returns Selected UTXOs, total value, calculated fee, and change amount
+ * @throws Error if insufficient funds or no valid UTXOs
+ */
+export declare function selectUtxosForPegin(availableUTXOs: UTXO[], peginAmount: bigint, feeRate: number): UTXOSelectionResult;
+/**
+ * Checks if change amount is above dust threshold.
+ *
+ * @param changeAmount - Change amount in satoshis
+ * @returns true if change should be added as output, false if it should go to miners
+ */
+export declare function shouldAddChangeOutput(changeAmount: bigint): boolean;
+/**
+ * Gets the dust threshold value.
+ *
+ * @returns Dust threshold in satoshis
+ */
+export declare function getDustThreshold(): number;
+//# sourceMappingURL=selectUtxos.d.ts.map

package/dist/tbv/core/utils/utxo/selectUtxos.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selectUtxos.d.ts","sourceRoot":"","sources":["../../../../../src/tbv/core/utils/utxo/selectUtxos.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAcH;;GAEG;AACH,MAAM,WAAW,IAAI;IACnB;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,mBAAmB;IAClC,aAAa,EAAE,IAAI,EAAE,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,mBAAmB,CACjC,cAAc,EAAE,IAAI,EAAE,EACtB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,GACd,mBAAmB,CAuErB;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAEnE;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC"}

package/dist/tbv/index.cjs

@@ -1,2 +1,2 @@
-"use strict";
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const t=require("../challengeAssert-34HqeVFH.cjs"),e=require("../PayoutManager-Dg_i_S7w.cjs");exports.buildChallengeAssertPsbt=t.buildChallengeAssertPsbt;exports.buildDepositorPayoutPsbt=t.buildDepositorPayoutPsbt;exports.buildNoPayoutPsbt=t.buildNoPayoutPsbt;exports.buildPayoutPsbt=t.buildPayoutPsbt;exports.buildPeginPsbt=t.buildPeginPsbt;exports.createPayoutScript=t.createPayoutScript;exports.deriveNativeSegwitAddress=t.deriveNativeSegwitAddress;exports.deriveTaprootAddress=t.deriveTaprootAddress;exports.extractPayoutSignature=t.extractPayoutSignature;exports.getNetwork=t.getNetwork;exports.hexToUint8Array=t.hexToUint8Array;exports.isAddressFromPublicKey=t.isAddressFromPublicKey;exports.isValidHex=t.isValidHex;exports.processPublicKeyToXOnly=t.processPublicKeyToXOnly;exports.stripHexPrefix=t.stripHexPrefix;exports.toXOnly=t.toXOnly;exports.uint8ArrayToHex=t.uint8ArrayToHex;exports.validateWalletPubkey=t.validateWalletPubkey;exports.BTCVaultsManagerABI=e.BTCVaultsManagerABI;exports.BTC_DUST_SAT=e.BTC_DUST_SAT;exports.BitcoinScriptType=e.BitcoinScriptType;exports.CONTRACT_ERRORS=e.CONTRACT_ERRORS;exports.DUST_THRESHOLD=e.DUST_THRESHOLD;exports.FEE_SAFETY_MARGIN=e.FEE_SAFETY_MARGIN;exports.LOW_RATE_ESTIMATION_ACCURACY_BUFFER=e.LOW_RATE_ESTIMATION_ACCURACY_BUFFER;exports.MAX_NON_LEGACY_OUTPUT_SIZE=e.MAX_NON_LEGACY_OUTPUT_SIZE;exports.MEMPOOL_API_URLS=e.MEMPOOL_API_URLS;exports.P2TR_INPUT_SIZE=e.P2TR_INPUT_SIZE;exports.PayoutManager=e.PayoutManager;exports.PeginManager=e.PeginManager;exports.TX_BUFFER_SIZE_OVERHEAD=e.TX_BUFFER_SIZE_OVERHEAD;exports.WALLET_RELAY_FEE_RATE_THRESHOLD=e.WALLET_RELAY_FEE_RATE_THRESHOLD;exports.calculateBtcTxHash=e.calculateBtcTxHash;exports.createSplitTransaction=e.createSplitTransaction;exports.createSplitTransactionPsbt=e.createSplitTransactionPsbt;exports.extractErrorData=e.extractErrorData;exports.fundPeginTransaction=e.fundPeginTransaction;exports.getAddressTxs=e.getAddressTxs;exports.getAddressUtxos=e.getAddressUtxos;exports.getContractErrorMessage=e.getContractErrorMessage;exports.getDustThreshold=e.getDustThreshold;exports.getMempoolApiUrl=e.getMempoolApiUrl;exports.getNetworkFees=e.getNetworkFees;exports.getPsbtInputFields=e.getPsbtInputFields;exports.getScriptType=e.getScriptType;exports.getTxHex=e.getTxHex;exports.getTxInfo=e.getTxInfo;exports.getUtxoInfo=e.getUtxoInfo;exports.handleContractError=e.handleContractError;exports.isKnownContractError=e.isKnownContractError;exports.parseUnfundedWasmTransaction=e.parseUnfundedWasmTransaction;exports.pushTx=e.pushTx;exports.rateBasedTxBufferFee=e.rateBasedTxBufferFee;exports.selectUtxosForPegin=e.selectUtxosForPegin;exports.shouldAddChangeOutput=e.shouldAddChangeOutput;
 //# sourceMappingURL=index.cjs.map

package/dist/tbv/index.js

@@ -1,2 +1,60 @@
-
+import { f as e, c as t, d as r, a as o, b as i, g as T, h as n, i as d, e as l, m as u, j as A, k as E, l as P, p as g, s as c, t as _, u as p, v as x } from "../challengeAssert-DVErOd8l.js";
+import { x as b, B as y, e as R, C as U, D as C, F as O, L as F, M as I, v as f, P as h, k as M, j as B, T as H, W as L, c as N, b as D, d as m, y as v, f as k, l as w, m as W, z as X, g as Y, n as K, o as V, i as Z, h as j, q as G, t as q, u as z, E as J, A as Q, p as $, w as aa, r as sa, s as ea, a as ta } from "../PayoutManager-rMj54HDh.js";
+export {
+  b as BTCVaultsManagerABI,
+  y as BTC_DUST_SAT,
+  R as BitcoinScriptType,
+  U as CONTRACT_ERRORS,
+  C as DUST_THRESHOLD,
+  O as FEE_SAFETY_MARGIN,
+  F as LOW_RATE_ESTIMATION_ACCURACY_BUFFER,
+  I as MAX_NON_LEGACY_OUTPUT_SIZE,
+  f as MEMPOOL_API_URLS,
+  h as P2TR_INPUT_SIZE,
+  M as PayoutManager,
+  B as PeginManager,
+  H as TX_BUFFER_SIZE_OVERHEAD,
+  L as WALLET_RELAY_FEE_RATE_THRESHOLD,
+  e as buildChallengeAssertPsbt,
+  t as buildDepositorPayoutPsbt,
+  r as buildNoPayoutPsbt,
+  o as buildPayoutPsbt,
+  i as buildPeginPsbt,
+  N as calculateBtcTxHash,
+  T as createPayoutScript,
+  D as createSplitTransaction,
+  m as createSplitTransactionPsbt,
+  n as deriveNativeSegwitAddress,
+  d as deriveTaprootAddress,
+  v as extractErrorData,
+  l as extractPayoutSignature,
+  k as fundPeginTransaction,
+  w as getAddressTxs,
+  W as getAddressUtxos,
+  X as getContractErrorMessage,
+  Y as getDustThreshold,
+  K as getMempoolApiUrl,
+  u as getNetwork,
+  V as getNetworkFees,
+  Z as getPsbtInputFields,
+  j as getScriptType,
+  G as getTxHex,
+  q as getTxInfo,
+  z as getUtxoInfo,
+  J as handleContractError,
+  A as hexToUint8Array,
+  E as isAddressFromPublicKey,
+  Q as isKnownContractError,
+  P as isValidHex,
+  $ as parseUnfundedWasmTransaction,
+  g as processPublicKeyToXOnly,
+  aa as pushTx,
+  sa as rateBasedTxBufferFee,
+  ea as selectUtxosForPegin,
+  ta as shouldAddChangeOutput,
+  c as stripHexPrefix,
+  _ as toXOnly,
+  p as uint8ArrayToHex,
+  x as validateWalletPubkey
+};
 //# sourceMappingURL=index.js.map

package/dist/tbv/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/integrations/aave/clients/__tests__/spoke.test.d.ts

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

package/dist/tbv/integrations/aave/clients/__tests__/spoke.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spoke.test.d.ts","sourceRoot":"","sources":["../../../../../../src/tbv/integrations/aave/clients/__tests__/spoke.test.ts"],"names":[],"mappings":""}

package/dist/tbv/integrations/aave/clients/__tests__/transaction.test.d.ts

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

package/dist/tbv/integrations/aave/clients/__tests__/transaction.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transaction.test.d.ts","sourceRoot":"","sources":["../../../../../../src/tbv/integrations/aave/clients/__tests__/transaction.test.ts"],"names":[],"mappings":""}