@bitgo/wasm-utxo 1.19.0 → 1.20.0

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

@@ -57,10 +57,13 @@ export type AddInputOptions = {
     prevTx?: Uint8Array;
 };
 export type AddOutputOptions = {
-    /** Output script (scriptPubKey) */
     script: Uint8Array;
     /** Value in satoshis */
     value: bigint;
+} | {
+    address: string;
+    /** Value in satoshis */
+    value: bigint;
 };
 /** Key identifier for signing ("user", "backup", or "bitgo") */
 export type SignerKey = "user" | "backup" | "bitgo";
@@ -146,15 +149,48 @@ export declare class BitGoPsbt {
     /**
      * Add an output to the PSBT
      *
-     * @param options - Output options (script, value)
+     * @param script - The output script (scriptPubKey)
+     * @param value - Value in satoshis
+     * @returns The index of the newly added output
+     *
+     * @example
+     * ```typescript
+     * const outputIndex = psbt.addOutput(outputScript, 50000n);
+     * ```
+     */
+    addOutput(script: Uint8Array, value: bigint): number;
+    /**
+     * Add an output to the PSBT by address
+     *
+     * @param address - The destination address
+     * @param value - Value in satoshis
+     * @returns The index of the newly added output
+     *
+     * @example
+     * ```typescript
+     * const outputIndex = psbt.addOutput("bc1q...", 50000n);
+     * ```
+     */
+    addOutput(address: string, value: bigint): number;
+    /**
+     * Add an output to the PSBT
+     *
+     * @param options - Output options (script or address, and value)
      * @returns The index of the newly added output
      *
      * @example
      * ```typescript
+     * // Using script
      * const outputIndex = psbt.addOutput({
      *   script: outputScript,
      *   value: 50000n,
      * });
+     *
+     * // Using address
+     * const outputIndex = psbt.addOutput({
+     *   address: "bc1qw508d6qejxtdg4y5r3zarvary0c5xw7kv8f3t4",
+     *   value: 50000n,
+     * });
      * ```
      */
     addOutput(options: AddOutputOptions): number;

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

@@ -77,22 +77,24 @@ class BitGoPsbt {
     addInput(options, script) {
         return this._wasm.add_input(options.txid, options.vout, options.value, script, options.sequence, options.prevTx);
     }
-    /**
-     * Add an output to the PSBT
-     *
-     * @param options - Output options (script, value)
-     * @returns The index of the newly added output
-     *
-     * @example
-     * ```typescript
-     * const outputIndex = psbt.addOutput({
-     *   script: outputScript,
-     *   value: 50000n,
-     * });
-     * ```
-     */
-    addOutput(options) {
-        return this._wasm.add_output(options.script, options.value);
+    addOutput(scriptOrOptions, value) {
+        if (scriptOrOptions instanceof Uint8Array || typeof scriptOrOptions === "string") {
+            if (value === undefined) {
+                throw new Error("Value is required when passing a script or address");
+            }
+            if (scriptOrOptions instanceof Uint8Array) {
+                return this._wasm.add_output(scriptOrOptions, value);
+            }
+            return this._wasm.add_output_with_address(scriptOrOptions, value);
+        }
+        const options = scriptOrOptions;
+        if ("script" in options) {
+            return this._wasm.add_output(options.script, options.value);
+        }
+        if ("address" in options) {
+            return this._wasm.add_output_with_address(options.address, options.value);
+        }
+        throw new Error("Invalid output options");
     }
     /**
      * Add a wallet input with full PSBT metadata

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

@@ -225,6 +225,17 @@ export class BitGoPsbt {
    * generated for security. Custom session_id is only allowed on testnets for testing purposes.
    */
   generate_musig2_nonces(xpriv: WasmBIP32, session_id_bytes?: Uint8Array | null): void;
+  /**
+   * Add an output to the PSBT by address
+   *
+   * # Arguments
+   * * `address` - The destination address
+   * * `value` - The value in satoshis
+   *
+   * # Returns
+   * The index of the newly added output
+   */
+  add_output_with_address(address: string, value: bigint): number;
   /**
    * Verify if a valid signature exists for a given ECPair key at the specified input index
    *

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

@@ -800,6 +800,36 @@ class BitGoPsbt {
             wasm.__wbindgen_add_to_stack_pointer(16);
         }
     }
+    /**
+     * Add an output to the PSBT by address
+     *
+     * # Arguments
+     * * `address` - The destination address
+     * * `value` - The value in satoshis
+     *
+     * # Returns
+     * The index of the newly added output
+     * @param {string} address
+     * @param {bigint} value
+     * @returns {number}
+     */
+    add_output_with_address(address, value) {
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            const ptr0 = passStringToWasm0(address, wasm.__wbindgen_export, wasm.__wbindgen_export2);
+            const len0 = WASM_VECTOR_LEN;
+            wasm.bitgopsbt_add_output_with_address(retptr, this.__wbg_ptr, ptr0, len0, value);
+            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);
+        }
+    }
     /**
      * Verify if a valid signature exists for a given ECPair key at the specified input index
      *

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

@@ -57,6 +57,7 @@ export const addressnamespace_from_output_script_with_coin: (a: number, b: numbe
 export const addressnamespace_to_output_script_with_coin: (a: number, b: number, c: number, d: number, e: 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_output: (a: number, b: number, c: number, d: number, e: bigint) => void;
+export const bitgopsbt_add_output_with_address: (a: number, b: number, c: number, d: number, e: bigint) => void;
 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) => 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;

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

@@ -57,10 +57,13 @@ export type AddInputOptions = {
     prevTx?: Uint8Array;
 };
 export type AddOutputOptions = {
-    /** Output script (scriptPubKey) */
     script: Uint8Array;
     /** Value in satoshis */
     value: bigint;
+} | {
+    address: string;
+    /** Value in satoshis */
+    value: bigint;
 };
 /** Key identifier for signing ("user", "backup", or "bitgo") */
 export type SignerKey = "user" | "backup" | "bitgo";
