@bitgo/wasm-utxo 4.19.0 → 4.20.0

package/dist/cjs/js/fixedScriptWallet/index.d.ts

@@ -5,6 +5,7 @@ export { outputScript, address } from "./address.js";
 export { Dimensions } from "./Dimensions.js";
 export { outputScriptTypes, inputScriptTypes, type OutputScriptType, type InputScriptType, type ScriptType, } from "./scriptType.js";
 export { ChainCode, chainCodes, assertChainCode, type Scope } from "./chains.js";
+export { requiresPrevTxForP2sh } from "./prevTx.js";
 export { BitGoPsbt, getWalletKeysFromPsbt, type NetworkName, type ScriptId, type ParsedInput, type ParsedOutput, type ParsedTransaction, type SignPath, type CreateEmptyOptions, type AddInputOptions, type AddOutputOptions, type AddWalletInputOptions, type AddWalletOutputOptions, type ParseTransactionOptions, type ParseOutputsOptions, type HydrationUnspent, } from "./BitGoPsbt.js";
 export { BitGoKeySubtype, type PsbtKvKey } from "./BitGoKeySubtype.js";
 export { ZcashBitGoPsbt, type ZcashNetworkName, type CreateEmptyZcashOptions, } from "./ZcashBitGoPsbt.js";

package/dist/cjs/js/fixedScriptWallet/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ZcashBitGoPsbt = exports.BitGoKeySubtype = exports.getWalletKeysFromPsbt = exports.BitGoPsbt = exports.assertChainCode = exports.chainCodes = exports.ChainCode = exports.inputScriptTypes = exports.outputScriptTypes = exports.Dimensions = exports.address = exports.outputScript = exports.ReplayProtection = exports.RootWalletKeys = void 0;
+exports.ZcashBitGoPsbt = exports.BitGoKeySubtype = exports.getWalletKeysFromPsbt = exports.BitGoPsbt = exports.requiresPrevTxForP2sh = exports.assertChainCode = exports.chainCodes = exports.ChainCode = exports.inputScriptTypes = exports.outputScriptTypes = exports.Dimensions = exports.address = exports.outputScript = exports.ReplayProtection = exports.RootWalletKeys = void 0;
 exports.supportsScriptType = supportsScriptType;
 exports.createOpReturnScript = createOpReturnScript;
 exports.p2shP2pkOutputScript = p2shP2pkOutputScript;
@@ -21,6 +21,9 @@ var chains_js_1 = require("./chains.js");
 Object.defineProperty(exports, "ChainCode", { enumerable: true, get: function () { return chains_js_1.ChainCode; } });
 Object.defineProperty(exports, "chainCodes", { enumerable: true, get: function () { return chains_js_1.chainCodes; } });
 Object.defineProperty(exports, "assertChainCode", { enumerable: true, get: function () { return chains_js_1.assertChainCode; } });
+// Previous-transaction inclusion policy (pure JS, no WASM init)
+var prevTx_js_1 = require("./prevTx.js");
+Object.defineProperty(exports, "requiresPrevTxForP2sh", { enumerable: true, get: function () { return prevTx_js_1.requiresPrevTxForP2sh; } });
 // Bitcoin-like PSBT (for all non-Zcash networks)
 var BitGoPsbt_js_1 = require("./BitGoPsbt.js");
 Object.defineProperty(exports, "BitGoPsbt", { enumerable: true, get: function () { return BitGoPsbt_js_1.BitGoPsbt; } });

package/dist/cjs/js/fixedScriptWallet/prevTx.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Previous-transaction inclusion policy for fixed-script wallet PSBT inputs.
+ *
+ * Decides whether a p2sh input requires the full previous transaction
+ * (PSBT_IN_NON_WITNESS_UTXO) or can be signed from witness_utxo-only.
+ *
+ * This is a pure-JS module (no WASM initialization) so callers can evaluate
+ * the policy cheaply without loading the wasm-utxo module.
+ */
+import { type CoinName } from "../coinName.js";
+/**
+ * Whether a p2sh input requires the full previous transaction
+ * (PSBT_IN_NON_WITNESS_UTXO). Callers are expected to have already
+ * confirmed the input is p2sh (non-segwit) and that the tx format
+ * includes prevTx (e.g. "psbt", not "psbt-lite"); this predicate only
+ * answers the coin-level question.
+ *
+ * Returns false for value-committing coins whose sighash commits the
+ * input amount, making `non_witness_utxo` (full prevTx) cryptographically
+ * pointless for signing p2sh inputs — `witness_utxo` (value +
+ * scriptPubKey) suffices:
+ *
+ * - Zcash (`zec`/`tzec`): ZIP-243 transparent sighash commits the amount.
+ *   Including prevTx also crashes wasm-utxo, whose consensus::deserialize
+ *   rejects Zcash overwintered transactions.
+ * - BCH family (`bch`/`bcha`/`bsv`/`btg` + testnets): replay-protected
+ *   BIP-143 sighash (SIGHASH_FORKID, the default for the whole family)
+ *   commits the 8-byte value as preimage item #6. eCash is `bcha`/`tbcha`.
+ *   For the BCH family, skipping prevTx is an optimization (no DB fetch)
+ *   plus defense-in-depth, with the same fee-validation risk that the
+ *   existing `psbt-lite` path already accepts for all coins.
+ *
+ * Testnets are normalized via `getMainnet` before the switch. True
+ * otherwise.
+ */
+export declare function requiresPrevTxForP2sh(coinName: CoinName): boolean;

