@bitgo/wasm-utxo 4.39.0 → 4.40.0

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

@@ -198,4 +198,28 @@ export declare class ZcashBitGoPsbt extends BitGoPsbt<ZcashParsedOutput> {
      * @throws Error if the PSBT is not fully finalized or extraction fails
      */
     extractTransaction(maxFeeRate?: number): ZcashTransaction;
+    /**
+     * Add a plain transparent output. Just `script`/`value` (no `unifiedAddress`) is the same as
+     * the generic {@link BitGoPsbt.addOutput}, unchanged.
+     *
+     * If `unifiedAddress` is given, it must be a Unified Address whose transparent receiver is
+     * exactly `script` — mismatches throw rather than being silently stored. It is then kept
+     * verbatim, keyed by this output's index, so {@link ZcashBitGoPsbt.transparentOutputUnifiedAddress}
+     * can later return the original UA string rather than just the bare scriptPubkey.
+     *
+     * `unifiedAddress` is only supported on a legacy v4 `ZcashBitGoPsbt` — the v6 (Ironwood)
+     * shielded side has its own UA path (`ZcashIronwoodBitGoPsbt.addShieldedOutput`'s
+     * `unifiedAddress` option).
+     *
+     * @param script - The output scriptPubkey
+     * @param value - The value in zatoshi
+     * @param unifiedAddress - Optional full Unified Address `script` was resolved from
+     * @returns The index of the newly added output
+     */
+    addTransparentOutput(script: Uint8Array, value: bigint, unifiedAddress?: string): number;
+    /**
+     * The Unified Address stored by {@link ZcashBitGoPsbt.addTransparentOutput} for output `index`,
+     * if one was supplied — `undefined` otherwise.
+     */
+    transparentOutputUnifiedAddress(index: number): string | undefined;
 }

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

@@ -214,5 +214,33 @@ class ZcashBitGoPsbt extends BitGoPsbt_js_1.BitGoPsbt {
     extractTransaction(maxFeeRate) {
         return transaction_js_1.ZcashTransaction.fromWasm(this.wasm.extract_zcash_transaction(maxFeeRate));
     }
+    /**
+     * Add a plain transparent output. Just `script`/`value` (no `unifiedAddress`) is the same as
+     * the generic {@link BitGoPsbt.addOutput}, unchanged.
+     *
+     * If `unifiedAddress` is given, it must be a Unified Address whose transparent receiver is
+     * exactly `script` — mismatches throw rather than being silently stored. It is then kept
+     * verbatim, keyed by this output's index, so {@link ZcashBitGoPsbt.transparentOutputUnifiedAddress}
+     * can later return the original UA string rather than just the bare scriptPubkey.
+     *
+     * `unifiedAddress` is only supported on a legacy v4 `ZcashBitGoPsbt` — the v6 (Ironwood)
+     * shielded side has its own UA path (`ZcashIronwoodBitGoPsbt.addShieldedOutput`'s
+     * `unifiedAddress` option).
+     *
+     * @param script - The output scriptPubkey
+     * @param value - The value in zatoshi
+     * @param unifiedAddress - Optional full Unified Address `script` was resolved from
+     * @returns The index of the newly added output
+     */
+    addTransparentOutput(script, value, unifiedAddress) {
+        return this.wasm.add_transparent_output(script, value, unifiedAddress);
+    }
+    /**
+     * The Unified Address stored by {@link ZcashBitGoPsbt.addTransparentOutput} for output `index`,
+     * if one was supplied — `undefined` otherwise.
+     */
+    transparentOutputUnifiedAddress(index) {
+        return this.wasm.transparent_output_unified_address(index);
+    }
 }
 exports.ZcashBitGoPsbt = ZcashBitGoPsbt;

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

