@bitgo/wasm-utxo 4.0.2 → 4.2.0

package/dist/cjs/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;
 }

package/dist/cjs/js/transaction.js

@@ -2,15 +2,15 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.DashTransaction = exports.ZcashTransaction = exports.Transaction = void 0;
 const wasm_utxo_js_1 = require("./wasm/wasm_utxo.js");
+const transactionBase_js_1 = require("./transactionBase.js");
 /**
  * Transaction wrapper (Bitcoin-like networks)
  *
  * Provides a camelCase, strongly-typed API over the snake_case WASM bindings.
  */
-class Transaction {
-    _wasm;
-    constructor(_wasm) {
-        this._wasm = _wasm;
+class Transaction extends transactionBase_js_1.TransactionBase {
+    constructor(wasm) {
+        super(wasm);
     }
     /**
      * Create an empty transaction (version 1, locktime 0)
@@ -44,20 +44,6 @@ class Transaction {
     addOutput(script, value) {
         return this._wasm.add_output(script, value);
     }
-    toBytes() {
-        return this._wasm.to_bytes();
-    }
-    /**
-     * 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() {
-        return this._wasm.get_txid();
-    }
     /**
      * Get the virtual size of the transaction
      *
@@ -68,27 +54,6 @@ class Transaction {
     getVSize() {
         return this._wasm.get_vsize();
     }
-    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;
@@ -100,10 +65,9 @@ exports.Transaction = Transaction;
  *
  * Provides a camelCase, strongly-typed API over the snake_case WASM bindings.
  */
-class ZcashTransaction {
-    _wasm;
-    constructor(_wasm) {
-        this._wasm = _wasm;
+class ZcashTransaction extends transactionBase_js_1.TransactionBase {
+    constructor(wasm) {
+        super(wasm);
     }
     static fromBytes(bytes) {
         return new ZcashTransaction(wasm_utxo_js_1.WasmZcashTransaction.from_bytes(bytes));
@@ -112,41 +76,6 @@ class ZcashTransaction {
     static fromWasm(wasm) {
         return new ZcashTransaction(wasm);
     }
-    toBytes() {
-        return this._wasm.to_bytes();
-    }
-    /**
-     * 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() {
-        return this._wasm.get_txid();
-    }
-    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;
@@ -158,10 +87,9 @@ exports.ZcashTransaction = ZcashTransaction;
  *
  * Round-trip only: bytes -> parse -> bytes.
  */
-class DashTransaction {
-    _wasm;
-    constructor(_wasm) {
-        this._wasm = _wasm;
+class DashTransaction extends transactionBase_js_1.TransactionBase {
+    constructor(wasm) {
+        super(wasm);
     }
     static fromBytes(bytes) {
         return new DashTransaction(wasm_utxo_js_1.WasmDashTransaction.from_bytes(bytes));
@@ -170,41 +98,6 @@ class DashTransaction {
     static fromWasm(wasm) {
         return new DashTransaction(wasm);
     }
-    toBytes() {
-        return this._wasm.to_bytes();
-    }
-    /**
-     * 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() {
-        return this._wasm.get_txid();
-    }
-    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/transactionBase.d.ts

@@ -0,0 +1,28 @@
+import type { TxInputData, TxOutputData, TxOutputDataWithAddress } from "./wasm/wasm_utxo.js";
+import type { CoinName } from "./coinName.js";
+import type { ITransaction } from "./transaction.js";
+interface WasmTransactionLike {
+    input_count(): number;
+    output_count(): number;
+    version(): number;
+    lock_time(): number;
+    to_bytes(): Uint8Array;
+    get_txid(): string;
+    get_inputs(): unknown;
+    get_outputs(): unknown;
+    get_outputs_with_address(coin: string): unknown;
+}
+export declare abstract class TransactionBase<W extends WasmTransactionLike> implements ITransaction {
+    protected _wasm: W;
+    constructor(wasm: W);
+    inputCount(): number;
+    outputCount(): number;
+    version(): number;
+    lockTime(): number;
+    toBytes(): Uint8Array;
+    getId(): string;
+    getInputs(): TxInputData[];
+    getOutputs(): TxOutputData[];
+    getOutputsWithAddress(coin: CoinName): TxOutputDataWithAddress[];
+}
+export {};

package/dist/cjs/js/transactionBase.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TransactionBase = void 0;
+class TransactionBase {
+    _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();
+    }
+    toBytes() {
+        return this._wasm.to_bytes();
+    }
+    getId() {
+        return this._wasm.get_txid();
+    }
+    getInputs() {
+        return this._wasm.get_inputs();
+    }
+    getOutputs() {
+        return this._wasm.get_outputs();
+    }
+    getOutputsWithAddress(coin) {
+        return this._wasm.get_outputs_with_address(coin);
+    }
+}
+exports.TransactionBase = TransactionBase;

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

@@ -334,7 +334,9 @@ export class BitGoPsbt {
      */
     generate_musig2_nonces(xpriv: WasmBIP32, session_id_bytes?: Uint8Array | null): void;
     get_global_xpubs(): any;
+    get_input_kv(index: number, key: any): Uint8Array | undefined;
     get_inputs(): any;
+    get_kv(key: any): Uint8Array | undefined;
     /**
      * Get the network type for transaction extraction
      *
@@ -342,6 +344,7 @@ export class BitGoPsbt {
      * wrapper class should be used in TypeScript.
      */
     get_network_type(): string;
+    get_output_kv(index: number, key: any): Uint8Array | undefined;
     get_outputs(): any;
     get_outputs_with_address(): any;
     input_count(): number;
@@ -384,6 +387,9 @@ export class BitGoPsbt {
      * The serialized PSBT as a byte array
      */
     serialize(): Uint8Array;
+    set_input_kv(index: number, key: any, value: Uint8Array): void;
+    set_kv(key: any, value: Uint8Array): void;
+    set_output_kv(index: number, key: any, value: Uint8Array): void;
     /**
      * Sign all MuSig2 keypath inputs in a single pass with optimized sighash computation.
      *
@@ -583,10 +589,7 @@ export class BitGoPsbt {
      * - `Err(WasmUtxoError)` if signing fails
      */
     sign_with_xpriv(input_index: number, xpriv: WasmBIP32): void;
-    /**
-     * Get the unsigned transaction ID
-     */
-    unsigned_txid(): string;
+    unsigned_tx_id(): string;
     /**
      * Verify if a replay protection input has a valid signature
      *
@@ -676,6 +679,11 @@ export class FixedScriptWalletNamespace {
      * The OP_RETURN script as bytes
      */
     static create_op_return_script(data?: Uint8Array | null): Uint8Array;
+    /**
+     * Returns an object mapping BitGo proprietary key subtype names to their `u8` values.
+     * Values are loaded directly from the Rust enum at build time — no duplication in TypeScript.
+     */
+    static get_bitgo_key_subtypes(): any;
     static output_script(keys: WasmRootWalletKeys, chain: number, index: number, network: any): Uint8Array;
     static output_script_with_network_str(keys: WasmRootWalletKeys, chain: number, index: number, network: string): Uint8Array;
     /**
@@ -1234,6 +1242,19 @@ export class WasmTransaction {
     version(): number;
 }
 
+/**
+ * Top-level package info namespace
+ */
+export class WasmUtxoNamespace {
+    private constructor();
+    free(): void;
+    [Symbol.dispose](): void;
+    /**
+     * Returns the wasm-utxo build version as `{ version: string, gitHash: string }`.
+     */
+    static get_wasm_utxo_version(): any;
+}
+
 /**
  * A Zcash transaction with network-specific fields
  *
@@ -1356,7 +1377,10 @@ export class WrapPsbt {
     extract_transaction(): WasmTransaction;
     finalize_mut(): void;
     get_global_xpubs(): any;
+    get_input_kv(index: number, key: any): Uint8Array | undefined;
     get_inputs(): any;
+    get_kv(key: any): Uint8Array | undefined;
+    get_output_kv(index: number, key: any): Uint8Array | undefined;
     get_outputs(): any;
     get_outputs_with_address(coin: string): any;
     get_partial_signatures(input_index: number): any;
@@ -1382,6 +1406,9 @@ export class WrapPsbt {
     remove_input(index: number): void;
     remove_output(index: number): void;
     serialize(): Uint8Array;
+    set_input_kv(index: number, key: any, value: Uint8Array): void;
+    set_kv(key: any, value: Uint8Array): void;
+    set_output_kv(index: number, key: any, value: Uint8Array): void;
     /**
      * Sign all inputs with a WasmBIP32 key
      *