@bitgo/wasm-utxo 1.15.0 → 1.17.0

package/README.md

@@ -20,7 +20,16 @@ This project is under active development.
 | Descriptor Wallet: Address Support      | ✅ Complete | 🚫          | 🚫          | 🚫          | 🚫          | 🚫          | 🚫          |
 | Descriptor Wallet: Transaction Support  | ✅ Complete | 🚫          | 🚫          | 🚫          | 🚫          | 🚫          | 🚫          |
 | FixedScript Wallet: Address Generation  | ✅ Complete | ✅ Complete | ✅ Complete | ✅ Complete | ✅ Complete | ✅ Complete | ✅ Complete |
-| FixedScript Wallet: Transaction Support | ✅ Complete | ✅ Complete | ✅ Complete | ⏳ TODO     | ⏳ TODO     | ✅ Complete | ⏳ TODO     |
+| FixedScript Wallet: Transaction Support | ✅ Complete | ✅ Complete | ✅ Complete | ✅ Complete | ✅ Complete | ✅ Complete | ✅ Complete |
+
+### Zcash Features
+
+Zcash support includes:
+
+- **Network Upgrade Awareness**: Automatic consensus branch ID determination based on block height
+- **All Network Upgrades**: Support for Overwinter, Sapling, Blossom, Heartwood, Canopy, Nu5, Nu6, and Nu6_1
+- **Height-Based API**: Preferred `createEmpty()` method automatically selects correct consensus rules
+- **Parity Testing**: Validated against `zebra-chain` for accuracy across all network upgrades
 
 ## Building
 

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

@@ -1,3 +1,4 @@
+import { BitGoPsbt as WasmBitGoPsbt } from "../wasm/wasm_utxo.js";
 import { type WalletKeysArg } from "./RootWalletKeys.js";
 import { type ReplayProtectionArg } from "./ReplayProtection.js";
 import { type BIP32Arg } from "../bip32.js";