@@ -200,6 +200,18 @@ export class BitGoPsbt {
     add_paygo_attestation(output_index: number, entropy: Uint8Array, signature: Uint8Array): void;
     add_replay_protection_input(ecpair: WasmECPair, txid: string, vout: number, value: bigint, sequence?: number | null, prev_tx?: Uint8Array | null): number;
     add_replay_protection_input_at_index(index: number, ecpair: WasmECPair, txid: string, vout: number, value: bigint, sequence?: number | null, prev_tx?: Uint8Array | null): number;
+    /**
+     * Zcash-only: add a plain transparent output. Just `script`/`value`
+     * (`unified_address: undefined`) is the legacy `add_output` behavior, unchanged.
+     *
+     * If `unified_address` is given, this PSBT must be a legacy v4 Zcash PSBT — a v6 (Ironwood)
+     * PSBT's shielded side already has its own UA path (`add_ironwood_output`). The UA must be a
+     * Unified Address whose transparent receiver is exactly `script`; mismatches are rejected
+     * rather than silently stored. It is then kept verbatim, keyed by this output's index, so
+     * `transparent_output_unified_address` can later return the original UA string rather than
+     * just the bare scriptPubkey.
+     */
+    add_transparent_output(script: Uint8Array, value: bigint, unified_address?: string | null): number;
     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;
     add_wallet_input_at_index(index: number, txid: string, vout: number, value: bigint, wallet_keys: WasmRootWalletKeys, chain: number, derivation_index: number, signer?: string | null, cosigner?: string | null, sequence?: number | null, prev_tx?: Uint8Array | null): number;
     add_wallet_output(chain: number, index: number, value: bigint, wallet_keys: WasmRootWalletKeys): number;
@@ -796,6 +808,12 @@ export class BitGoPsbt {
      * - `Err(WasmUtxoError)` if signing fails
      */
     sign_with_xpriv(input_index: number, xpriv: WasmBIP32): void;
+    /**
+     * Zcash-only: the Unified Address stored by [`Self::add_transparent_output`] for output
+     * `index`, if the caller supplied one — `undefined` otherwise (including for a non-Zcash
+     * PSBT).
+     */
+    transparent_output_unified_address(index: number): string | undefined;
     unsigned_tx_id(): string;
     /**
      * Verify if a replay protection input has a valid signature

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

@@ -763,6 +763,40 @@ class BitGoPsbt {
             wasm.__wbindgen_add_to_stack_pointer(16);
         }
     }
+    /**
+     * Zcash-only: add a plain transparent output. Just `script`/`value`
+     * (`unified_address: undefined`) is the legacy `add_output` behavior, unchanged.
+     *
+     * If `unified_address` is given, this PSBT must be a legacy v4 Zcash PSBT — a v6 (Ironwood)
+     * PSBT's shielded side already has its own UA path (`add_ironwood_output`). The UA must be a
+     * Unified Address whose transparent receiver is exactly `script`; mismatches are rejected
+     * rather than silently stored. It is then kept verbatim, keyed by this output's index, so
+     * `transparent_output_unified_address` can later return the original UA string rather than
+     * just the bare scriptPubkey.
+     * @param {Uint8Array} script
+     * @param {bigint} value
+     * @param {string | null} [unified_address]
+     * @returns {number}
+     */
+    add_transparent_output(script, value, unified_address) {
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            const ptr0 = passArray8ToWasm0(script, wasm.__wbindgen_export);
+            const len0 = WASM_VECTOR_LEN;
+            var ptr1 = isLikeNone(unified_address) ? 0 : passStringToWasm0(unified_address, wasm.__wbindgen_export, wasm.__wbindgen_export2);
+            var len1 = WASM_VECTOR_LEN;
+            wasm.bitgopsbt_add_transparent_output(retptr, this.__wbg_ptr, ptr0, len0, value, ptr1, len1);
+            var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+            var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+            var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
+            if (r2) {
+                throw takeObject(r1);
+            }
+            return r0 >>> 0;
+        } finally {
+            wasm.__wbindgen_add_to_stack_pointer(16);
+        }
+    }
     /**
      * @param {string} txid
      * @param {number} vout
@@ -2590,6 +2624,29 @@ class BitGoPsbt {
             wasm.__wbindgen_add_to_stack_pointer(16);
         }
     }
+    /**
+     * Zcash-only: the Unified Address stored by [`Self::add_transparent_output`] for output
+     * `index`, if the caller supplied one — `undefined` otherwise (including for a non-Zcash
+     * PSBT).
+     * @param {number} index
+     * @returns {string | undefined}
+     */
+    transparent_output_unified_address(index) {
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            wasm.bitgopsbt_transparent_output_unified_address(retptr, this.__wbg_ptr, index);
+            var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+            var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+            let v1;
+            if (r0 !== 0) {
+                v1 = getStringFromWasm0(r0, r1).slice();
+                wasm.__wbindgen_export4(r0, r1 * 1, 1);
+            }
+            return v1;
+        } finally {
+            wasm.__wbindgen_add_to_stack_pointer(16);
+        }
+    }
     /**
      * @returns {string}
      */

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

