@babylonlabs-io/ts-sdk 0.79.0 → 1.0.0

package/dist/tbv/core/vault-secrets/__tests__/deriveContextHash.vectors.test.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Conformance vectors for the wallet-side `deriveContextHash` API that
+ * `deriveVaultRoot` consumes.
+ *
+ * No adapter in this repository runs the derivation; it runs inside the
+ * wallet (the Ledger vault app, the Keystone firmware, OneKey, UniSat).
+ * This file therefore carries a reference implementation and pins its
+ * outputs. Every conforming wallet MUST reproduce them. Any change here
+ * is a hard fork (CLAUDE.md, "Critical paths", section 4).
+ *
+ * ```
+ * ikm    = BIP-32 private key at path m/73681862'
+ * salt   = "derive-context-hash"                      (UTF-8)
+ * info   = SHA-256(UTF8(appName))                     (32 bytes)
+ *       || SHA-256(UTF8(canonicalNetworkName))        (32 bytes)
+ *       || connectedPubkey                            (33 bytes, compressed SEC1)
+ *       || context                                    (raw bytes, decoded from hex)
+ * output = HKDF-SHA-256(ikm, salt, info, 32)          (64 lowercase hex chars)
+ * ```
+ *
+ * `canonicalNetworkName` is one of `bitcoin-mainnet`, `bitcoin-testnet`
+ * (testnet3 and testnet4 share it), `bitcoin-signet`, `bitcoin-regtest`.
+ * `appName` matches `[a-z0-9-]{1,64}`; `context` is non-empty lowercase hex
+ * of even length, no `0x` prefix, at most 1024 bytes.
+ *
+ * The purpose index 73681862 is `trunc31_be(SHA-256("derive-context-hash"))`.
+ * `ikm` is the raw 32-byte big-endian private-key scalar at that path (no
+ * chain code, no serialization prefix); an invalid BIP-32 child is an error,
+ * not a skip to the next index, and the path is never used for signing or
+ * any other derivation. `connectedPubkey` is the compressed SEC1 form of the
+ * key the wallet returned to the dApp as the active connected key for this
+ * request (the BIP-44 leaf below is only the fixture for this vector).
+ * Imported (non-HD) keys use the raw private key as `ikm`; MPC and other
+ * non-HD wallets may use their own deterministic derivation, as long as the
+ * output is 32 bytes, depends on the key material and on all four inputs,
+ * and stays stable across share refreshes that keep the same public key.
+ * Neither is portable to an HD wallet restored from the same phrase.
+ */
+export {};
+//# sourceMappingURL=deriveContextHash.vectors.test.d.ts.map

package/dist/tbv/core/vault-secrets/__tests__/deriveContextHash.vectors.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deriveContextHash.vectors.test.d.ts","sourceRoot":"","sources":["../../../../../src/tbv/core/vault-secrets/__tests__/deriveContextHash.vectors.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG"}

package/dist/tbv/core/vault-secrets/context.d.ts

@@ -1,6 +1,6 @@
 /**
- * Canonical `vaultContext` byte encoding per
- * `derive-vault-secrets.md` §2.3.
+ * Canonical `vaultContext` byte encoding, pinned by
+ * `__tests__/context.golden.test.ts`.
  *
  * ```
  * vaultContext :=

package/dist/tbv/core/vault-secrets/deriveVaultRoot.d.ts

@@ -2,8 +2,7 @@ import { VaultContextInput } from './context';
 /**
  * The fixed `appName` passed to the wallet's `deriveContextHash` for
  * Babylon vault derivations. The wallet displays this in its approval
- * dialog. Defined by `derive-vault-secrets.md` §2.2 — must not be
- * changed without coordinating a spec revision and a downstream
+ * dialog. Frozen — must not be changed without a downstream
  * migration plan, as it provides app-level domain separation across
  * applications using the same wallet.
  */