@@ -85,14 +86,16 @@ export type AddWalletOutputOptions = {
     value: bigint;
 };
 export declare class BitGoPsbt {
-    private wasm;
-    private constructor();
+    protected wasm: WasmBitGoPsbt;
+    protected constructor(wasm: WasmBitGoPsbt);
     /**
      * Create an empty PSBT for the given network with wallet keys
      *
      * The wallet keys are used to set global xpubs in the PSBT, which identifies
      * the keys that will be used for signing.
      *
+     * For Zcash networks, use ZcashBitGoPsbt.createEmpty() instead.
+     *
      * @param network - Network name (utxolib name like "bitcoin" or coin name like "btc")
      * @param walletKeys - The wallet's root keys (sets global xpubs in the PSBT)
      * @param options - Optional transaction parameters (version, lockTime)

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

@@ -17,6 +17,8 @@ class BitGoPsbt {
      * The wallet keys are used to set global xpubs in the PSBT, which identifies
      * the keys that will be used for signing.
      *
+     * For Zcash networks, use ZcashBitGoPsbt.createEmpty() instead.
+     *
      * @param network - Network name (utxolib name like "bitcoin" or coin name like "btc")
      * @param walletKeys - The wallet's root keys (sets global xpubs in the PSBT)
      * @param options - Optional transaction parameters (version, lockTime)

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

@@ -0,0 +1,113 @@
+import { type WalletKeysArg } from "./RootWalletKeys.js";
+import { BitGoPsbt, type CreateEmptyOptions } from "./BitGoPsbt.js";
+/** Zcash network names */
+export type ZcashNetworkName = "zcash" | "zcashTest" | "zec" | "tzec";
+/** Options for creating an empty Zcash PSBT (preferred method using block height) */
+export type CreateEmptyZcashOptions = CreateEmptyOptions & {
+    /** Block height to determine consensus branch ID automatically */
+    blockHeight: number;
+    /** Zcash version group ID (defaults to Sapling: 0x892F2085) */
+    versionGroupId?: number;
+    /** Zcash transaction expiry height */
+    expiryHeight?: number;
+};
+/** Options for creating an empty Zcash PSBT with explicit consensus branch ID (advanced use) */
+export type CreateEmptyZcashWithConsensusBranchIdOptions = CreateEmptyOptions & {
+    /** Zcash consensus branch ID (required, e.g., 0xC2D6D0B4 for NU5, 0x76B809BB for Sapling) */
+    consensusBranchId: number;
+    /** Zcash version group ID (defaults to Sapling: 0x892F2085) */
+    versionGroupId?: number;
+    /** Zcash transaction expiry height */
+    expiryHeight?: number;
+};
+/**
+ * Zcash-specific PSBT implementation
+ *
+ * This class extends BitGoPsbt with Zcash-specific functionality:
+ * - Required consensus branch ID for sighash computation
+ * - Version group ID for Zcash transaction format
+ * - Expiry height for transaction validity
+ *
+ * All Zcash-specific getters return non-optional types since they're
+ * guaranteed to be present for Zcash PSBTs.
+ *
+ * @example
+ * ```typescript
+ * // Create a new Zcash PSBT
+ * const psbt = ZcashBitGoPsbt.createEmpty("zcash", walletKeys, {
+ *   consensusBranchId: 0x76B809BB,  // Sapling
+ * });
+ *
+ * // Deserialize from bytes
+ * const psbt = ZcashBitGoPsbt.fromBytes(bytes, "zcash");
+ * ```
+ */
+export declare class ZcashBitGoPsbt extends BitGoPsbt {
+    /**
+     * Create an empty Zcash PSBT with consensus branch ID determined from block height
+     *
+     * **This is the preferred method for creating Zcash PSBTs.** It automatically determines
+     * the correct consensus branch ID based on the network and block height using Zcash
+     * network upgrade activation heights, eliminating the need to manually look up branch IDs.
+     *
+     * @param network - Zcash network name ("zcash", "zcashTest", "zec", "tzec")
+     * @param walletKeys - The wallet's root keys (sets global xpubs in the PSBT)
+     * @param options - Options including blockHeight to determine consensus rules
+     * @returns A new ZcashBitGoPsbt instance
+     * @throws Error if block height is before Overwinter activation
+     *
+     * @example
+     * ```typescript
+     * // Create PSBT for a specific block height (recommended)
+     * const psbt = ZcashBitGoPsbt.createEmpty("zcash", walletKeys, {
+     *   blockHeight: 1687104,  // Automatically uses Nu5 branch ID
+     * });
+     *
+     * // Create PSBT for current block height
+     * const currentHeight = await getBlockHeight();
+     * const psbt = ZcashBitGoPsbt.createEmpty("zcash", walletKeys, {
+     *   blockHeight: currentHeight,
+     * });
+     * ```
+     */
+    static createEmpty(network: ZcashNetworkName, walletKeys: WalletKeysArg, options: CreateEmptyZcashOptions): ZcashBitGoPsbt;
+    /**
+     * Create an empty Zcash PSBT with explicit consensus branch ID
+     *
+     * **Advanced use only.** This method requires manually specifying the consensus branch ID.
+     * In most cases, you should use `createEmpty()` instead, which automatically determines
+     * the correct branch ID from the block height.
+     *
+     * @param network - Zcash network name ("zcash", "zcashTest", "zec", "tzec")
+     * @param walletKeys - The wallet's root keys (sets global xpubs in the PSBT)
+     * @param options - Zcash-specific options including required consensusBranchId
+     * @returns A new ZcashBitGoPsbt instance
+     *
+     * @example
+     * ```typescript
+     * // Only use this if you need explicit control over the branch ID
+     * const psbt = ZcashBitGoPsbt.createEmptyWithConsensusBranchId("zcash", walletKeys, {
+     *   consensusBranchId: 0xC2D6D0B4,  // Nu5 branch ID
+     * });
+     * ```
+     */
+    static createEmptyWithConsensusBranchId(network: ZcashNetworkName, walletKeys: WalletKeysArg, options: CreateEmptyZcashWithConsensusBranchIdOptions): ZcashBitGoPsbt;
+    /**
+     * Deserialize a Zcash PSBT from bytes
+     *
+     * @param bytes - The PSBT bytes
+     * @param network - Zcash network name ("zcash", "zcashTest", "zec", "tzec")
+     * @returns A ZcashBitGoPsbt instance
+     */
+    static fromBytes(bytes: Uint8Array, network: ZcashNetworkName): ZcashBitGoPsbt;
+    /**
+     * Get the Zcash version group ID
+     * @returns The version group ID (e.g., 0x892F2085 for Sapling)
+     */
+    get versionGroupId(): number;
+    /**
+     * Get the Zcash expiry height
+     * @returns The expiry height (0 if not set)
+     */
+    get expiryHeight(): number;
+}

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

@@ -0,0 +1,114 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ZcashBitGoPsbt = void 0;
+const wasm_utxo_js_1 = require("../wasm/wasm_utxo.js");
+const RootWalletKeys_js_1 = require("./RootWalletKeys.js");
+const BitGoPsbt_js_1 = require("./BitGoPsbt.js");
+/**
+ * Zcash-specific PSBT implementation
+ *
+ * This class extends BitGoPsbt with Zcash-specific functionality:
+ * - Required consensus branch ID for sighash computation
+ * - Version group ID for Zcash transaction format
+ * - Expiry height for transaction validity
+ *
+ * All Zcash-specific getters return non-optional types since they're
+ * guaranteed to be present for Zcash PSBTs.
+ *
+ * @example
+ * ```typescript
+ * // Create a new Zcash PSBT
+ * const psbt = ZcashBitGoPsbt.createEmpty("zcash", walletKeys, {
+ *   consensusBranchId: 0x76B809BB,  // Sapling
+ * });
+ *
+ * // Deserialize from bytes
+ * const psbt = ZcashBitGoPsbt.fromBytes(bytes, "zcash");
+ * ```
+ */
+class ZcashBitGoPsbt extends BitGoPsbt_js_1.BitGoPsbt {
+    /**
+     * Create an empty Zcash PSBT with consensus branch ID determined from block height
+     *
+     * **This is the preferred method for creating Zcash PSBTs.** It automatically determines
+     * the correct consensus branch ID based on the network and block height using Zcash
+     * network upgrade activation heights, eliminating the need to manually look up branch IDs.
+     *
+     * @param network - Zcash network name ("zcash", "zcashTest", "zec", "tzec")
+     * @param walletKeys - The wallet's root keys (sets global xpubs in the PSBT)
+     * @param options - Options including blockHeight to determine consensus rules
+     * @returns A new ZcashBitGoPsbt instance
+     * @throws Error if block height is before Overwinter activation
+     *
+     * @example
+     * ```typescript
+     * // Create PSBT for a specific block height (recommended)
+     * const psbt = ZcashBitGoPsbt.createEmpty("zcash", walletKeys, {
+     *   blockHeight: 1687104,  // Automatically uses Nu5 branch ID
+     * });
+     *
+     * // Create PSBT for current block height
+     * const currentHeight = await getBlockHeight();
+     * const psbt = ZcashBitGoPsbt.createEmpty("zcash", walletKeys, {
+     *   blockHeight: currentHeight,
+     * });
+     * ```
+     */
+    static createEmpty(network, walletKeys, options) {
+        const keys = RootWalletKeys_js_1.RootWalletKeys.from(walletKeys);
+        const wasm = wasm_utxo_js_1.BitGoPsbt.create_empty_zcash_at_height(network, keys.wasm, options.blockHeight, options.version, options.lockTime, options.versionGroupId, options.expiryHeight);
+        return new ZcashBitGoPsbt(wasm);
+    }
+    /**
+     * Create an empty Zcash PSBT with explicit consensus branch ID
+     *
+     * **Advanced use only.** This method requires manually specifying the consensus branch ID.
+     * In most cases, you should use `createEmpty()` instead, which automatically determines
+     * the correct branch ID from the block height.
+     *
+     * @param network - Zcash network name ("zcash", "zcashTest", "zec", "tzec")
+     * @param walletKeys - The wallet's root keys (sets global xpubs in the PSBT)
+     * @param options - Zcash-specific options including required consensusBranchId
+     * @returns A new ZcashBitGoPsbt instance
+     *
+     * @example
+     * ```typescript
+     * // Only use this if you need explicit control over the branch ID
+     * const psbt = ZcashBitGoPsbt.createEmptyWithConsensusBranchId("zcash", walletKeys, {
+     *   consensusBranchId: 0xC2D6D0B4,  // Nu5 branch ID
+     * });
+     * ```
+     */
+    static createEmptyWithConsensusBranchId(network, walletKeys, options) {
+        const keys = RootWalletKeys_js_1.RootWalletKeys.from(walletKeys);
+        const wasm = wasm_utxo_js_1.BitGoPsbt.create_empty_zcash(network, keys.wasm, options.consensusBranchId, options.version, options.lockTime, options.versionGroupId, options.expiryHeight);
+        return new ZcashBitGoPsbt(wasm);
+    }
+    /**
+     * Deserialize a Zcash PSBT from bytes
+     *
+     * @param bytes - The PSBT bytes
+     * @param network - Zcash network name ("zcash", "zcashTest", "zec", "tzec")
+     * @returns A ZcashBitGoPsbt instance
+     */
+    static fromBytes(bytes, network) {
+        const wasm = wasm_utxo_js_1.BitGoPsbt.from_bytes(bytes, network);
+        return new ZcashBitGoPsbt(wasm);
+    }
+    // --- Zcash-specific getters ---
+    /**
+     * Get the Zcash version group ID
+     * @returns The version group ID (e.g., 0x892F2085 for Sapling)
+     */
+    get versionGroupId() {
+        return this.wasm.version_group_id();
+    }
+    /**
+     * Get the Zcash expiry height
+     * @returns The expiry height (0 if not set)
+     */
+    get expiryHeight() {
+        return this.wasm.expiry_height();
+    }
+}
+exports.ZcashBitGoPsbt = ZcashBitGoPsbt;

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

@@ -1,4 +1,5 @@
 export { RootWalletKeys, type WalletKeysArg, type IWalletKeys } from "./RootWalletKeys.js";
 export { ReplayProtection, type ReplayProtectionArg } from "./ReplayProtection.js";
 export { outputScript, address } from "./address.js";
-export { BitGoPsbt, type NetworkName, type ScriptId, type InputScriptType, type ParsedInput, type ParsedOutput, type ParsedTransaction, type SignPath, } from "./BitGoPsbt.js";
+export { BitGoPsbt, type NetworkName, type ScriptId, type InputScriptType, type ParsedInput, type ParsedOutput, type ParsedTransaction, type SignPath, type CreateEmptyOptions, type AddInputOptions, type AddOutputOptions, type AddWalletInputOptions, type AddWalletOutputOptions, } from "./BitGoPsbt.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.BitGoPsbt = exports.address = exports.outputScript = exports.ReplayProtection = exports.RootWalletKeys = void 0;
+exports.ZcashBitGoPsbt = exports.BitGoPsbt = exports.address = exports.outputScript = exports.ReplayProtection = exports.RootWalletKeys = void 0;
 var RootWalletKeys_js_1 = require("./RootWalletKeys.js");
 Object.defineProperty(exports, "RootWalletKeys", { enumerable: true, get: function () { return RootWalletKeys_js_1.RootWalletKeys; } });
 var ReplayProtection_js_1 = require("./ReplayProtection.js");
@@ -8,5 +8,9 @@ Object.defineProperty(exports, "ReplayProtection", { enumerable: true, get: func
 var address_js_1 = require("./address.js");
 Object.defineProperty(exports, "outputScript", { enumerable: true, get: function () { return address_js_1.outputScript; } });
 Object.defineProperty(exports, "address", { enumerable: true, get: function () { return address_js_1.address; } });
+// 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; } });
+// Zcash-specific PSBT subclass
+var ZcashBitGoPsbt_js_1 = require("./ZcashBitGoPsbt.js");
+Object.defineProperty(exports, "ZcashBitGoPsbt", { enumerable: true, get: function () { return ZcashBitGoPsbt_js_1.ZcashBitGoPsbt; } });

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

@@ -39,3 +39,4 @@ declare module "./wasm/wasm_utxo.js" {
 export { WrapDescriptor as Descriptor } from "./wasm/wasm_utxo.js";
 export { WrapMiniscript as Miniscript } from "./wasm/wasm_utxo.js";
 export { WrapPsbt as Psbt } from "./wasm/wasm_utxo.js";
+export { DashTransaction, Transaction, ZcashTransaction } from "./transaction.js";

package/dist/cjs/js/index.js

@@ -33,7 +33,7 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Psbt = exports.Miniscript = exports.Descriptor = exports.BIP32 = exports.ECPair = exports.ecpair = exports.bip32 = exports.fixedScriptWallet = exports.utxolibCompat = exports.ast = exports.address = void 0;
+exports.ZcashTransaction = exports.Transaction = exports.DashTransaction = exports.Psbt = exports.Miniscript = exports.Descriptor = exports.BIP32 = exports.ECPair = exports.ecpair = exports.bip32 = exports.fixedScriptWallet = exports.utxolibCompat = exports.ast = exports.address = void 0;
 const wasm = __importStar(require("./wasm/wasm_utxo.js"));
 // we need to access the wasm module here, otherwise webpack gets all weird
 // and forgets to include it in the bundle
@@ -57,3 +57,7 @@ var wasm_utxo_js_2 = require("./wasm/wasm_utxo.js");
 Object.defineProperty(exports, "Miniscript", { enumerable: true, get: function () { return wasm_utxo_js_2.WrapMiniscript; } });
 var wasm_utxo_js_3 = require("./wasm/wasm_utxo.js");
 Object.defineProperty(exports, "Psbt", { enumerable: true, get: function () { return wasm_utxo_js_3.WrapPsbt; } });
+var transaction_js_1 = require("./transaction.js");
+Object.defineProperty(exports, "DashTransaction", { enumerable: true, get: function () { return transaction_js_1.DashTransaction; } });
+Object.defineProperty(exports, "Transaction", { enumerable: true, get: function () { return transaction_js_1.Transaction; } });
+Object.defineProperty(exports, "ZcashTransaction", { enumerable: true, get: function () { return transaction_js_1.ZcashTransaction; } });

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

@@ -0,0 +1,46 @@
+import { WasmDashTransaction, WasmTransaction, WasmZcashTransaction } from "./wasm/wasm_utxo.js";
+/**
+ * Transaction wrapper (Bitcoin-like networks)
+ *
+ * Provides a camelCase, strongly-typed API over the snake_case WASM bindings.
+ */
+export declare class Transaction {
+    private _wasm;
+    private constructor();
+    static fromBytes(bytes: Uint8Array): Transaction;
+    toBytes(): Uint8Array;
+    /**
+     * @internal
+     */
+    get wasm(): WasmTransaction;
+}
+/**
+ * Zcash Transaction wrapper
+ *
+ * Provides a camelCase, strongly-typed API over the snake_case WASM bindings.
+ */
+export declare class ZcashTransaction {
+    private _wasm;
+    private constructor();
+    static fromBytes(bytes: Uint8Array): ZcashTransaction;
+    toBytes(): Uint8Array;
+    /**
+     * @internal
+     */
+    get wasm(): WasmZcashTransaction;
+}
+/**
+ * Dash Transaction wrapper (supports EVO special transactions)
+ *
+ * Round-trip only: bytes -> parse -> bytes.
+ */
+export declare class DashTransaction {
+    private _wasm;
+    private constructor();
+    static fromBytes(bytes: Uint8Array): DashTransaction;
+    toBytes(): Uint8Array;
+    /**
+     * @internal
+     */
+    get wasm(): WasmDashTransaction;
+}

package/dist/cjs/js/transaction.js

@@ -0,0 +1,76 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DashTransaction = exports.ZcashTransaction = exports.Transaction = void 0;
+const wasm_utxo_js_1 = require("./wasm/wasm_utxo.js");
+/**
+ * Transaction wrapper (Bitcoin-like networks)
+ *
+ * Provides a camelCase, strongly-typed API over the snake_case WASM bindings.
+ */
+class Transaction {
+    _wasm;
+    constructor(_wasm) {
+        this._wasm = _wasm;
+    }
+    static fromBytes(bytes) {
+        return new Transaction(wasm_utxo_js_1.WasmTransaction.from_bytes(bytes));
+    }
+    toBytes() {
+        return this._wasm.to_bytes();
+    }
+    /**
+     * @internal
+     */
+    get wasm() {
+        return this._wasm;
+    }
+}
+exports.Transaction = Transaction;
+/**
+ * Zcash Transaction wrapper
+ *
+ * Provides a camelCase, strongly-typed API over the snake_case WASM bindings.
+ */
+class ZcashTransaction {
+    _wasm;
+    constructor(_wasm) {
+        this._wasm = _wasm;
+    }
+    static fromBytes(bytes) {
+        return new ZcashTransaction(wasm_utxo_js_1.WasmZcashTransaction.from_bytes(bytes));
+    }
+    toBytes() {
+        return this._wasm.to_bytes();
+    }
+    /**
+     * @internal
+     */
+    get wasm() {
+        return this._wasm;
+    }
+}
+exports.ZcashTransaction = ZcashTransaction;
+/**
+ * Dash Transaction wrapper (supports EVO special transactions)
+ *
+ * Round-trip only: bytes -> parse -> bytes.
+ */
+class DashTransaction {
+    _wasm;
+    constructor(_wasm) {
+        this._wasm = _wasm;
+    }
+    static fromBytes(bytes) {
+        return new DashTransaction(wasm_utxo_js_1.WasmDashTransaction.from_bytes(bytes));
+    }
+    toBytes() {
+        return this._wasm.to_bytes();
+    }
+    /**
+     * @internal
+     */
+    get wasm() {
+        return this._wasm;
+    }
+}
+exports.DashTransaction = DashTransaction;

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

@@ -38,6 +38,10 @@ export class BitGoPsbt {
    * * `lock_time` - Optional lock time (default: 0)
    */
   static create_empty(network: string, wallet_keys: WasmRootWalletKeys, version?: number | null, lock_time?: number | null): BitGoPsbt;
+  /**
+   * Get the Zcash expiry height (returns None for non-Zcash PSBTs)
+   */
+  expiry_height(): number | undefined;
   /**
    * Get the unsigned transaction ID
    */
@@ -84,6 +88,10 @@ export class BitGoPsbt {
    * The index of the newly added input
    */
   add_wallet_input(txid: string, vout: number, value: bigint, wallet_keys: WasmRootWalletKeys, chain: number, index: number, signer?: string | null, cosigner?: string | null, sequence?: number | null, prev_tx?: Uint8Array | null): number;
+  /**
+   * Get the Zcash version group ID (returns None for non-Zcash PSBTs)
+   */
+  version_group_id(): number | undefined;
   /**
    * Add a wallet output with full PSBT metadata
    *
@@ -120,6 +128,22 @@ export class BitGoPsbt {
    * - `Err(WasmUtxoError)` if signing fails
    */
   sign_with_privkey(input_index: number, ecpair: WasmECPair): void;
+  /**
+   * Create an empty Zcash PSBT with the required consensus branch ID
+   *
+   * This method is specifically for Zcash networks which require additional
+   * parameters for sighash computation.
+   *
+   * # Arguments
+   * * `network` - Network name (must be "zcash" or "zcashTest")
+   * * `wallet_keys` - The wallet's root keys (used to set global xpubs)
+   * * `consensus_branch_id` - Zcash consensus branch ID (e.g., 0xC2D6D0B4 for NU5)
+   * * `version` - Optional transaction version (default: 4 for Zcash Sapling+)
+   * * `lock_time` - Optional lock time (default: 0)
+   * * `version_group_id` - Optional version group ID (defaults to Sapling: 0x892F2085)
+   * * `expiry_height` - Optional expiry height
+   */
+  static create_empty_zcash(network: string, wallet_keys: WasmRootWalletKeys, consensus_branch_id: number, version?: number | null, lock_time?: number | null, version_group_id?: number | null, expiry_height?: number | null): BitGoPsbt;
   /**
    * Extract the final transaction from a finalized PSBT
    *
@@ -257,6 +281,25 @@ export class BitGoPsbt {
    * The index of the newly added input
    */
   add_replay_protection_input(ecpair: WasmECPair, txid: string, vout: number, value: bigint, sequence?: number | null): number;
+  /**
+   * Create an empty Zcash PSBT with consensus branch ID determined from block height
+   *
+   * This method automatically determines the correct consensus branch ID based on
+   * the network and block height using the network upgrade activation heights.
+   *
+   * # Arguments
+   * * `network` - Network name (must be "zcash" or "zcashTest")
+   * * `wallet_keys` - The wallet's root keys (used to set global xpubs)
+   * * `block_height` - Block height to determine consensus rules
+   * * `version` - Optional transaction version (default: 4 for Zcash Sapling+)
+   * * `lock_time` - Optional lock time (default: 0)
+   * * `version_group_id` - Optional version group ID (defaults to Sapling: 0x892F2085)
+   * * `expiry_height` - Optional expiry height
+   *
+   * # Errors
+   * Returns error if block height is before Overwinter activation
+   */
+  static create_empty_zcash_at_height(network: string, wallet_keys: WasmRootWalletKeys, block_height: number, version?: number | null, lock_time?: number | null, version_group_id?: number | null, expiry_height?: number | null): BitGoPsbt;
   /**
    * Parse outputs with wallet keys to identify which outputs belong to a wallet
    *
@@ -445,6 +488,20 @@ export class WasmBIP32 {
   readonly index: number;
 }
 
+export class WasmDashTransaction {
+  private constructor();
+  free(): void;
+  [Symbol.dispose](): void;
+  /**
+   * Deserialize a Dash transaction from bytes (supports EVO special tx extra payload).
+   */
+  static from_bytes(bytes: Uint8Array): WasmDashTransaction;
+  /**
+   * Serialize the Dash transaction to bytes (preserving tx_type and extra payload).
+   */
+  to_bytes(): Uint8Array;
+}
+
 export class WasmECPair {
   private constructor();
   free(): void;
@@ -548,6 +605,58 @@ export class WasmRootWalletKeys {
   bitgo_key(): WasmBIP32;
 }
 
+export class WasmTransaction {
+  private constructor();
+  free(): void;
+  [Symbol.dispose](): void;
+  /**
+   * Deserialize a transaction from bytes
+   *
+   * # Arguments
+   * * `bytes` - The serialized transaction bytes
+   *
+   * # Returns
+   * A WasmTransaction instance
+   *
+   * # Errors
+   * Returns an error if the bytes cannot be parsed as a valid transaction
+   */
+  static from_bytes(bytes: Uint8Array): WasmTransaction;
+  /**
+   * Serialize the transaction to bytes
+   *
+   * # Returns
+   * The serialized transaction bytes
+   */
+  to_bytes(): Uint8Array;
+}
+
+export class WasmZcashTransaction {
+  private constructor();
+  free(): void;
+  [Symbol.dispose](): void;
+  /**
+   * Deserialize a Zcash transaction from bytes
+   *
+   * # Arguments
+   * * `bytes` - The serialized transaction bytes
+   *
+   * # Returns
+   * A WasmZcashTransaction instance
+   *
+   * # Errors
+   * Returns an error if the bytes cannot be parsed as a valid Zcash transaction
+   */
+  static from_bytes(bytes: Uint8Array): WasmZcashTransaction;
+  /**
+   * Serialize the transaction to bytes
+   *
+   * # Returns
+   * The serialized transaction bytes
+   */
+  to_bytes(): Uint8Array;
+}
+
 export class WrapDescriptor {
   private constructor();
   free(): void;