@@ -23,20 +23,14 @@ 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 __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_inscriptionsnamespace_free: (a: number, b: number) => void;
 export const __wbg_messagenamespace_free: (a: number, b: number) => void;
 export const __wbg_wasmdashtransaction_free: (a: number, b: number) => void;
+export const __wbg_wasmreplayprotection_free: (a: number, b: number) => void;
 export const __wbg_wasmtransaction_free: (a: number, b: number) => void;
 export const __wbg_wasmzcashtransaction_free: (a: number, b: number) => void;
 export const __wbg_wrappsbt_free: (a: number, b: number) => void;
 export const __wbg_zcashunifiedaddress_free: (a: number, b: number) => void;
 export const __wbg_zcashv6transaction_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 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 wasmdashtransaction_from_bytes: (a: number, b: number, c: number) => void;
@@ -49,6 +43,9 @@ export const wasmdashtransaction_lock_time: (a: number) => number;
 export const wasmdashtransaction_output_count: (a: number) => number;
 export const wasmdashtransaction_to_bytes: (a: number, b: number) => void;
 export const wasmdashtransaction_version: (a: number) => number;
+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 wasmtransaction_add_input: (a: number, b: number, c: number, d: number, e: number, f: number) => void;
 export const wasmtransaction_add_input_at_index: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => void;
 export const wasmtransaction_add_output: (a: number, b: number, c: number, d: bigint) => number;
@@ -141,11 +138,44 @@ 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_inscriptionsnamespace_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 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 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_bip322namespace_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;
+export const bip322namespace_verify_bip322_psbt_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 bip322namespace_verify_bip322_tx_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) => void;
+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 __wbg_bitgopsbt_free: (a: number, b: number) => void;
 export const __wbg_fixedscriptwalletnamespace_free: (a: number, b: number) => void;
 export const __wbg_wasmbip32_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 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, l: number, m: number) => void;
@@ -158,6 +188,7 @@ export const bitgopsbt_add_output_with_address_at_index: (a: number, b: number,
 export const bitgopsbt_add_paygo_attestation: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => void;
 export const bitgopsbt_add_replay_protection_input: (a: number, b: number, c: number, d: number, e: number, f: number, g: bigint, h: number, i: number, j: number) => void;
 export const bitgopsbt_add_replay_protection_input_at_index: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: bigint, i: number, j: number, k: number) => void;
+export const bitgopsbt_add_transparent_output: (a: number, b: number, c: number, d: number, e: bigint, f: number, g: number) => void;
 export const bitgopsbt_add_wallet_input: (a: number, b: number, c: number, d: number, e: number, f: bigint, g: number, h: number, i: number, j: number, k: number, l: number, m: number, n: number, o: number, p: number) => void;
 export const bitgopsbt_add_wallet_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, m: number, n: number, o: number, p: number, q: number) => void;
 export const bitgopsbt_add_wallet_output: (a: number, b: number, c: number, d: number, e: bigint, f: number) => void;