package/dist/cjs/js/fixedScriptWallet/prevTx.js

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.requiresPrevTxForP2sh = requiresPrevTxForP2sh;
+/**
+ * Previous-transaction inclusion policy for fixed-script wallet PSBT inputs.
+ *
+ * Decides whether a p2sh input requires the full previous transaction
+ * (PSBT_IN_NON_WITNESS_UTXO) or can be signed from witness_utxo-only.
+ *
+ * This is a pure-JS module (no WASM initialization) so callers can evaluate
+ * the policy cheaply without loading the wasm-utxo module.
+ */
+const coinName_js_1 = require("../coinName.js");
+/**
+ * Whether a p2sh input requires the full previous transaction
+ * (PSBT_IN_NON_WITNESS_UTXO). Callers are expected to have already
+ * confirmed the input is p2sh (non-segwit) and that the tx format
+ * includes prevTx (e.g. "psbt", not "psbt-lite"); this predicate only
+ * answers the coin-level question.
+ *
+ * Returns false for value-committing coins whose sighash commits the
+ * input amount, making `non_witness_utxo` (full prevTx) cryptographically
+ * pointless for signing p2sh inputs — `witness_utxo` (value +
+ * scriptPubKey) suffices:
+ *
+ * - Zcash (`zec`/`tzec`): ZIP-243 transparent sighash commits the amount.
+ *   Including prevTx also crashes wasm-utxo, whose consensus::deserialize
+ *   rejects Zcash overwintered transactions.
+ * - BCH family (`bch`/`bcha`/`bsv`/`btg` + testnets): replay-protected
+ *   BIP-143 sighash (SIGHASH_FORKID, the default for the whole family)
+ *   commits the 8-byte value as preimage item #6. eCash is `bcha`/`tbcha`.
+ *   For the BCH family, skipping prevTx is an optimization (no DB fetch)
+ *   plus defense-in-depth, with the same fee-validation risk that the
+ *   existing `psbt-lite` path already accepts for all coins.
+ *
+ * Testnets are normalized via `getMainnet` before the switch. True
+ * otherwise.
+ */
+function requiresPrevTxForP2sh(coinName) {
+    switch ((0, coinName_js_1.getMainnet)(coinName)) {
+        case "zec": // Zcash (ZIP-243)
+        case "bch": // Bitcoin Cash (BIP-143/FORKID)
+        case "bcha": // eCash (BIP-143/FORKID)
+        case "bsv": // Bitcoin SV (BIP-143/FORKID)
+        case "btg": // Bitcoin Gold (BIP-143/FORKID)
+            return false;
+        default:
+            return true;
+    }
+}

package/dist/cjs/js/index.d.ts

@@ -17,6 +17,7 @@ export type WasmUtxoVersionInfo = {
 };
 export declare function getWasmUtxoVersion(): WasmUtxoVersionInfo;
 export { type CoinName, getMainnet, isMainnet, isTestnet, isCoinName } from "./coinName.js";
+export { requiresPrevTxForP2sh } from "./fixedScriptWallet/prevTx.js";
 export type { Triple } from "./triple.js";
 export type { AddressFormat } from "./address.js";
 export type { TapLeafScript, PreparedInscriptionRevealData } from "./inscriptions.js";

package/dist/cjs/js/index.js

@@ -33,7 +33,7 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.hasPsbtMagic = exports.ZcashTransaction = exports.Transaction = exports.DashTransaction = exports.Psbt = exports.Miniscript = exports.Descriptor = exports.isCoinName = exports.isTestnet = exports.isMainnet = exports.getMainnet = exports.Dimensions = exports.BIP32 = exports.ECPair = exports.ecpair = exports.bip32 = exports.descriptorWallet = exports.fixedScriptWallet = exports.utxolibCompat = exports.message = exports.inscriptions = exports.bip322 = exports.ast = exports.address = void 0;
+exports.hasPsbtMagic = exports.ZcashTransaction = exports.Transaction = exports.DashTransaction = exports.Psbt = exports.Miniscript = exports.Descriptor = exports.requiresPrevTxForP2sh = exports.isCoinName = exports.isTestnet = exports.isMainnet = exports.getMainnet = exports.Dimensions = exports.BIP32 = exports.ECPair = exports.ecpair = exports.bip32 = exports.descriptorWallet = exports.fixedScriptWallet = exports.utxolibCompat = exports.message = exports.inscriptions = exports.bip322 = exports.ast = exports.address = void 0;
 exports.getWasmUtxoVersion = getWasmUtxoVersion;
 exports.isWasmUtxoError = isWasmUtxoError;
 const wasm = __importStar(require("./wasm/wasm_utxo.js"));