@@ -146,15 +149,48 @@ export declare class BitGoPsbt {
     /**
      * Add an output to the PSBT
      *
-     * @param options - Output options (script, value)
+     * @param script - The output script (scriptPubKey)
+     * @param value - Value in satoshis
+     * @returns The index of the newly added output
+     *
+     * @example
+     * ```typescript
+     * const outputIndex = psbt.addOutput(outputScript, 50000n);
+     * ```
+     */
+    addOutput(script: Uint8Array, value: bigint): number;
+    /**
+     * Add an output to the PSBT by address
+     *
+     * @param address - The destination address
+     * @param value - Value in satoshis
+     * @returns The index of the newly added output
+     *
+     * @example
+     * ```typescript
+     * const outputIndex = psbt.addOutput("bc1q...", 50000n);
+     * ```
+     */
+    addOutput(address: string, value: bigint): number;
+    /**
+     * Add an output to the PSBT
+     *
+     * @param options - Output options (script or address, and value)
      * @returns The index of the newly added output
      *
      * @example
      * ```typescript
+     * // Using script
      * const outputIndex = psbt.addOutput({
      *   script: outputScript,
      *   value: 50000n,
      * });
+     *
+     * // Using address
+     * const outputIndex = psbt.addOutput({
+     *   address: "bc1qw508d6qejxtdg4y5r3zarvary0c5xw7kv8f3t4",
+     *   value: 50000n,
+     * });
      * ```
      */
     addOutput(options: AddOutputOptions): number;

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

@@ -74,22 +74,24 @@ export class BitGoPsbt {
     addInput(options, script) {
         return this._wasm.add_input(options.txid, options.vout, options.value, script, options.sequence, options.prevTx);
     }
-    /**
-     * Add an output to the PSBT
-     *
-     * @param options - Output options (script, value)
-     * @returns The index of the newly added output
-     *
-     * @example
-     * ```typescript
-     * const outputIndex = psbt.addOutput({
-     *   script: outputScript,
-     *   value: 50000n,
-     * });
-     * ```
-     */
-    addOutput(options) {
-        return this._wasm.add_output(options.script, options.value);
+    addOutput(scriptOrOptions, value) {
+        if (scriptOrOptions instanceof Uint8Array || typeof scriptOrOptions === "string") {
+            if (value === undefined) {
+                throw new Error("Value is required when passing a script or address");
+            }
+            if (scriptOrOptions instanceof Uint8Array) {
+                return this._wasm.add_output(scriptOrOptions, value);
+            }
+            return this._wasm.add_output_with_address(scriptOrOptions, value);
+        }
+        const options = scriptOrOptions;
+        if ("script" in options) {
+            return this._wasm.add_output(options.script, options.value);
+        }
+        if ("address" in options) {
+            return this._wasm.add_output_with_address(options.address, options.value);
+        }
+        throw new Error("Invalid output options");
     }
     /**
      * Add a wallet input with full PSBT metadata

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

@@ -225,6 +225,17 @@ export class BitGoPsbt {
    * generated for security. Custom session_id is only allowed on testnets for testing purposes.
    */
   generate_musig2_nonces(xpriv: WasmBIP32, session_id_bytes?: Uint8Array | null): void;
+  /**
+   * Add an output to the PSBT by address
+   *
+   * # Arguments
+   * * `address` - The destination address
+   * * `value` - The value in satoshis
+   *
+   * # Returns
+   * The index of the newly added output
+   */
+  add_output_with_address(address: string, value: bigint): number;
   /**
    * Verify if a valid signature exists for a given ECPair key at the specified input index
    *

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

@@ -808,6 +808,36 @@ export class BitGoPsbt {
             wasm.__wbindgen_add_to_stack_pointer(16);
         }
     }
+    /**
+     * Add an output to the PSBT by address
+     *
+     * # Arguments
+     * * `address` - The destination address
+     * * `value` - The value in satoshis
+     *
+     * # Returns
+     * The index of the newly added output
+     * @param {string} address
+     * @param {bigint} value
+     * @returns {number}
+     */
+    add_output_with_address(address, value) {
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            const ptr0 = passStringToWasm0(address, wasm.__wbindgen_export, wasm.__wbindgen_export2);
+            const len0 = WASM_VECTOR_LEN;
+            wasm.bitgopsbt_add_output_with_address(retptr, this.__wbg_ptr, ptr0, len0, value);
+            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);
+        }
+    }
     /**
      * Verify if a valid signature exists for a given ECPair key at the specified input index
      *

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

@@ -57,6 +57,7 @@ export const addressnamespace_from_output_script_with_coin: (a: number, b: numbe
 export const addressnamespace_to_output_script_with_coin: (a: number, b: number, c: number, d: number, e: 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_output: (a: number, b: number, c: number, d: number, e: bigint) => void;
+export const bitgopsbt_add_output_with_address: (a: number, b: number, c: number, d: number, e: bigint) => void;
 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) => 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;

package/package.json

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