@bitgo/wasm-utxo 4.18.0 → 4.20.0

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

@@ -568,10 +568,13 @@ export declare class BitGoPsbt extends PsbtBase<WasmBitGoPsbt> implements IPsbtW
     /**
      * Extract the final transaction from a finalized PSBT
      *
+     * @param maxFeeRate Optional maximum fee rate in **sat/vB**. `Infinity` skips
+     *   the absurd-fee check; `undefined` uses rust-bitcoin's default check.
+     *   Callers holding sat/kB thresholds must divide by 1000 before passing.
      * @returns The extracted transaction instance
      * @throws Error if the PSBT is not fully finalized or extraction fails
      */
-    extractTransaction(): ITransaction;
+    extractTransaction(maxFeeRate?: number): ITransaction;
     /**
      * Extract a half-signed transaction in legacy format for p2ms-based script types.
      *

package/dist/cjs/js/fixedScriptWallet/BitGoPsbt.js

@@ -569,12 +569,15 @@ class BitGoPsbt extends psbtBase_js_1.PsbtBase {
     /**
      * Extract the final transaction from a finalized PSBT
      *
+     * @param maxFeeRate Optional maximum fee rate in **sat/vB**. `Infinity` skips
+     *   the absurd-fee check; `undefined` uses rust-bitcoin's default check.
+     *   Callers holding sat/kB thresholds must divide by 1000 before passing.
      * @returns The extracted transaction instance
      * @throws Error if the PSBT is not fully finalized or extraction fails
      */
