@bitgo/wasm-utxo 4.1.0 → 4.3.0

package/dist/esm/js/descriptorWallet/Psbt.js

@@ -1,14 +1,9 @@
 import { WrapPsbt as WasmPsbt, } from "../wasm/wasm_utxo.js";
 import { Transaction } from "../transaction.js";
-export class Psbt {
-    _wasm;
+import { PsbtBase } from "../psbtBase.js";
+export class Psbt extends PsbtBase {
     constructor(versionOrWasm, lockTime) {
-        if (versionOrWasm instanceof WasmPsbt) {
-            this._wasm = versionOrWasm;
-        }
-        else {
-            this._wasm = new WasmPsbt(versionOrWasm, lockTime);
-        }
+        super(versionOrWasm instanceof WasmPsbt ? versionOrWasm : new WasmPsbt(versionOrWasm, lockTime));
     }
     /** @internal Access the underlying WASM instance */
     get wasm() {
@@ -22,37 +17,10 @@ export class Psbt {
         return new Psbt(WasmPsbt.deserialize(bytes));
     }
     // -- Serialization --
-    serialize() {
-        return this._wasm.serialize();
-    }
     clone() {
         return new Psbt(this._wasm.clone());
     }
     // -- IPsbt: introspection --
-    inputCount() {
-        return this._wasm.input_count();
-    }
-    outputCount() {
-        return this._wasm.output_count();
-    }
-    version() {
-        return this._wasm.version();
-    }
-    lockTime() {
-        return this._wasm.lock_time();
-    }
-    unsignedTxId() {
-        return this._wasm.unsigned_tx_id();
-    }
-    getInputs() {
-        return this._wasm.get_inputs();
-    }
-    getOutputs() {
-        return this._wasm.get_outputs();
-    }
-    getGlobalXpubs() {
-        return this._wasm.get_global_xpubs();
-    }
     getOutputsWithAddress(coin) {
         return this._wasm.get_outputs_with_address(coin);
     }
@@ -69,30 +37,6 @@ export class Psbt {
     addOutput(script, value) {
         return this._wasm.add_output(script, value);
     }
-    removeInput(index) {
-        this._wasm.remove_input(index);
-    }
-    removeOutput(index) {
-        this._wasm.remove_output(index);
-    }
-    setKV(key, value) {
-        this._wasm.set_kv(key, value);
-    }
-    getKV(key) {
-        return this._wasm.get_kv(key) ?? undefined;
-    }
-    setInputKV(index, key, value) {
-        this._wasm.set_input_kv(index, key, value);
-    }
-    getInputKV(index, key) {
-        return this._wasm.get_input_kv(index, key) ?? undefined;
-    }
-    setOutputKV(index, key, value) {
-        this._wasm.set_output_kv(index, key, value);
-    }
-    getOutputKV(index, key) {
-        return this._wasm.get_output_kv(index, key) ?? undefined;
-    }
     // -- Descriptor updates --
     updateInputWithDescriptor(inputIndex, descriptor) {
         this._wasm.update_input_with_descriptor(inputIndex, descriptor);

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

@@ -1,5 +1,6 @@
-import { BitGoPsbt as WasmBitGoPsbt, type PsbtInputData, type PsbtOutputData, type PsbtOutputDataWithAddress } from "../wasm/wasm_utxo.js";
+import { BitGoPsbt as WasmBitGoPsbt, type PsbtOutputDataWithAddress } from "../wasm/wasm_utxo.js";
 import type { IPsbtWithAddress } from "../psbt.js";
+import { PsbtBase } from "../psbtBase.js";
 import { type WalletKeysArg, RootWalletKeys } from "./RootWalletKeys.js";
 import { type ReplayProtectionArg } from "./ReplayProtection.js";
 import { type BIP32Arg, BIP32 } from "../bip32.js";
@@ -7,7 +8,6 @@ import { type ECPairArg } from "../ecpair.js";
 import type { UtxolibName } from "../utxolibCompat.js";
 import type { CoinName } from "../coinName.js";
 import type { InputScriptType } from "./scriptType.js";
-import type { PsbtKvKey } from "./BitGoKeySubtype.js";
 import { type ITransaction } from "../transaction.js";
 export type { InputScriptType };
 export type NetworkName = UtxolibName | CoinName;
@@ -103,10 +103,12 @@ export type HydrationUnspent = {
     chain: number;
     index: number;
     value: bigint;
+} | {
+    pubkey: Uint8Array;
+    value: bigint;
 };
-export declare class BitGoPsbt implements IPsbtWithAddress {
-    protected _wasm: WasmBitGoPsbt;
-    protected constructor(_wasm: WasmBitGoPsbt);
+export declare class BitGoPsbt extends PsbtBase<WasmBitGoPsbt> implements IPsbtWithAddress {
+    protected constructor(wasm: WasmBitGoPsbt);
     /**
      * Get the underlying WASM instance
      * @internal - for use by other wasm-utxo modules
@@ -289,31 +291,6 @@ export declare class BitGoPsbt implements IPsbtWithAddress {
      */
     addReplayProtectionInputAtIndex(index: number, inputOptions: AddInputOptions, key: ECPairArg): number;
     addReplayProtectionInput(inputOptions: AddInputOptions, key: ECPairArg): number;
-    removeInput(index: number): void;
-    removeOutput(index: number): void;
-    /**
-     * Get the unsigned transaction ID
-     * @returns The unsigned transaction ID
-     */
-    unsignedTxId(): string;
-    /**
-     * Get the transaction version
-     * @returns The transaction version number
-     */
-    version(): number;
-    lockTime(): number;
-    /** Set an arbitrary KV pair on the PSBT global map. */
-    setKV(key: PsbtKvKey, value: Uint8Array): void;
-    /** Get a KV value from the PSBT global map. Returns `undefined` if not present. */
-    getKV(key: PsbtKvKey): Uint8Array | undefined;
-    /** Set an arbitrary KV pair on a specific PSBT input. */
-    setInputKV(index: number, key: PsbtKvKey, value: Uint8Array): void;
-    /** Get a KV value from a specific PSBT input. Returns `undefined` if not present. */
-    getInputKV(index: number, key: PsbtKvKey): Uint8Array | undefined;
-    /** Set an arbitrary KV pair on a specific PSBT output. */
-    setOutputKV(index: number, key: PsbtKvKey, value: Uint8Array): void;
-    /** Get a KV value from a specific PSBT output. Returns `undefined` if not present. */
-    getOutputKV(index: number, key: PsbtKvKey): Uint8Array | undefined;
     /**
      * Parse transaction with wallet keys to identify wallet inputs/outputs
      * @param walletKeys - The wallet keys to use for identification
@@ -480,12 +457,6 @@ export declare class BitGoPsbt implements IPsbtWithAddress {
      * @throws Error if the input is not a replay protection input, index is out of bounds, or scripts are invalid
      */
     verifyReplayProtectionSignature(inputIndex: number, replayProtection: ReplayProtectionArg): boolean;
-    /**
-     * Serialize the PSBT to bytes
-     *
-     * @returns The serialized PSBT as a byte array
-     */
-    serialize(): Uint8Array;
     /**
      * Generate and store MuSig2 nonces for all MuSig2 inputs
      *
@@ -584,31 +555,6 @@ export declare class BitGoPsbt implements IPsbtWithAddress {
      * ```
      */
     getHalfSignedLegacyFormat(): Uint8Array;
-    /**
-     * Get the number of inputs in the PSBT
-     * @returns The number of inputs
-     */
-    inputCount(): number;
-    outputCount(): number;
-    /**
-     * Get all PSBT inputs as an array
-     *
-     * Returns raw PSBT input data including witness_utxo and derivation info.
-     * For parsed transaction data with address identification, use
-     * parseTransactionWithWalletKeys() instead.
-     *
-     * @returns Array of PsbtInputData objects
-     */
-    getInputs(): PsbtInputData[];
-    /**
-     * Get all PSBT outputs as an array
-     *
-     * Returns raw PSBT output data without address resolution.
-     * For output data with addresses, use getOutputsWithAddress().
-     *
-     * @returns Array of PsbtOutputData objects
-     */
-    getOutputs(): PsbtOutputData[];
     /**
      * Get all PSBT outputs with resolved address strings
      *
@@ -626,10 +572,6 @@ export declare class BitGoPsbt implements IPsbtWithAddress {
      * ```
      */
     getOutputsWithAddress(): PsbtOutputDataWithAddress[];
-    /**
-     * Returns the unordered global xpubs from this PSBT as BIP32 instances.
-     */
-    getGlobalXpubs(): BIP32[];
 }
 /**
  * Extract sorted wallet keys from a PSBT's global xpub fields.

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

@@ -1,13 +1,13 @@
 import { BitGoPsbt as WasmBitGoPsbt, FixedScriptWalletNamespace, } from "../wasm/wasm_utxo.js";
+import { PsbtBase } from "../psbtBase.js";
 import { RootWalletKeys } from "./RootWalletKeys.js";
 import { ReplayProtection } from "./ReplayProtection.js";
 import { BIP32, isBIP32Arg } from "../bip32.js";
 import { ECPair } from "../ecpair.js";
 import { Transaction, DashTransaction, ZcashTransaction, } from "../transaction.js";
-export class BitGoPsbt {
-    _wasm;
-    constructor(_wasm) {
-        this._wasm = _wasm;
+export class BitGoPsbt extends PsbtBase {
+    constructor(wasm) {
+        super(wasm);
     }
     /**
      * Get the underlying WASM instance
@@ -230,53 +230,6 @@ export class BitGoPsbt {
         const ecpair = ECPair.from(key);
         return this._wasm.add_replay_protection_input(ecpair.wasm, inputOptions.txid, inputOptions.vout, inputOptions.value, inputOptions.sequence, inputOptions.prevTx);
     }
-    removeInput(index) {
-        this._wasm.remove_input(index);
-    }
-    removeOutput(index) {
-        this._wasm.remove_output(index);
-    }
-    /**
-     * Get the unsigned transaction ID
-     * @returns The unsigned transaction ID
-     */
-    unsignedTxId() {
-        return this._wasm.unsigned_txid();
-    }
-    /**
-     * Get the transaction version
-     * @returns The transaction version number
-     */
-    version() {
-        return this._wasm.version();
-    }
-    lockTime() {
-        return this._wasm.lock_time();
-    }
-    /** Set an arbitrary KV pair on the PSBT global map. */
-    setKV(key, value) {
-        this._wasm.set_kv(key, value);
-    }
-    /** Get a KV value from the PSBT global map. Returns `undefined` if not present. */
-    getKV(key) {
-        return this._wasm.get_kv(key) ?? undefined;
-    }
-    /** Set an arbitrary KV pair on a specific PSBT input. */
-    setInputKV(index, key, value) {
-        this._wasm.set_input_kv(index, key, value);
-    }
-    /** Get a KV value from a specific PSBT input. Returns `undefined` if not present. */
-    getInputKV(index, key) {
-        return this._wasm.get_input_kv(index, key) ?? undefined;
-    }
-    /** Set an arbitrary KV pair on a specific PSBT output. */
-    setOutputKV(index, key, value) {
-        this._wasm.set_output_kv(index, key, value);
-    }
-    /** Get a KV value from a specific PSBT output. Returns `undefined` if not present. */
-    getOutputKV(index, key) {
-        return this._wasm.get_output_kv(index, key) ?? undefined;
-    }
     /**
      * Parse transaction with wallet keys to identify wallet inputs/outputs
      * @param walletKeys - The wallet keys to use for identification
@@ -470,14 +423,6 @@ export class BitGoPsbt {
         const rp = ReplayProtection.from(replayProtection, this._wasm.network());
         return this._wasm.verify_replay_protection_signature(inputIndex, rp.wasm);
     }
-    /**
-     * Serialize the PSBT to bytes
-     *
-     * @returns The serialized PSBT as a byte array
-     */
-    serialize() {
-        return this._wasm.serialize();
-    }
     /**
      * Generate and store MuSig2 nonces for all MuSig2 inputs
      *
@@ -596,39 +541,6 @@ export class BitGoPsbt {
     getHalfSignedLegacyFormat() {
         return this._wasm.extract_half_signed_legacy_tx();
     }
-    /**
-     * Get the number of inputs in the PSBT
-     * @returns The number of inputs
-     */
-    inputCount() {
-        return this._wasm.input_count();
-    }
-    outputCount() {
-        return this._wasm.output_count();
-    }
-    /**
-     * Get all PSBT inputs as an array
-     *
-     * Returns raw PSBT input data including witness_utxo and derivation info.
-     * For parsed transaction data with address identification, use
-     * parseTransactionWithWalletKeys() instead.
-     *
-     * @returns Array of PsbtInputData objects
-     */
-    getInputs() {
-        return this._wasm.get_inputs();
-    }
-    /**
-     * Get all PSBT outputs as an array
-     *
-     * Returns raw PSBT output data without address resolution.
-     * For output data with addresses, use getOutputsWithAddress().
-     *
-     * @returns Array of PsbtOutputData objects
-     */
-    getOutputs() {
-        return this._wasm.get_outputs();
-    }
     /**
      * Get all PSBT outputs with resolved address strings
      *
@@ -648,13 +560,6 @@ export class BitGoPsbt {
     getOutputsWithAddress() {
         return this._wasm.get_outputs_with_address();
     }
-    /**
-     * Returns the unordered global xpubs from this PSBT as BIP32 instances.
-     */
-    getGlobalXpubs() {
-        const result = this._wasm.get_global_xpubs();
-        return result.map((w) => BIP32.fromWasm(w));
-    }
 }
 /**
  * Extract sorted wallet keys from a PSBT's global xpub fields.

package/dist/esm/js/psbtBase.d.ts

@@ -0,0 +1,44 @@
+import type { PsbtInputData, PsbtOutputData } from "./wasm/wasm_utxo.js";
+import { BIP32 } from "./bip32.js";
+import type { PsbtKvKey } from "./fixedScriptWallet/BitGoKeySubtype.js";
+interface WasmPsbtBase {
+    input_count(): number;
+    output_count(): number;
+    version(): number;
+    lock_time(): number;
+    unsigned_tx_id(): string;
+    serialize(): Uint8Array;
+    get_inputs(): unknown;
+    get_outputs(): unknown;
+    get_global_xpubs(): unknown;
+    remove_input(index: number): void;
+    remove_output(index: number): void;
+    set_kv(key: unknown, value: Uint8Array): void;
+    get_kv(key: unknown): Uint8Array | null | undefined;
+    set_input_kv(index: number, key: unknown, value: Uint8Array): void;
+    get_input_kv(index: number, key: unknown): Uint8Array | null | undefined;
+    set_output_kv(index: number, key: unknown, value: Uint8Array): void;
+    get_output_kv(index: number, key: unknown): Uint8Array | null | undefined;
+}
+export declare abstract class PsbtBase<W extends WasmPsbtBase> {
+    protected _wasm: W;
+    constructor(wasm: W);
+    inputCount(): number;
+    outputCount(): number;
+    version(): number;
+    lockTime(): number;
+    unsignedTxId(): string;
+    serialize(): Uint8Array;
+    getInputs(): PsbtInputData[];
+    getOutputs(): PsbtOutputData[];
+    getGlobalXpubs(): BIP32[];
+    removeInput(index: number): void;
+    removeOutput(index: number): void;
+    setKV(key: PsbtKvKey, value: Uint8Array): void;
+    getKV(key: PsbtKvKey): Uint8Array | undefined;
+    setInputKV(index: number, key: PsbtKvKey, value: Uint8Array): void;
+    getInputKV(index: number, key: PsbtKvKey): Uint8Array | undefined;
+    setOutputKV(index: number, key: PsbtKvKey, value: Uint8Array): void;
+    getOutputKV(index: number, key: PsbtKvKey): Uint8Array | undefined;
+}
+export {};

package/dist/esm/js/psbtBase.js

@@ -0,0 +1,58 @@
+import { BIP32 } from "./bip32.js";
+export class PsbtBase {
+    _wasm;
+    constructor(wasm) {
+        this._wasm = wasm;
+    }
+    inputCount() {
+        return this._wasm.input_count();
+    }
+    outputCount() {
+        return this._wasm.output_count();
+    }
+    version() {
+        return this._wasm.version();
+    }
+    lockTime() {
+        return this._wasm.lock_time();
+    }
+    unsignedTxId() {
+        return this._wasm.unsigned_tx_id();
+    }
+    serialize() {
+        return this._wasm.serialize();
+    }
+    getInputs() {
+        return this._wasm.get_inputs();
+    }
+    getOutputs() {
+        return this._wasm.get_outputs();
+    }
+    getGlobalXpubs() {
+        return this._wasm.get_global_xpubs().map((w) => BIP32.fromWasm(w));
+    }
+    removeInput(index) {
+        this._wasm.remove_input(index);
+    }
+    removeOutput(index) {
+        this._wasm.remove_output(index);
+    }
+    setKV(key, value) {
+        this._wasm.set_kv(key, value);
+    }
+    getKV(key) {
+        return this._wasm.get_kv(key) ?? undefined;
+    }
+    setInputKV(index, key, value) {
+        this._wasm.set_input_kv(index, key, value);
+    }
+    getInputKV(index, key) {
+        return this._wasm.get_input_kv(index, key) ?? undefined;
+    }
+    setOutputKV(index, key, value) {
+        this._wasm.set_output_kv(index, key, value);
+    }
+    getOutputKV(index, key) {
+        return this._wasm.get_output_kv(index, key) ?? undefined;
+    }
+}

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

@@ -1,5 +1,7 @@
-import { WasmDashTransaction, WasmTransaction, WasmZcashTransaction, type TxInputData, type TxOutputData, type TxOutputDataWithAddress } from "./wasm/wasm_utxo.js";
+import { WasmDashTransaction, WasmTransaction, WasmZcashTransaction } from "./wasm/wasm_utxo.js";
+import type { TxInputData, TxOutputData, TxOutputDataWithAddress } from "./wasm/wasm_utxo.js";
 import type { CoinName } from "./coinName.js";
+import { TransactionBase } from "./transactionBase.js";
 /** Common read-only interface shared by transactions and PSBTs */
 export interface ITransactionCommon<TInput, TOutput> {
     inputCount(): number;
@@ -20,8 +22,7 @@ export interface ITransaction extends ITransactionCommon<TxInputData, TxOutputDa
  *
  * Provides a camelCase, strongly-typed API over the snake_case WASM bindings.
  */
-export declare class Transaction implements ITransaction {
-    private _wasm;
+export declare class Transaction extends TransactionBase<WasmTransaction> {
     private constructor();
     /**
      * Create an empty transaction (version 1, locktime 0)
@@ -41,16 +42,6 @@ export declare class Transaction implements ITransaction {
     addInput(txid: string, vout: number, sequence?: number): number;
     addOutputAtIndex(index: number, script: Uint8Array, value: bigint): number;
     addOutput(script: Uint8Array, value: bigint): number;
-    toBytes(): Uint8Array;
-    /**
-     * Get the transaction ID (txid)
-     *
-     * The txid is the double SHA256 of the transaction bytes (excluding witness
-     * data for segwit transactions), displayed in reverse byte order as is standard.
-     *
-     * @returns The transaction ID as a hex string
-     */
-    getId(): string;
     /**
      * Get the virtual size of the transaction
      *
@@ -59,13 +50,6 @@ export declare class Transaction implements ITransaction {
      * @returns The virtual size in virtual bytes (vbytes)
      */
     getVSize(): number;
-    inputCount(): number;
-    outputCount(): number;
-    version(): number;
-    lockTime(): number;
-    getInputs(): TxInputData[];
-    getOutputs(): TxOutputData[];
-    getOutputsWithAddress(coin: CoinName): TxOutputDataWithAddress[];
     /** @internal */
     get wasm(): WasmTransaction;
 }
@@ -74,29 +58,11 @@ export declare class Transaction implements ITransaction {
  *
  * Provides a camelCase, strongly-typed API over the snake_case WASM bindings.
  */
-export declare class ZcashTransaction implements ITransaction {
-    private _wasm;
+export declare class ZcashTransaction extends TransactionBase<WasmZcashTransaction> {
     private constructor();
     static fromBytes(bytes: Uint8Array): ZcashTransaction;
     /** @internal Create from WASM instance directly (avoids re-parsing bytes) */
     static fromWasm(wasm: WasmZcashTransaction): ZcashTransaction;
-    toBytes(): Uint8Array;
-    /**
-     * Get the transaction ID (txid)
-     *
-     * The txid is the double SHA256 of the full Zcash transaction bytes,
-     * displayed in reverse byte order as is standard.
-     *
-     * @returns The transaction ID as a hex string
-     */
-    getId(): string;
-    inputCount(): number;
-    outputCount(): number;
-    version(): number;
-    lockTime(): number;
-    getInputs(): TxInputData[];
-    getOutputs(): TxOutputData[];
-    getOutputsWithAddress(coin: CoinName): TxOutputDataWithAddress[];
     /** @internal */
     get wasm(): WasmZcashTransaction;
 }
@@ -105,29 +71,11 @@ export declare class ZcashTransaction implements ITransaction {
  *
  * Round-trip only: bytes -> parse -> bytes.
  */
-export declare class DashTransaction implements ITransaction {
-    private _wasm;
+export declare class DashTransaction extends TransactionBase<WasmDashTransaction> {
     private constructor();
     static fromBytes(bytes: Uint8Array): DashTransaction;
     /** @internal Create from WASM instance directly (avoids re-parsing bytes) */
     static fromWasm(wasm: WasmDashTransaction): DashTransaction;
-    toBytes(): Uint8Array;
-    /**
-     * Get the transaction ID (txid)
-     *
-     * The txid is the double SHA256 of the full Dash transaction bytes,
-     * displayed in reverse byte order as is standard.
-     *
-     * @returns The transaction ID as a hex string
-     */
-    getId(): string;
-    inputCount(): number;
-    outputCount(): number;
-    version(): number;
-    lockTime(): number;
-    getInputs(): TxInputData[];
-    getOutputs(): TxOutputData[];
-    getOutputsWithAddress(coin: CoinName): TxOutputDataWithAddress[];
     /** @internal */
     get wasm(): WasmDashTransaction;
 }