@bitgo/wasm-utxo 4.37.1 → 4.38.0

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

@@ -40,20 +40,10 @@ export type ParsedOutput = {
     paygo: boolean;
     /** Full BIP32 derivation path from the wallet xpub (e.g. "0/1"). Null for external outputs. */
     derivationPath: string | null;
-    /**
-     * True for a shielded (Orchard/Ironwood) output. Such an output has no `unsigned_tx` entry of
-     * its own — it lives in the PSBT's proprietary-map PCZT, read from its plaintext (not
-     * encrypted/decrypted) recipient field. `address` is a single-receiver ZIP-316 unified address
-     * (`u1...`/`utest1...`) encoding that receiver — a real, usable Zcash address, though not
-     * necessarily byte-identical to whatever multi-receiver UA the sender originally pasted in (a
-     * UA with a transparent/Sapling receiver too would round-trip to a different string carrying
-     * only the Orchard one). `script` holds the same receiver as raw 43 bytes.
-     */
-    isShielded: boolean;
 };
-export type ParsedTransaction = {
+export type ParsedTransaction<TOutput extends ParsedOutput = ParsedOutput> = {
     inputs: ParsedInput[];
-    outputs: ParsedOutput[];
+    outputs: TOutput[];
     spendAmount: bigint;
     minerFee: bigint;
     virtualSize: number;
@@ -123,7 +113,7 @@ export type HydrationUnspent = {
     pubkey: Uint8Array;
     value: bigint;
 };
-export declare class BitGoPsbt extends PsbtBase<WasmBitGoPsbt> implements IPsbtWithAddress {
+export declare class BitGoPsbt<TOutput extends ParsedOutput = ParsedOutput> extends PsbtBase<WasmBitGoPsbt> implements IPsbtWithAddress {
     protected constructor(wasm: WasmBitGoPsbt);
     /**
      * Get the underlying WASM instance
@@ -339,7 +329,7 @@ export declare class BitGoPsbt extends PsbtBase<WasmBitGoPsbt> implements IPsbtW
      * @param options.payGoPubkeys - Optional public keys for PayGo attestation verification
      * @returns Parsed transaction information
      */
-    parseTransactionWithWalletKeys(walletKeys: WalletKeysArg, options: ParseTransactionOptions): ParsedTransaction;
+    parseTransactionWithWalletKeys(walletKeys: WalletKeysArg, options: ParseTransactionOptions): ParsedTransaction<TOutput>;
     /**
      * Parse outputs with wallet keys to identify which outputs belong to a wallet
      * with the given wallet keys.
@@ -353,7 +343,7 @@ export declare class BitGoPsbt extends PsbtBase<WasmBitGoPsbt> implements IPsbtW
      * @returns Array of parsed outputs
      * @note This method does NOT validate wallet inputs. It only parses outputs.
      */
-    parseOutputsWithWalletKeys(walletKeys: WalletKeysArg, options?: ParseOutputsOptions): ParsedOutput[];
+    parseOutputsWithWalletKeys(walletKeys: WalletKeysArg, options?: ParseOutputsOptions): TOutput[];
     /**
      * Add a PayGo attestation to a PSBT output
      *

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

@@ -1,8 +1,20 @@
 import { type WalletKeysArg } from "./RootWalletKeys.js";
-import { BitGoPsbt, type CreateEmptyOptions, type HydrationUnspent } from "./BitGoPsbt.js";
+import { BitGoPsbt, type CreateEmptyOptions, type HydrationUnspent, type ParsedOutput } from "./BitGoPsbt.js";
 import { ZcashTransaction, type ITransaction } from "../transaction.js";
 /** Zcash network names */
 export type ZcashNetworkName = "zcash" | "zcashTest" | "zec" | "tzec";
+export type ZcashParsedOutput = ParsedOutput & {
+    /**
+     * True for a shielded (Orchard/Ironwood) output. Such an output has no `unsigned_tx` entry of
+     * its own — it lives in the PSBT's proprietary-map PCZT, read from its plaintext (not
+     * encrypted/decrypted) recipient field. `address` is a single-receiver ZIP-316 unified address
+     * (`u1...`/`utest1...`) encoding that receiver — a real, usable Zcash address, though not
+     * necessarily byte-identical to whatever multi-receiver UA the sender originally pasted in (a
+     * UA with a transparent/Sapling receiver too would round-trip to a different string carrying
+     * only the Orchard one). `script` holds the same receiver as raw 43 bytes.
+     */
+    isShielded: boolean;
+};
 /**
  * Zcash v6 (Ironwood) version group id (0xd884b698). Its presence marks a PSBT as v6 — see
  * `ZcashIronwoodBitGoPsbt`.
@@ -52,7 +64,7 @@ export type CreateEmptyZcashWithConsensusBranchIdOptions = CreateEmptyOptions &
  * const psbt = ZcashBitGoPsbt.fromBytes(bytes, "zcash");
  * ```
  */
-export declare class ZcashBitGoPsbt extends BitGoPsbt {
+export declare class ZcashBitGoPsbt extends BitGoPsbt<ZcashParsedOutput> {
     /**
      * Create an empty Zcash PSBT with consensus branch ID determined from block height
      *

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

@@ -133,12 +133,40 @@ export declare class ZcashIronwoodBitGoPsbt extends ZcashBitGoPsbt {
      * @param options.anchor - 32-byte Ironwood note-commitment-tree root
      * @param options.memo - optional 512-byte memo (defaults to the ZIP-302 "no memo" encoding)
      * @param options.ovk - optional 32-byte outgoing viewing key (omit for a keyless build)
+     * @param options.unifiedAddress - optional full Unified Address string this output was addressed
+     *   to. Its Orchard receiver must equal `recipient`. The PCZT itself only carries the raw 43-byte
+     *   receiver — a lossy encoding for a multi-receiver UA, since any transparent/Sapling receiver
+     *   can't be recovered from it — so passing this stores the original UA verbatim, letting a later
+     *   `parseOutputsWithWalletKeys`/`parseTransactionWithWalletKeys` (even after a
+     *   serialize/deserialize round-trip) return it in full instead of a re-encoded single-receiver UA.
      */
     addShieldedOutput(recipient: Uint8Array, amount: bigint, options: {
         anchor: Uint8Array;
         memo?: Uint8Array;
         ovk?: Uint8Array;
+        unifiedAddress?: string;
     }): void;
+    /**
+     * Add one or more shielded outputs (Constructor role) as a single orchard PCZT — the
+     * multi-recipient counterpart to {@link addShieldedOutput}. Every recipient must be passed in
+     * one call: only one call to `addShieldedOutput`/`addShieldedOutputs` is supported per PSBT (see
+     * {@link addShieldedOutput}).
+     *
+     * @param outputs - one entry per recipient; `memo` defaults per-entry to the ZIP-302 "no memo"
+     *   encoding, exactly as {@link addShieldedOutput}'s does
+     * @param anchor - 32-byte Ironwood note-commitment-tree root, shared by every output
+     * @returns the action index assigned to each output, in the same order as `outputs` — the
+     *   orchard builder pads/reorders actions, so a client-managed-`ovk` caller must use these
+     *   indices (not the position in `outputs`) when later calling
+     *   `setIronwoodOutCiphertext`/`setIronwoodOutCiphertextForUser` for a specific recipient.
+     */
+    addShieldedOutputs(outputs: Array<{
+        recipient: Uint8Array;
+        amount: bigint;
+        memo?: Uint8Array;
+        ovk?: Uint8Array;
+        unifiedAddress?: string;
+    }>, anchor: Uint8Array): number[];
     /**
      * Client-managed `ovk`: re-encrypt the shielded output's `out_ciphertext` under **this wallet's**
      * `ovk`, derived as the ECDH agreement of `rootWalletKeys.bitgoKey()` and `userKey`. Both are root

package/dist/cjs/js/fixedScriptWallet/ZcashIronwoodBitGoPsbt.js

@@ -132,10 +132,39 @@ class ZcashIronwoodBitGoPsbt extends ZcashBitGoPsbt_js_1.ZcashBitGoPsbt {
      * @param options.anchor - 32-byte Ironwood note-commitment-tree root
      * @param options.memo - optional 512-byte memo (defaults to the ZIP-302 "no memo" encoding)
      * @param options.ovk - optional 32-byte outgoing viewing key (omit for a keyless build)
+     * @param options.unifiedAddress - optional full Unified Address string this output was addressed
+     *   to. Its Orchard receiver must equal `recipient`. The PCZT itself only carries the raw 43-byte
+     *   receiver — a lossy encoding for a multi-receiver UA, since any transparent/Sapling receiver
+     *   can't be recovered from it — so passing this stores the original UA verbatim, letting a later
+     *   `parseOutputsWithWalletKeys`/`parseTransactionWithWalletKeys` (even after a
+     *   serialize/deserialize round-trip) return it in full instead of a re-encoded single-receiver UA.
      */
     addShieldedOutput(recipient, amount, options) {
         const memo = options.memo ?? zip302NoMemo();
-        this.wasm.add_ironwood_output(recipient, amount, options.ovk, options.anchor, memo);
+        this.wasm.add_ironwood_output(recipient, amount, options.ovk, options.anchor, memo, options.unifiedAddress);
+    }
+    /**
+     * Add one or more shielded outputs (Constructor role) as a single orchard PCZT — the
+     * multi-recipient counterpart to {@link addShieldedOutput}. Every recipient must be passed in
+     * one call: only one call to `addShieldedOutput`/`addShieldedOutputs` is supported per PSBT (see
+     * {@link addShieldedOutput}).
+     *
+     * @param outputs - one entry per recipient; `memo` defaults per-entry to the ZIP-302 "no memo"
+     *   encoding, exactly as {@link addShieldedOutput}'s does
+     * @param anchor - 32-byte Ironwood note-commitment-tree root, shared by every output
+     * @returns the action index assigned to each output, in the same order as `outputs` — the
+     *   orchard builder pads/reorders actions, so a client-managed-`ovk` caller must use these
+     *   indices (not the position in `outputs`) when later calling
+     *   `setIronwoodOutCiphertext`/`setIronwoodOutCiphertextForUser` for a specific recipient.
+     */
+    addShieldedOutputs(outputs, anchor) {
+        return Array.from(this.wasm.add_ironwood_outputs(outputs.map((o) => ({
+            recipient: o.recipient,
+            amount: o.amount,
+            memo: o.memo ?? zip302NoMemo(),
+            ovk: o.ovk,
+            unifiedAddress: o.unifiedAddress,
+        })), anchor));
     }
     /**
      * Client-managed `ovk`: re-encrypt the shielded output's `out_ciphertext` under **this wallet's**

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

@@ -8,7 +8,7 @@ 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, IRONWOOD_VERSION_GROUP_ID, } from "./ZcashBitGoPsbt.js";
+export { ZcashBitGoPsbt, type ZcashNetworkName, type ZcashParsedOutput, type CreateEmptyZcashOptions, IRONWOOD_VERSION_GROUP_ID, } from "./ZcashBitGoPsbt.js";
 export { ZcashIronwoodBitGoPsbt, zip302NoMemo, type CreateEmptyIronwoodOptions, type CreateEmptyIronwoodWithConsensusBranchIdOptions, } from "./ZcashIronwoodBitGoPsbt.js";
 export { ZcashUnifiedAddress } from "./ZcashUnifiedAddress.js";
 export { ZcashV6Transaction } from "./ZcashV6Transaction.js";

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

@@ -150,13 +150,32 @@ export class BitGoPsbt {
      * * `ovk` - optional outgoing viewing key ([`OVK_SIZE`] bytes; `None` for a keyless build)
      * * `anchor` - Ironwood note-commitment-tree root ([`ANCHOR_SIZE`] bytes)
      * * `memo` - ZIP-302 memo field ([`MEMO_SIZE`] bytes)
+     * * `unified_address` - optional full Unified Address the output was addressed to; if given,
+     *   its Orchard receiver must match `recipient`, and it is stored verbatim so output parsing
+     *   can later return it in full (transparent/Sapling receivers included) instead of
+     *   reconstructing a single-receiver UA from `recipient` alone
      *
      * [`ORCHARD_ADDRESS_SIZE`]: crate::zcash::ironwood_build::ORCHARD_ADDRESS_SIZE
      * [`OVK_SIZE`]: crate::zcash::ironwood_build::OVK_SIZE
      * [`ANCHOR_SIZE`]: crate::zcash::ironwood_build::ANCHOR_SIZE
      * [`MEMO_SIZE`]: crate::zcash::ironwood_build::MEMO_SIZE
      */
-    add_ironwood_output(recipient: Uint8Array, amount: bigint, ovk: Uint8Array | null | undefined, anchor: Uint8Array, memo: Uint8Array): void;
+    add_ironwood_output(recipient: Uint8Array, amount: bigint, ovk: Uint8Array | null | undefined, anchor: Uint8Array, memo: Uint8Array, unified_address?: string | null): void;
+    /**
+     * Constructor: add one or more shielded Ironwood outputs as a single orchard PCZT stored in
+     * the PSBT — the multi-recipient counterpart to [`Self::add_ironwood_output`].
+     *
+     * `outputs` is an array of `{ recipient: Uint8Array, amount: bigint, memo: Uint8Array,
+     * ovk?: Uint8Array, unifiedAddress?: string }`, one entry per recipient — see
+     * [`Self::add_ironwood_output`] for the meaning of each field. `anchor` is shared by every
+     * output.
+     *
+     * Returns the action index assigned to each output, in the same order as `outputs` — the
+     * orchard builder pads/reorders actions, so a client-managed-`ovk` caller must use these
+     * indices (not the position in `outputs`) when later calling `set_ironwood_out_ciphertext`
+     * for a specific recipient.
+     */
+    add_ironwood_outputs(outputs: any, anchor: Uint8Array): Uint32Array;
     /**
      * Ingest a transparent-input signature (`sig`: DER ECDSA with the trailing SIGHASH_ALL byte)
      * after verifying it against `ironwood_v6_transparent_sighash(index)`.

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

@@ -482,6 +482,10 @@ class BitGoPsbt {
      * * `ovk` - optional outgoing viewing key ([`OVK_SIZE`] bytes; `None` for a keyless build)
      * * `anchor` - Ironwood note-commitment-tree root ([`ANCHOR_SIZE`] bytes)
      * * `memo` - ZIP-302 memo field ([`MEMO_SIZE`] bytes)
+     * * `unified_address` - optional full Unified Address the output was addressed to; if given,
+     *   its Orchard receiver must match `recipient`, and it is stored verbatim so output parsing
+     *   can later return it in full (transparent/Sapling receivers included) instead of
+     *   reconstructing a single-receiver UA from `recipient` alone
      *
      * [`ORCHARD_ADDRESS_SIZE`]: crate::zcash::ironwood_build::ORCHARD_ADDRESS_SIZE
      * [`OVK_SIZE`]: crate::zcash::ironwood_build::OVK_SIZE
@@ -492,8 +496,9 @@ class BitGoPsbt {
      * @param {Uint8Array | null | undefined} ovk
      * @param {Uint8Array} anchor
      * @param {Uint8Array} memo
+     * @param {string | null} [unified_address]
      */
-    add_ironwood_output(recipient, amount, ovk, anchor, memo) {
+    add_ironwood_output(recipient, amount, ovk, anchor, memo, unified_address) {
         try {
             const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
             const ptr0 = passArray8ToWasm0(recipient, wasm.__wbindgen_export);
@@ -504,7 +509,9 @@ class BitGoPsbt {
             const len2 = WASM_VECTOR_LEN;
             const ptr3 = passArray8ToWasm0(memo, wasm.__wbindgen_export);
             const len3 = WASM_VECTOR_LEN;
-            wasm.bitgopsbt_add_ironwood_output(retptr, this.__wbg_ptr, ptr0, len0, amount, ptr1, len1, ptr2, len2, ptr3, len3);
+            var ptr4 = isLikeNone(unified_address) ? 0 : passStringToWasm0(unified_address, wasm.__wbindgen_export, wasm.__wbindgen_export2);
+            var len4 = WASM_VECTOR_LEN;
+            wasm.bitgopsbt_add_ironwood_output(retptr, this.__wbg_ptr, ptr0, len0, amount, ptr1, len1, ptr2, len2, ptr3, len3, ptr4, len4);
             var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
             var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
             if (r1) {
@@ -514,6 +521,43 @@ class BitGoPsbt {
             wasm.__wbindgen_add_to_stack_pointer(16);
         }
     }
+    /**
+     * Constructor: add one or more shielded Ironwood outputs as a single orchard PCZT stored in
+     * the PSBT — the multi-recipient counterpart to [`Self::add_ironwood_output`].
+     *
+     * `outputs` is an array of `{ recipient: Uint8Array, amount: bigint, memo: Uint8Array,
+     * ovk?: Uint8Array, unifiedAddress?: string }`, one entry per recipient — see
+     * [`Self::add_ironwood_output`] for the meaning of each field. `anchor` is shared by every
+     * output.
+     *
+     * Returns the action index assigned to each output, in the same order as `outputs` — the
+     * orchard builder pads/reorders actions, so a client-managed-`ovk` caller must use these
+     * indices (not the position in `outputs`) when later calling `set_ironwood_out_ciphertext`
+     * for a specific recipient.
+     * @param {any} outputs
+     * @param {Uint8Array} anchor
+     * @returns {Uint32Array}
+     */
+    add_ironwood_outputs(outputs, anchor) {
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            const ptr0 = passArray8ToWasm0(anchor, wasm.__wbindgen_export);
+            const len0 = WASM_VECTOR_LEN;
+            wasm.bitgopsbt_add_ironwood_outputs(retptr, this.__wbg_ptr, addHeapObject(outputs), ptr0, len0);
+            var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+            var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+            var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
+            var r3 = getDataViewMemory0().getInt32(retptr + 4 * 3, true);
+            if (r3) {
+                throw takeObject(r2);
+            }
+            var v2 = getArrayU32FromWasm0(r0, r1).slice();
+            wasm.__wbindgen_export4(r0, r1 * 4, 4);
+            return v2;
+        } finally {
+            wasm.__wbindgen_add_to_stack_pointer(16);
+        }
+    }
     /**
      * Ingest a transparent-input signature (`sig`: DER ECDSA with the trailing SIGHASH_ALL byte)
      * after verifying it against `ironwood_v6_transparent_sighash(index)`.
@@ -7167,6 +7211,10 @@ function __wbg_get_imports() {
             getDataViewMemory0().setInt32(arg0 + 4 * 1, len1, true);
             getDataViewMemory0().setInt32(arg0 + 4 * 0, ptr1, true);
         },
+        __wbg___wbindgen_is_bigint_31b12575b56f32fc: function(arg0) {
+            const ret = typeof(getObject(arg0)) === 'bigint';
+            return ret;
+        },
         __wbg___wbindgen_is_function_0095a73b8b156f76: function(arg0) {
             const ret = typeof(getObject(arg0)) === 'function';
             return ret;

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

@@ -5,6 +5,30 @@ export const __wbg_wasmreplayprotection_free: (a: number, b: number) => void;
 export const wasmreplayprotection_from_addresses: (a: number, b: number, c: number, d: number, e: number) => void;
 export const wasmreplayprotection_from_output_scripts: (a: number, b: number) => number;
 export const wasmreplayprotection_from_public_keys: (a: number, b: number, c: number) => void;
+export const __wbg_wasmutxonamespace_free: (a: number, b: number) => void;
+export const __wbg_wrapdescriptor_free: (a: number, b: number) => void;
+export const __wbg_wrapminiscript_free: (a: number, b: number) => void;
+export const wasmutxonamespace_get_wasm_utxo_version: (a: number) => void;
+export const wrapdescriptor_atDerivationIndex: (a: number, b: number, c: number) => void;
+export const wrapdescriptor_descType: (a: number, b: number) => void;
+export const wrapdescriptor_encode: (a: number, b: number) => void;
+export const wrapdescriptor_fromString: (a: number, b: number, c: number, d: number, e: number) => void;
+export const wrapdescriptor_fromStringDetectType: (a: number, b: number, c: number) => void;
+export const wrapdescriptor_fromStringExt: (a: number, b: number, c: number, d: number, e: number, f: number) => void;
+export const wrapdescriptor_hasWildcard: (a: number) => number;
+export const wrapdescriptor_maxWeightToSatisfy: (a: number, b: number) => void;
+export const wrapdescriptor_node: (a: number, b: number) => void;
+export const wrapdescriptor_scriptPubkey: (a: number, b: number) => void;
+export const wrapdescriptor_toAsmString: (a: number, b: number) => void;
+export const wrapdescriptor_toString: (a: number, b: number) => void;
+export const wrapminiscript_encode: (a: number, b: number) => void;
+export const wrapminiscript_fromBitcoinScript: (a: number, b: number, c: number, d: number, e: number) => void;
+export const wrapminiscript_fromBitcoinScriptExt: (a: number, b: number, c: number, d: number, e: number, f: number) => void;
+export const wrapminiscript_fromString: (a: number, b: number, c: number, d: number, e: number) => void;
+export const wrapminiscript_fromStringExt: (a: number, b: number, c: number, d: number, e: number, f: number) => void;
+export const wrapminiscript_node: (a: number, b: number) => void;
+export const wrapminiscript_toAsmString: (a: number, b: number) => void;
+export const wrapminiscript_toString: (a: number, b: number) => void;
 export const __wbg_addressnamespace_free: (a: number, b: number) => void;
 export const __wbg_utxolibcompatnamespace_free: (a: number, b: number) => void;
 export const __wbg_wasmdashtransaction_free: (a: number, b: number) => void;
@@ -15,6 +39,8 @@ export const __wbg_zcashunifiedaddress_free: (a: number, b: number) => void;
 export const __wbg_zcashv6transaction_free: (a: number, b: number) => void;
 export const addressnamespace_from_output_script_with_coin: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => void;
 export const addressnamespace_to_output_script_with_coin: (a: number, b: number, c: number, d: number, e: number, f: number) => void;
+export const isInspectEnabled: () => number;
+export const parsePsbtRawToJson: (a: number, b: number, c: number, d: number, e: number) => void;
 export const utxolibcompatnamespace_from_output_script: (a: number, b: number, c: number, d: number, e: number, f: number) => void;
 export const utxolibcompatnamespace_to_output_script: (a: number, b: number, c: number, d: number, e: number, f: number) => void;
 export const wasmdashtransaction_from_bytes: (a: number, b: number, c: number) => void;
@@ -111,48 +137,35 @@ export const wasmtransaction_input_count: (a: number) => number;
 export const wasmtransaction_output_count: (a: number) => number;
 export const wasmzcashtransaction_input_count: (a: number) => number;
 export const wasmzcashtransaction_output_count: (a: number) => number;
+export const parsePsbtToJson: (a: number, b: number, c: number, d: number, e: number) => void;
+export const parseTxToJson: (a: number, b: number, c: number, d: number, e: number) => void;
 export const wasmtransaction_lock_time: (a: number) => number;
 export const wasmtransaction_version: (a: number) => number;
 export const wasmzcashtransaction_lock_time: (a: number) => number;
 export const wasmzcashtransaction_version: (a: number) => number;
 export const wrappsbt_lock_time: (a: number) => number;
 export const wrappsbt_version: (a: number) => number;
-export const __wbg_wrapdescriptor_free: (a: number, b: number) => void;
-export const __wbg_wrapminiscript_free: (a: number, b: number) => void;
-export const wrapdescriptor_atDerivationIndex: (a: number, b: number, c: number) => void;
-export const wrapdescriptor_descType: (a: number, b: number) => void;
-export const wrapdescriptor_encode: (a: number, b: number) => void;
-export const wrapdescriptor_fromString: (a: number, b: number, c: number, d: number, e: number) => void;
-export const wrapdescriptor_fromStringDetectType: (a: number, b: number, c: number) => void;
-export const wrapdescriptor_fromStringExt: (a: number, b: number, c: number, d: number, e: number, f: number) => void;
-export const wrapdescriptor_hasWildcard: (a: number) => number;
-export const wrapdescriptor_maxWeightToSatisfy: (a: number, b: number) => void;
-export const wrapdescriptor_node: (a: number, b: number) => void;
-export const wrapdescriptor_scriptPubkey: (a: number, b: number) => void;
-export const wrapdescriptor_toAsmString: (a: number, b: number) => void;
-export const wrapdescriptor_toString: (a: number, b: number) => void;
-export const wrapminiscript_encode: (a: number, b: number) => void;
-export const wrapminiscript_fromBitcoinScript: (a: number, b: number, c: number, d: number, e: number) => void;
-export const wrapminiscript_fromBitcoinScriptExt: (a: number, b: number, c: number, d: number, e: number, f: number) => void;
-export const wrapminiscript_fromString: (a: number, b: number, c: number, d: number, e: number) => void;
-export const wrapminiscript_fromStringExt: (a: number, b: number, c: number, d: number, e: number, f: number) => void;
-export const wrapminiscript_node: (a: number, b: number) => void;
-export const wrapminiscript_toAsmString: (a: number, b: number) => void;
-export const wrapminiscript_toString: (a: number, b: number) => void;
-export const __wbg_inscriptionsnamespace_free: (a: number, b: number) => void;
 export const __wbg_messagenamespace_free: (a: number, b: number) => void;
-export const inscriptionsnamespace_create_inscription_reveal_data: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => void;
-export const inscriptionsnamespace_sign_reveal_transaction: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: bigint) => void;
+export const __wbg_wasmecpair_free: (a: number, b: number) => void;
 export const messagenamespace_sign_message: (a: number, b: number, c: number, d: number) => void;
 export const messagenamespace_verify_message: (a: number, b: number, c: number, d: number, e: number, f: number) => void;
+export const wasmecpair_from_private_key: (a: number, b: number, c: number) => void;
+export const wasmecpair_from_public_key: (a: number, b: number, c: number) => void;
+export const wasmecpair_from_wif: (a: number, b: number, c: number) => void;
+export const wasmecpair_from_wif_mainnet: (a: number, b: number, c: number) => void;
+export const wasmecpair_from_wif_testnet: (a: number, b: number, c: number) => void;
+export const wasmecpair_private_key: (a: number) => number;
+export const wasmecpair_public_key: (a: number) => number;
+export const wasmecpair_to_wif: (a: number, b: number) => void;
+export const wasmecpair_to_wif_mainnet: (a: number, b: number) => void;
+export const wasmecpair_to_wif_testnet: (a: number, b: number) => void;
 export const __wbg_bip322namespace_free: (a: number, b: number) => void;
 export const __wbg_bitgopsbt_free: (a: number, b: number) => void;
 export const __wbg_fixedscriptwalletnamespace_free: (a: number, b: number) => void;
+export const __wbg_inscriptionsnamespace_free: (a: number, b: number) => void;
 export const __wbg_wasmbip32_free: (a: number, b: number) => void;
 export const __wbg_wasmdimensions_free: (a: number, b: number) => void;
-export const __wbg_wasmecpair_free: (a: number, b: number) => void;
 export const __wbg_wasmrootwalletkeys_free: (a: number, b: number) => void;
-export const __wbg_wasmutxonamespace_free: (a: number, b: number) => void;
 export const bip322namespace_add_bip322_input: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number, k: number, l: number, m: number) => void;
 export const bip322namespace_get_bip322_message: (a: number, b: number, c: number) => void;
 export const bip322namespace_verify_bip322_psbt_input: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number) => void;
@@ -161,7 +174,8 @@ export const bip322namespace_verify_bip322_tx_input: (a: number, b: number, c: n
 export const bip322namespace_verify_bip322_tx_input_with_pubkeys: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number, k: number, l: number) => void;
 export const bitgopsbt_add_input: (a: number, b: number, c: number, d: number, e: number, f: bigint, g: number, h: number, i: number, j: number, k: number) => void;
 export const bitgopsbt_add_input_at_index: (a: number, b: number, c: number, d: number, e: number, f: number, g: bigint, h: number, i: number, j: number, k: number, l: number) => void;
-export const bitgopsbt_add_ironwood_output: (a: number, b: number, c: number, d: number, e: bigint, f: number, g: number, h: number, i: number, j: number, k: number) => void;
+export const bitgopsbt_add_ironwood_output: (a: number, b: number, c: number, d: number, e: bigint, f: number, g: number, h: number, i: number, j: number, k: number, l: number, m: number) => void;
+export const bitgopsbt_add_ironwood_outputs: (a: number, b: number, c: number, d: number, e: number) => void;
 export const bitgopsbt_add_ironwood_v6_signature: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => void;
 export const bitgopsbt_add_output: (a: number, b: number, c: number, d: number, e: bigint) => void;
 export const bitgopsbt_add_output_at_index: (a: number, b: number, c: number, d: number, e: number, f: bigint) => void;
@@ -252,8 +266,8 @@ export const fixedscriptwalletnamespace_output_script_with_network_str: (a: numb
 export const fixedscriptwalletnamespace_p2sh_p2pk_output_script: (a: number, b: number, c: number) => void;
 export const fixedscriptwalletnamespace_supports_script_type: (a: number, b: number, c: number, d: number, e: number) => void;
 export const fixedscriptwalletnamespace_to_wallet_keys: (a: number, b: number, c: number, d: number, e: number) => void;
-export const isInspectEnabled: () => number;
-export const parsePsbtRawToJson: (a: number, b: number, c: number, d: number, e: number) => void;
+export const inscriptionsnamespace_create_inscription_reveal_data: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => void;
+export const inscriptionsnamespace_sign_reveal_transaction: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: bigint) => void;
 export const wasmbip32_chain_code: (a: number) => number;
 export const wasmbip32_depth: (a: number) => number;
 export const wasmbip32_derive: (a: number, b: number, c: number) => void;
@@ -291,28 +305,15 @@ export const wasmdimensions_get_weight: (a: number, b: number, c: number) => num
 export const wasmdimensions_has_segwit: (a: number) => number;
 export const wasmdimensions_plus: (a: number, b: number) => number;
 export const wasmdimensions_times: (a: number, b: number) => number;
-export const wasmecpair_from_private_key: (a: number, b: number, c: number) => void;
-export const wasmecpair_from_public_key: (a: number, b: number, c: number) => void;
-export const wasmecpair_from_wif: (a: number, b: number, c: number) => void;
-export const wasmecpair_from_wif_mainnet: (a: number, b: number, c: number) => void;
-export const wasmecpair_from_wif_testnet: (a: number, b: number, c: number) => void;
-export const wasmecpair_private_key: (a: number) => number;
-export const wasmecpair_public_key: (a: number) => number;
-export const wasmecpair_to_wif: (a: number, b: number) => void;
-export const wasmecpair_to_wif_mainnet: (a: number, b: number) => void;
-export const wasmecpair_to_wif_testnet: (a: number, b: number) => void;
 export const wasmrootwalletkeys_backup_key: (a: number) => number;
 export const wasmrootwalletkeys_bitgo_key: (a: number) => number;
 export const wasmrootwalletkeys_new: (a: number, b: number, c: number, d: number) => void;
 export const wasmrootwalletkeys_user_key: (a: number) => number;
 export const wasmrootwalletkeys_with_derivation_prefixes: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number) => void;
-export const wasmutxonamespace_get_wasm_utxo_version: (a: number) => void;
 export const wasmbip32_from_bip32_properties: (a: number, b: number) => void;
-export const parsePsbtToJson: (a: number, b: number, c: number, d: number, e: number) => void;
-export const parseTxToJson: (a: number, b: number, c: number, d: number, e: number) => void;
+export const bitgopsbt_sign_replay_protection_inputs: (a: number, b: number, c: number) => void;
 export const bitgopsbt_sign_wallet_input: (a: number, b: number, c: number, d: number) => void;
 export const bitgopsbt_sign_all_with_xpriv: (a: number, b: number, c: number) => void;
-export const bitgopsbt_sign_replay_protection_inputs: (a: number, b: number, c: number) => void;
 export const rustsecp256k1_v0_10_0_context_create: (a: number) => number;
 export const rustsecp256k1_v0_10_0_context_destroy: (a: number) => void;
 export const rustsecp256k1_v0_10_0_default_error_callback_fn: (a: number, b: number) => void;

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

@@ -40,20 +40,10 @@ export type ParsedOutput = {
     paygo: boolean;
     /** Full BIP32 derivation path from the wallet xpub (e.g. "0/1"). Null for external outputs. */
     derivationPath: string | null;
-    /**
-     * True for a shielded (Orchard/Ironwood) output. Such an output has no `unsigned_tx` entry of
-     * its own — it lives in the PSBT's proprietary-map PCZT, read from its plaintext (not
-     * encrypted/decrypted) recipient field. `address` is a single-receiver ZIP-316 unified address
-     * (`u1...`/`utest1...`) encoding that receiver — a real, usable Zcash address, though not
-     * necessarily byte-identical to whatever multi-receiver UA the sender originally pasted in (a
-     * UA with a transparent/Sapling receiver too would round-trip to a different string carrying
-     * only the Orchard one). `script` holds the same receiver as raw 43 bytes.
-     */
-    isShielded: boolean;
 };
-export type ParsedTransaction = {
+export type ParsedTransaction<TOutput extends ParsedOutput = ParsedOutput> = {
     inputs: ParsedInput[];
-    outputs: ParsedOutput[];
+    outputs: TOutput[];
     spendAmount: bigint;
     minerFee: bigint;
     virtualSize: number;
@@ -123,7 +113,7 @@ export type HydrationUnspent = {
     pubkey: Uint8Array;
     value: bigint;
 };
-export declare class BitGoPsbt extends PsbtBase<WasmBitGoPsbt> implements IPsbtWithAddress {
+export declare class BitGoPsbt<TOutput extends ParsedOutput = ParsedOutput> extends PsbtBase<WasmBitGoPsbt> implements IPsbtWithAddress {
     protected constructor(wasm: WasmBitGoPsbt);
     /**
      * Get the underlying WASM instance
@@ -339,7 +329,7 @@ export declare class BitGoPsbt extends PsbtBase<WasmBitGoPsbt> implements IPsbtW
      * @param options.payGoPubkeys - Optional public keys for PayGo attestation verification
      * @returns Parsed transaction information
      */
-    parseTransactionWithWalletKeys(walletKeys: WalletKeysArg, options: ParseTransactionOptions): ParsedTransaction;
+    parseTransactionWithWalletKeys(walletKeys: WalletKeysArg, options: ParseTransactionOptions): ParsedTransaction<TOutput>;
     /**
      * Parse outputs with wallet keys to identify which outputs belong to a wallet
      * with the given wallet keys.
@@ -353,7 +343,7 @@ export declare class BitGoPsbt extends PsbtBase<WasmBitGoPsbt> implements IPsbtW
      * @returns Array of parsed outputs
      * @note This method does NOT validate wallet inputs. It only parses outputs.
      */
-    parseOutputsWithWalletKeys(walletKeys: WalletKeysArg, options?: ParseOutputsOptions): ParsedOutput[];
+    parseOutputsWithWalletKeys(walletKeys: WalletKeysArg, options?: ParseOutputsOptions): TOutput[];
     /**
      * Add a PayGo attestation to a PSBT output
      *

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

@@ -1,8 +1,20 @@
 import { type WalletKeysArg } from "./RootWalletKeys.js";
-import { BitGoPsbt, type CreateEmptyOptions, type HydrationUnspent } from "./BitGoPsbt.js";
+import { BitGoPsbt, type CreateEmptyOptions, type HydrationUnspent, type ParsedOutput } from "./BitGoPsbt.js";
 import { ZcashTransaction, type ITransaction } from "../transaction.js";
 /** Zcash network names */
 export type ZcashNetworkName = "zcash" | "zcashTest" | "zec" | "tzec";
+export type ZcashParsedOutput = ParsedOutput & {
+    /**
+     * True for a shielded (Orchard/Ironwood) output. Such an output has no `unsigned_tx` entry of
+     * its own — it lives in the PSBT's proprietary-map PCZT, read from its plaintext (not
+     * encrypted/decrypted) recipient field. `address` is a single-receiver ZIP-316 unified address
+     * (`u1...`/`utest1...`) encoding that receiver — a real, usable Zcash address, though not
+     * necessarily byte-identical to whatever multi-receiver UA the sender originally pasted in (a
+     * UA with a transparent/Sapling receiver too would round-trip to a different string carrying
+     * only the Orchard one). `script` holds the same receiver as raw 43 bytes.
+     */
+    isShielded: boolean;
+};
 /**
  * Zcash v6 (Ironwood) version group id (0xd884b698). Its presence marks a PSBT as v6 — see
  * `ZcashIronwoodBitGoPsbt`.
@@ -52,7 +64,7 @@ export type CreateEmptyZcashWithConsensusBranchIdOptions = CreateEmptyOptions &
  * const psbt = ZcashBitGoPsbt.fromBytes(bytes, "zcash");
  * ```
  */
-export declare class ZcashBitGoPsbt extends BitGoPsbt {
+export declare class ZcashBitGoPsbt extends BitGoPsbt<ZcashParsedOutput> {
     /**
      * Create an empty Zcash PSBT with consensus branch ID determined from block height
      *

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

@@ -1,6 +1,6 @@
 import { BitGoPsbt as WasmBitGoPsbt, zcash_branch_id_for_height, zcash_ironwood_version_group_id, } from "../wasm/wasm_utxo.js";
 import { RootWalletKeys } from "./RootWalletKeys.js";
-import { BitGoPsbt } from "./BitGoPsbt.js";
+import { BitGoPsbt, } from "./BitGoPsbt.js";
 import { ZcashTransaction } from "../transaction.js";
 /**
  * Zcash v6 (Ironwood) version group id (0xd884b698). Its presence marks a PSBT as v6 — see

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

@@ -133,12 +133,40 @@ export declare class ZcashIronwoodBitGoPsbt extends ZcashBitGoPsbt {
      * @param options.anchor - 32-byte Ironwood note-commitment-tree root
      * @param options.memo - optional 512-byte memo (defaults to the ZIP-302 "no memo" encoding)
      * @param options.ovk - optional 32-byte outgoing viewing key (omit for a keyless build)
+     * @param options.unifiedAddress - optional full Unified Address string this output was addressed
+     *   to. Its Orchard receiver must equal `recipient`. The PCZT itself only carries the raw 43-byte
+     *   receiver — a lossy encoding for a multi-receiver UA, since any transparent/Sapling receiver
+     *   can't be recovered from it — so passing this stores the original UA verbatim, letting a later
+     *   `parseOutputsWithWalletKeys`/`parseTransactionWithWalletKeys` (even after a
+     *   serialize/deserialize round-trip) return it in full instead of a re-encoded single-receiver UA.
      */
     addShieldedOutput(recipient: Uint8Array, amount: bigint, options: {
         anchor: Uint8Array;
         memo?: Uint8Array;
         ovk?: Uint8Array;
+        unifiedAddress?: string;
     }): void;
+    /**
+     * Add one or more shielded outputs (Constructor role) as a single orchard PCZT — the
+     * multi-recipient counterpart to {@link addShieldedOutput}. Every recipient must be passed in
+     * one call: only one call to `addShieldedOutput`/`addShieldedOutputs` is supported per PSBT (see
+     * {@link addShieldedOutput}).
+     *
+     * @param outputs - one entry per recipient; `memo` defaults per-entry to the ZIP-302 "no memo"
+     *   encoding, exactly as {@link addShieldedOutput}'s does
+     * @param anchor - 32-byte Ironwood note-commitment-tree root, shared by every output
+     * @returns the action index assigned to each output, in the same order as `outputs` — the
+     *   orchard builder pads/reorders actions, so a client-managed-`ovk` caller must use these
+     *   indices (not the position in `outputs`) when later calling
+     *   `setIronwoodOutCiphertext`/`setIronwoodOutCiphertextForUser` for a specific recipient.
+     */
+    addShieldedOutputs(outputs: Array<{
+        recipient: Uint8Array;
+        amount: bigint;
+        memo?: Uint8Array;
+        ovk?: Uint8Array;
+        unifiedAddress?: string;
+    }>, anchor: Uint8Array): number[];
     /**
      * Client-managed `ovk`: re-encrypt the shielded output's `out_ciphertext` under **this wallet's**
      * `ovk`, derived as the ECDH agreement of `rootWalletKeys.bitgoKey()` and `userKey`. Both are root

package/dist/esm/js/fixedScriptWallet/ZcashIronwoodBitGoPsbt.js

@@ -128,10 +128,39 @@ export class ZcashIronwoodBitGoPsbt extends ZcashBitGoPsbt {
      * @param options.anchor - 32-byte Ironwood note-commitment-tree root
      * @param options.memo - optional 512-byte memo (defaults to the ZIP-302 "no memo" encoding)
      * @param options.ovk - optional 32-byte outgoing viewing key (omit for a keyless build)
+     * @param options.unifiedAddress - optional full Unified Address string this output was addressed
+     *   to. Its Orchard receiver must equal `recipient`. The PCZT itself only carries the raw 43-byte
+     *   receiver — a lossy encoding for a multi-receiver UA, since any transparent/Sapling receiver
+     *   can't be recovered from it — so passing this stores the original UA verbatim, letting a later
+     *   `parseOutputsWithWalletKeys`/`parseTransactionWithWalletKeys` (even after a
+     *   serialize/deserialize round-trip) return it in full instead of a re-encoded single-receiver UA.
      */
     addShieldedOutput(recipient, amount, options) {
         const memo = options.memo ?? zip302NoMemo();
-        this.wasm.add_ironwood_output(recipient, amount, options.ovk, options.anchor, memo);
+        this.wasm.add_ironwood_output(recipient, amount, options.ovk, options.anchor, memo, options.unifiedAddress);
+    }
+    /**
+     * Add one or more shielded outputs (Constructor role) as a single orchard PCZT — the
+     * multi-recipient counterpart to {@link addShieldedOutput}. Every recipient must be passed in
+     * one call: only one call to `addShieldedOutput`/`addShieldedOutputs` is supported per PSBT (see
+     * {@link addShieldedOutput}).
+     *
+     * @param outputs - one entry per recipient; `memo` defaults per-entry to the ZIP-302 "no memo"
+     *   encoding, exactly as {@link addShieldedOutput}'s does
+     * @param anchor - 32-byte Ironwood note-commitment-tree root, shared by every output
+     * @returns the action index assigned to each output, in the same order as `outputs` — the
+     *   orchard builder pads/reorders actions, so a client-managed-`ovk` caller must use these
+     *   indices (not the position in `outputs`) when later calling
+     *   `setIronwoodOutCiphertext`/`setIronwoodOutCiphertextForUser` for a specific recipient.
+     */
+    addShieldedOutputs(outputs, anchor) {
+        return Array.from(this.wasm.add_ironwood_outputs(outputs.map((o) => ({
+            recipient: o.recipient,
+            amount: o.amount,
+            memo: o.memo ?? zip302NoMemo(),
+            ovk: o.ovk,
+            unifiedAddress: o.unifiedAddress,
+        })), anchor));
     }
     /**
      * Client-managed `ovk`: re-encrypt the shielded output's `out_ciphertext` under **this wallet's**

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

@@ -8,7 +8,7 @@ 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, IRONWOOD_VERSION_GROUP_ID, } from "./ZcashBitGoPsbt.js";
+export { ZcashBitGoPsbt, type ZcashNetworkName, type ZcashParsedOutput, type CreateEmptyZcashOptions, IRONWOOD_VERSION_GROUP_ID, } from "./ZcashBitGoPsbt.js";
 export { ZcashIronwoodBitGoPsbt, zip302NoMemo, type CreateEmptyIronwoodOptions, type CreateEmptyIronwoodWithConsensusBranchIdOptions, } from "./ZcashIronwoodBitGoPsbt.js";
 export { ZcashUnifiedAddress } from "./ZcashUnifiedAddress.js";
 export { ZcashV6Transaction } from "./ZcashV6Transaction.js";

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

@@ -150,13 +150,32 @@ export class BitGoPsbt {
      * * `ovk` - optional outgoing viewing key ([`OVK_SIZE`] bytes; `None` for a keyless build)
      * * `anchor` - Ironwood note-commitment-tree root ([`ANCHOR_SIZE`] bytes)
      * * `memo` - ZIP-302 memo field ([`MEMO_SIZE`] bytes)
+     * * `unified_address` - optional full Unified Address the output was addressed to; if given,
+     *   its Orchard receiver must match `recipient`, and it is stored verbatim so output parsing
+     *   can later return it in full (transparent/Sapling receivers included) instead of
+     *   reconstructing a single-receiver UA from `recipient` alone
      *
      * [`ORCHARD_ADDRESS_SIZE`]: crate::zcash::ironwood_build::ORCHARD_ADDRESS_SIZE
      * [`OVK_SIZE`]: crate::zcash::ironwood_build::OVK_SIZE
      * [`ANCHOR_SIZE`]: crate::zcash::ironwood_build::ANCHOR_SIZE
      * [`MEMO_SIZE`]: crate::zcash::ironwood_build::MEMO_SIZE
      */
-    add_ironwood_output(recipient: Uint8Array, amount: bigint, ovk: Uint8Array | null | undefined, anchor: Uint8Array, memo: Uint8Array): void;
+    add_ironwood_output(recipient: Uint8Array, amount: bigint, ovk: Uint8Array | null | undefined, anchor: Uint8Array, memo: Uint8Array, unified_address?: string | null): void;
+    /**
+     * Constructor: add one or more shielded Ironwood outputs as a single orchard PCZT stored in
+     * the PSBT — the multi-recipient counterpart to [`Self::add_ironwood_output`].
+     *
+     * `outputs` is an array of `{ recipient: Uint8Array, amount: bigint, memo: Uint8Array,
+     * ovk?: Uint8Array, unifiedAddress?: string }`, one entry per recipient — see
+     * [`Self::add_ironwood_output`] for the meaning of each field. `anchor` is shared by every
+     * output.
+     *
+     * Returns the action index assigned to each output, in the same order as `outputs` — the
+     * orchard builder pads/reorders actions, so a client-managed-`ovk` caller must use these
+     * indices (not the position in `outputs`) when later calling `set_ironwood_out_ciphertext`
+     * for a specific recipient.
+     */
+    add_ironwood_outputs(outputs: any, anchor: Uint8Array): Uint32Array;
     /**
      * Ingest a transparent-input signature (`sig`: DER ECDSA with the trailing SIGHASH_ALL byte)
      * after verifying it against `ironwood_v6_transparent_sighash(index)`.

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

@@ -478,6 +478,10 @@ export class BitGoPsbt {
      * * `ovk` - optional outgoing viewing key ([`OVK_SIZE`] bytes; `None` for a keyless build)
      * * `anchor` - Ironwood note-commitment-tree root ([`ANCHOR_SIZE`] bytes)
      * * `memo` - ZIP-302 memo field ([`MEMO_SIZE`] bytes)
+     * * `unified_address` - optional full Unified Address the output was addressed to; if given,
+     *   its Orchard receiver must match `recipient`, and it is stored verbatim so output parsing
+     *   can later return it in full (transparent/Sapling receivers included) instead of
+     *   reconstructing a single-receiver UA from `recipient` alone
      *
      * [`ORCHARD_ADDRESS_SIZE`]: crate::zcash::ironwood_build::ORCHARD_ADDRESS_SIZE
      * [`OVK_SIZE`]: crate::zcash::ironwood_build::OVK_SIZE
@@ -488,8 +492,9 @@ export class BitGoPsbt {
      * @param {Uint8Array | null | undefined} ovk
      * @param {Uint8Array} anchor
      * @param {Uint8Array} memo
+     * @param {string | null} [unified_address]
      */
-    add_ironwood_output(recipient, amount, ovk, anchor, memo) {
+    add_ironwood_output(recipient, amount, ovk, anchor, memo, unified_address) {
         try {
             const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
             const ptr0 = passArray8ToWasm0(recipient, wasm.__wbindgen_export);
@@ -500,7 +505,9 @@ export class BitGoPsbt {
             const len2 = WASM_VECTOR_LEN;
             const ptr3 = passArray8ToWasm0(memo, wasm.__wbindgen_export);
             const len3 = WASM_VECTOR_LEN;
-            wasm.bitgopsbt_add_ironwood_output(retptr, this.__wbg_ptr, ptr0, len0, amount, ptr1, len1, ptr2, len2, ptr3, len3);
+            var ptr4 = isLikeNone(unified_address) ? 0 : passStringToWasm0(unified_address, wasm.__wbindgen_export, wasm.__wbindgen_export2);
+            var len4 = WASM_VECTOR_LEN;
+            wasm.bitgopsbt_add_ironwood_output(retptr, this.__wbg_ptr, ptr0, len0, amount, ptr1, len1, ptr2, len2, ptr3, len3, ptr4, len4);
             var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
             var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
             if (r1) {
@@ -510,6 +517,43 @@ export class BitGoPsbt {
             wasm.__wbindgen_add_to_stack_pointer(16);
         }
     }
+    /**
+     * Constructor: add one or more shielded Ironwood outputs as a single orchard PCZT stored in
+     * the PSBT — the multi-recipient counterpart to [`Self::add_ironwood_output`].
+     *
+     * `outputs` is an array of `{ recipient: Uint8Array, amount: bigint, memo: Uint8Array,
+     * ovk?: Uint8Array, unifiedAddress?: string }`, one entry per recipient — see
+     * [`Self::add_ironwood_output`] for the meaning of each field. `anchor` is shared by every
+     * output.
+     *
+     * Returns the action index assigned to each output, in the same order as `outputs` — the
+     * orchard builder pads/reorders actions, so a client-managed-`ovk` caller must use these
+     * indices (not the position in `outputs`) when later calling `set_ironwood_out_ciphertext`
+     * for a specific recipient.
+     * @param {any} outputs
+     * @param {Uint8Array} anchor
+     * @returns {Uint32Array}
+     */
+    add_ironwood_outputs(outputs, anchor) {
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            const ptr0 = passArray8ToWasm0(anchor, wasm.__wbindgen_export);
+            const len0 = WASM_VECTOR_LEN;
+            wasm.bitgopsbt_add_ironwood_outputs(retptr, this.__wbg_ptr, addHeapObject(outputs), ptr0, len0);
+            var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+            var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+            var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
+            var r3 = getDataViewMemory0().getInt32(retptr + 4 * 3, true);
+            if (r3) {
+                throw takeObject(r2);
+            }
+            var v2 = getArrayU32FromWasm0(r0, r1).slice();
+            wasm.__wbindgen_export4(r0, r1 * 4, 4);
+            return v2;
+        } finally {
+            wasm.__wbindgen_add_to_stack_pointer(16);
+        }
+    }
     /**
      * Ingest a transparent-input signature (`sig`: DER ECDSA with the trailing SIGHASH_ALL byte)
      * after verifying it against `ironwood_v6_transparent_sighash(index)`.
@@ -7134,6 +7178,10 @@ export function __wbg___wbindgen_debug_string_0bc8482c6e3508ae(arg0, arg1) {
     getDataViewMemory0().setInt32(arg0 + 4 * 1, len1, true);
     getDataViewMemory0().setInt32(arg0 + 4 * 0, ptr1, true);
 }
+export function __wbg___wbindgen_is_bigint_31b12575b56f32fc(arg0) {
+    const ret = typeof(getObject(arg0)) === 'bigint';
+    return ret;
+}
 export function __wbg___wbindgen_is_function_0095a73b8b156f76(arg0) {
     const ret = typeof(getObject(arg0)) === 'function';
     return ret;

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

@@ -5,6 +5,30 @@ export const __wbg_wasmreplayprotection_free: (a: number, b: number) => void;
 export const wasmreplayprotection_from_addresses: (a: number, b: number, c: number, d: number, e: number) => void;
 export const wasmreplayprotection_from_output_scripts: (a: number, b: number) => number;
 export const wasmreplayprotection_from_public_keys: (a: number, b: number, c: number) => void;
+export const __wbg_wasmutxonamespace_free: (a: number, b: number) => void;
+export const __wbg_wrapdescriptor_free: (a: number, b: number) => void;
+export const __wbg_wrapminiscript_free: (a: number, b: number) => void;
+export const wasmutxonamespace_get_wasm_utxo_version: (a: number) => void;
+export const wrapdescriptor_atDerivationIndex: (a: number, b: number, c: number) => void;
+export const wrapdescriptor_descType: (a: number, b: number) => void;
+export const wrapdescriptor_encode: (a: number, b: number) => void;
+export const wrapdescriptor_fromString: (a: number, b: number, c: number, d: number, e: number) => void;
+export const wrapdescriptor_fromStringDetectType: (a: number, b: number, c: number) => void;
+export const wrapdescriptor_fromStringExt: (a: number, b: number, c: number, d: number, e: number, f: number) => void;
+export const wrapdescriptor_hasWildcard: (a: number) => number;
+export const wrapdescriptor_maxWeightToSatisfy: (a: number, b: number) => void;
+export const wrapdescriptor_node: (a: number, b: number) => void;
+export const wrapdescriptor_scriptPubkey: (a: number, b: number) => void;
+export const wrapdescriptor_toAsmString: (a: number, b: number) => void;
+export const wrapdescriptor_toString: (a: number, b: number) => void;
+export const wrapminiscript_encode: (a: number, b: number) => void;
+export const wrapminiscript_fromBitcoinScript: (a: number, b: number, c: number, d: number, e: number) => void;
+export const wrapminiscript_fromBitcoinScriptExt: (a: number, b: number, c: number, d: number, e: number, f: number) => void;
+export const wrapminiscript_fromString: (a: number, b: number, c: number, d: number, e: number) => void;
+export const wrapminiscript_fromStringExt: (a: number, b: number, c: number, d: number, e: number, f: number) => void;
+export const wrapminiscript_node: (a: number, b: number) => void;
+export const wrapminiscript_toAsmString: (a: number, b: number) => void;
+export const wrapminiscript_toString: (a: number, b: number) => void;
 export const __wbg_addressnamespace_free: (a: number, b: number) => void;
 export const __wbg_utxolibcompatnamespace_free: (a: number, b: number) => void;
 export const __wbg_wasmdashtransaction_free: (a: number, b: number) => void;
@@ -15,6 +39,8 @@ export const __wbg_zcashunifiedaddress_free: (a: number, b: number) => void;
 export const __wbg_zcashv6transaction_free: (a: number, b: number) => void;
 export const addressnamespace_from_output_script_with_coin: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => void;
 export const addressnamespace_to_output_script_with_coin: (a: number, b: number, c: number, d: number, e: number, f: number) => void;
+export const isInspectEnabled: () => number;
+export const parsePsbtRawToJson: (a: number, b: number, c: number, d: number, e: number) => void;
 export const utxolibcompatnamespace_from_output_script: (a: number, b: number, c: number, d: number, e: number, f: number) => void;
 export const utxolibcompatnamespace_to_output_script: (a: number, b: number, c: number, d: number, e: number, f: number) => void;
 export const wasmdashtransaction_from_bytes: (a: number, b: number, c: number) => void;
@@ -111,48 +137,35 @@ export const wasmtransaction_input_count: (a: number) => number;
 export const wasmtransaction_output_count: (a: number) => number;
 export const wasmzcashtransaction_input_count: (a: number) => number;
 export const wasmzcashtransaction_output_count: (a: number) => number;
+export const parsePsbtToJson: (a: number, b: number, c: number, d: number, e: number) => void;
+export const parseTxToJson: (a: number, b: number, c: number, d: number, e: number) => void;
 export const wasmtransaction_lock_time: (a: number) => number;
 export const wasmtransaction_version: (a: number) => number;
 export const wasmzcashtransaction_lock_time: (a: number) => number;
 export const wasmzcashtransaction_version: (a: number) => number;
 export const wrappsbt_lock_time: (a: number) => number;
 export const wrappsbt_version: (a: number) => number;
-export const __wbg_wrapdescriptor_free: (a: number, b: number) => void;
-export const __wbg_wrapminiscript_free: (a: number, b: number) => void;
-export const wrapdescriptor_atDerivationIndex: (a: number, b: number, c: number) => void;
-export const wrapdescriptor_descType: (a: number, b: number) => void;
-export const wrapdescriptor_encode: (a: number, b: number) => void;
-export const wrapdescriptor_fromString: (a: number, b: number, c: number, d: number, e: number) => void;
-export const wrapdescriptor_fromStringDetectType: (a: number, b: number, c: number) => void;
-export const wrapdescriptor_fromStringExt: (a: number, b: number, c: number, d: number, e: number, f: number) => void;
-export const wrapdescriptor_hasWildcard: (a: number) => number;
-export const wrapdescriptor_maxWeightToSatisfy: (a: number, b: number) => void;
-export const wrapdescriptor_node: (a: number, b: number) => void;
-export const wrapdescriptor_scriptPubkey: (a: number, b: number) => void;
-export const wrapdescriptor_toAsmString: (a: number, b: number) => void;
-export const wrapdescriptor_toString: (a: number, b: number) => void;
-export const wrapminiscript_encode: (a: number, b: number) => void;
-export const wrapminiscript_fromBitcoinScript: (a: number, b: number, c: number, d: number, e: number) => void;
-export const wrapminiscript_fromBitcoinScriptExt: (a: number, b: number, c: number, d: number, e: number, f: number) => void;
-export const wrapminiscript_fromString: (a: number, b: number, c: number, d: number, e: number) => void;
-export const wrapminiscript_fromStringExt: (a: number, b: number, c: number, d: number, e: number, f: number) => void;
-export const wrapminiscript_node: (a: number, b: number) => void;
-export const wrapminiscript_toAsmString: (a: number, b: number) => void;
-export const wrapminiscript_toString: (a: number, b: number) => void;
-export const __wbg_inscriptionsnamespace_free: (a: number, b: number) => void;
 export const __wbg_messagenamespace_free: (a: number, b: number) => void;
-export const inscriptionsnamespace_create_inscription_reveal_data: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => void;
-export const inscriptionsnamespace_sign_reveal_transaction: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: bigint) => void;
+export const __wbg_wasmecpair_free: (a: number, b: number) => void;
 export const messagenamespace_sign_message: (a: number, b: number, c: number, d: number) => void;
 export const messagenamespace_verify_message: (a: number, b: number, c: number, d: number, e: number, f: number) => void;
+export const wasmecpair_from_private_key: (a: number, b: number, c: number) => void;
+export const wasmecpair_from_public_key: (a: number, b: number, c: number) => void;
+export const wasmecpair_from_wif: (a: number, b: number, c: number) => void;
+export const wasmecpair_from_wif_mainnet: (a: number, b: number, c: number) => void;
+export const wasmecpair_from_wif_testnet: (a: number, b: number, c: number) => void;
+export const wasmecpair_private_key: (a: number) => number;
+export const wasmecpair_public_key: (a: number) => number;
+export const wasmecpair_to_wif: (a: number, b: number) => void;
+export const wasmecpair_to_wif_mainnet: (a: number, b: number) => void;
+export const wasmecpair_to_wif_testnet: (a: number, b: number) => void;
 export const __wbg_bip322namespace_free: (a: number, b: number) => void;
 export const __wbg_bitgopsbt_free: (a: number, b: number) => void;
 export const __wbg_fixedscriptwalletnamespace_free: (a: number, b: number) => void;
+export const __wbg_inscriptionsnamespace_free: (a: number, b: number) => void;
 export const __wbg_wasmbip32_free: (a: number, b: number) => void;
 export const __wbg_wasmdimensions_free: (a: number, b: number) => void;
-export const __wbg_wasmecpair_free: (a: number, b: number) => void;
 export const __wbg_wasmrootwalletkeys_free: (a: number, b: number) => void;
-export const __wbg_wasmutxonamespace_free: (a: number, b: number) => void;
 export const bip322namespace_add_bip322_input: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number, k: number, l: number, m: number) => void;
 export const bip322namespace_get_bip322_message: (a: number, b: number, c: number) => void;
 export const bip322namespace_verify_bip322_psbt_input: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number) => void;
@@ -161,7 +174,8 @@ export const bip322namespace_verify_bip322_tx_input: (a: number, b: number, c: n
 export const bip322namespace_verify_bip322_tx_input_with_pubkeys: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number, k: number, l: number) => void;
 export const bitgopsbt_add_input: (a: number, b: number, c: number, d: number, e: number, f: bigint, g: number, h: number, i: number, j: number, k: number) => void;
 export const bitgopsbt_add_input_at_index: (a: number, b: number, c: number, d: number, e: number, f: number, g: bigint, h: number, i: number, j: number, k: number, l: number) => void;
-export const bitgopsbt_add_ironwood_output: (a: number, b: number, c: number, d: number, e: bigint, f: number, g: number, h: number, i: number, j: number, k: number) => void;
+export const bitgopsbt_add_ironwood_output: (a: number, b: number, c: number, d: number, e: bigint, f: number, g: number, h: number, i: number, j: number, k: number, l: number, m: number) => void;
+export const bitgopsbt_add_ironwood_outputs: (a: number, b: number, c: number, d: number, e: number) => void;
 export const bitgopsbt_add_ironwood_v6_signature: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => void;
 export const bitgopsbt_add_output: (a: number, b: number, c: number, d: number, e: bigint) => void;
 export const bitgopsbt_add_output_at_index: (a: number, b: number, c: number, d: number, e: number, f: bigint) => void;
@@ -252,8 +266,8 @@ export const fixedscriptwalletnamespace_output_script_with_network_str: (a: numb
 export const fixedscriptwalletnamespace_p2sh_p2pk_output_script: (a: number, b: number, c: number) => void;
 export const fixedscriptwalletnamespace_supports_script_type: (a: number, b: number, c: number, d: number, e: number) => void;
 export const fixedscriptwalletnamespace_to_wallet_keys: (a: number, b: number, c: number, d: number, e: number) => void;
-export const isInspectEnabled: () => number;
-export const parsePsbtRawToJson: (a: number, b: number, c: number, d: number, e: number) => void;
+export const inscriptionsnamespace_create_inscription_reveal_data: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => void;
+export const inscriptionsnamespace_sign_reveal_transaction: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: bigint) => void;
 export const wasmbip32_chain_code: (a: number) => number;
 export const wasmbip32_depth: (a: number) => number;
 export const wasmbip32_derive: (a: number, b: number, c: number) => void;
@@ -291,28 +305,15 @@ export const wasmdimensions_get_weight: (a: number, b: number, c: number) => num
 export const wasmdimensions_has_segwit: (a: number) => number;
 export const wasmdimensions_plus: (a: number, b: number) => number;
 export const wasmdimensions_times: (a: number, b: number) => number;
-export const wasmecpair_from_private_key: (a: number, b: number, c: number) => void;
-export const wasmecpair_from_public_key: (a: number, b: number, c: number) => void;
-export const wasmecpair_from_wif: (a: number, b: number, c: number) => void;
-export const wasmecpair_from_wif_mainnet: (a: number, b: number, c: number) => void;
-export const wasmecpair_from_wif_testnet: (a: number, b: number, c: number) => void;
-export const wasmecpair_private_key: (a: number) => number;
-export const wasmecpair_public_key: (a: number) => number;
-export const wasmecpair_to_wif: (a: number, b: number) => void;
-export const wasmecpair_to_wif_mainnet: (a: number, b: number) => void;
-export const wasmecpair_to_wif_testnet: (a: number, b: number) => void;
 export const wasmrootwalletkeys_backup_key: (a: number) => number;
 export const wasmrootwalletkeys_bitgo_key: (a: number) => number;
 export const wasmrootwalletkeys_new: (a: number, b: number, c: number, d: number) => void;
 export const wasmrootwalletkeys_user_key: (a: number) => number;
 export const wasmrootwalletkeys_with_derivation_prefixes: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number) => void;
-export const wasmutxonamespace_get_wasm_utxo_version: (a: number) => void;
 export const wasmbip32_from_bip32_properties: (a: number, b: number) => void;
-export const parsePsbtToJson: (a: number, b: number, c: number, d: number, e: number) => void;
-export const parseTxToJson: (a: number, b: number, c: number, d: number, e: number) => void;
+export const bitgopsbt_sign_replay_protection_inputs: (a: number, b: number, c: number) => void;
 export const bitgopsbt_sign_wallet_input: (a: number, b: number, c: number, d: number) => void;
 export const bitgopsbt_sign_all_with_xpriv: (a: number, b: number, c: number) => void;
-export const bitgopsbt_sign_replay_protection_inputs: (a: number, b: number, c: number) => void;
 export const rustsecp256k1_v0_10_0_context_create: (a: number) => number;
 export const rustsecp256k1_v0_10_0_context_destroy: (a: number) => void;
 export const rustsecp256k1_v0_10_0_default_error_callback_fn: (a: number, b: number) => void;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@bitgo/wasm-utxo",
   "description": "WebAssembly wrapper for rust-bitcoin (beta)",
-  "version": "4.37.1",
+  "version": "4.38.0",
   "type": "module",
   "repository": {
     "type": "git",
@@ -60,7 +60,8 @@
     "./dist/cjs/js/wasm/wasm_utxo.js"
   ],
   "scripts": {
-    "test": "npm run test:mocha && npm run test:wasm-pack && npm run test:imports",
+    "test": "npm run build:test && npm run test:mocha && npm run test:wasm-pack && npm run test:imports",
+    "build:test": "tsc --noEmit --project tsconfig.test.json",
     "test:mocha": "mocha --recursive 'test/**/*.ts'",
     "test:integrationLocalRpc": "mocha --config .mocharc.integrationLocalRpc.json --recursive 'test/integrationLocalRpc/**/*.test.ts'",
     "test:integrationLocalRpc:generate": "tsx --experimental-wasm-modules test/integrationLocalRpc/generate/main.ts",
@@ -76,7 +77,7 @@
     "build:ts-cjs": "tsc --project tsconfig.cjs.json",
     "build:ts": "npm run build:ts-esm && npm run build:ts-cjs",
     "build:package-json": "echo '{\"type\":\"commonjs\"}' > dist/cjs/package.json",
-    "build": "npm run build:wasm && npm run build:ts && npm run build:package-json",
+    "build": "npm run build:wasm && npm run build:ts && npm run build:test && npm run build:package-json",
     "check-fmt": "npm run lint:prettier && npm run lint:rustfmt",
     "lint:prettier": "prettier --check .",
     "lint:eslint": "eslint .",