-    extractTransaction() {
+    extractTransaction(maxFeeRate) {
         const networkType = this._wasm.get_network_type();
-        const wasm = this._wasm.extract_transaction();
+        const wasm = this._wasm.extract_transaction(maxFeeRate);
         switch (networkType) {
             case "dash":
                 return transaction_js_1.DashTransaction.fromWasm(wasm);

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

@@ -168,8 +168,11 @@ export declare class ZcashBitGoPsbt extends BitGoPsbt {
     /**
      * Extract the final Zcash transaction from a finalized PSBT
      *
+     * @param maxFeeRate Optional maximum fee rate in **sat/vB**. `Infinity` skips
+     *   the absurd-fee check; `undefined` uses rust-bitcoin's default check.
+     *   Callers holding sat/kB thresholds must divide by 1000 before passing.
      * @returns The extracted Zcash transaction instance
      * @throws Error if the PSBT is not fully finalized or extraction fails
      */
-    extractTransaction(): ZcashTransaction;
+    extractTransaction(maxFeeRate?: number): ZcashTransaction;
 }

package/dist/cjs/js/fixedScriptWallet/ZcashBitGoPsbt.js

@@ -190,11 +190,14 @@ class ZcashBitGoPsbt extends BitGoPsbt_js_1.BitGoPsbt {
     /**
      * Extract the final Zcash transaction from a finalized PSBT
      *
+     * @param maxFeeRate Optional maximum fee rate in **sat/vB**. `Infinity` skips
+     *   the absurd-fee check; `undefined` uses rust-bitcoin's default check.
+     *   Callers holding sat/kB thresholds must divide by 1000 before passing.
      * @returns The extracted Zcash transaction instance
      * @throws Error if the PSBT is not fully finalized or extraction fails
      */
-    extractTransaction() {
-        return transaction_js_1.ZcashTransaction.fromWasm(this.wasm.extract_zcash_transaction());
+    extractTransaction(maxFeeRate) {
+        return transaction_js_1.ZcashTransaction.fromWasm(this.wasm.extract_zcash_transaction(maxFeeRate));
     }
 }
 exports.ZcashBitGoPsbt = ZcashBitGoPsbt;

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/cjs/js/wasm/wasm_utxo.d.ts

@@ -249,14 +249,14 @@ export class BitGoPsbt {
      * This avoids re-parsing bytes by returning the transaction directly.
      * Only valid for Bitcoin-like networks (not Dash or Zcash).
      */
-    extract_bitcoin_transaction(): WasmTransaction;
+    extract_bitcoin_transaction(max_fee_rate_sat_per_vb?: number | null): WasmTransaction;
     /**
      * Extract the final transaction as a WasmDashTransaction (for Dash networks)
      *
      * This avoids re-parsing bytes by returning the transaction directly.
      * Only valid for Dash networks.
      */
-    extract_dash_transaction(): WasmDashTransaction;
+    extract_dash_transaction(max_fee_rate_sat_per_vb?: number | null): WasmDashTransaction;
     /**
      * Extract a half-signed transaction in legacy format for p2ms-based script types.
      *
@@ -289,14 +289,14 @@ export class BitGoPsbt {
      * - `Ok(JsValue)` containing the WASM transaction instance
      * - `Err(WasmUtxoError)` if the PSBT is not fully finalized or extraction fails
      */
-    extract_transaction(): any;
+    extract_transaction(max_fee_rate_sat_per_vb?: number | null): any;
     /**
      * Extract the final transaction as a WasmZcashTransaction (for Zcash networks)
      *
      * This avoids re-parsing bytes by returning the transaction directly.
      * Only valid for Zcash networks.
      */
-    extract_zcash_transaction(): WasmZcashTransaction;
+    extract_zcash_transaction(max_fee_rate_sat_per_vb?: number | null): WasmZcashTransaction;
     /**
      * Finalize all inputs in the PSBT
      *

package/dist/cjs/js/wasm/wasm_utxo.js

@@ -1017,12 +1017,13 @@ class BitGoPsbt {
      *
      * This avoids re-parsing bytes by returning the transaction directly.
      * Only valid for Bitcoin-like networks (not Dash or Zcash).
+     * @param {number | null} [max_fee_rate_sat_per_vb]
      * @returns {WasmTransaction}
      */
-    extract_bitcoin_transaction() {
+    extract_bitcoin_transaction(max_fee_rate_sat_per_vb) {
         try {
             const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
-            wasm.bitgopsbt_extract_bitcoin_transaction(retptr, this.__wbg_ptr);
+            wasm.bitgopsbt_extract_bitcoin_transaction(retptr, this.__wbg_ptr, !isLikeNone(max_fee_rate_sat_per_vb), isLikeNone(max_fee_rate_sat_per_vb) ? 0 : max_fee_rate_sat_per_vb);
             var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
             var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
             var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
@@ -1039,12 +1040,13 @@ class BitGoPsbt {
      *
      * This avoids re-parsing bytes by returning the transaction directly.
      * Only valid for Dash networks.
+     * @param {number | null} [max_fee_rate_sat_per_vb]
      * @returns {WasmDashTransaction}
      */
-    extract_dash_transaction() {
+    extract_dash_transaction(max_fee_rate_sat_per_vb) {
         try {
             const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
-            wasm.bitgopsbt_extract_dash_transaction(retptr, this.__wbg_ptr);
+            wasm.bitgopsbt_extract_dash_transaction(retptr, this.__wbg_ptr, !isLikeNone(max_fee_rate_sat_per_vb), isLikeNone(max_fee_rate_sat_per_vb) ? 0 : max_fee_rate_sat_per_vb);
             var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
             var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
             var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
@@ -1105,12 +1107,13 @@ class BitGoPsbt {
      * # Returns
      * - `Ok(JsValue)` containing the WASM transaction instance
      * - `Err(WasmUtxoError)` if the PSBT is not fully finalized or extraction fails
+     * @param {number | null} [max_fee_rate_sat_per_vb]
      * @returns {any}
      */
-    extract_transaction() {
+    extract_transaction(max_fee_rate_sat_per_vb) {
         try {
             const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
-            wasm.bitgopsbt_extract_transaction(retptr, this.__wbg_ptr);
+            wasm.bitgopsbt_extract_transaction(retptr, this.__wbg_ptr, !isLikeNone(max_fee_rate_sat_per_vb), isLikeNone(max_fee_rate_sat_per_vb) ? 0 : max_fee_rate_sat_per_vb);
             var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
             var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
             var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
@@ -1127,12 +1130,13 @@ class BitGoPsbt {
      *
      * This avoids re-parsing bytes by returning the transaction directly.
      * Only valid for Zcash networks.
+     * @param {number | null} [max_fee_rate_sat_per_vb]
      * @returns {WasmZcashTransaction}
      */
-    extract_zcash_transaction() {
+    extract_zcash_transaction(max_fee_rate_sat_per_vb) {
         try {
             const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
-            wasm.bitgopsbt_extract_zcash_transaction(retptr, this.__wbg_ptr);
+            wasm.bitgopsbt_extract_zcash_transaction(retptr, this.__wbg_ptr, !isLikeNone(max_fee_rate_sat_per_vb), isLikeNone(max_fee_rate_sat_per_vb) ? 0 : max_fee_rate_sat_per_vb);
             var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
             var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
             var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);

package/dist/cjs/js/wasm/wasm_utxo_bg.wasm.d.ts

@@ -170,11 +170,11 @@ export const bitgopsbt_delete_input_kv: (a: number, b: number, c: number, d: num
 export const bitgopsbt_delete_kv: (a: number, b: number, c: number) => void;
 export const bitgopsbt_delete_output_kv: (a: number, b: number, c: number, d: number) => void;
 export const bitgopsbt_expiry_height: (a: number) => number;
-export const bitgopsbt_extract_bitcoin_transaction: (a: number, b: number) => void;
-export const bitgopsbt_extract_dash_transaction: (a: number, b: number) => void;
+export const bitgopsbt_extract_bitcoin_transaction: (a: number, b: number, c: number, d: number) => void;
+export const bitgopsbt_extract_dash_transaction: (a: number, b: number, c: number, d: number) => void;
 export const bitgopsbt_extract_half_signed_legacy_tx: (a: number, b: number) => void;
-export const bitgopsbt_extract_transaction: (a: number, b: number) => void;
-export const bitgopsbt_extract_zcash_transaction: (a: number, b: number) => void;
+export const bitgopsbt_extract_transaction: (a: number, b: number, c: number, d: number) => void;
+export const bitgopsbt_extract_zcash_transaction: (a: number, b: number, c: number, d: number) => void;
 export const bitgopsbt_finalize_all_inputs: (a: number, b: number) => void;
 export const bitgopsbt_from_bytes: (a: number, b: number, c: number, d: number, e: number) => void;
 export const bitgopsbt_from_half_signed_legacy_transaction: (a: number, b: number, c: number, d: number, e: number, f: number) => void;

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

@@ -568,10 +568,13 @@ export declare class BitGoPsbt extends PsbtBase<WasmBitGoPsbt> implements IPsbtW
     /**
      * Extract the final transaction from a finalized PSBT
      *
+     * @param maxFeeRate Optional maximum fee rate in **sat/vB**. `Infinity` skips
+     *   the absurd-fee check; `undefined` uses rust-bitcoin's default check.
+     *   Callers holding sat/kB thresholds must divide by 1000 before passing.
      * @returns The extracted transaction instance
      * @throws Error if the PSBT is not fully finalized or extraction fails
      */
-    extractTransaction(): ITransaction;
+    extractTransaction(maxFeeRate?: number): ITransaction;
     /**
      * Extract a half-signed transaction in legacy format for p2ms-based script types.
      *

package/dist/esm/js/fixedScriptWallet/BitGoPsbt.js

@@ -565,12 +565,15 @@ export class BitGoPsbt extends PsbtBase {
     /**
      * Extract the final transaction from a finalized PSBT
      *
+     * @param maxFeeRate Optional maximum fee rate in **sat/vB**. `Infinity` skips
+     *   the absurd-fee check; `undefined` uses rust-bitcoin's default check.
+     *   Callers holding sat/kB thresholds must divide by 1000 before passing.
      * @returns The extracted transaction instance
      * @throws Error if the PSBT is not fully finalized or extraction fails
      */
-    extractTransaction() {
+    extractTransaction(maxFeeRate) {
         const networkType = this._wasm.get_network_type();
-        const wasm = this._wasm.extract_transaction();
+        const wasm = this._wasm.extract_transaction(maxFeeRate);
         switch (networkType) {
             case "dash":
                 return DashTransaction.fromWasm(wasm);

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

@@ -168,8 +168,11 @@ export declare class ZcashBitGoPsbt extends BitGoPsbt {
     /**
      * Extract the final Zcash transaction from a finalized PSBT
      *
+     * @param maxFeeRate Optional maximum fee rate in **sat/vB**. `Infinity` skips
+     *   the absurd-fee check; `undefined` uses rust-bitcoin's default check.
+     *   Callers holding sat/kB thresholds must divide by 1000 before passing.
      * @returns The extracted Zcash transaction instance
      * @throws Error if the PSBT is not fully finalized or extraction fails
      */
-    extractTransaction(): ZcashTransaction;
+    extractTransaction(maxFeeRate?: number): ZcashTransaction;
 }

package/dist/esm/js/fixedScriptWallet/ZcashBitGoPsbt.js

@@ -187,10 +187,13 @@ export class ZcashBitGoPsbt extends BitGoPsbt {
     /**
      * Extract the final Zcash transaction from a finalized PSBT
      *
+     * @param maxFeeRate Optional maximum fee rate in **sat/vB**. `Infinity` skips
+     *   the absurd-fee check; `undefined` uses rust-bitcoin's default check.
+     *   Callers holding sat/kB thresholds must divide by 1000 before passing.
      * @returns The extracted Zcash transaction instance
      * @throws Error if the PSBT is not fully finalized or extraction fails
      */
-    extractTransaction() {
-        return ZcashTransaction.fromWasm(this.wasm.extract_zcash_transaction());
+    extractTransaction(maxFeeRate) {
+        return ZcashTransaction.fromWasm(this.wasm.extract_zcash_transaction(maxFeeRate));
     }
 }

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/dist/esm/js/wasm/wasm_utxo.d.ts

@@ -249,14 +249,14 @@ export class BitGoPsbt {
      * This avoids re-parsing bytes by returning the transaction directly.
      * Only valid for Bitcoin-like networks (not Dash or Zcash).
      */
-    extract_bitcoin_transaction(): WasmTransaction;
+    extract_bitcoin_transaction(max_fee_rate_sat_per_vb?: number | null): WasmTransaction;
     /**
      * Extract the final transaction as a WasmDashTransaction (for Dash networks)
      *
      * This avoids re-parsing bytes by returning the transaction directly.
      * Only valid for Dash networks.
      */
-    extract_dash_transaction(): WasmDashTransaction;
+    extract_dash_transaction(max_fee_rate_sat_per_vb?: number | null): WasmDashTransaction;
     /**
      * Extract a half-signed transaction in legacy format for p2ms-based script types.
      *
@@ -289,14 +289,14 @@ export class BitGoPsbt {
      * - `Ok(JsValue)` containing the WASM transaction instance
      * - `Err(WasmUtxoError)` if the PSBT is not fully finalized or extraction fails
      */
-    extract_transaction(): any;
+    extract_transaction(max_fee_rate_sat_per_vb?: number | null): any;
     /**
      * Extract the final transaction as a WasmZcashTransaction (for Zcash networks)
      *
      * This avoids re-parsing bytes by returning the transaction directly.
      * Only valid for Zcash networks.
      */
-    extract_zcash_transaction(): WasmZcashTransaction;
+    extract_zcash_transaction(max_fee_rate_sat_per_vb?: number | null): WasmZcashTransaction;
     /**
      * Finalize all inputs in the PSBT
      *

package/dist/esm/js/wasm/wasm_utxo_bg.js

@@ -1013,12 +1013,13 @@ export class BitGoPsbt {
      *
      * This avoids re-parsing bytes by returning the transaction directly.
      * Only valid for Bitcoin-like networks (not Dash or Zcash).
+     * @param {number | null} [max_fee_rate_sat_per_vb]
      * @returns {WasmTransaction}
      */
-    extract_bitcoin_transaction() {
+    extract_bitcoin_transaction(max_fee_rate_sat_per_vb) {
         try {
             const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
-            wasm.bitgopsbt_extract_bitcoin_transaction(retptr, this.__wbg_ptr);
+            wasm.bitgopsbt_extract_bitcoin_transaction(retptr, this.__wbg_ptr, !isLikeNone(max_fee_rate_sat_per_vb), isLikeNone(max_fee_rate_sat_per_vb) ? 0 : max_fee_rate_sat_per_vb);
             var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
             var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
             var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
@@ -1035,12 +1036,13 @@ export class BitGoPsbt {
      *
      * This avoids re-parsing bytes by returning the transaction directly.
      * Only valid for Dash networks.
+     * @param {number | null} [max_fee_rate_sat_per_vb]
      * @returns {WasmDashTransaction}
      */
-    extract_dash_transaction() {
+    extract_dash_transaction(max_fee_rate_sat_per_vb) {
         try {
             const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
-            wasm.bitgopsbt_extract_dash_transaction(retptr, this.__wbg_ptr);
+            wasm.bitgopsbt_extract_dash_transaction(retptr, this.__wbg_ptr, !isLikeNone(max_fee_rate_sat_per_vb), isLikeNone(max_fee_rate_sat_per_vb) ? 0 : max_fee_rate_sat_per_vb);
             var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
             var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
             var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
@@ -1101,12 +1103,13 @@ export class BitGoPsbt {
      * # Returns
      * - `Ok(JsValue)` containing the WASM transaction instance
      * - `Err(WasmUtxoError)` if the PSBT is not fully finalized or extraction fails
+     * @param {number | null} [max_fee_rate_sat_per_vb]
      * @returns {any}
      */
-    extract_transaction() {
+    extract_transaction(max_fee_rate_sat_per_vb) {
         try {
             const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
-            wasm.bitgopsbt_extract_transaction(retptr, this.__wbg_ptr);
+            wasm.bitgopsbt_extract_transaction(retptr, this.__wbg_ptr, !isLikeNone(max_fee_rate_sat_per_vb), isLikeNone(max_fee_rate_sat_per_vb) ? 0 : max_fee_rate_sat_per_vb);
             var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
             var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
             var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
@@ -1123,12 +1126,13 @@ export class BitGoPsbt {
      *
      * This avoids re-parsing bytes by returning the transaction directly.
      * Only valid for Zcash networks.
+     * @param {number | null} [max_fee_rate_sat_per_vb]
      * @returns {WasmZcashTransaction}
      */
-    extract_zcash_transaction() {
+    extract_zcash_transaction(max_fee_rate_sat_per_vb) {
         try {
             const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
-            wasm.bitgopsbt_extract_zcash_transaction(retptr, this.__wbg_ptr);
+            wasm.bitgopsbt_extract_zcash_transaction(retptr, this.__wbg_ptr, !isLikeNone(max_fee_rate_sat_per_vb), isLikeNone(max_fee_rate_sat_per_vb) ? 0 : max_fee_rate_sat_per_vb);
             var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
             var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
             var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);

package/dist/esm/js/wasm/wasm_utxo_bg.wasm.d.ts

@@ -170,11 +170,11 @@ export const bitgopsbt_delete_input_kv: (a: number, b: number, c: number, d: num
 export const bitgopsbt_delete_kv: (a: number, b: number, c: number) => void;
 export const bitgopsbt_delete_output_kv: (a: number, b: number, c: number, d: number) => void;
 export const bitgopsbt_expiry_height: (a: number) => number;
-export const bitgopsbt_extract_bitcoin_transaction: (a: number, b: number) => void;
-export const bitgopsbt_extract_dash_transaction: (a: number, b: number) => void;
+export const bitgopsbt_extract_bitcoin_transaction: (a: number, b: number, c: number, d: number) => void;
+export const bitgopsbt_extract_dash_transaction: (a: number, b: number, c: number, d: number) => void;
 export const bitgopsbt_extract_half_signed_legacy_tx: (a: number, b: number) => void;
-export const bitgopsbt_extract_transaction: (a: number, b: number) => void;
-export const bitgopsbt_extract_zcash_transaction: (a: number, b: number) => void;
+export const bitgopsbt_extract_transaction: (a: number, b: number, c: number, d: number) => void;
+export const bitgopsbt_extract_zcash_transaction: (a: number, b: number, c: number, d: number) => void;
 export const bitgopsbt_finalize_all_inputs: (a: number, b: number) => void;
 export const bitgopsbt_from_bytes: (a: number, b: number, c: number, d: number, e: number) => void;
 export const bitgopsbt_from_half_signed_legacy_transaction: (a: number, b: number, c: number, d: number, e: number, f: number) => void;

package/package.json

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