@@ -224,6 +255,7 @@ export const bitgopsbt_sign_single_input_with_privkey: (a: number, b: number, c:
 export const bitgopsbt_sign_single_input_with_xpriv: (a: number, b: number, c: number, d: number) => void;
 export const bitgopsbt_sign_with_privkey: (a: number, b: number, c: number, d: number) => void;
 export const bitgopsbt_sign_with_xpriv: (a: number, b: number, c: number, d: number) => void;
+export const bitgopsbt_transparent_output_unified_address: (a: number, b: number, c: number) => void;
 export const bitgopsbt_unsigned_tx_id: (a: number, b: number) => void;
 export const bitgopsbt_verify_replay_protection_signature: (a: number, b: number, c: number, d: number) => void;
 export const bitgopsbt_verify_signature_with_pub: (a: number, b: number, c: number, d: number) => void;
@@ -240,6 +272,7 @@ 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 wasmbip32_chain_code: (a: number) => number;
 export const wasmbip32_depth: (a: number) => number;
@@ -278,44 +311,13 @@ 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 isInspectEnabled: () => 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 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 __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_bip322namespace_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;
-export const bip322namespace_verify_bip322_psbt_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 bip322namespace_verify_bip322_tx_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) => void;
-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 wasmutxonamespace_get_wasm_utxo_version: (a: 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/ZcashBitGoPsbt.d.ts

@@ -198,4 +198,28 @@ export declare class ZcashBitGoPsbt extends BitGoPsbt<ZcashParsedOutput> {
      * @throws Error if the PSBT is not fully finalized or extraction fails
      */
     extractTransaction(maxFeeRate?: number): ZcashTransaction;
+    /**
+     * Add a plain transparent output. Just `script`/`value` (no `unifiedAddress`) is the same as
+     * the generic {@link BitGoPsbt.addOutput}, unchanged.
+     *
+     * If `unifiedAddress` is given, it must be a Unified Address whose transparent receiver is
+     * exactly `script` — mismatches throw rather than being silently stored. It is then kept
+     * verbatim, keyed by this output's index, so {@link ZcashBitGoPsbt.transparentOutputUnifiedAddress}
+     * can later return the original UA string rather than just the bare scriptPubkey.
+     *
+     * `unifiedAddress` is only supported on a legacy v4 `ZcashBitGoPsbt` — the v6 (Ironwood)
+     * shielded side has its own UA path (`ZcashIronwoodBitGoPsbt.addShieldedOutput`'s
+     * `unifiedAddress` option).
+     *
+     * @param script - The output scriptPubkey
+     * @param value - The value in zatoshi
+     * @param unifiedAddress - Optional full Unified Address `script` was resolved from
+     * @returns The index of the newly added output
+     */
+    addTransparentOutput(script: Uint8Array, value: bigint, unifiedAddress?: string): number;
+    /**
+     * The Unified Address stored by {@link ZcashBitGoPsbt.addTransparentOutput} for output `index`,
+     * if one was supplied — `undefined` otherwise.
+     */
+    transparentOutputUnifiedAddress(index: number): string | undefined;
 }

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

@@ -211,4 +211,32 @@ export class ZcashBitGoPsbt extends BitGoPsbt {
     extractTransaction(maxFeeRate) {
         return ZcashTransaction.fromWasm(this.wasm.extract_zcash_transaction(maxFeeRate));
     }
+    /**
+     * Add a plain transparent output. Just `script`/`value` (no `unifiedAddress`) is the same as
+     * the generic {@link BitGoPsbt.addOutput}, unchanged.
+     *
+     * If `unifiedAddress` is given, it must be a Unified Address whose transparent receiver is
+     * exactly `script` — mismatches throw rather than being silently stored. It is then kept
+     * verbatim, keyed by this output's index, so {@link ZcashBitGoPsbt.transparentOutputUnifiedAddress}
+     * can later return the original UA string rather than just the bare scriptPubkey.
+     *
+     * `unifiedAddress` is only supported on a legacy v4 `ZcashBitGoPsbt` — the v6 (Ironwood)
+     * shielded side has its own UA path (`ZcashIronwoodBitGoPsbt.addShieldedOutput`'s
+     * `unifiedAddress` option).
+     *
+     * @param script - The output scriptPubkey
+     * @param value - The value in zatoshi
+     * @param unifiedAddress - Optional full Unified Address `script` was resolved from
+     * @returns The index of the newly added output
+     */
+    addTransparentOutput(script, value, unifiedAddress) {
+        return this.wasm.add_transparent_output(script, value, unifiedAddress);
+    }
+    /**
+     * The Unified Address stored by {@link ZcashBitGoPsbt.addTransparentOutput} for output `index`,
+     * if one was supplied — `undefined` otherwise.
+     */
+    transparentOutputUnifiedAddress(index) {
+        return this.wasm.transparent_output_unified_address(index);
+    }
 }

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

@@ -200,6 +200,18 @@ export class BitGoPsbt {
     add_paygo_attestation(output_index: number, entropy: Uint8Array, signature: Uint8Array): void;
     add_replay_protection_input(ecpair: WasmECPair, txid: string, vout: number, value: bigint, sequence?: number | null, prev_tx?: Uint8Array | null): number;
     add_replay_protection_input_at_index(index: number, ecpair: WasmECPair, txid: string, vout: number, value: bigint, sequence?: number | null, prev_tx?: Uint8Array | null): number;
+    /**
+     * Zcash-only: add a plain transparent output. Just `script`/`value`
+     * (`unified_address: undefined`) is the legacy `add_output` behavior, unchanged.
+     *
+     * If `unified_address` is given, this PSBT must be a legacy v4 Zcash PSBT — a v6 (Ironwood)
+     * PSBT's shielded side already has its own UA path (`add_ironwood_output`). The UA must be a
+     * Unified Address whose transparent receiver is exactly `script`; mismatches are rejected
+     * rather than silently stored. It is then kept verbatim, keyed by this output's index, so
+     * `transparent_output_unified_address` can later return the original UA string rather than
+     * just the bare scriptPubkey.
+     */
+    add_transparent_output(script: Uint8Array, value: bigint, unified_address?: string | null): number;
     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;
     add_wallet_input_at_index(index: number, txid: string, vout: number, value: bigint, wallet_keys: WasmRootWalletKeys, chain: number, derivation_index: number, signer?: string | null, cosigner?: string | null, sequence?: number | null, prev_tx?: Uint8Array | null): number;
     add_wallet_output(chain: number, index: number, value: bigint, wallet_keys: WasmRootWalletKeys): number;
@@ -796,6 +808,12 @@ export class BitGoPsbt {
      * - `Err(WasmUtxoError)` if signing fails
      */
     sign_with_xpriv(input_index: number, xpriv: WasmBIP32): void;
+    /**
+     * Zcash-only: the Unified Address stored by [`Self::add_transparent_output`] for output
+     * `index`, if the caller supplied one — `undefined` otherwise (including for a non-Zcash
+     * PSBT).
+     */
+    transparent_output_unified_address(index: number): string | undefined;
     unsigned_tx_id(): string;
     /**
      * Verify if a replay protection input has a valid signature

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

@@ -759,6 +759,40 @@ export class BitGoPsbt {
             wasm.__wbindgen_add_to_stack_pointer(16);
         }
     }
+    /**
+     * Zcash-only: add a plain transparent output. Just `script`/`value`
+     * (`unified_address: undefined`) is the legacy `add_output` behavior, unchanged.
+     *
+     * If `unified_address` is given, this PSBT must be a legacy v4 Zcash PSBT — a v6 (Ironwood)
+     * PSBT's shielded side already has its own UA path (`add_ironwood_output`). The UA must be a
+     * Unified Address whose transparent receiver is exactly `script`; mismatches are rejected
+     * rather than silently stored. It is then kept verbatim, keyed by this output's index, so
+     * `transparent_output_unified_address` can later return the original UA string rather than
+     * just the bare scriptPubkey.
+     * @param {Uint8Array} script
+     * @param {bigint} value
+     * @param {string | null} [unified_address]
+     * @returns {number}
+     */
+    add_transparent_output(script, value, unified_address) {
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            const ptr0 = passArray8ToWasm0(script, wasm.__wbindgen_export);
+            const len0 = WASM_VECTOR_LEN;
+            var ptr1 = isLikeNone(unified_address) ? 0 : passStringToWasm0(unified_address, wasm.__wbindgen_export, wasm.__wbindgen_export2);
+            var len1 = WASM_VECTOR_LEN;
+            wasm.bitgopsbt_add_transparent_output(retptr, this.__wbg_ptr, ptr0, len0, value, ptr1, len1);
+            var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+            var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+            var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
+            if (r2) {
+                throw takeObject(r1);
+            }
+            return r0 >>> 0;
+        } finally {
+            wasm.__wbindgen_add_to_stack_pointer(16);
+        }
+    }
     /**
      * @param {string} txid
      * @param {number} vout
@@ -2586,6 +2620,29 @@ export class BitGoPsbt {
             wasm.__wbindgen_add_to_stack_pointer(16);
         }
     }
+    /**
+     * Zcash-only: the Unified Address stored by [`Self::add_transparent_output`] for output
+     * `index`, if the caller supplied one — `undefined` otherwise (including for a non-Zcash
+     * PSBT).
+     * @param {number} index
+     * @returns {string | undefined}
+     */
+    transparent_output_unified_address(index) {
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            wasm.bitgopsbt_transparent_output_unified_address(retptr, this.__wbg_ptr, index);
+            var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+            var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+            let v1;
+            if (r0 !== 0) {
+                v1 = getStringFromWasm0(r0, r1).slice();
+                wasm.__wbindgen_export4(r0, r1 * 1, 1);
+            }
+            return v1;
+        } finally {
+            wasm.__wbindgen_add_to_stack_pointer(16);
+        }
+    }
     /**
      * @returns {string}
      */

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

@@ -23,20 +23,14 @@ 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 __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_inscriptionsnamespace_free: (a: number, b: number) => void;
 export const __wbg_messagenamespace_free: (a: number, b: number) => void;
 export const __wbg_wasmdashtransaction_free: (a: number, b: number) => void;
+export const __wbg_wasmreplayprotection_free: (a: number, b: number) => void;
 export const __wbg_wasmtransaction_free: (a: number, b: number) => void;
 export const __wbg_wasmzcashtransaction_free: (a: number, b: number) => void;
 export const __wbg_wrappsbt_free: (a: number, b: number) => void;
 export const __wbg_zcashunifiedaddress_free: (a: number, b: number) => void;
 export const __wbg_zcashv6transaction_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 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 wasmdashtransaction_from_bytes: (a: number, b: number, c: number) => void;
@@ -49,6 +43,9 @@ export const wasmdashtransaction_lock_time: (a: number) => number;
 export const wasmdashtransaction_output_count: (a: number) => number;
 export const wasmdashtransaction_to_bytes: (a: number, b: number) => void;
 export const wasmdashtransaction_version: (a: number) => number;
+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 wasmtransaction_add_input: (a: number, b: number, c: number, d: number, e: number, f: number) => void;
 export const wasmtransaction_add_input_at_index: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => void;
 export const wasmtransaction_add_output: (a: number, b: number, c: number, d: bigint) => number;
@@ -141,11 +138,44 @@ 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_inscriptionsnamespace_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 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 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_bip322namespace_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;
+export const bip322namespace_verify_bip322_psbt_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 bip322namespace_verify_bip322_tx_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) => void;
+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 __wbg_bitgopsbt_free: (a: number, b: number) => void;
 export const __wbg_fixedscriptwalletnamespace_free: (a: number, b: number) => void;
 export const __wbg_wasmbip32_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 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, l: number, m: number) => void;