@@ -68,6 +68,8 @@ Object.defineProperty(exports, "getMainnet", { enumerable: true, get: function (
 Object.defineProperty(exports, "isMainnet", { enumerable: true, get: function () { return coinName_js_1.isMainnet; } });
 Object.defineProperty(exports, "isTestnet", { enumerable: true, get: function () { return coinName_js_1.isTestnet; } });
 Object.defineProperty(exports, "isCoinName", { enumerable: true, get: function () { return coinName_js_1.isCoinName; } });
+var prevTx_js_1 = require("./fixedScriptWallet/prevTx.js");
+Object.defineProperty(exports, "requiresPrevTxForP2sh", { enumerable: true, get: function () { return prevTx_js_1.requiresPrevTxForP2sh; } });
 const WASM_UTXO_ERROR_SYMBOL = Symbol.for("@bitgo/wasm-utxo/error");
 function isWasmUtxoError(e) {
     return (e instanceof Error &&

package/dist/esm/js/fixedScriptWallet/index.d.ts

@@ -5,6 +5,7 @@ export { outputScript, address } from "./address.js";
 export { Dimensions } from "./Dimensions.js";
 export { outputScriptTypes, inputScriptTypes, type OutputScriptType, type InputScriptType, type ScriptType, } from "./scriptType.js";
 export { ChainCode, chainCodes, assertChainCode, type Scope } from "./chains.js";
+export { requiresPrevTxForP2sh } from "./prevTx.js";
 export { BitGoPsbt, getWalletKeysFromPsbt, type NetworkName, type ScriptId, type ParsedInput, type ParsedOutput, type ParsedTransaction, type SignPath, type CreateEmptyOptions, type AddInputOptions, type AddOutputOptions, type AddWalletInputOptions, type AddWalletOutputOptions, type ParseTransactionOptions, type ParseOutputsOptions, type HydrationUnspent, } from "./BitGoPsbt.js";
 export { BitGoKeySubtype, type PsbtKvKey } from "./BitGoKeySubtype.js";
 export { ZcashBitGoPsbt, type ZcashNetworkName, type CreateEmptyZcashOptions, } from "./ZcashBitGoPsbt.js";

package/dist/esm/js/fixedScriptWallet/index.js

@@ -5,6 +5,8 @@ export { outputScript, address } from "./address.js";
 export { Dimensions } from "./Dimensions.js";
 export { outputScriptTypes, inputScriptTypes, } from "./scriptType.js";
 export { ChainCode, chainCodes, assertChainCode } from "./chains.js";
+// Previous-transaction inclusion policy (pure JS, no WASM init)
+export { requiresPrevTxForP2sh } from "./prevTx.js";
 // Bitcoin-like PSBT (for all non-Zcash networks)
 export { BitGoPsbt, getWalletKeysFromPsbt, } from "./BitGoPsbt.js";
 export { BitGoKeySubtype } from "./BitGoKeySubtype.js";

package/dist/esm/js/fixedScriptWallet/prevTx.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Previous-transaction inclusion policy for fixed-script wallet PSBT inputs.
+ *
+ * Decides whether a p2sh input requires the full previous transaction
+ * (PSBT_IN_NON_WITNESS_UTXO) or can be signed from witness_utxo-only.
+ *
+ * This is a pure-JS module (no WASM initialization) so callers can evaluate
+ * the policy cheaply without loading the wasm-utxo module.
+ */
+import { type CoinName } from "../coinName.js";
+/**
+ * Whether a p2sh input requires the full previous transaction
+ * (PSBT_IN_NON_WITNESS_UTXO). Callers are expected to have already
+ * confirmed the input is p2sh (non-segwit) and that the tx format
+ * includes prevTx (e.g. "psbt", not "psbt-lite"); this predicate only
+ * answers the coin-level question.
+ *
+ * Returns false for value-committing coins whose sighash commits the
+ * input amount, making `non_witness_utxo` (full prevTx) cryptographically
+ * pointless for signing p2sh inputs — `witness_utxo` (value +
+ * scriptPubKey) suffices:
+ *
+ * - Zcash (`zec`/`tzec`): ZIP-243 transparent sighash commits the amount.
+ *   Including prevTx also crashes wasm-utxo, whose consensus::deserialize
+ *   rejects Zcash overwintered transactions.
+ * - BCH family (`bch`/`bcha`/`bsv`/`btg` + testnets): replay-protected
+ *   BIP-143 sighash (SIGHASH_FORKID, the default for the whole family)
+ *   commits the 8-byte value as preimage item #6. eCash is `bcha`/`tbcha`.
+ *   For the BCH family, skipping prevTx is an optimization (no DB fetch)
+ *   plus defense-in-depth, with the same fee-validation risk that the
+ *   existing `psbt-lite` path already accepts for all coins.
+ *
+ * Testnets are normalized via `getMainnet` before the switch. True
+ * otherwise.
+ */
+export declare function requiresPrevTxForP2sh(coinName: CoinName): boolean;

package/dist/esm/js/fixedScriptWallet/prevTx.js

@@ -0,0 +1,47 @@
+/**
+ * Previous-transaction inclusion policy for fixed-script wallet PSBT inputs.
+ *
+ * Decides whether a p2sh input requires the full previous transaction
+ * (PSBT_IN_NON_WITNESS_UTXO) or can be signed from witness_utxo-only.
+ *
+ * This is a pure-JS module (no WASM initialization) so callers can evaluate
+ * the policy cheaply without loading the wasm-utxo module.
+ */
+import { getMainnet } from "../coinName.js";
+/**
+ * Whether a p2sh input requires the full previous transaction
+ * (PSBT_IN_NON_WITNESS_UTXO). Callers are expected to have already
+ * confirmed the input is p2sh (non-segwit) and that the tx format
+ * includes prevTx (e.g. "psbt", not "psbt-lite"); this predicate only
+ * answers the coin-level question.
+ *
+ * Returns false for value-committing coins whose sighash commits the
+ * input amount, making `non_witness_utxo` (full prevTx) cryptographically
+ * pointless for signing p2sh inputs — `witness_utxo` (value +
+ * scriptPubKey) suffices:
+ *
+ * - Zcash (`zec`/`tzec`): ZIP-243 transparent sighash commits the amount.
+ *   Including prevTx also crashes wasm-utxo, whose consensus::deserialize
+ *   rejects Zcash overwintered transactions.
+ * - BCH family (`bch`/`bcha`/`bsv`/`btg` + testnets): replay-protected
+ *   BIP-143 sighash (SIGHASH_FORKID, the default for the whole family)
+ *   commits the 8-byte value as preimage item #6. eCash is `bcha`/`tbcha`.
+ *   For the BCH family, skipping prevTx is an optimization (no DB fetch)
+ *   plus defense-in-depth, with the same fee-validation risk that the
+ *   existing `psbt-lite` path already accepts for all coins.
+ *
+ * Testnets are normalized via `getMainnet` before the switch. True
+ * otherwise.
+ */
+export function requiresPrevTxForP2sh(coinName) {
+    switch (getMainnet(coinName)) {
+        case "zec": // Zcash (ZIP-243)
+        case "bch": // Bitcoin Cash (BIP-143/FORKID)
+        case "bcha": // eCash (BIP-143/FORKID)
+        case "bsv": // Bitcoin SV (BIP-143/FORKID)
+        case "btg": // Bitcoin Gold (BIP-143/FORKID)
+            return false;
+        default:
+            return true;
+    }
+}

package/dist/esm/js/index.d.ts

@@ -17,6 +17,7 @@ export type WasmUtxoVersionInfo = {
 };
 export declare function getWasmUtxoVersion(): WasmUtxoVersionInfo;
 export { type CoinName, getMainnet, isMainnet, isTestnet, isCoinName } from "./coinName.js";
+export { requiresPrevTxForP2sh } from "./fixedScriptWallet/prevTx.js";
 export type { Triple } from "./triple.js";
 export type { AddressFormat } from "./address.js";
 export type { TapLeafScript, PreparedInscriptionRevealData } from "./inscriptions.js";

package/dist/esm/js/index.js

@@ -23,6 +23,7 @@ export function getWasmUtxoVersion() {
     return WasmUtxoNamespace.get_wasm_utxo_version();
 }
 export { getMainnet, isMainnet, isTestnet, isCoinName } from "./coinName.js";
+export { requiresPrevTxForP2sh } from "./fixedScriptWallet/prevTx.js";
 const WASM_UTXO_ERROR_SYMBOL = Symbol.for("@bitgo/wasm-utxo/error");
 export function isWasmUtxoError(e) {
     return (e instanceof Error &&

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@bitgo/wasm-utxo",
   "description": "WebAssembly wrapper for rust-bitcoin (beta)",
-  "version": "4.19.0",
+  "version": "4.20.0",
   "type": "module",
   "repository": {
     "type": "git",