@@ -28,13 +27,13 @@ export declare function forwardDeriveContextHash(wallet: Partial<DeriveContextHa
  * `wallet.deriveContextHash`.
  *
  * Validates the wallet's output strictly: must be exactly 64
- * lowercase hex characters per `derive-context-hash.md` §2.1. A
+ * lowercase hex characters, as the `deriveContextHash` contract requires. A
  * conformant wallet always satisfies this, but we re-check at the
  * SDK boundary so a non-conformant wallet (or a wallet returning a
  * malformed value through a buggy adapter) fails loud here rather
  * than producing silently-wrong derived secrets downstream.
  *
- * The helper itself produces only valid spec inputs (`appName` is
+ * The helper itself produces only valid `deriveContextHash` inputs (`appName` is
  * the hardcoded `VAULT_APP_NAME`; `context` is hex of the 72-byte
  * `vaultContext`, always 144 chars lowercase), so input-side
  * validation is unnecessary.
@@ -47,8 +46,8 @@ export declare function forwardDeriveContextHash(wallet: Partial<DeriveContextHa
  * @stability frozen — on-chain-binding. The pair (`VAULT_APP_NAME`,
  * `vaultContext` encoding) is the wallet's input space; changing
  * either rotates the root and invalidates every secret derived from
- * it. `VAULT_APP_NAME` is fixed by `derive-vault-secrets.md` §2.2
- * and must never change without a coordinated spec revision.
+ * it. `VAULT_APP_NAME` is frozen and must never change without a
+ * downstream migration plan.
  *
  * @returns 32-byte root suitable for {@link expandAuthAnchor},
  *          {@link expandHashlockSecret}, {@link expandWotsSeed}.

package/dist/tbv/core/vault-secrets/deriveVaultRoot.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"deriveVaultRoot.d.ts","sourceRoot":"","sources":["../../../../src/tbv/core/vault-secrets/deriveVaultRoot.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAIH,OAAO,EAAqB,KAAK,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAEtE;;;;;;;GAOG;AACH,eAAO,MAAM,cAAc,sBAAsB,CAAC;AAUlD;;;;;;GAMG;AACH,MAAM,WAAW,8BAA8B;IAC7C,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CACtE;AAED;;kCAEkC;AAClC,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,OAAO,CAAC,8BAA8B,CAAC,GAC9C,OAAO,CAAC,8BAA8B,CAAC,CAWzC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,wBAAsB,eAAe,CACnC,MAAM,EAAE,8BAA8B,EACtC,KAAK,EAAE,iBAAiB,GACvB,OAAO,CAAC,UAAU,CAAC,CAuBrB"}
+{"version":3,"file":"deriveVaultRoot.d.ts","sourceRoot":"","sources":["../../../../src/tbv/core/vault-secrets/deriveVaultRoot.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH,OAAO,EAAqB,KAAK,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAEtE;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,sBAAsB,CAAC;AAUlD;;;;;;GAMG;AACH,MAAM,WAAW,8BAA8B;IAC7C,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CACtE;AAED;;kCAEkC;AAClC,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,OAAO,CAAC,8BAA8B,CAAC,GAC9C,OAAO,CAAC,8BAA8B,CAAC,CAWzC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,wBAAsB,eAAe,CACnC,MAAM,EAAE,8BAA8B,EACtC,KAAK,EAAE,iBAAiB,GACvB,OAAO,CAAC,UAAU,CAAC,CAuBrB"}

package/dist/tbv/core/vault-secrets/index.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const t=require("../wasm/index.cjs"),e=require("../../../parseFundingOutpoints-B4iQeX6q.cjs");exports.expandAuthAnchor=t.expandAuthAnchor;exports.expandHashlockSecret=t.expandHashlockSecret;exports.expandWotsSeed=t.expandWotsSeed;exports.VAULT_APP_NAME=e.VAULT_APP_NAME;exports.buildFundingOutpointsCommitment=e.buildFundingOutpointsCommitment;exports.buildVaultContext=e.buildVaultContext;exports.deriveVaultRoot=e.deriveVaultRoot;exports.forwardDeriveContextHash=e.forwardDeriveContextHash;exports.parseFundingOutpointsFromTx=e.parseFundingOutpointsFromTx;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const t=require("../wasm/index.cjs"),e=require("../../../parseFundingOutpoints-BwC3foxS.cjs");exports.expandAuthAnchor=t.expandAuthAnchor;exports.expandHashlockSecret=t.expandHashlockSecret;exports.expandWotsSeed=t.expandWotsSeed;exports.VAULT_APP_NAME=e.VAULT_APP_NAME;exports.buildFundingOutpointsCommitment=e.buildFundingOutpointsCommitment;exports.buildVaultContext=e.buildVaultContext;exports.deriveVaultRoot=e.deriveVaultRoot;exports.forwardDeriveContextHash=e.forwardDeriveContextHash;exports.parseFundingOutpointsFromTx=e.parseFundingOutpointsFromTx;
 //# sourceMappingURL=index.cjs.map

package/dist/tbv/core/vault-secrets/index.d.ts

@@ -3,8 +3,8 @@
  * secrets (HTLC hashlock preimage, depositor auth anchor, WOTS seed)
  * from a single 32-byte root.
  *
- * Implements `derive-vault-secrets.md` §2.2 and Appendix A. The root is
- * spec-opaque — callers produce it from `wallet.deriveContextHash` via
+ * Implements the root-to-leaf expansion pinned by `__tests__/expand.test.ts`.
+ * The root is opaque to the expanders — callers produce it from `wallet.deriveContextHash` via
  * {@link deriveVaultRoot} (canonical path), or from any other source
  * that yields 32 bytes. The SDK is provenance-agnostic and only
  * consumes the 32 bytes.

package/dist/tbv/core/vault-secrets/index.js

@@ -1,5 +1,5 @@
 import { expandAuthAnchor as a, expandHashlockSecret as o, expandWotsSeed as n } from "../wasm/index.js";
-import { V as s, b as d, a as i, d as p, f as u, p as x } from "../../../parseFundingOutpoints-BQWvINfm.js";
+import { V as s, b as d, a as i, d as p, f as u, p as x } from "../../../parseFundingOutpoints-CC4NKYz2.js";
 export {
   s as VAULT_APP_NAME,
   d as buildFundingOutpointsCommitment,

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

@@ -1,2 +1,2 @@
-"use strict";var y=Object.create;var d=Object.defineProperty;var h=Object.getOwnPropertyDescriptor;var f=Object.getOwnPropertyNames;var b=Object.getPrototypeOf,m=Object.prototype.hasOwnProperty;var w=(e,t,a,r)=>{if(t&&typeof t=="object"||typeof t=="function")for(let o of f(t))!m.call(e,o)&&o!==a&&d(e,o,{get:()=>t[o],enumerable:!(r=h(t,o))||r.enumerable});return e};var P=(e,t,a)=>(a=e!=null?y(b(e)):{},w(t||!e||!e.__esModule?d(a,"default",{value:e,enumerable:!0}):a,e));Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const l="50929b74c1a04954b78b4b6035e97a5e078a5a0f28ec96d547bfee9ace803ac0",i=2,A=Uint8Array.from({length:l.length/i},(e,t)=>Number.parseInt(l.slice(t*i,t*i+i),16));let s,c;function n(){return s??(s=import("@babylonlabs-io/babylon-tbv-rust-wasm").catch(e=>{throw s=void 0,new Error("The vault-WASM engine @babylonlabs-io/babylon-tbv-rust-wasm failed to load. The module could not be resolved, or it threw while evaluating, commonly a missing or stale generated WASM build. See the cause for the underlying error.",{cause:e})})),s}function v(){return c??(c=import("@babylonlabs-io/babylon-tbv-rust-wasm/raw").catch(e=>{throw c=void 0,new Error("The raw vault-WASM entry @babylonlabs-io/babylon-tbv-rust-wasm/raw failed to load. The module could not be resolved, or it threw while evaluating. See the cause for the underlying error.",{cause:e})}).then(async e=>{try{await e.initWasm()}catch(t){throw c=void 0,new Error("The raw vault-WASM entry resolved but its WebAssembly binary failed to initialize.",{cause:t})}return e})),c}async function S(e){return(await n()).createPrePeginTransaction(e)}async function T(e,t,a,r){return(await n()).buildPeginTxFromPrePegin(e,t,a,r)}async function I(e){return(await n()).getPrePeginHtlcConnectorInfo(e)}async function x(e,t,a,r,o,u){return(await n()).computeMinClaimValue(e,t,a,r,o,u)}async function W(e,t,a,r){return(await n()).computeMinPeginFee(e,t,a,r)}async function C(e,t,a,r,o,u,p,g){return(await n()).computePayoutFeeFloor(e,t,a,r,o,u,p,g)}async function M(){return(await n()).supportedTxGraphVersions()}async function F(e){return(await n()).peginP2aAnchorOutput(e)}async function E(e,t){return(await n()).validatePeginP2aAnchor(e,t)}async function V(e,t){return(await n()).createPayoutConnector(e,t)}async function H(e){return(await n()).getAssertPayoutScriptInfo(e)}async function N(e,t){return(await n()).getAssertNoPayoutScriptInfo(e,t)}async function _(e){return(await n()).getChallengeAssertScriptInfo(e)}async function R(e){return(await n()).expandAuthAnchor(e)}async function k(e,t){return(await n()).expandHashlockSecret(e,t)}async function O(e,t){return(await n()).expandWotsSeed(e,t)}async function G(e,t){return(await n()).deriveVaultId(e,t)}exports.TAP_INTERNAL_KEY=l;exports.buildPeginTxFromPrePegin=T;exports.computeMinClaimValue=x;exports.computeMinPeginFee=W;exports.computePayoutFeeFloor=C;exports.createPayoutConnector=V;exports.createPrePeginTransaction=S;exports.deriveVaultId=G;exports.expandAuthAnchor=R;exports.expandHashlockSecret=k;exports.expandWotsSeed=O;exports.getAssertNoPayoutScriptInfo=N;exports.getAssertPayoutScriptInfo=H;exports.getChallengeAssertScriptInfo=_;exports.getPrePeginHtlcConnectorInfo=I;exports.loadRawTbvWasm=v;exports.loadTbvWasm=n;exports.peginP2aAnchorOutput=F;exports.supportedTxGraphVersions=M;exports.tapInternalPubkey=A;exports.validatePeginP2aAnchor=E;
+"use strict";var d=Object.create;var l=Object.defineProperty;var p=Object.getOwnPropertyDescriptor;var y=Object.getOwnPropertyNames;var f=Object.getPrototypeOf,h=Object.prototype.hasOwnProperty;var b=(e,t,a,r)=>{if(t&&typeof t=="object"||typeof t=="function")for(let o of y(t))!h.call(e,o)&&o!==a&&l(e,o,{get:()=>t[o],enumerable:!(r=p(t,o))||r.enumerable});return e};var m=(e,t,a)=>(a=e!=null?d(f(e)):{},b(t||!e||!e.__esModule?l(a,"default",{value:e,enumerable:!0}):a,e));Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const s="50929b74c1a04954b78b4b6035e97a5e078a5a0f28ec96d547bfee9ace803ac0",i=2,A=Uint8Array.from({length:s.length/i},(e,t)=>Number.parseInt(s.slice(t*i,t*i+i),16));let c;function n(){return c??(c=import("@babylonlabs-io/babylon-tbv-rust-wasm").catch(e=>{throw c=void 0,new Error("The vault-WASM engine @babylonlabs-io/babylon-tbv-rust-wasm failed to load. The module could not be resolved, or it threw while evaluating, commonly a missing or stale generated WASM build. See the cause for the underlying error.",{cause:e})}).then(async e=>{try{await e.initWasm()}catch(t){throw c=void 0,new Error("The vault-WASM engine @babylonlabs-io/babylon-tbv-rust-wasm resolved, but its WebAssembly binary failed to initialize, commonly a missing or stale generated WASM build. See the cause for the underlying error.",{cause:t})}return e})),c}async function w(e){return(await n()).createPrePeginTransaction(e)}async function S(e,t,a,r){return(await n()).buildPeginTxFromPrePegin(e,t,a,r)}async function I(e){return(await n()).getPrePeginHtlcConnectorInfo(e)}async function T(e,t,a,r,o,u){return(await n()).computeMinClaimValue(e,t,a,r,o,u)}async function v(e,t,a,r){return(await n()).computeMinPeginFee(e,t,a,r)}async function x(e,t,a,r,o,u,P,g){return(await n()).computePayoutFeeFloor(e,t,a,r,o,u,P,g)}async function C(){return(await n()).supportedTxGraphVersions()}async function F(e){return(await n()).peginP2aAnchorOutput(e)}async function M(e,t){return(await n()).validatePeginP2aAnchor(e,t)}async function W(e,t){return(await n()).createPayoutConnector(e,t)}async function E(e){return(await n()).getAssertPayoutScriptInfo(e)}async function V(e,t){return(await n()).getAssertNoPayoutScriptInfo(e,t)}async function H(e){return(await n()).getChallengeAssertScriptInfo(e)}async function N(e){return(await n()).expandAuthAnchor(e)}async function _(e,t){return(await n()).expandHashlockSecret(e,t)}async function k(e,t){return(await n()).expandWotsSeed(e,t)}async function O(e,t){return(await n()).deriveVaultId(e,t)}exports.TAP_INTERNAL_KEY=s;exports.buildPeginTxFromPrePegin=S;exports.computeMinClaimValue=T;exports.computeMinPeginFee=v;exports.computePayoutFeeFloor=x;exports.createPayoutConnector=W;exports.createPrePeginTransaction=w;exports.deriveVaultId=O;exports.expandAuthAnchor=N;exports.expandHashlockSecret=_;exports.expandWotsSeed=k;exports.getAssertNoPayoutScriptInfo=V;exports.getAssertPayoutScriptInfo=E;exports.getChallengeAssertScriptInfo=H;exports.getPrePeginHtlcConnectorInfo=I;exports.loadTbvWasm=n;exports.peginP2aAnchorOutput=F;exports.supportedTxGraphVersions=C;exports.tapInternalPubkey=A;exports.validatePeginP2aAnchor=M;
 //# sourceMappingURL=index.cjs.map

package/dist/tbv/core/wasm/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","sources":["../../../../src/tbv/core/wasm/constants.ts","../../../../src/tbv/core/wasm/index.ts"],"sourcesContent":["/**\n * Protocol constants that do not require loading the vault WASM module.\n *\n * Keeping these values local lets Bitcoin builders construct PSBT metadata\n * without resolving or evaluating the WASM engine at module-import\n * time. The hex value is the BIP-341 nothing-up-my-sleeve internal key and is\n * pinned by the vault protocol.\n */\nexport const TAP_INTERNAL_KEY =\n  \"50929b74c1a04954b78b4b6035e97a5e078a5a0f28ec96d547bfee9ace803ac0\";\n\nconst HEX_CHARS_PER_BYTE = 2;\n\nexport const tapInternalPubkey = Uint8Array.from(\n  { length: TAP_INTERNAL_KEY.length / HEX_CHARS_PER_BYTE },\n  (_, index) =>\n    Number.parseInt(\n      TAP_INTERNAL_KEY.slice(\n        index * HEX_CHARS_PER_BYTE,\n        index * HEX_CHARS_PER_BYTE + HEX_CHARS_PER_BYTE,\n      ),\n      16,\n    ),\n);\n","/**\n * Explicit lazy boundary around the vault-WASM engine package.\n *\n * Importing the SDK (including its legacy root barrels) does not resolve the\n * WASM package or generated binary. The engine is loaded only when a caller\n * invokes an operation that actually needs the Bitcoin transaction graph.\n * ETH-only entry points never import this module.\n *\n * @module tbv/core/wasm\n */\n\nimport type {\n  AssertNoPayoutScriptInfo,\n  AssertPayoutNoPayoutConnectorParams,\n  AssertPayoutScriptInfo,\n  ChallengeAssertConnectorParams,\n  ChallengeAssertScriptInfo,\n  HtlcConnectorInfo,\n  HtlcConnectorParams,\n  Network,\n  PayoutConnectorInfo,\n  PayoutConnectorParams,\n  PeginP2aAnchorInfo,\n  PeginTxResult,\n  PrePeginParams,\n  PrePeginResult,\n} from \"@babylonlabs-io/babylon-tbv-rust-wasm\";\n\nexport { TAP_INTERNAL_KEY, tapInternalPubkey } from \"./constants\";\n\ntype TbvWasmModule = typeof import(\"@babylonlabs-io/babylon-tbv-rust-wasm\");\n\nlet wasmModulePromise: Promise<TbvWasmModule> | undefined;\ntype RawTbvWasmModule =\n  typeof import(\"@babylonlabs-io/babylon-tbv-rust-wasm/raw\");\nlet rawWasmModulePromise: Promise<RawTbvWasmModule> | undefined;\n\n/** Load the WASM engine on first use and share the in-flight import. */\nexport function loadTbvWasm(): Promise<TbvWasmModule> {\n  wasmModulePromise ??= import(\"@babylonlabs-io/babylon-tbv-rust-wasm\").catch(\n    (error: unknown) => {\n      wasmModulePromise = undefined;\n      throw new Error(\n        \"The vault-WASM engine @babylonlabs-io/babylon-tbv-rust-wasm failed \" +\n          \"to load. The module could not be resolved, or it threw while \" +\n          \"evaluating, commonly a missing or stale generated WASM build. \" +\n          \"See the cause for the underlying error.\",\n        { cause: error },\n      );\n    },\n  );\n  return wasmModulePromise;\n}\n\n/**\n * Load and initialize the raw engine classes. This bypasses SDK value checks.\n * The internal refund builder applies equivalent checks at its call site.\n *\n * @deprecated Use buildPrePeginPsbt, buildPeginTxFromFundedPrePegin, or\n * buildRefundPsbt from @babylonlabs-io/ts-sdk/tbv/core/primitives.\n * Raw callers must independently check transaction values and signing data.\n */\nexport function loadRawTbvWasm(): Promise<RawTbvWasmModule> {\n  rawWasmModulePromise ??= import(\"@babylonlabs-io/babylon-tbv-rust-wasm/raw\")\n    .catch((error: unknown) => {\n      rawWasmModulePromise = undefined;\n      throw new Error(\n        \"The raw vault-WASM entry @babylonlabs-io/babylon-tbv-rust-wasm/raw \" +\n          \"failed to load. The module could not be resolved, or it threw \" +\n          \"while evaluating. See the cause for the underlying error.\",\n        { cause: error },\n      );\n    })\n    .then(async (wasm) => {\n      try {\n        await wasm.initWasm();\n      } catch (error: unknown) {\n        rawWasmModulePromise = undefined;\n        throw new Error(\n          \"The raw vault-WASM entry resolved but its WebAssembly \" +\n            \"binary failed to initialize.\",\n          { cause: error },\n        );\n      }\n      return wasm;\n    });\n  return rawWasmModulePromise;\n}\n\n/**\n * Creates an unfunded Pre-PegIn transaction with no inputs and HTLC output(s).\n *\n * The HTLC output value (htlcValue) covers the peg-in amount, depositor claim value,\n * and minimum pegin fee — all computed internally from the provided contract parameters.\n *\n * After building the Pre-PegIn transaction, the caller must:\n * 1. Select UTXOs covering htlcValue + network fees\n * 2. Fund the transaction (add inputs and change output)\n * 3. Call reconstructFromFundedTx() with the funded tx hex\n * 4. Call buildPeginTx() to derive the PegIn transaction\n * 5. Sign the PegIn input using the HTLC hashlock leaf (leaf 0)\n *\n * @param params - Pre-PegIn parameters from contract and depositor wallet\n * @returns Unfunded transaction details with HTLC output information\n */\nexport async function createPrePeginTransaction(\n  params: PrePeginParams,\n): Promise<PrePeginResult> {\n  return (await loadTbvWasm()).createPrePeginTransaction(params);\n}\n\n/**\n * Derives the PegIn transaction from a funded Pre-PegIn transaction.\n *\n * The PegIn transaction has a single input spending the Pre-PegIn HTLC output\n * at `htlcVout` via the hashlock + all-party script (leaf 0).\n *\n * @param params - Same PrePeginParams used to create the Pre-PegIn transaction\n * @param timelockPegin - CSV timelock in blocks for the PegIn vault output\n * @param fundedPrePeginTxHex - Hex-encoded funded Pre-PegIn transaction\n * @param htlcVout - Index of the HTLC output to spend\n * @returns PegIn transaction details including vault output information\n */\nexport async function buildPeginTxFromPrePegin(\n  params: PrePeginParams,\n  timelockPegin: number,\n  fundedPrePeginTxHex: string,\n  htlcVout: number,\n): Promise<PeginTxResult> {\n  return (await loadTbvWasm()).buildPeginTxFromPrePegin(\n    params,\n    timelockPegin,\n    fundedPrePeginTxHex,\n    htlcVout,\n  );\n}\n\n/**\n * Returns HTLC connector script info for signing the PegIn transaction input.\n *\n * The depositor signs PegIn input 0 using the hashlock leaf (leaf 0) of the\n * Pre-PegIn HTLC output. Use getHashlockScript() and getHashlockControlBlock()\n * to construct the tapLeafScript entry in the PSBT.\n *\n * @param params - HTLC connector parameters (subset of PrePeginParams)\n * @returns Hashlock and refund script info for PSBT construction\n */\nexport async function getPrePeginHtlcConnectorInfo(\n  params: HtlcConnectorParams,\n): Promise<HtlcConnectorInfo> {\n  return (await loadTbvWasm()).getPrePeginHtlcConnectorInfo(params);\n}\n\n/**\n * Compute the minimum depositor claim value (PegIn output 1) in satoshis.\n *\n * This covers the full downstream tx graph cost (Claim → Assert → Payout)\n * based on the protocol parameters.\n */\nexport async function computeMinClaimValue(\n  txGraphVersion: number,\n  numLocalChallengers: number,\n  numUniversalChallengers: number,\n  councilQuorum: number,\n  councilSize: number,\n  feeRate: bigint,\n): Promise<bigint> {\n  return (await loadTbvWasm()).computeMinClaimValue(\n    txGraphVersion,\n    numLocalChallengers,\n    numUniversalChallengers,\n    councilQuorum,\n    councilSize,\n    feeRate,\n  );\n}\n\n/**\n * Compute the minimum PegIn (activation) transaction fee in satoshis.\n *\n * `minPeginFee = peginTxVsize(numVks, numUcs) × minPeginFeeRate`. Each HTLC\n * the depositor funds in the Pre-PegIn tx must reserve at least this fee\n * inside its value (`htlcValue = peginAmount + depositorClaimValue +\n * minPeginFee`), otherwise the VP cannot afford to broadcast the PegIn at\n * activation. The vsize comes from a Taproot script-path-spend weight\n * prediction whose witness shape depends on the VK + UC signer count.\n */\nexport async function computeMinPeginFee(\n  txGraphVersion: number,\n  numVks: number,\n  numUcs: number,\n  minPeginFeeRate: bigint,\n): Promise<bigint> {\n  return (await loadTbvWasm()).computeMinPeginFee(\n    txGraphVersion,\n    numVks,\n    numUcs,\n    minPeginFeeRate,\n  );\n}\n\n/**\n * Floor of the Payout transaction fee under `txGraphVersion`: the minimum of\n * `estimatedVsize * feeRate` across every output-sizing model a deployed\n * vault provider is known to have used (fixed-34, intermediate,\n * script-aware). A VP-built payout paying less than this is provably not\n * produced by any known VP build. `out0Len` must be the TRUSTED length of the\n * pinned outs[0] script (1..=128); `out1Len` is the measured, UNTRUSTED\n * commission-script length — safe here because padding cannot raise the floor\n * (the fixed-34 model saturates the minimum) and shortening only lowers it.\n * Pass `undefined` for `out1Len` on 2-output (non-VP-claimer) payouts.\n * `feeRate` is the vault's version-locked `offchainParams.feeRate`.\n */\nexport async function computePayoutFeeFloor(\n  txGraphVersion: number,\n  numVaultKeepers: number,\n  numUniversalChallengers: number,\n  numLocalChallengers: number,\n  councilSize: number,\n  out0Len: number,\n  out1Len: number | null | undefined,\n  feeRate: bigint,\n): Promise<bigint> {\n  return (await loadTbvWasm()).computePayoutFeeFloor(\n    txGraphVersion,\n    numVaultKeepers,\n    numUniversalChallengers,\n    numLocalChallengers,\n    councilSize,\n    out0Len,\n    out1Len,\n    feeRate,\n  );\n}\n\n/**\n * Tx graph versions the shipped vault-wasm binary can build. Callers must\n * preflight the required version (fresh: active; resume: stamped) against\n * this list and fail closed instead of hitting per-call errors mid-flow.\n *\n * Note: the facade constructors themselves fail closed on unsupported\n * versions, and derived objects carry the version they were built with —\n * value-level cross-checks live in `assertWasmPeginSizing` and the golden\n * byte-parity tests, not in a per-call version echo.\n */\nexport async function supportedTxGraphVersions(): Promise<number[]> {\n  return (await loadTbvWasm()).supportedTxGraphVersions();\n}\n\n/**\n * The PegIn transaction's P2A (pay-to-anchor) output for a graph version, or\n * `null` when that version's PegIn carries no anchor (v1). The facade returns\n * one record per version — never a zero-valued placeholder — so an absent\n * anchor can't be mistaken for a real output. For v2/v3: 240 sats at vout 2,\n * script `51024e73`.\n */\nexport async function peginP2aAnchorOutput(\n  txGraphVersion: number,\n): Promise<PeginP2aAnchorInfo | null> {\n  return (await loadTbvWasm()).peginP2aAnchorOutput(txGraphVersion);\n}\n\n/**\n * Validate a PegIn transaction's P2A anchor against a graph version's rules:\n * v2 and v3 require the exact anchor (240 sats, vout 2, P2A script) and v1\n * requires that NO output carries the P2A script. Throws on any mismatch — a\n * v2 PegIn checked as v1 fails closed, and vice versa.\n */\nexport async function validatePeginP2aAnchor(\n  txGraphVersion: number,\n  txHex: string,\n): Promise<void> {\n  return (await loadTbvWasm()).validatePeginP2aAnchor(txGraphVersion, txHex);\n}\n\n/**\n * Creates a payout connector for vault transactions.\n *\n * The payout connector generates the necessary taproot scripts and information\n * required for signing payout transactions (both optimistic and regular payout paths).\n *\n * @param params - Parameters for creating the payout connector\n * @param network - Bitcoin network\n * @returns Payout connector information including scripts, hashes, and address\n */\nexport async function createPayoutConnector(\n  params: PayoutConnectorParams,\n  network: Network,\n): Promise<PayoutConnectorInfo> {\n  return (await loadTbvWasm()).createPayoutConnector(params, network);\n}\n\n/**\n * Get the Payout script and control block for the depositor's Assert output.\n *\n * Used to build the depositor's Payout PSBT (depositor-as-claimer path).\n *\n * @param params - Assert Payout/NoPayout connector parameters\n * @returns Payout script and control block (hex encoded)\n */\nexport async function getAssertPayoutScriptInfo(\n  params: AssertPayoutNoPayoutConnectorParams,\n): Promise<AssertPayoutScriptInfo> {\n  return (await loadTbvWasm()).getAssertPayoutScriptInfo(params);\n}\n\n/**\n * Get the NoPayout script and control block for a specific challenger.\n *\n * Used to build the depositor's NoPayout PSBT (depositor-as-claimer path).\n * Each challenger has a distinct NoPayout script.\n *\n * @param params - Assert Payout/NoPayout connector parameters\n * @param challengerPubkey - The challenger's x-only public key (hex encoded)\n * @returns NoPayout script and control block (hex encoded)\n */\nexport async function getAssertNoPayoutScriptInfo(\n  params: AssertPayoutNoPayoutConnectorParams,\n  challengerPubkey: string,\n): Promise<AssertNoPayoutScriptInfo> {\n  return (await loadTbvWasm()).getAssertNoPayoutScriptInfo(\n    params,\n    challengerPubkey,\n  );\n}\n\n/**\n * Get the ChallengeAssert script and control block.\n *\n * Used to build ChallengeAssert PSBTs for the depositor-as-claimer path.\n * Each challenger has 3 ChallengeAssert transactions, and this connector\n * generates the spending scripts using WOTS public keys from the VP.\n *\n * @param params - ChallengeAssert connector parameters\n * @returns Script and control block (hex encoded)\n */\nexport async function getChallengeAssertScriptInfo(\n  params: ChallengeAssertConnectorParams,\n): Promise<ChallengeAssertScriptInfo> {\n  return (await loadTbvWasm()).getChallengeAssertScriptInfo(params);\n}\n\n/**\n * Derive 32-byte `authAnchor` (OP_RETURN preimage → VP bearer token).\n * @stability frozen - btc-vault Rust owns this API through the vault-wasm pin (`VAULT_WASM_COMMIT`).\n * Changing the derived bytes breaks VP auth for existing deposits. See CLAUDE.md §4.\n */\nexport async function expandAuthAnchor(root: Uint8Array): Promise<Uint8Array> {\n  return (await loadTbvWasm()).expandAuthAnchor(root);\n}\n\n/**\n * Derive 32-byte `hashlockSecret` for HTLC `htlcVout` (preimage → `activateVaultWithSecret`).\n * @stability frozen - btc-vault Rust owns this API.\n * Changing the derived bytes means affected vaults can never activate. See CLAUDE.md §4.\n */\nexport async function expandHashlockSecret(\n  root: Uint8Array,\n  htlcVout: number,\n): Promise<Uint8Array> {\n  return (await loadTbvWasm()).expandHashlockSecret(root, htlcVout);\n}\n\n/**\n * Derive 64-byte `wotsSeed` for HTLC `htlcVout` (→ WOTS keys, hashed as `depositorWotsPkHash`).\n * @stability frozen - btc-vault Rust owns this API.\n * Changing the derived bytes breaks existing `depositorWotsPkHash` values. No claim path remains. See CLAUDE.md §4.\n */\nexport async function expandWotsSeed(\n  root: Uint8Array,\n  htlcVout: number,\n): Promise<Uint8Array> {\n  return (await loadTbvWasm()).expandWotsSeed(root, htlcVout);\n}\n\n/**\n * Derives the vault ID from a PegIn transaction hash and depositor ETH address.\n *\n * Vault ID = keccak256(abi.encode(peginTxHash, depositor))\n * This matches the Solidity-side derivation in BTCVaultRegistry.\n *\n * @param peginTxHash - 32-byte PegIn tx hash in display order (big-endian), hex encoded\n * @param depositor - 20-byte Ethereum address of the depositor, hex encoded\n * @returns Hex-encoded vault ID (32 bytes)\n */\nexport async function deriveVaultId(\n  peginTxHash: string,\n  depositor: string,\n): Promise<string> {\n  return (await loadTbvWasm()).deriveVaultId(peginTxHash, depositor);\n}\n\nexport type {\n  AssertNoPayoutScriptInfo,\n  AssertPayoutNoPayoutConnectorParams,\n  AssertPayoutScriptInfo,\n  ChallengeAssertConnectorParams,\n  ChallengeAssertScriptInfo,\n  HtlcConnectorInfo,\n  HtlcConnectorParams,\n  Network,\n  PayoutConnectorInfo,\n  PayoutConnectorParams,\n  PeginP2aAnchorInfo,\n  PeginTxResult,\n  PrePeginParams,\n  PrePeginResult,\n};\n"],"names":["TAP_INTERNAL_KEY","HEX_CHARS_PER_BYTE","tapInternalPubkey","_","index","wasmModulePromise","rawWasmModulePromise","loadTbvWasm","error","loadRawTbvWasm","wasm","createPrePeginTransaction","params","buildPeginTxFromPrePegin","timelockPegin","fundedPrePeginTxHex","htlcVout","getPrePeginHtlcConnectorInfo","computeMinClaimValue","txGraphVersion","numLocalChallengers","numUniversalChallengers","councilQuorum","councilSize","feeRate","computeMinPeginFee","numVks","numUcs","minPeginFeeRate","computePayoutFeeFloor","numVaultKeepers","out0Len","out1Len","supportedTxGraphVersions","peginP2aAnchorOutput","validatePeginP2aAnchor","txHex","createPayoutConnector","network","getAssertPayoutScriptInfo","getAssertNoPayoutScriptInfo","challengerPubkey","getChallengeAssertScriptInfo","expandAuthAnchor","root","expandHashlockSecret","expandWotsSeed","deriveVaultId","peginTxHash","depositor"],"mappings":"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"}
+{"version":3,"file":"index.cjs","sources":["../../../../src/tbv/core/wasm/constants.ts","../../../../src/tbv/core/wasm/index.ts"],"sourcesContent":["/**\n * Protocol constants that do not require loading the vault WASM module.\n *\n * Keeping these values local lets Bitcoin builders construct PSBT metadata\n * without resolving or evaluating the WASM engine at module-import\n * time. The hex value is the BIP-341 nothing-up-my-sleeve internal key and is\n * pinned by the vault protocol.\n */\nexport const TAP_INTERNAL_KEY =\n  \"50929b74c1a04954b78b4b6035e97a5e078a5a0f28ec96d547bfee9ace803ac0\";\n\nconst HEX_CHARS_PER_BYTE = 2;\n\nexport const tapInternalPubkey = Uint8Array.from(\n  { length: TAP_INTERNAL_KEY.length / HEX_CHARS_PER_BYTE },\n  (_, index) =>\n    Number.parseInt(\n      TAP_INTERNAL_KEY.slice(\n        index * HEX_CHARS_PER_BYTE,\n        index * HEX_CHARS_PER_BYTE + HEX_CHARS_PER_BYTE,\n      ),\n      16,\n    ),\n);\n","/**\n * Explicit lazy boundary around the vault-WASM engine package.\n *\n * Importing the SDK (including its legacy root barrels) does not resolve the\n * WASM package or generated binary. The engine is loaded only when a caller\n * invokes an operation that actually needs the Bitcoin transaction graph.\n * ETH-only entry points never import this module.\n *\n * @module tbv/core/wasm\n */\n\nimport type {\n  AssertNoPayoutScriptInfo,\n  AssertPayoutNoPayoutConnectorParams,\n  AssertPayoutScriptInfo,\n  ChallengeAssertConnectorParams,\n  ChallengeAssertScriptInfo,\n  HtlcConnectorInfo,\n  HtlcConnectorParams,\n  Network,\n  PayoutConnectorInfo,\n  PayoutConnectorParams,\n  PeginP2aAnchorInfo,\n  PeginTxResult,\n  PrePeginParams,\n  PrePeginResult,\n} from \"@babylonlabs-io/babylon-tbv-rust-wasm\";\n\nexport { TAP_INTERNAL_KEY, tapInternalPubkey } from \"./constants\";\n\ntype TbvWasmModule = typeof import(\"@babylonlabs-io/babylon-tbv-rust-wasm\");\n\nlet wasmModulePromise: Promise<TbvWasmModule> | undefined;\n\n/**\n * Load and initialize the WASM engine on first use. Concurrent callers share\n * one load. The returned module is already initialized, so a caller does not\n * call `initWasm()`. A load or initialization failure rejects with an error\n * that names the engine package. The original error is its cause. A failure\n * clears this cache, so the next call loads again. The engine keeps a failed\n * binary initialization rejected, so only a failed import or binary read can\n * succeed on a later call.\n *\n * The module also contains the wasm-bindgen classes. The classes have no value\n * guards. A caller that uses a class must cross-check its output at the call\n * site.\n */\nexport function loadTbvWasm(): Promise<TbvWasmModule> {\n  wasmModulePromise ??= import(\"@babylonlabs-io/babylon-tbv-rust-wasm\")\n    .catch((error: unknown) => {\n      wasmModulePromise = undefined;\n      throw new Error(\n        \"The vault-WASM engine @babylonlabs-io/babylon-tbv-rust-wasm failed \" +\n          \"to load. The module could not be resolved, or it threw while \" +\n          \"evaluating, commonly a missing or stale generated WASM build. \" +\n          \"See the cause for the underlying error.\",\n        { cause: error },\n      );\n    })\n    .then(async (wasm) => {\n      try {\n        await wasm.initWasm();\n      } catch (error: unknown) {\n        wasmModulePromise = undefined;\n        throw new Error(\n          \"The vault-WASM engine @babylonlabs-io/babylon-tbv-rust-wasm \" +\n            \"resolved, but its WebAssembly binary failed to initialize, \" +\n            \"commonly a missing or stale generated WASM build. See the \" +\n            \"cause for the underlying error.\",\n          { cause: error },\n        );\n      }\n      return wasm;\n    });\n  return wasmModulePromise;\n}\n\n/**\n * Creates an unfunded Pre-PegIn transaction with no inputs and HTLC output(s).\n *\n * The HTLC output value (htlcValue) covers the peg-in amount, depositor claim value,\n * and minimum pegin fee — all computed internally from the provided contract parameters.\n *\n * After building the Pre-PegIn transaction, the caller must:\n * 1. Select UTXOs covering htlcValue + network fees\n * 2. Fund the transaction (add inputs and change output)\n * 3. Call reconstructFromFundedTx() with the funded tx hex\n * 4. Call buildPeginTx() to derive the PegIn transaction\n * 5. Sign the PegIn input using the HTLC hashlock leaf (leaf 0)\n *\n * @param params - Pre-PegIn parameters from contract and depositor wallet\n * @returns Unfunded transaction details with HTLC output information\n */\nexport async function createPrePeginTransaction(\n  params: PrePeginParams,\n): Promise<PrePeginResult> {\n  return (await loadTbvWasm()).createPrePeginTransaction(params);\n}\n\n/**\n * Derives the PegIn transaction from a funded Pre-PegIn transaction.\n *\n * The PegIn transaction has a single input spending the Pre-PegIn HTLC output\n * at `htlcVout` via the hashlock + all-party script (leaf 0).\n *\n * @param params - Same PrePeginParams used to create the Pre-PegIn transaction\n * @param timelockPegin - CSV timelock in blocks for the PegIn vault output\n * @param fundedPrePeginTxHex - Hex-encoded funded Pre-PegIn transaction\n * @param htlcVout - Index of the HTLC output to spend\n * @returns PegIn transaction details including vault output information\n */\nexport async function buildPeginTxFromPrePegin(\n  params: PrePeginParams,\n  timelockPegin: number,\n  fundedPrePeginTxHex: string,\n  htlcVout: number,\n): Promise<PeginTxResult> {\n  return (await loadTbvWasm()).buildPeginTxFromPrePegin(\n    params,\n    timelockPegin,\n    fundedPrePeginTxHex,\n    htlcVout,\n  );\n}\n\n/**\n * Returns HTLC connector script info for signing the PegIn transaction input.\n *\n * The depositor signs PegIn input 0 using the hashlock leaf (leaf 0) of the\n * Pre-PegIn HTLC output. Use getHashlockScript() and getHashlockControlBlock()\n * to construct the tapLeafScript entry in the PSBT.\n *\n * @param params - HTLC connector parameters (subset of PrePeginParams)\n * @returns Hashlock and refund script info for PSBT construction\n */\nexport async function getPrePeginHtlcConnectorInfo(\n  params: HtlcConnectorParams,\n): Promise<HtlcConnectorInfo> {\n  return (await loadTbvWasm()).getPrePeginHtlcConnectorInfo(params);\n}\n\n/**\n * Compute the minimum depositor claim value (PegIn output 1) in satoshis.\n *\n * This covers the full downstream tx graph cost (Claim → Assert → Payout)\n * based on the protocol parameters.\n */\nexport async function computeMinClaimValue(\n  txGraphVersion: number,\n  numLocalChallengers: number,\n  numUniversalChallengers: number,\n  councilQuorum: number,\n  councilSize: number,\n  feeRate: bigint,\n): Promise<bigint> {\n  return (await loadTbvWasm()).computeMinClaimValue(\n    txGraphVersion,\n    numLocalChallengers,\n    numUniversalChallengers,\n    councilQuorum,\n    councilSize,\n    feeRate,\n  );\n}\n\n/**\n * Compute the minimum PegIn (activation) transaction fee in satoshis.\n *\n * `minPeginFee = peginTxVsize(numVks, numUcs) × minPeginFeeRate`. Each HTLC\n * the depositor funds in the Pre-PegIn tx must reserve at least this fee\n * inside its value (`htlcValue = peginAmount + depositorClaimValue +\n * minPeginFee`), otherwise the VP cannot afford to broadcast the PegIn at\n * activation. The vsize comes from a Taproot script-path-spend weight\n * prediction whose witness shape depends on the VK + UC signer count.\n */\nexport async function computeMinPeginFee(\n  txGraphVersion: number,\n  numVks: number,\n  numUcs: number,\n  minPeginFeeRate: bigint,\n): Promise<bigint> {\n  return (await loadTbvWasm()).computeMinPeginFee(\n    txGraphVersion,\n    numVks,\n    numUcs,\n    minPeginFeeRate,\n  );\n}\n\n/**\n * Floor of the Payout transaction fee under `txGraphVersion`: the minimum of\n * `estimatedVsize * feeRate` across every output-sizing model a deployed\n * vault provider is known to have used (fixed-34, intermediate,\n * script-aware). A VP-built payout paying less than this is provably not\n * produced by any known VP build. `out0Len` must be the TRUSTED length of the\n * pinned outs[0] script (1..=128); `out1Len` is the measured, UNTRUSTED\n * commission-script length — safe here because padding cannot raise the floor\n * (the fixed-34 model saturates the minimum) and shortening only lowers it.\n * Pass `undefined` for `out1Len` on 2-output (non-VP-claimer) payouts.\n * `feeRate` is the vault's version-locked `offchainParams.feeRate`.\n */\nexport async function computePayoutFeeFloor(\n  txGraphVersion: number,\n  numVaultKeepers: number,\n  numUniversalChallengers: number,\n  numLocalChallengers: number,\n  councilSize: number,\n  out0Len: number,\n  out1Len: number | null | undefined,\n  feeRate: bigint,\n): Promise<bigint> {\n  return (await loadTbvWasm()).computePayoutFeeFloor(\n    txGraphVersion,\n    numVaultKeepers,\n    numUniversalChallengers,\n    numLocalChallengers,\n    councilSize,\n    out0Len,\n    out1Len,\n    feeRate,\n  );\n}\n\n/**\n * Tx graph versions the shipped vault-wasm binary can build. Callers must\n * preflight the required version (fresh: active; resume: stamped) against\n * this list and fail closed instead of hitting per-call errors mid-flow.\n *\n * Note: the facade constructors themselves fail closed on unsupported\n * versions, and derived objects carry the version they were built with —\n * value-level cross-checks live in `assertWasmPeginSizing` and the golden\n * byte-parity tests, not in a per-call version echo.\n */\nexport async function supportedTxGraphVersions(): Promise<number[]> {\n  return (await loadTbvWasm()).supportedTxGraphVersions();\n}\n\n/**\n * The PegIn transaction's P2A (pay-to-anchor) output for a graph version, or\n * `null` when that version's PegIn carries no anchor (v1). The facade returns\n * one record per version — never a zero-valued placeholder — so an absent\n * anchor can't be mistaken for a real output. For v2/v3: 240 sats at vout 2,\n * script `51024e73`.\n */\nexport async function peginP2aAnchorOutput(\n  txGraphVersion: number,\n): Promise<PeginP2aAnchorInfo | null> {\n  return (await loadTbvWasm()).peginP2aAnchorOutput(txGraphVersion);\n}\n\n/**\n * Validate a PegIn transaction's P2A anchor against a graph version's rules:\n * v2 and v3 require the exact anchor (240 sats, vout 2, P2A script) and v1\n * requires that NO output carries the P2A script. Throws on any mismatch — a\n * v2 PegIn checked as v1 fails closed, and vice versa.\n */\nexport async function validatePeginP2aAnchor(\n  txGraphVersion: number,\n  txHex: string,\n): Promise<void> {\n  return (await loadTbvWasm()).validatePeginP2aAnchor(txGraphVersion, txHex);\n}\n\n/**\n * Creates a payout connector for vault transactions.\n *\n * The payout connector generates the necessary taproot scripts and information\n * required for signing payout transactions (both optimistic and regular payout paths).\n *\n * @param params - Parameters for creating the payout connector\n * @param network - Bitcoin network\n * @returns Payout connector information including scripts, hashes, and address\n */\nexport async function createPayoutConnector(\n  params: PayoutConnectorParams,\n  network: Network,\n): Promise<PayoutConnectorInfo> {\n  return (await loadTbvWasm()).createPayoutConnector(params, network);\n}\n\n/**\n * Get the Payout script and control block for the depositor's Assert output.\n *\n * Used to build the depositor's Payout PSBT (depositor-as-claimer path).\n *\n * @param params - Assert Payout/NoPayout connector parameters\n * @returns Payout script and control block (hex encoded)\n */\nexport async function getAssertPayoutScriptInfo(\n  params: AssertPayoutNoPayoutConnectorParams,\n): Promise<AssertPayoutScriptInfo> {\n  return (await loadTbvWasm()).getAssertPayoutScriptInfo(params);\n}\n\n/**\n * Get the NoPayout script and control block for a specific challenger.\n *\n * Used to build the depositor's NoPayout PSBT (depositor-as-claimer path).\n * Each challenger has a distinct NoPayout script.\n *\n * @param params - Assert Payout/NoPayout connector parameters\n * @param challengerPubkey - The challenger's x-only public key (hex encoded)\n * @returns NoPayout script and control block (hex encoded)\n */\nexport async function getAssertNoPayoutScriptInfo(\n  params: AssertPayoutNoPayoutConnectorParams,\n  challengerPubkey: string,\n): Promise<AssertNoPayoutScriptInfo> {\n  return (await loadTbvWasm()).getAssertNoPayoutScriptInfo(\n    params,\n    challengerPubkey,\n  );\n}\n\n/**\n * Get the ChallengeAssert script and control block.\n *\n * Used to build ChallengeAssert PSBTs for the depositor-as-claimer path.\n * Each challenger has 3 ChallengeAssert transactions, and this connector\n * generates the spending scripts using WOTS public keys from the VP.\n *\n * @param params - ChallengeAssert connector parameters\n * @returns Script and control block (hex encoded)\n */\nexport async function getChallengeAssertScriptInfo(\n  params: ChallengeAssertConnectorParams,\n): Promise<ChallengeAssertScriptInfo> {\n  return (await loadTbvWasm()).getChallengeAssertScriptInfo(params);\n}\n\n/**\n * Derive 32-byte `authAnchor` (OP_RETURN preimage → VP bearer token).\n * @stability frozen - btc-vault Rust owns this API through the vault-wasm pin (`VAULT_WASM_COMMIT`).\n * Changing the derived bytes breaks VP auth for existing deposits. See CLAUDE.md §4.\n */\nexport async function expandAuthAnchor(root: Uint8Array): Promise<Uint8Array> {\n  return (await loadTbvWasm()).expandAuthAnchor(root);\n}\n\n/**\n * Derive 32-byte `hashlockSecret` for HTLC `htlcVout` (preimage → `activateVaultWithSecret`).\n * @stability frozen - btc-vault Rust owns this API.\n * Changing the derived bytes means affected vaults can never activate. See CLAUDE.md §4.\n */\nexport async function expandHashlockSecret(\n  root: Uint8Array,\n  htlcVout: number,\n): Promise<Uint8Array> {\n  return (await loadTbvWasm()).expandHashlockSecret(root, htlcVout);\n}\n\n/**\n * Derive 64-byte `wotsSeed` for HTLC `htlcVout` (→ WOTS keys, hashed as `depositorWotsPkHash`).\n * @stability frozen - btc-vault Rust owns this API.\n * Changing the derived bytes breaks existing `depositorWotsPkHash` values. No claim path remains. See CLAUDE.md §4.\n */\nexport async function expandWotsSeed(\n  root: Uint8Array,\n  htlcVout: number,\n): Promise<Uint8Array> {\n  return (await loadTbvWasm()).expandWotsSeed(root, htlcVout);\n}\n\n/**\n * Derives the vault ID from a PegIn transaction hash and depositor ETH address.\n *\n * Vault ID = keccak256(abi.encode(peginTxHash, depositor))\n * This matches the Solidity-side derivation in BTCVaultRegistry.\n *\n * @param peginTxHash - 32-byte PegIn tx hash in display order (big-endian), hex encoded\n * @param depositor - 20-byte Ethereum address of the depositor, hex encoded\n * @returns Hex-encoded vault ID (32 bytes)\n */\nexport async function deriveVaultId(\n  peginTxHash: string,\n  depositor: string,\n): Promise<string> {\n  return (await loadTbvWasm()).deriveVaultId(peginTxHash, depositor);\n}\n\nexport type {\n  AssertNoPayoutScriptInfo,\n  AssertPayoutNoPayoutConnectorParams,\n  AssertPayoutScriptInfo,\n  ChallengeAssertConnectorParams,\n  ChallengeAssertScriptInfo,\n  HtlcConnectorInfo,\n  HtlcConnectorParams,\n  Network,\n  PayoutConnectorInfo,\n  PayoutConnectorParams,\n  PeginP2aAnchorInfo,\n  PeginTxResult,\n  PrePeginParams,\n  PrePeginResult,\n};\n"],"names":["TAP_INTERNAL_KEY","HEX_CHARS_PER_BYTE","tapInternalPubkey","_","index","wasmModulePromise","loadTbvWasm","error","wasm","createPrePeginTransaction","params","buildPeginTxFromPrePegin","timelockPegin","fundedPrePeginTxHex","htlcVout","getPrePeginHtlcConnectorInfo","computeMinClaimValue","txGraphVersion","numLocalChallengers","numUniversalChallengers","councilQuorum","councilSize","feeRate","computeMinPeginFee","numVks","numUcs","minPeginFeeRate","computePayoutFeeFloor","numVaultKeepers","out0Len","out1Len","supportedTxGraphVersions","peginP2aAnchorOutput","validatePeginP2aAnchor","txHex","createPayoutConnector","network","getAssertPayoutScriptInfo","getAssertNoPayoutScriptInfo","challengerPubkey","getChallengeAssertScriptInfo","expandAuthAnchor","root","expandHashlockSecret","expandWotsSeed","deriveVaultId","peginTxHash","depositor"],"mappings":"2hBAQO,MAAMA,EACX,mEAEIC,EAAqB,EAEdC,EAAoB,WAAW,KAC1C,CAAE,OAAQF,EAAiB,OAASC,CAAA,EACpC,CAACE,EAAGC,IACF,OAAO,SACLJ,EAAiB,MACfI,EAAQH,EACRG,EAAQH,EAAqBA,CAAA,EAE/B,EAAA,CAEN,ECSA,IAAII,EAeG,SAASC,GAAsC,CACpD,OAAAD,MAAsB,OAAO,uCAAuC,EACjE,MAAOE,GAAmB,CACzB,MAAAF,EAAoB,OACd,IAAI,MACR,wOAIA,CAAE,MAAOE,CAAA,CAAM,CAEnB,CAAC,EACA,KAAK,MAAOC,GAAS,CACpB,GAAI,CACF,MAAMA,EAAK,SAAA,CACb,OAASD,EAAgB,CACvB,MAAAF,EAAoB,OACd,IAAI,MACR,mNAIA,CAAE,MAAOE,CAAA,CAAM,CAEnB,CACA,OAAOC,CACT,CAAC,GACIH,CACT,CAkBA,eAAsBI,EACpBC,EACyB,CACzB,OAAQ,MAAMJ,KAAe,0BAA0BI,CAAM,CAC/D,CAcA,eAAsBC,EACpBD,EACAE,EACAC,EACAC,EACwB,CACxB,OAAQ,MAAMR,KAAe,yBAC3BI,EACAE,EACAC,EACAC,CAAA,CAEJ,CAYA,eAAsBC,EACpBL,EAC4B,CAC5B,OAAQ,MAAMJ,KAAe,6BAA6BI,CAAM,CAClE,CAQA,eAAsBM,EACpBC,EACAC,EACAC,EACAC,EACAC,EACAC,EACiB,CACjB,OAAQ,MAAMhB,KAAe,qBAC3BW,EACAC,EACAC,EACAC,EACAC,EACAC,CAAA,CAEJ,CAYA,eAAsBC,EACpBN,EACAO,EACAC,EACAC,EACiB,CACjB,OAAQ,MAAMpB,KAAe,mBAC3BW,EACAO,EACAC,EACAC,CAAA,CAEJ,CAcA,eAAsBC,EACpBV,EACAW,EACAT,EACAD,EACAG,EACAQ,EACAC,EACAR,EACiB,CACjB,OAAQ,MAAMhB,KAAe,sBAC3BW,EACAW,EACAT,EACAD,EACAG,EACAQ,EACAC,EACAR,CAAA,CAEJ,CAYA,eAAsBS,GAA8C,CAClE,OAAQ,MAAMzB,EAAA,GAAe,yBAAA,CAC/B,CASA,eAAsB0B,EACpBf,EACoC,CACpC,OAAQ,MAAMX,KAAe,qBAAqBW,CAAc,CAClE,CAQA,eAAsBgB,EACpBhB,EACAiB,EACe,CACf,OAAQ,MAAM5B,EAAA,GAAe,uBAAuBW,EAAgBiB,CAAK,CAC3E,CAYA,eAAsBC,EACpBzB,EACA0B,EAC8B,CAC9B,OAAQ,MAAM9B,EAAA,GAAe,sBAAsBI,EAAQ0B,CAAO,CACpE,CAUA,eAAsBC,EACpB3B,EACiC,CACjC,OAAQ,MAAMJ,KAAe,0BAA0BI,CAAM,CAC/D,CAYA,eAAsB4B,EACpB5B,EACA6B,EACmC,CACnC,OAAQ,MAAMjC,KAAe,4BAC3BI,EACA6B,CAAA,CAEJ,CAYA,eAAsBC,EACpB9B,EACoC,CACpC,OAAQ,MAAMJ,KAAe,6BAA6BI,CAAM,CAClE,CAOA,eAAsB+B,EAAiBC,EAAuC,CAC5E,OAAQ,MAAMpC,KAAe,iBAAiBoC,CAAI,CACpD,CAOA,eAAsBC,EACpBD,EACA5B,EACqB,CACrB,OAAQ,MAAMR,EAAA,GAAe,qBAAqBoC,EAAM5B,CAAQ,CAClE,CAOA,eAAsB8B,EACpBF,EACA5B,EACqB,CACrB,OAAQ,MAAMR,EAAA,GAAe,eAAeoC,EAAM5B,CAAQ,CAC5D,CAYA,eAAsB+B,EACpBC,EACAC,EACiB,CACjB,OAAQ,MAAMzC,EAAA,GAAe,cAAcwC,EAAaC,CAAS,CACnE"}

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

@@ -1,18 +1,20 @@
 import { AssertNoPayoutScriptInfo, AssertPayoutNoPayoutConnectorParams, AssertPayoutScriptInfo, ChallengeAssertConnectorParams, ChallengeAssertScriptInfo, HtlcConnectorInfo, HtlcConnectorParams, Network, PayoutConnectorInfo, PayoutConnectorParams, PeginP2aAnchorInfo, PeginTxResult, PrePeginParams, PrePeginResult } from '@babylonlabs-io/babylon-tbv-rust-wasm';
 export { TAP_INTERNAL_KEY, tapInternalPubkey } from './constants';
 type TbvWasmModule = typeof import("@babylonlabs-io/babylon-tbv-rust-wasm");
-type RawTbvWasmModule = typeof import("@babylonlabs-io/babylon-tbv-rust-wasm/raw");
-/** Load the WASM engine on first use and share the in-flight import. */
-export declare function loadTbvWasm(): Promise<TbvWasmModule>;
 /**
- * Load and initialize the raw engine classes. This bypasses SDK value checks.
- * The internal refund builder applies equivalent checks at its call site.
+ * Load and initialize the WASM engine on first use. Concurrent callers share
+ * one load. The returned module is already initialized, so a caller does not
+ * call `initWasm()`. A load or initialization failure rejects with an error
+ * that names the engine package. The original error is its cause. A failure
+ * clears this cache, so the next call loads again. The engine keeps a failed
+ * binary initialization rejected, so only a failed import or binary read can
+ * succeed on a later call.
  *
- * @deprecated Use buildPrePeginPsbt, buildPeginTxFromFundedPrePegin, or
- * buildRefundPsbt from @babylonlabs-io/ts-sdk/tbv/core/primitives.
- * Raw callers must independently check transaction values and signing data.
+ * The module also contains the wasm-bindgen classes. The classes have no value
+ * guards. A caller that uses a class must cross-check its output at the call
+ * site.
  */
-export declare function loadRawTbvWasm(): Promise<RawTbvWasmModule>;
+export declare function loadTbvWasm(): Promise<TbvWasmModule>;
 /**
  * Creates an unfunded Pre-PegIn transaction with no inputs and HTLC output(s).
  *

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/tbv/core/wasm/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/tbv/core/wasm/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EACV,wBAAwB,EACxB,mCAAmC,EACnC,sBAAsB,EACtB,8BAA8B,EAC9B,yBAAyB,EACzB,iBAAiB,EACjB,mBAAmB,EACnB,OAAO,EACP,mBAAmB,EACnB,qBAAqB,EACrB,kBAAkB,EAClB,aAAa,EACb,cAAc,EACd,cAAc,EACf,MAAM,uCAAuC,CAAC;AAE/C,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAElE,KAAK,aAAa,GAAG,cAAc,uCAAuC,CAAC,CAAC;AAI5E;;;;;;;;;;;;GAYG;AACH,wBAAgB,WAAW,IAAI,OAAO,CAAC,aAAa,CAAC,CA4BpD;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,yBAAyB,CAC7C,MAAM,EAAE,cAAc,GACrB,OAAO,CAAC,cAAc,CAAC,CAEzB;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,wBAAwB,CAC5C,MAAM,EAAE,cAAc,EACtB,aAAa,EAAE,MAAM,EACrB,mBAAmB,EAAE,MAAM,EAC3B,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,aAAa,CAAC,CAOxB;AAED;;;;;;;;;GASG;AACH,wBAAsB,4BAA4B,CAChD,MAAM,EAAE,mBAAmB,GAC1B,OAAO,CAAC,iBAAiB,CAAC,CAE5B;AAED;;;;;GAKG;AACH,wBAAsB,oBAAoB,CACxC,cAAc,EAAE,MAAM,EACtB,mBAAmB,EAAE,MAAM,EAC3B,uBAAuB,EAAE,MAAM,EAC/B,aAAa,EAAE,MAAM,EACrB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,MAAM,CAAC,CASjB;AAED;;;;;;;;;GASG;AACH,wBAAsB,kBAAkB,CACtC,cAAc,EAAE,MAAM,EACtB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,eAAe,EAAE,MAAM,GACtB,OAAO,CAAC,MAAM,CAAC,CAOjB;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,qBAAqB,CACzC,cAAc,EAAE,MAAM,EACtB,eAAe,EAAE,MAAM,EACvB,uBAAuB,EAAE,MAAM,EAC/B,mBAAmB,EAAE,MAAM,EAC3B,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAClC,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,MAAM,CAAC,CAWjB;AAED;;;;;;;;;GASG;AACH,wBAAsB,wBAAwB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAElE;AAED;;;;;;GAMG;AACH,wBAAsB,oBAAoB,CACxC,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAEpC;AAED;;;;;GAKG;AACH,wBAAsB,sBAAsB,CAC1C,cAAc,EAAE,MAAM,EACtB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,IAAI,CAAC,CAEf;AAED;;;;;;;;;GASG;AACH,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,qBAAqB,EAC7B,OAAO,EAAE,OAAO,GACf,OAAO,CAAC,mBAAmB,CAAC,CAE9B;AAED;;;;;;;GAOG;AACH,wBAAsB,yBAAyB,CAC7C,MAAM,EAAE,mCAAmC,GAC1C,OAAO,CAAC,sBAAsB,CAAC,CAEjC;AAED;;;;;;;;;GASG;AACH,wBAAsB,2BAA2B,CAC/C,MAAM,EAAE,mCAAmC,EAC3C,gBAAgB,EAAE,MAAM,GACvB,OAAO,CAAC,wBAAwB,CAAC,CAKnC;AAED;;;;;;;;;GASG;AACH,wBAAsB,4BAA4B,CAChD,MAAM,EAAE,8BAA8B,GACrC,OAAO,CAAC,yBAAyB,CAAC,CAEpC;AAED;;;;GAIG;AACH,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAE5E;AAED;;;;GAIG;AACH,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,UAAU,EAChB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,UAAU,CAAC,CAErB;AAED;;;;GAIG;AACH,wBAAsB,cAAc,CAClC,IAAI,EAAE,UAAU,EAChB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,UAAU,CAAC,CAErB;AAED;;;;;;;;;GASG;AACH,wBAAsB,aAAa,CACjC,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,MAAM,CAAC,CAEjB;AAED,YAAY,EACV,wBAAwB,EACxB,mCAAmC,EACnC,sBAAsB,EACtB,8BAA8B,EAC9B,yBAAyB,EACzB,iBAAiB,EACjB,mBAAmB,EACnB,OAAO,EACP,mBAAmB,EACnB,qBAAqB,EACrB,kBAAkB,EAClB,aAAa,EACb,cAAc,EACd,cAAc,GACf,CAAC"}

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

@@ -1,144 +1,133 @@
-const s = "50929b74c1a04954b78b4b6035e97a5e078a5a0f28ec96d547bfee9ace803ac0";
+const u = "50929b74c1a04954b78b4b6035e97a5e078a5a0f28ec96d547bfee9ace803ac0";
 const y = Uint8Array.from(
-  { length: s.length / 2 },
-  (e, t) => Number.parseInt(
-    s.slice(
-      t * 2,
-      t * 2 + 2
+  { length: u.length / 2 },
+  (e, n) => Number.parseInt(
+    u.slice(
+      n * 2,
+      n * 2 + 2
     ),
     16
   )
 );
-let u, o;
-function n() {
-  return u ?? (u = import("@babylonlabs-io/babylon-tbv-rust-wasm").catch(
-    (e) => {
-      throw u = void 0, new Error(
-        "The vault-WASM engine @babylonlabs-io/babylon-tbv-rust-wasm failed to load. The module could not be resolved, or it threw while evaluating, commonly a missing or stale generated WASM build. See the cause for the underlying error.",
-        { cause: e }
-      );
-    }
-  )), u;
-}
-function P() {
-  return o ?? (o = import("@babylonlabs-io/babylon-tbv-rust-wasm/raw").catch((e) => {
+let o;
+function t() {
+  return o ?? (o = import("@babylonlabs-io/babylon-tbv-rust-wasm").catch((e) => {
     throw o = void 0, new Error(
-      "The raw vault-WASM entry @babylonlabs-io/babylon-tbv-rust-wasm/raw failed to load. The module could not be resolved, or it threw while evaluating. See the cause for the underlying error.",
+      "The vault-WASM engine @babylonlabs-io/babylon-tbv-rust-wasm failed to load. The module could not be resolved, or it threw while evaluating, commonly a missing or stale generated WASM build. See the cause for the underlying error.",
       { cause: e }
     );
   }).then(async (e) => {
     try {
       await e.initWasm();
-    } catch (t) {
+    } catch (n) {
       throw o = void 0, new Error(
-        "The raw vault-WASM entry resolved but its WebAssembly binary failed to initialize.",
-        { cause: t }
+        "The vault-WASM engine @babylonlabs-io/babylon-tbv-rust-wasm resolved, but its WebAssembly binary failed to initialize, commonly a missing or stale generated WASM build. See the cause for the underlying error.",
+        { cause: n }
       );
     }
     return e;
   })), o;
 }
-async function h(e) {
-  return (await n()).createPrePeginTransaction(e);
+async function P(e) {
+  return (await t()).createPrePeginTransaction(e);
 }
-async function f(e, t, a, r) {
-  return (await n()).buildPeginTxFromPrePegin(
+async function d(e, n, a, r) {
+  return (await t()).buildPeginTxFromPrePegin(
     e,
-    t,
+    n,
     a,
     r
   );
 }
-async function w(e) {
-  return (await n()).getPrePeginHtlcConnectorInfo(e);
+async function g(e) {
+  return (await t()).getPrePeginHtlcConnectorInfo(e);
 }
-async function g(e, t, a, r, i, c) {
-  return (await n()).computeMinClaimValue(
+async function f(e, n, a, r, i, c) {
+  return (await t()).computeMinClaimValue(
     e,
-    t,
+    n,
     a,
     r,
     i,
     c
   );
 }
-async function p(e, t, a, r) {
-  return (await n()).computeMinPeginFee(
+async function p(e, n, a, r) {
+  return (await t()).computeMinPeginFee(
     e,
-    t,
+    n,
     a,
     r
   );
 }
-async function b(e, t, a, r, i, c, l, d) {
-  return (await n()).computePayoutFeeFloor(
+async function h(e, n, a, r, i, c, s, l) {
+  return (await t()).computePayoutFeeFloor(
     e,
-    t,
+    n,
     a,
     r,
     i,
     c,
-    l,
-    d
+    s,
+    l
   );
 }
-async function m() {
-  return (await n()).supportedTxGraphVersions();
+async function b() {
+  return (await t()).supportedTxGraphVersions();
 }
 async function A(e) {
-  return (await n()).peginP2aAnchorOutput(e);
+  return (await t()).peginP2aAnchorOutput(e);
 }
-async function S(e, t) {
-  return (await n()).validatePeginP2aAnchor(e, t);
+async function m(e, n) {
+  return (await t()).validatePeginP2aAnchor(e, n);
 }
-async function E(e, t) {
-  return (await n()).createPayoutConnector(e, t);
+async function w(e, n) {
+  return (await t()).createPayoutConnector(e, n);
 }
-async function T(e) {
-  return (await n()).getAssertPayoutScriptInfo(e);
+async function S(e) {
+  return (await t()).getAssertPayoutScriptInfo(e);
 }
-async function v(e, t) {
-  return (await n()).getAssertNoPayoutScriptInfo(
+async function E(e, n) {
+  return (await t()).getAssertNoPayoutScriptInfo(
     e,
-    t
+    n
   );
 }
 async function _(e) {
-  return (await n()).getChallengeAssertScriptInfo(e);
+  return (await t()).getChallengeAssertScriptInfo(e);
 }
-async function H(e) {
-  return (await n()).expandAuthAnchor(e);
+async function T(e) {
+  return (await t()).expandAuthAnchor(e);
 }
-async function C(e, t) {
-  return (await n()).expandHashlockSecret(e, t);
+async function v(e, n) {
+  return (await t()).expandHashlockSecret(e, n);
 }
-async function I(e, t) {
-  return (await n()).expandWotsSeed(e, t);
+async function H(e, n) {
+  return (await t()).expandWotsSeed(e, n);
 }
-async function R(e, t) {
-  return (await n()).deriveVaultId(e, t);
+async function C(e, n) {
+  return (await t()).deriveVaultId(e, n);
 }
 export {
-  s as TAP_INTERNAL_KEY,
-  f as buildPeginTxFromPrePegin,
-  g as computeMinClaimValue,
+  u as TAP_INTERNAL_KEY,
+  d as buildPeginTxFromPrePegin,
+  f as computeMinClaimValue,
   p as computeMinPeginFee,
-  b as computePayoutFeeFloor,
-  E as createPayoutConnector,
-  h as createPrePeginTransaction,
-  R as deriveVaultId,
-  H as expandAuthAnchor,
-  C as expandHashlockSecret,
-  I as expandWotsSeed,
-  v as getAssertNoPayoutScriptInfo,
-  T as getAssertPayoutScriptInfo,
+  h as computePayoutFeeFloor,
+  w as createPayoutConnector,
+  P as createPrePeginTransaction,
+  C as deriveVaultId,
+  T as expandAuthAnchor,
+  v as expandHashlockSecret,
+  H as expandWotsSeed,
+  E as getAssertNoPayoutScriptInfo,
+  S as getAssertPayoutScriptInfo,
   _ as getChallengeAssertScriptInfo,
-  w as getPrePeginHtlcConnectorInfo,
-  P as loadRawTbvWasm,
-  n as loadTbvWasm,
+  g as getPrePeginHtlcConnectorInfo,
+  t as loadTbvWasm,
   A as peginP2aAnchorOutput,
-  m as supportedTxGraphVersions,
+  b as supportedTxGraphVersions,
   y as tapInternalPubkey,
-  S as validatePeginP2aAnchor
+  m as validatePeginP2aAnchor
 };
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../../../../src/tbv/core/wasm/constants.ts","../../../../src/tbv/core/wasm/index.ts"],"sourcesContent":["/**\n * Protocol constants that do not require loading the vault WASM module.\n *\n * Keeping these values local lets Bitcoin builders construct PSBT metadata\n * without resolving or evaluating the WASM engine at module-import\n * time. The hex value is the BIP-341 nothing-up-my-sleeve internal key and is\n * pinned by the vault protocol.\n */\nexport const TAP_INTERNAL_KEY =\n  \"50929b74c1a04954b78b4b6035e97a5e078a5a0f28ec96d547bfee9ace803ac0\";\n\nconst HEX_CHARS_PER_BYTE = 2;\n\nexport const tapInternalPubkey = Uint8Array.from(\n  { length: TAP_INTERNAL_KEY.length / HEX_CHARS_PER_BYTE },\n  (_, index) =>\n    Number.parseInt(\n      TAP_INTERNAL_KEY.slice(\n        index * HEX_CHARS_PER_BYTE,\n        index * HEX_CHARS_PER_BYTE + HEX_CHARS_PER_BYTE,\n      ),\n      16,\n    ),\n);\n","/**\n * Explicit lazy boundary around the vault-WASM engine package.\n *\n * Importing the SDK (including its legacy root barrels) does not resolve the\n * WASM package or generated binary. The engine is loaded only when a caller\n * invokes an operation that actually needs the Bitcoin transaction graph.\n * ETH-only entry points never import this module.\n *\n * @module tbv/core/wasm\n */\n\nimport type {\n  AssertNoPayoutScriptInfo,\n  AssertPayoutNoPayoutConnectorParams,\n  AssertPayoutScriptInfo,\n  ChallengeAssertConnectorParams,\n  ChallengeAssertScriptInfo,\n  HtlcConnectorInfo,\n  HtlcConnectorParams,\n  Network,\n  PayoutConnectorInfo,\n  PayoutConnectorParams,\n  PeginP2aAnchorInfo,\n  PeginTxResult,\n  PrePeginParams,\n  PrePeginResult,\n} from \"@babylonlabs-io/babylon-tbv-rust-wasm\";\n\nexport { TAP_INTERNAL_KEY, tapInternalPubkey } from \"./constants\";\n\ntype TbvWasmModule = typeof import(\"@babylonlabs-io/babylon-tbv-rust-wasm\");\n\nlet wasmModulePromise: Promise<TbvWasmModule> | undefined;\ntype RawTbvWasmModule =\n  typeof import(\"@babylonlabs-io/babylon-tbv-rust-wasm/raw\");\nlet rawWasmModulePromise: Promise<RawTbvWasmModule> | undefined;\n\n/** Load the WASM engine on first use and share the in-flight import. */\nexport function loadTbvWasm(): Promise<TbvWasmModule> {\n  wasmModulePromise ??= import(\"@babylonlabs-io/babylon-tbv-rust-wasm\").catch(\n    (error: unknown) => {\n      wasmModulePromise = undefined;\n      throw new Error(\n        \"The vault-WASM engine @babylonlabs-io/babylon-tbv-rust-wasm failed \" +\n          \"to load. The module could not be resolved, or it threw while \" +\n          \"evaluating, commonly a missing or stale generated WASM build. \" +\n          \"See the cause for the underlying error.\",\n        { cause: error },\n      );\n    },\n  );\n  return wasmModulePromise;\n}\n\n/**\n * Load and initialize the raw engine classes. This bypasses SDK value checks.\n * The internal refund builder applies equivalent checks at its call site.\n *\n * @deprecated Use buildPrePeginPsbt, buildPeginTxFromFundedPrePegin, or\n * buildRefundPsbt from @babylonlabs-io/ts-sdk/tbv/core/primitives.\n * Raw callers must independently check transaction values and signing data.\n */\nexport function loadRawTbvWasm(): Promise<RawTbvWasmModule> {\n  rawWasmModulePromise ??= import(\"@babylonlabs-io/babylon-tbv-rust-wasm/raw\")\n    .catch((error: unknown) => {\n      rawWasmModulePromise = undefined;\n      throw new Error(\n        \"The raw vault-WASM entry @babylonlabs-io/babylon-tbv-rust-wasm/raw \" +\n          \"failed to load. The module could not be resolved, or it threw \" +\n          \"while evaluating. See the cause for the underlying error.\",\n        { cause: error },\n      );\n    })\n    .then(async (wasm) => {\n      try {\n        await wasm.initWasm();\n      } catch (error: unknown) {\n        rawWasmModulePromise = undefined;\n        throw new Error(\n          \"The raw vault-WASM entry resolved but its WebAssembly \" +\n            \"binary failed to initialize.\",\n          { cause: error },\n        );\n      }\n      return wasm;\n    });\n  return rawWasmModulePromise;\n}\n\n/**\n * Creates an unfunded Pre-PegIn transaction with no inputs and HTLC output(s).\n *\n * The HTLC output value (htlcValue) covers the peg-in amount, depositor claim value,\n * and minimum pegin fee — all computed internally from the provided contract parameters.\n *\n * After building the Pre-PegIn transaction, the caller must:\n * 1. Select UTXOs covering htlcValue + network fees\n * 2. Fund the transaction (add inputs and change output)\n * 3. Call reconstructFromFundedTx() with the funded tx hex\n * 4. Call buildPeginTx() to derive the PegIn transaction\n * 5. Sign the PegIn input using the HTLC hashlock leaf (leaf 0)\n *\n * @param params - Pre-PegIn parameters from contract and depositor wallet\n * @returns Unfunded transaction details with HTLC output information\n */\nexport async function createPrePeginTransaction(\n  params: PrePeginParams,\n): Promise<PrePeginResult> {\n  return (await loadTbvWasm()).createPrePeginTransaction(params);\n}\n\n/**\n * Derives the PegIn transaction from a funded Pre-PegIn transaction.\n *\n * The PegIn transaction has a single input spending the Pre-PegIn HTLC output\n * at `htlcVout` via the hashlock + all-party script (leaf 0).\n *\n * @param params - Same PrePeginParams used to create the Pre-PegIn transaction\n * @param timelockPegin - CSV timelock in blocks for the PegIn vault output\n * @param fundedPrePeginTxHex - Hex-encoded funded Pre-PegIn transaction\n * @param htlcVout - Index of the HTLC output to spend\n * @returns PegIn transaction details including vault output information\n */\nexport async function buildPeginTxFromPrePegin(\n  params: PrePeginParams,\n  timelockPegin: number,\n  fundedPrePeginTxHex: string,\n  htlcVout: number,\n): Promise<PeginTxResult> {\n  return (await loadTbvWasm()).buildPeginTxFromPrePegin(\n    params,\n    timelockPegin,\n    fundedPrePeginTxHex,\n    htlcVout,\n  );\n}\n\n/**\n * Returns HTLC connector script info for signing the PegIn transaction input.\n *\n * The depositor signs PegIn input 0 using the hashlock leaf (leaf 0) of the\n * Pre-PegIn HTLC output. Use getHashlockScript() and getHashlockControlBlock()\n * to construct the tapLeafScript entry in the PSBT.\n *\n * @param params - HTLC connector parameters (subset of PrePeginParams)\n * @returns Hashlock and refund script info for PSBT construction\n */\nexport async function getPrePeginHtlcConnectorInfo(\n  params: HtlcConnectorParams,\n): Promise<HtlcConnectorInfo> {\n  return (await loadTbvWasm()).getPrePeginHtlcConnectorInfo(params);\n}\n\n/**\n * Compute the minimum depositor claim value (PegIn output 1) in satoshis.\n *\n * This covers the full downstream tx graph cost (Claim → Assert → Payout)\n * based on the protocol parameters.\n */\nexport async function computeMinClaimValue(\n  txGraphVersion: number,\n  numLocalChallengers: number,\n  numUniversalChallengers: number,\n  councilQuorum: number,\n  councilSize: number,\n  feeRate: bigint,\n): Promise<bigint> {\n  return (await loadTbvWasm()).computeMinClaimValue(\n    txGraphVersion,\n    numLocalChallengers,\n    numUniversalChallengers,\n    councilQuorum,\n    councilSize,\n    feeRate,\n  );\n}\n\n/**\n * Compute the minimum PegIn (activation) transaction fee in satoshis.\n *\n * `minPeginFee = peginTxVsize(numVks, numUcs) × minPeginFeeRate`. Each HTLC\n * the depositor funds in the Pre-PegIn tx must reserve at least this fee\n * inside its value (`htlcValue = peginAmount + depositorClaimValue +\n * minPeginFee`), otherwise the VP cannot afford to broadcast the PegIn at\n * activation. The vsize comes from a Taproot script-path-spend weight\n * prediction whose witness shape depends on the VK + UC signer count.\n */\nexport async function computeMinPeginFee(\n  txGraphVersion: number,\n  numVks: number,\n  numUcs: number,\n  minPeginFeeRate: bigint,\n): Promise<bigint> {\n  return (await loadTbvWasm()).computeMinPeginFee(\n    txGraphVersion,\n    numVks,\n    numUcs,\n    minPeginFeeRate,\n  );\n}\n\n/**\n * Floor of the Payout transaction fee under `txGraphVersion`: the minimum of\n * `estimatedVsize * feeRate` across every output-sizing model a deployed\n * vault provider is known to have used (fixed-34, intermediate,\n * script-aware). A VP-built payout paying less than this is provably not\n * produced by any known VP build. `out0Len` must be the TRUSTED length of the\n * pinned outs[0] script (1..=128); `out1Len` is the measured, UNTRUSTED\n * commission-script length — safe here because padding cannot raise the floor\n * (the fixed-34 model saturates the minimum) and shortening only lowers it.\n * Pass `undefined` for `out1Len` on 2-output (non-VP-claimer) payouts.\n * `feeRate` is the vault's version-locked `offchainParams.feeRate`.\n */\nexport async function computePayoutFeeFloor(\n  txGraphVersion: number,\n  numVaultKeepers: number,\n  numUniversalChallengers: number,\n  numLocalChallengers: number,\n  councilSize: number,\n  out0Len: number,\n  out1Len: number | null | undefined,\n  feeRate: bigint,\n): Promise<bigint> {\n  return (await loadTbvWasm()).computePayoutFeeFloor(\n    txGraphVersion,\n    numVaultKeepers,\n    numUniversalChallengers,\n    numLocalChallengers,\n    councilSize,\n    out0Len,\n    out1Len,\n    feeRate,\n  );\n}\n\n/**\n * Tx graph versions the shipped vault-wasm binary can build. Callers must\n * preflight the required version (fresh: active; resume: stamped) against\n * this list and fail closed instead of hitting per-call errors mid-flow.\n *\n * Note: the facade constructors themselves fail closed on unsupported\n * versions, and derived objects carry the version they were built with —\n * value-level cross-checks live in `assertWasmPeginSizing` and the golden\n * byte-parity tests, not in a per-call version echo.\n */\nexport async function supportedTxGraphVersions(): Promise<number[]> {\n  return (await loadTbvWasm()).supportedTxGraphVersions();\n}\n\n/**\n * The PegIn transaction's P2A (pay-to-anchor) output for a graph version, or\n * `null` when that version's PegIn carries no anchor (v1). The facade returns\n * one record per version — never a zero-valued placeholder — so an absent\n * anchor can't be mistaken for a real output. For v2/v3: 240 sats at vout 2,\n * script `51024e73`.\n */\nexport async function peginP2aAnchorOutput(\n  txGraphVersion: number,\n): Promise<PeginP2aAnchorInfo | null> {\n  return (await loadTbvWasm()).peginP2aAnchorOutput(txGraphVersion);\n}\n\n/**\n * Validate a PegIn transaction's P2A anchor against a graph version's rules:\n * v2 and v3 require the exact anchor (240 sats, vout 2, P2A script) and v1\n * requires that NO output carries the P2A script. Throws on any mismatch — a\n * v2 PegIn checked as v1 fails closed, and vice versa.\n */\nexport async function validatePeginP2aAnchor(\n  txGraphVersion: number,\n  txHex: string,\n): Promise<void> {\n  return (await loadTbvWasm()).validatePeginP2aAnchor(txGraphVersion, txHex);\n}\n\n/**\n * Creates a payout connector for vault transactions.\n *\n * The payout connector generates the necessary taproot scripts and information\n * required for signing payout transactions (both optimistic and regular payout paths).\n *\n * @param params - Parameters for creating the payout connector\n * @param network - Bitcoin network\n * @returns Payout connector information including scripts, hashes, and address\n */\nexport async function createPayoutConnector(\n  params: PayoutConnectorParams,\n  network: Network,\n): Promise<PayoutConnectorInfo> {\n  return (await loadTbvWasm()).createPayoutConnector(params, network);\n}\n\n/**\n * Get the Payout script and control block for the depositor's Assert output.\n *\n * Used to build the depositor's Payout PSBT (depositor-as-claimer path).\n *\n * @param params - Assert Payout/NoPayout connector parameters\n * @returns Payout script and control block (hex encoded)\n */\nexport async function getAssertPayoutScriptInfo(\n  params: AssertPayoutNoPayoutConnectorParams,\n): Promise<AssertPayoutScriptInfo> {\n  return (await loadTbvWasm()).getAssertPayoutScriptInfo(params);\n}\n\n/**\n * Get the NoPayout script and control block for a specific challenger.\n *\n * Used to build the depositor's NoPayout PSBT (depositor-as-claimer path).\n * Each challenger has a distinct NoPayout script.\n *\n * @param params - Assert Payout/NoPayout connector parameters\n * @param challengerPubkey - The challenger's x-only public key (hex encoded)\n * @returns NoPayout script and control block (hex encoded)\n */\nexport async function getAssertNoPayoutScriptInfo(\n  params: AssertPayoutNoPayoutConnectorParams,\n  challengerPubkey: string,\n): Promise<AssertNoPayoutScriptInfo> {\n  return (await loadTbvWasm()).getAssertNoPayoutScriptInfo(\n    params,\n    challengerPubkey,\n  );\n}\n\n/**\n * Get the ChallengeAssert script and control block.\n *\n * Used to build ChallengeAssert PSBTs for the depositor-as-claimer path.\n * Each challenger has 3 ChallengeAssert transactions, and this connector\n * generates the spending scripts using WOTS public keys from the VP.\n *\n * @param params - ChallengeAssert connector parameters\n * @returns Script and control block (hex encoded)\n */\nexport async function getChallengeAssertScriptInfo(\n  params: ChallengeAssertConnectorParams,\n): Promise<ChallengeAssertScriptInfo> {\n  return (await loadTbvWasm()).getChallengeAssertScriptInfo(params);\n}\n\n/**\n * Derive 32-byte `authAnchor` (OP_RETURN preimage → VP bearer token).\n * @stability frozen - btc-vault Rust owns this API through the vault-wasm pin (`VAULT_WASM_COMMIT`).\n * Changing the derived bytes breaks VP auth for existing deposits. See CLAUDE.md §4.\n */\nexport async function expandAuthAnchor(root: Uint8Array): Promise<Uint8Array> {\n  return (await loadTbvWasm()).expandAuthAnchor(root);\n}\n\n/**\n * Derive 32-byte `hashlockSecret` for HTLC `htlcVout` (preimage → `activateVaultWithSecret`).\n * @stability frozen - btc-vault Rust owns this API.\n * Changing the derived bytes means affected vaults can never activate. See CLAUDE.md §4.\n */\nexport async function expandHashlockSecret(\n  root: Uint8Array,\n  htlcVout: number,\n): Promise<Uint8Array> {\n  return (await loadTbvWasm()).expandHashlockSecret(root, htlcVout);\n}\n\n/**\n * Derive 64-byte `wotsSeed` for HTLC `htlcVout` (→ WOTS keys, hashed as `depositorWotsPkHash`).\n * @stability frozen - btc-vault Rust owns this API.\n * Changing the derived bytes breaks existing `depositorWotsPkHash` values. No claim path remains. See CLAUDE.md §4.\n */\nexport async function expandWotsSeed(\n  root: Uint8Array,\n  htlcVout: number,\n): Promise<Uint8Array> {\n  return (await loadTbvWasm()).expandWotsSeed(root, htlcVout);\n}\n\n/**\n * Derives the vault ID from a PegIn transaction hash and depositor ETH address.\n *\n * Vault ID = keccak256(abi.encode(peginTxHash, depositor))\n * This matches the Solidity-side derivation in BTCVaultRegistry.\n *\n * @param peginTxHash - 32-byte PegIn tx hash in display order (big-endian), hex encoded\n * @param depositor - 20-byte Ethereum address of the depositor, hex encoded\n * @returns Hex-encoded vault ID (32 bytes)\n */\nexport async function deriveVaultId(\n  peginTxHash: string,\n  depositor: string,\n): Promise<string> {\n  return (await loadTbvWasm()).deriveVaultId(peginTxHash, depositor);\n}\n\nexport type {\n  AssertNoPayoutScriptInfo,\n  AssertPayoutNoPayoutConnectorParams,\n  AssertPayoutScriptInfo,\n  ChallengeAssertConnectorParams,\n  ChallengeAssertScriptInfo,\n  HtlcConnectorInfo,\n  HtlcConnectorParams,\n  Network,\n  PayoutConnectorInfo,\n  PayoutConnectorParams,\n  PeginP2aAnchorInfo,\n  PeginTxResult,\n  PrePeginParams,\n  PrePeginResult,\n};\n"],"names":["TAP_INTERNAL_KEY","tapInternalPubkey","_","index","wasmModulePromise","rawWasmModulePromise","loadTbvWasm","error","loadRawTbvWasm","wasm","createPrePeginTransaction","params","buildPeginTxFromPrePegin","timelockPegin","fundedPrePeginTxHex","htlcVout","getPrePeginHtlcConnectorInfo","computeMinClaimValue","txGraphVersion","numLocalChallengers","numUniversalChallengers","councilQuorum","councilSize","feeRate","computeMinPeginFee","numVks","numUcs","minPeginFeeRate","computePayoutFeeFloor","numVaultKeepers","out0Len","out1Len","supportedTxGraphVersions","peginP2aAnchorOutput","validatePeginP2aAnchor","txHex","createPayoutConnector","network","getAssertPayoutScriptInfo","getAssertNoPayoutScriptInfo","challengerPubkey","getChallengeAssertScriptInfo","expandAuthAnchor","root","expandHashlockSecret","expandWotsSeed","deriveVaultId","peginTxHash","depositor"],"mappings":"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"}
+{"version":3,"file":"index.js","sources":["../../../../src/tbv/core/wasm/constants.ts","../../../../src/tbv/core/wasm/index.ts"],"sourcesContent":["/**\n * Protocol constants that do not require loading the vault WASM module.\n *\n * Keeping these values local lets Bitcoin builders construct PSBT metadata\n * without resolving or evaluating the WASM engine at module-import\n * time. The hex value is the BIP-341 nothing-up-my-sleeve internal key and is\n * pinned by the vault protocol.\n */\nexport const TAP_INTERNAL_KEY =\n  \"50929b74c1a04954b78b4b6035e97a5e078a5a0f28ec96d547bfee9ace803ac0\";\n\nconst HEX_CHARS_PER_BYTE = 2;\n\nexport const tapInternalPubkey = Uint8Array.from(\n  { length: TAP_INTERNAL_KEY.length / HEX_CHARS_PER_BYTE },\n  (_, index) =>\n    Number.parseInt(\n      TAP_INTERNAL_KEY.slice(\n        index * HEX_CHARS_PER_BYTE,\n        index * HEX_CHARS_PER_BYTE + HEX_CHARS_PER_BYTE,\n      ),\n      16,\n    ),\n);\n","/**\n * Explicit lazy boundary around the vault-WASM engine package.\n *\n * Importing the SDK (including its legacy root barrels) does not resolve the\n * WASM package or generated binary. The engine is loaded only when a caller\n * invokes an operation that actually needs the Bitcoin transaction graph.\n * ETH-only entry points never import this module.\n *\n * @module tbv/core/wasm\n */\n\nimport type {\n  AssertNoPayoutScriptInfo,\n  AssertPayoutNoPayoutConnectorParams,\n  AssertPayoutScriptInfo,\n  ChallengeAssertConnectorParams,\n  ChallengeAssertScriptInfo,\n  HtlcConnectorInfo,\n  HtlcConnectorParams,\n  Network,\n  PayoutConnectorInfo,\n  PayoutConnectorParams,\n  PeginP2aAnchorInfo,\n  PeginTxResult,\n  PrePeginParams,\n  PrePeginResult,\n} from \"@babylonlabs-io/babylon-tbv-rust-wasm\";\n\nexport { TAP_INTERNAL_KEY, tapInternalPubkey } from \"./constants\";\n\ntype TbvWasmModule = typeof import(\"@babylonlabs-io/babylon-tbv-rust-wasm\");\n\nlet wasmModulePromise: Promise<TbvWasmModule> | undefined;\n\n/**\n * Load and initialize the WASM engine on first use. Concurrent callers share\n * one load. The returned module is already initialized, so a caller does not\n * call `initWasm()`. A load or initialization failure rejects with an error\n * that names the engine package. The original error is its cause. A failure\n * clears this cache, so the next call loads again. The engine keeps a failed\n * binary initialization rejected, so only a failed import or binary read can\n * succeed on a later call.\n *\n * The module also contains the wasm-bindgen classes. The classes have no value\n * guards. A caller that uses a class must cross-check its output at the call\n * site.\n */\nexport function loadTbvWasm(): Promise<TbvWasmModule> {\n  wasmModulePromise ??= import(\"@babylonlabs-io/babylon-tbv-rust-wasm\")\n    .catch((error: unknown) => {\n      wasmModulePromise = undefined;\n      throw new Error(\n        \"The vault-WASM engine @babylonlabs-io/babylon-tbv-rust-wasm failed \" +\n          \"to load. The module could not be resolved, or it threw while \" +\n          \"evaluating, commonly a missing or stale generated WASM build. \" +\n          \"See the cause for the underlying error.\",\n        { cause: error },\n      );\n    })\n    .then(async (wasm) => {\n      try {\n        await wasm.initWasm();\n      } catch (error: unknown) {\n        wasmModulePromise = undefined;\n        throw new Error(\n          \"The vault-WASM engine @babylonlabs-io/babylon-tbv-rust-wasm \" +\n            \"resolved, but its WebAssembly binary failed to initialize, \" +\n            \"commonly a missing or stale generated WASM build. See the \" +\n            \"cause for the underlying error.\",\n          { cause: error },\n        );\n      }\n      return wasm;\n    });\n  return wasmModulePromise;\n}\n\n/**\n * Creates an unfunded Pre-PegIn transaction with no inputs and HTLC output(s).\n *\n * The HTLC output value (htlcValue) covers the peg-in amount, depositor claim value,\n * and minimum pegin fee — all computed internally from the provided contract parameters.\n *\n * After building the Pre-PegIn transaction, the caller must:\n * 1. Select UTXOs covering htlcValue + network fees\n * 2. Fund the transaction (add inputs and change output)\n * 3. Call reconstructFromFundedTx() with the funded tx hex\n * 4. Call buildPeginTx() to derive the PegIn transaction\n * 5. Sign the PegIn input using the HTLC hashlock leaf (leaf 0)\n *\n * @param params - Pre-PegIn parameters from contract and depositor wallet\n * @returns Unfunded transaction details with HTLC output information\n */\nexport async function createPrePeginTransaction(\n  params: PrePeginParams,\n): Promise<PrePeginResult> {\n  return (await loadTbvWasm()).createPrePeginTransaction(params);\n}\n\n/**\n * Derives the PegIn transaction from a funded Pre-PegIn transaction.\n *\n * The PegIn transaction has a single input spending the Pre-PegIn HTLC output\n * at `htlcVout` via the hashlock + all-party script (leaf 0).\n *\n * @param params - Same PrePeginParams used to create the Pre-PegIn transaction\n * @param timelockPegin - CSV timelock in blocks for the PegIn vault output\n * @param fundedPrePeginTxHex - Hex-encoded funded Pre-PegIn transaction\n * @param htlcVout - Index of the HTLC output to spend\n * @returns PegIn transaction details including vault output information\n */\nexport async function buildPeginTxFromPrePegin(\n  params: PrePeginParams,\n  timelockPegin: number,\n  fundedPrePeginTxHex: string,\n  htlcVout: number,\n): Promise<PeginTxResult> {\n  return (await loadTbvWasm()).buildPeginTxFromPrePegin(\n    params,\n    timelockPegin,\n    fundedPrePeginTxHex,\n    htlcVout,\n  );\n}\n\n/**\n * Returns HTLC connector script info for signing the PegIn transaction input.\n *\n * The depositor signs PegIn input 0 using the hashlock leaf (leaf 0) of the\n * Pre-PegIn HTLC output. Use getHashlockScript() and getHashlockControlBlock()\n * to construct the tapLeafScript entry in the PSBT.\n *\n * @param params - HTLC connector parameters (subset of PrePeginParams)\n * @returns Hashlock and refund script info for PSBT construction\n */\nexport async function getPrePeginHtlcConnectorInfo(\n  params: HtlcConnectorParams,\n): Promise<HtlcConnectorInfo> {\n  return (await loadTbvWasm()).getPrePeginHtlcConnectorInfo(params);\n}\n\n/**\n * Compute the minimum depositor claim value (PegIn output 1) in satoshis.\n *\n * This covers the full downstream tx graph cost (Claim → Assert → Payout)\n * based on the protocol parameters.\n */\nexport async function computeMinClaimValue(\n  txGraphVersion: number,\n  numLocalChallengers: number,\n  numUniversalChallengers: number,\n  councilQuorum: number,\n  councilSize: number,\n  feeRate: bigint,\n): Promise<bigint> {\n  return (await loadTbvWasm()).computeMinClaimValue(\n    txGraphVersion,\n    numLocalChallengers,\n    numUniversalChallengers,\n    councilQuorum,\n    councilSize,\n    feeRate,\n  );\n}\n\n/**\n * Compute the minimum PegIn (activation) transaction fee in satoshis.\n *\n * `minPeginFee = peginTxVsize(numVks, numUcs) × minPeginFeeRate`. Each HTLC\n * the depositor funds in the Pre-PegIn tx must reserve at least this fee\n * inside its value (`htlcValue = peginAmount + depositorClaimValue +\n * minPeginFee`), otherwise the VP cannot afford to broadcast the PegIn at\n * activation. The vsize comes from a Taproot script-path-spend weight\n * prediction whose witness shape depends on the VK + UC signer count.\n */\nexport async function computeMinPeginFee(\n  txGraphVersion: number,\n  numVks: number,\n  numUcs: number,\n  minPeginFeeRate: bigint,\n): Promise<bigint> {\n  return (await loadTbvWasm()).computeMinPeginFee(\n    txGraphVersion,\n    numVks,\n    numUcs,\n    minPeginFeeRate,\n  );\n}\n\n/**\n * Floor of the Payout transaction fee under `txGraphVersion`: the minimum of\n * `estimatedVsize * feeRate` across every output-sizing model a deployed\n * vault provider is known to have used (fixed-34, intermediate,\n * script-aware). A VP-built payout paying less than this is provably not\n * produced by any known VP build. `out0Len` must be the TRUSTED length of the\n * pinned outs[0] script (1..=128); `out1Len` is the measured, UNTRUSTED\n * commission-script length — safe here because padding cannot raise the floor\n * (the fixed-34 model saturates the minimum) and shortening only lowers it.\n * Pass `undefined` for `out1Len` on 2-output (non-VP-claimer) payouts.\n * `feeRate` is the vault's version-locked `offchainParams.feeRate`.\n */\nexport async function computePayoutFeeFloor(\n  txGraphVersion: number,\n  numVaultKeepers: number,\n  numUniversalChallengers: number,\n  numLocalChallengers: number,\n  councilSize: number,\n  out0Len: number,\n  out1Len: number | null | undefined,\n  feeRate: bigint,\n): Promise<bigint> {\n  return (await loadTbvWasm()).computePayoutFeeFloor(\n    txGraphVersion,\n    numVaultKeepers,\n    numUniversalChallengers,\n    numLocalChallengers,\n    councilSize,\n    out0Len,\n    out1Len,\n    feeRate,\n  );\n}\n\n/**\n * Tx graph versions the shipped vault-wasm binary can build. Callers must\n * preflight the required version (fresh: active; resume: stamped) against\n * this list and fail closed instead of hitting per-call errors mid-flow.\n *\n * Note: the facade constructors themselves fail closed on unsupported\n * versions, and derived objects carry the version they were built with —\n * value-level cross-checks live in `assertWasmPeginSizing` and the golden\n * byte-parity tests, not in a per-call version echo.\n */\nexport async function supportedTxGraphVersions(): Promise<number[]> {\n  return (await loadTbvWasm()).supportedTxGraphVersions();\n}\n\n/**\n * The PegIn transaction's P2A (pay-to-anchor) output for a graph version, or\n * `null` when that version's PegIn carries no anchor (v1). The facade returns\n * one record per version — never a zero-valued placeholder — so an absent\n * anchor can't be mistaken for a real output. For v2/v3: 240 sats at vout 2,\n * script `51024e73`.\n */\nexport async function peginP2aAnchorOutput(\n  txGraphVersion: number,\n): Promise<PeginP2aAnchorInfo | null> {\n  return (await loadTbvWasm()).peginP2aAnchorOutput(txGraphVersion);\n}\n\n/**\n * Validate a PegIn transaction's P2A anchor against a graph version's rules:\n * v2 and v3 require the exact anchor (240 sats, vout 2, P2A script) and v1\n * requires that NO output carries the P2A script. Throws on any mismatch — a\n * v2 PegIn checked as v1 fails closed, and vice versa.\n */\nexport async function validatePeginP2aAnchor(\n  txGraphVersion: number,\n  txHex: string,\n): Promise<void> {\n  return (await loadTbvWasm()).validatePeginP2aAnchor(txGraphVersion, txHex);\n}\n\n/**\n * Creates a payout connector for vault transactions.\n *\n * The payout connector generates the necessary taproot scripts and information\n * required for signing payout transactions (both optimistic and regular payout paths).\n *\n * @param params - Parameters for creating the payout connector\n * @param network - Bitcoin network\n * @returns Payout connector information including scripts, hashes, and address\n */\nexport async function createPayoutConnector(\n  params: PayoutConnectorParams,\n  network: Network,\n): Promise<PayoutConnectorInfo> {\n  return (await loadTbvWasm()).createPayoutConnector(params, network);\n}\n\n/**\n * Get the Payout script and control block for the depositor's Assert output.\n *\n * Used to build the depositor's Payout PSBT (depositor-as-claimer path).\n *\n * @param params - Assert Payout/NoPayout connector parameters\n * @returns Payout script and control block (hex encoded)\n */\nexport async function getAssertPayoutScriptInfo(\n  params: AssertPayoutNoPayoutConnectorParams,\n): Promise<AssertPayoutScriptInfo> {\n  return (await loadTbvWasm()).getAssertPayoutScriptInfo(params);\n}\n\n/**\n * Get the NoPayout script and control block for a specific challenger.\n *\n * Used to build the depositor's NoPayout PSBT (depositor-as-claimer path).\n * Each challenger has a distinct NoPayout script.\n *\n * @param params - Assert Payout/NoPayout connector parameters\n * @param challengerPubkey - The challenger's x-only public key (hex encoded)\n * @returns NoPayout script and control block (hex encoded)\n */\nexport async function getAssertNoPayoutScriptInfo(\n  params: AssertPayoutNoPayoutConnectorParams,\n  challengerPubkey: string,\n): Promise<AssertNoPayoutScriptInfo> {\n  return (await loadTbvWasm()).getAssertNoPayoutScriptInfo(\n    params,\n    challengerPubkey,\n  );\n}\n\n/**\n * Get the ChallengeAssert script and control block.\n *\n * Used to build ChallengeAssert PSBTs for the depositor-as-claimer path.\n * Each challenger has 3 ChallengeAssert transactions, and this connector\n * generates the spending scripts using WOTS public keys from the VP.\n *\n * @param params - ChallengeAssert connector parameters\n * @returns Script and control block (hex encoded)\n */\nexport async function getChallengeAssertScriptInfo(\n  params: ChallengeAssertConnectorParams,\n): Promise<ChallengeAssertScriptInfo> {\n  return (await loadTbvWasm()).getChallengeAssertScriptInfo(params);\n}\n\n/**\n * Derive 32-byte `authAnchor` (OP_RETURN preimage → VP bearer token).\n * @stability frozen - btc-vault Rust owns this API through the vault-wasm pin (`VAULT_WASM_COMMIT`).\n * Changing the derived bytes breaks VP auth for existing deposits. See CLAUDE.md §4.\n */\nexport async function expandAuthAnchor(root: Uint8Array): Promise<Uint8Array> {\n  return (await loadTbvWasm()).expandAuthAnchor(root);\n}\n\n/**\n * Derive 32-byte `hashlockSecret` for HTLC `htlcVout` (preimage → `activateVaultWithSecret`).\n * @stability frozen - btc-vault Rust owns this API.\n * Changing the derived bytes means affected vaults can never activate. See CLAUDE.md §4.\n */\nexport async function expandHashlockSecret(\n  root: Uint8Array,\n  htlcVout: number,\n): Promise<Uint8Array> {\n  return (await loadTbvWasm()).expandHashlockSecret(root, htlcVout);\n}\n\n/**\n * Derive 64-byte `wotsSeed` for HTLC `htlcVout` (→ WOTS keys, hashed as `depositorWotsPkHash`).\n * @stability frozen - btc-vault Rust owns this API.\n * Changing the derived bytes breaks existing `depositorWotsPkHash` values. No claim path remains. See CLAUDE.md §4.\n */\nexport async function expandWotsSeed(\n  root: Uint8Array,\n  htlcVout: number,\n): Promise<Uint8Array> {\n  return (await loadTbvWasm()).expandWotsSeed(root, htlcVout);\n}\n\n/**\n * Derives the vault ID from a PegIn transaction hash and depositor ETH address.\n *\n * Vault ID = keccak256(abi.encode(peginTxHash, depositor))\n * This matches the Solidity-side derivation in BTCVaultRegistry.\n *\n * @param peginTxHash - 32-byte PegIn tx hash in display order (big-endian), hex encoded\n * @param depositor - 20-byte Ethereum address of the depositor, hex encoded\n * @returns Hex-encoded vault ID (32 bytes)\n */\nexport async function deriveVaultId(\n  peginTxHash: string,\n  depositor: string,\n): Promise<string> {\n  return (await loadTbvWasm()).deriveVaultId(peginTxHash, depositor);\n}\n\nexport type {\n  AssertNoPayoutScriptInfo,\n  AssertPayoutNoPayoutConnectorParams,\n  AssertPayoutScriptInfo,\n  ChallengeAssertConnectorParams,\n  ChallengeAssertScriptInfo,\n  HtlcConnectorInfo,\n  HtlcConnectorParams,\n  Network,\n  PayoutConnectorInfo,\n  PayoutConnectorParams,\n  PeginP2aAnchorInfo,\n  PeginTxResult,\n  PrePeginParams,\n  PrePeginResult,\n};\n"],"names":["TAP_INTERNAL_KEY","tapInternalPubkey","_","index","wasmModulePromise","loadTbvWasm","error","wasm","createPrePeginTransaction","params","buildPeginTxFromPrePegin","timelockPegin","fundedPrePeginTxHex","htlcVout","getPrePeginHtlcConnectorInfo","computeMinClaimValue","txGraphVersion","numLocalChallengers","numUniversalChallengers","councilQuorum","councilSize","feeRate","computeMinPeginFee","numVks","numUcs","minPeginFeeRate","computePayoutFeeFloor","numVaultKeepers","out0Len","out1Len","supportedTxGraphVersions","peginP2aAnchorOutput","validatePeginP2aAnchor","txHex","createPayoutConnector","network","getAssertPayoutScriptInfo","getAssertNoPayoutScriptInfo","challengerPubkey","getChallengeAssertScriptInfo","expandAuthAnchor","root","expandHashlockSecret","expandWotsSeed","deriveVaultId","peginTxHash","depositor"],"mappings":"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"}