@@ -158,6 +188,7 @@ export const bitgopsbt_add_output_with_address_at_index: (a: number, b: number,
 export const bitgopsbt_add_paygo_attestation: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => void;
 export const bitgopsbt_add_replay_protection_input: (a: number, b: number, c: number, d: number, e: number, f: number, g: bigint, h: number, i: number, j: number) => void;
 export const bitgopsbt_add_replay_protection_input_at_index: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: bigint, i: number, j: number, k: number) => void;
+export const bitgopsbt_add_transparent_output: (a: number, b: number, c: number, d: number, e: bigint, f: number, g: number) => void;
 export const bitgopsbt_add_wallet_input: (a: number, b: number, c: number, d: number, e: number, f: bigint, g: number, h: number, i: number, j: number, k: number, l: number, m: number, n: number, o: number, p: number) => void;
 export const bitgopsbt_add_wallet_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, m: number, n: number, o: number, p: number, q: number) => void;
 export const bitgopsbt_add_wallet_output: (a: number, b: number, c: number, d: number, e: bigint, f: number) => void;
@@ -224,6 +255,7 @@ export const bitgopsbt_sign_single_input_with_privkey: (a: number, b: number, c:
 export const bitgopsbt_sign_single_input_with_xpriv: (a: number, b: number, c: number, d: number) => void;
 export const bitgopsbt_sign_with_privkey: (a: number, b: number, c: number, d: number) => void;
 export const bitgopsbt_sign_with_xpriv: (a: number, b: number, c: number, d: number) => void;
+export const bitgopsbt_transparent_output_unified_address: (a: number, b: number, c: number) => void;
 export const bitgopsbt_unsigned_tx_id: (a: number, b: number) => void;
 export const bitgopsbt_verify_replay_protection_signature: (a: number, b: number, c: number, d: number) => void;
 export const bitgopsbt_verify_signature_with_pub: (a: number, b: number, c: number, d: number) => void;
@@ -240,6 +272,7 @@ 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 wasmbip32_chain_code: (a: number) => number;
 export const wasmbip32_depth: (a: number) => number;
@@ -278,44 +311,13 @@ 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 isInspectEnabled: () => 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 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 __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_bip322namespace_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;
-export const bip322namespace_verify_bip322_psbt_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 bip322namespace_verify_bip322_tx_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) => void;
-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 wasmutxonamespace_get_wasm_utxo_version: (a: 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.39.0",
+  "version": "4.40.0",
   "type": "module",
   "repository": {
     "type": "git",