@bitgo/wasm-utxo 3.0.0 → 4.0.0

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

@@ -106,6 +106,11 @@ export type VerifyBip322TxInputParams = VerifyBip322InputParams & {
  * ```
  */
 export declare function addBip322Input(psbt: BitGoPsbt, params: AddBip322InputParams): number;
+/**
+ * Get the BIP322 message stored at a PSBT input index.
+ * Returns null if no message is stored.
+ */
+export declare function getBip322Message(psbt: BitGoPsbt, inputIndex: number): string | null;
 /**
  * Verify a single input of a BIP-0322 transaction proof
  *

package/dist/cjs/js/bip322/index.js

@@ -36,6 +36,7 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.addBip322Input = addBip322Input;
+exports.getBip322Message = getBip322Message;
 exports.verifyBip322TxInput = verifyBip322TxInput;
 exports.verifyBip322PsbtInput = verifyBip322PsbtInput;
 exports.verifyBip322PsbtInputWithPubkeys = verifyBip322PsbtInputWithPubkeys;
@@ -75,6 +76,13 @@ function addBip322Input(psbt, params) {
     const keys = RootWalletKeys_js_1.RootWalletKeys.from(params.rootWalletKeys);
     return wasm_utxo_js_1.Bip322Namespace.add_bip322_input(psbt.wasm, params.message, params.scriptId.chain, params.scriptId.index, keys.wasm, params.signPath?.signer, params.signPath?.cosigner, params.tag);
 }
+/**
+ * Get the BIP322 message stored at a PSBT input index.
+ * Returns null if no message is stored.
+ */
+function getBip322Message(psbt, inputIndex) {
+    return wasm_utxo_js_1.Bip322Namespace.get_bip322_message(psbt.wasm, inputIndex) ?? null;
+}
 /**
  * Verify a single input of a BIP-0322 transaction proof
  *

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

@@ -98,6 +98,11 @@ export type ParseTransactionOptions = {
 export type ParseOutputsOptions = {
     payGoPubkeys?: ECPairArg[];
 };
+export type HydrationUnspent = {
+    chain: number;
+    index: number;
+    value: bigint;
+};
 export declare class BitGoPsbt implements IPsbtWithAddress {
     protected _wasm: WasmBitGoPsbt;
     protected constructor(_wasm: WasmBitGoPsbt);
@@ -136,6 +141,19 @@ export declare class BitGoPsbt implements IPsbtWithAddress {
      * @returns A BitGoPsbt instance
      */
     static fromBytes(bytes: Uint8Array, network: NetworkName): BitGoPsbt;
+    /**
+     * Convert a half-signed legacy transaction to a psbt-lite.
+     *
+     * Extracts partial signatures from scriptSig/witness and creates a PSBT
+     * with proper wallet metadata (bip32Derivation, scripts, witnessUtxo).
+     * Only supports p2sh, p2shP2wsh, and p2wsh inputs (not taproot).
+     *
+     * @param txBytes - The serialized half-signed legacy transaction
+     * @param network - Network name
+     * @param walletKeys - The wallet's root keys
+     * @param unspents - Chain, index, and value for each input
+     */
+    static fromHalfSignedLegacyTransaction(txBytes: Uint8Array, network: NetworkName, walletKeys: WalletKeysArg, unspents: HydrationUnspent[]): BitGoPsbt;
     /**
      * Add an input to the PSBT
      *

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

@@ -57,6 +57,23 @@ class BitGoPsbt {
         const wasm = wasm_utxo_js_1.BitGoPsbt.from_bytes(bytes, network);
         return new BitGoPsbt(wasm);
     }
+    /**
+     * Convert a half-signed legacy transaction to a psbt-lite.
+     *
+     * Extracts partial signatures from scriptSig/witness and creates a PSBT
+     * with proper wallet metadata (bip32Derivation, scripts, witnessUtxo).
+     * Only supports p2sh, p2shP2wsh, and p2wsh inputs (not taproot).
+     *
+     * @param txBytes - The serialized half-signed legacy transaction
+     * @param network - Network name
+     * @param walletKeys - The wallet's root keys
+     * @param unspents - Chain, index, and value for each input
+     */
+    static fromHalfSignedLegacyTransaction(txBytes, network, walletKeys, unspents) {
+        const keys = RootWalletKeys_js_1.RootWalletKeys.from(walletKeys);
+        const wasm = wasm_utxo_js_1.BitGoPsbt.from_half_signed_legacy_transaction(txBytes, network, keys.wasm, unspents);
+        return new BitGoPsbt(wasm);
+    }
     addInputAtIndex(index, txidOrOptions, voutOrScript, value, script, sequence) {
         if (typeof txidOrOptions === "string") {
             return this._wasm.add_input_at_index(index, txidOrOptions, voutOrScript, value, script, sequence);

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

@@ -5,7 +5,7 @@ export { outputScript, address } from "./address.js";
 export { Dimensions } from "./Dimensions.js";
 export { outputScriptTypes, inputScriptTypes, type OutputScriptType, type InputScriptType, type ScriptType, } from "./scriptType.js";
 export { ChainCode, chainCodes, assertChainCode, type Scope } from "./chains.js";
-export { 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, } from "./BitGoPsbt.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 { ZcashBitGoPsbt, type ZcashNetworkName, type CreateEmptyZcashOptions, } from "./ZcashBitGoPsbt.js";
 export type { PsbtBip32Derivation, PsbtInputData, PsbtOutputData, PsbtOutputDataWithAddress, PsbtWitnessUtxo, } from "../wasm/wasm_utxo.js";
 import type { ScriptType } from "./scriptType.js";

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

@@ -61,9 +61,30 @@ declare module "./wasm/wasm_utxo.js" {
     interface PsbtOutputDataWithAddress extends PsbtOutputData {
         address: string;
     }
+    /** Outpoint referencing a previous transaction output */
+    interface TxOutPoint {
+        txid: string;
+        vout: number;
+    }
+    /** Raw transaction input data returned by Transaction.getInputs() */
+    interface TxInputData {
+        previousOutput: TxOutPoint;
+        sequence: number;
+        scriptSig: Uint8Array;
+        witness: Uint8Array[];
+    }
+    /** Raw transaction output data returned by Transaction.getOutputs() */
+    interface TxOutputData {
+        script: Uint8Array;
+        value: bigint;
+    }
+    /** Transaction output data with resolved address */
+    interface TxOutputDataWithAddress extends TxOutputData {
+        address: string;
+    }
 }
 export { WrapDescriptor as Descriptor } from "./wasm/wasm_utxo.js";
 export { WrapMiniscript as Miniscript } from "./wasm/wasm_utxo.js";
 export { Psbt } from "./descriptorWallet/Psbt.js";
-export { DashTransaction, Transaction, ZcashTransaction } from "./transaction.js";
+export { DashTransaction, Transaction, ZcashTransaction, type ITransaction, type ITransactionCommon, } from "./transaction.js";
 export { hasPsbtMagic, type IPsbt, type IPsbtWithAddress } from "./psbt.js";

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

@@ -1,14 +1,9 @@
 import type { PsbtInputData, PsbtOutputData, PsbtOutputDataWithAddress } from "./wasm/wasm_utxo.js";
 import type { BIP32 } from "./bip32.js";
+import type { ITransactionCommon } from "./transaction.js";
 /** Common interface for PSBT types */
-export interface IPsbt {
-    inputCount(): number;
-    outputCount(): number;
-    getInputs(): PsbtInputData[];
-    getOutputs(): PsbtOutputData[];
+export interface IPsbt extends ITransactionCommon<PsbtInputData, PsbtOutputData> {
     getGlobalXpubs(): BIP32[];
-    version(): number;
-    lockTime(): number;
     unsignedTxId(): string;
     addInputAtIndex(index: number, txid: string, vout: number, value: bigint, script: Uint8Array, sequence?: number): number;
     addOutputAtIndex(index: number, script: Uint8Array, value: bigint): number;

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

@@ -1,10 +1,19 @@
-import { WasmDashTransaction, WasmTransaction, WasmZcashTransaction } from "./wasm/wasm_utxo.js";
-/**
- * Common interface for all transaction types
- */
-export interface ITransaction {
+import { WasmDashTransaction, WasmTransaction, WasmZcashTransaction, type TxInputData, type TxOutputData, type TxOutputDataWithAddress } from "./wasm/wasm_utxo.js";
+import type { CoinName } from "./coinName.js";
+/** Common read-only interface shared by transactions and PSBTs */
+export interface ITransactionCommon<TInput, TOutput> {
+    inputCount(): number;
+    outputCount(): number;
+    version(): number;
+    lockTime(): number;
+    getInputs(): TInput[];
+    getOutputs(): TOutput[];
+}
+/** Common interface for all transaction types */
+export interface ITransaction extends ITransactionCommon<TxInputData, TxOutputData> {
     toBytes(): Uint8Array;
     getId(): string;
+    getOutputsWithAddress(coin: CoinName): TxOutputDataWithAddress[];
 }
 /**
  * Transaction wrapper (Bitcoin-like networks)
@@ -19,9 +28,7 @@ export declare class Transaction implements ITransaction {
      */
     static create(): Transaction;
     static fromBytes(bytes: Uint8Array): Transaction;
-    /**
-     * @internal Create from WASM instance directly (avoids re-parsing bytes)
-     */
+    /** @internal Create from WASM instance directly (avoids re-parsing bytes) */
     static fromWasm(wasm: WasmTransaction): Transaction;
     /**
      * Add an input to the transaction
@@ -52,9 +59,14 @@ export declare class Transaction implements ITransaction {
      * @returns The virtual size in virtual bytes (vbytes)
      */
     getVSize(): number;
-    /**
-     * @internal
-     */
+    inputCount(): number;
+    outputCount(): number;
+    version(): number;
+    lockTime(): number;
+    getInputs(): TxInputData[];
+    getOutputs(): TxOutputData[];
+    getOutputsWithAddress(coin: CoinName): TxOutputDataWithAddress[];
+    /** @internal */
     get wasm(): WasmTransaction;
 }
 /**
@@ -66,9 +78,7 @@ export declare class ZcashTransaction implements ITransaction {
     private _wasm;
     private constructor();
     static fromBytes(bytes: Uint8Array): ZcashTransaction;
-    /**
-     * @internal Create from WASM instance directly (avoids re-parsing bytes)
-     */
+    /** @internal Create from WASM instance directly (avoids re-parsing bytes) */
     static fromWasm(wasm: WasmZcashTransaction): ZcashTransaction;
     toBytes(): Uint8Array;
     /**
@@ -80,9 +90,14 @@ export declare class ZcashTransaction implements ITransaction {
      * @returns The transaction ID as a hex string
      */
     getId(): string;
-    /**
-     * @internal
-     */
+    inputCount(): number;
+    outputCount(): number;
+    version(): number;
+    lockTime(): number;
+    getInputs(): TxInputData[];
+    getOutputs(): TxOutputData[];
+    getOutputsWithAddress(coin: CoinName): TxOutputDataWithAddress[];
+    /** @internal */
     get wasm(): WasmZcashTransaction;
 }
 /**
@@ -94,9 +109,7 @@ export declare class DashTransaction implements ITransaction {
     private _wasm;
     private constructor();
     static fromBytes(bytes: Uint8Array): DashTransaction;
-    /**
-     * @internal Create from WASM instance directly (avoids re-parsing bytes)
-     */
+    /** @internal Create from WASM instance directly (avoids re-parsing bytes) */
     static fromWasm(wasm: WasmDashTransaction): DashTransaction;
     toBytes(): Uint8Array;
     /**
@@ -108,8 +121,13 @@ export declare class DashTransaction implements ITransaction {
      * @returns The transaction ID as a hex string
      */
     getId(): string;
-    /**
-     * @internal
-     */
+    inputCount(): number;
+    outputCount(): number;
+    version(): number;
+    lockTime(): number;
+    getInputs(): TxInputData[];
+    getOutputs(): TxOutputData[];
+    getOutputsWithAddress(coin: CoinName): TxOutputDataWithAddress[];
+    /** @internal */
     get wasm(): WasmDashTransaction;
 }

package/dist/cjs/js/transaction.js

@@ -21,9 +21,7 @@ class Transaction {
     static fromBytes(bytes) {
         return new Transaction(wasm_utxo_js_1.WasmTransaction.from_bytes(bytes));
     }
-    /**
-     * @internal Create from WASM instance directly (avoids re-parsing bytes)
-     */
+    /** @internal Create from WASM instance directly (avoids re-parsing bytes) */
     static fromWasm(wasm) {
         return new Transaction(wasm);
     }
@@ -70,9 +68,28 @@ class Transaction {
     getVSize() {
         return this._wasm.get_vsize();
     }
-    /**
-     * @internal
-     */
+    inputCount() {
+        return this._wasm.input_count();
+    }
+    outputCount() {
+        return this._wasm.output_count();
+    }
+    version() {
+        return this._wasm.version();
+    }
+    lockTime() {
+        return this._wasm.lock_time();
+    }
+    getInputs() {
+        return this._wasm.get_inputs();
+    }
+    getOutputs() {
+        return this._wasm.get_outputs();
+    }
+    getOutputsWithAddress(coin) {
+        return this._wasm.get_outputs_with_address(coin);
+    }
+    /** @internal */
     get wasm() {
         return this._wasm;
     }
@@ -91,9 +108,7 @@ class ZcashTransaction {
     static fromBytes(bytes) {
         return new ZcashTransaction(wasm_utxo_js_1.WasmZcashTransaction.from_bytes(bytes));
     }
-    /**
-     * @internal Create from WASM instance directly (avoids re-parsing bytes)
-     */
+    /** @internal Create from WASM instance directly (avoids re-parsing bytes) */
     static fromWasm(wasm) {
         return new ZcashTransaction(wasm);
     }
@@ -111,9 +126,28 @@ class ZcashTransaction {
     getId() {
         return this._wasm.get_txid();
     }
-    /**
-     * @internal
-     */
+    inputCount() {
+        return this._wasm.input_count();
+    }
+    outputCount() {
+        return this._wasm.output_count();
+    }
+    version() {
+        return this._wasm.version();
+    }
+    lockTime() {
+        return this._wasm.lock_time();
+    }
+    getInputs() {
+        return this._wasm.get_inputs();
+    }
+    getOutputs() {
+        return this._wasm.get_outputs();
+    }
+    getOutputsWithAddress(coin) {
+        return this._wasm.get_outputs_with_address(coin);
+    }
+    /** @internal */
     get wasm() {
         return this._wasm;
     }
@@ -132,9 +166,7 @@ class DashTransaction {
     static fromBytes(bytes) {
         return new DashTransaction(wasm_utxo_js_1.WasmDashTransaction.from_bytes(bytes));
     }
-    /**
-     * @internal Create from WASM instance directly (avoids re-parsing bytes)
-     */
+    /** @internal Create from WASM instance directly (avoids re-parsing bytes) */
     static fromWasm(wasm) {
         return new DashTransaction(wasm);
     }
@@ -152,9 +184,28 @@ class DashTransaction {
     getId() {
         return this._wasm.get_txid();
     }
-    /**
-     * @internal
-     */
+    inputCount() {
+        return this._wasm.input_count();
+    }
+    outputCount() {
+        return this._wasm.output_count();
+    }
+    version() {
+        return this._wasm.version();
+    }
+    lockTime() {
+        return this._wasm.lock_time();
+    }
+    getInputs() {
+        return this._wasm.get_inputs();
+    }
+    getOutputs() {
+        return this._wasm.get_outputs();
+    }
+    getOutputsWithAddress(coin) {
+        return this._wasm.get_outputs_with_address(coin);
+    }
+    /** @internal */
     get wasm() {
         return this._wasm;
     }

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

@@ -36,6 +36,11 @@ export class Bip322Namespace {
      * The index of the added input
      */
     static add_bip322_input(psbt: BitGoPsbt, message: string, chain: number, index: number, wallet_keys: WasmRootWalletKeys, signer?: string | null, cosigner?: string | null, tag?: string | null): number;
+    /**
+     * Get the BIP322 message stored at a PSBT input index.
+     * Returns null if no message is stored.
+     */
+    static get_bip322_message(psbt: BitGoPsbt, input_index: number): string | undefined;
     /**
      * Verify a single input of a BIP-0322 PSBT proof
      *
@@ -289,6 +294,16 @@ export class BitGoPsbt {
      * Deserialize a PSBT from bytes with network-specific logic
      */
     static from_bytes(bytes: Uint8Array, network: string): BitGoPsbt;
+    /**
+     * Convert a half-signed legacy transaction to a psbt-lite.
+     *
+     * # Arguments
+     * * `tx_bytes` - The serialized half-signed legacy transaction
+     * * `network` - Network name (utxolib or coin name)
+     * * `wallet_keys` - The wallet's root keys
+     * * `unspents` - Array of `{ chain: number, index: number, value: bigint }` for each input
+     */
+    static from_half_signed_legacy_transaction(tx_bytes: Uint8Array, network: string, wallet_keys: WasmRootWalletKeys, unspents: any): BitGoPsbt;
     /**
      * Generate and store MuSig2 nonces for all MuSig2 inputs
      *
@@ -899,6 +914,9 @@ export class WasmDashTransaction {
      * Deserialize a Dash transaction from bytes (supports EVO special tx extra payload).
      */
     static from_bytes(bytes: Uint8Array): WasmDashTransaction;
+    get_inputs(): any;
+    get_outputs(): any;
+    get_outputs_with_address(coin: string): any;
     /**
      * Get the transaction ID (txid)
      *
@@ -912,10 +930,14 @@ export class WasmDashTransaction {
      * Returns an error if the transaction cannot be serialized
      */
     get_txid(): string;
+    input_count(): number;
+    lock_time(): number;
+    output_count(): number;
     /**
      * Serialize the Dash transaction to bytes (preserving tx_type and extra payload).
      */
     to_bytes(): Uint8Array;
+    version(): number;
 }
 
 /**
@@ -1175,6 +1197,9 @@ export class WasmTransaction {
      * Returns an error if the bytes cannot be parsed as a valid transaction
      */
     static from_bytes(bytes: Uint8Array): WasmTransaction;
+    get_inputs(): any;
+    get_outputs(): any;
+    get_outputs_with_address(coin: string): any;
     /**
      * Get the transaction ID (txid)
      *
@@ -1196,6 +1221,9 @@ export class WasmTransaction {
      * The virtual size in virtual bytes (vbytes)
      */
     get_vsize(): number;
+    input_count(): number;
+    lock_time(): number;
+    output_count(): number;
     /**
      * Serialize the transaction to bytes
      *
@@ -1203,6 +1231,7 @@ export class WasmTransaction {
      * The serialized transaction bytes
      */
     to_bytes(): Uint8Array;
+    version(): number;
 }
 
 /**
@@ -1228,6 +1257,9 @@ export class WasmZcashTransaction {
      * Returns an error if the bytes cannot be parsed as a valid Zcash transaction
      */
     static from_bytes(bytes: Uint8Array): WasmZcashTransaction;
+    get_inputs(): any;
+    get_outputs(): any;
+    get_outputs_with_address(coin: string): any;
     /**
      * Get the transaction ID (txid)
      *
@@ -1241,6 +1273,9 @@ export class WasmZcashTransaction {
      * Returns an error if the transaction cannot be serialized
      */
     get_txid(): string;
+    input_count(): number;
+    lock_time(): number;
+    output_count(): number;
     /**
      * Serialize the transaction to bytes
      *
@@ -1248,6 +1283,7 @@ export class WasmZcashTransaction {
      * The serialized transaction bytes
      */
     to_bytes(): Uint8Array;
+    version(): number;
 }
 
 export class WrapDescriptor {