@bitgo/wasm-utxo 1.44.0 → 2.0.0

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

@@ -1,5 +1,5 @@
 import { BitGoPsbt as WasmBitGoPsbt, type PsbtInputData, type PsbtOutputData, type PsbtOutputDataWithAddress } from "../wasm/wasm_utxo.js";
-import type { IPsbtIntrospectionWithAddress } from "../psbt.js";
+import type { IPsbtWithAddress } from "../psbt.js";
 import { type WalletKeysArg } from "./RootWalletKeys.js";
 import { type ReplayProtectionArg } from "./ReplayProtection.js";
 import { type BIP32Arg } from "../bip32.js";
@@ -98,7 +98,7 @@ export type ParseTransactionOptions = {
 export type ParseOutputsOptions = {
     payGoPubkeys?: ECPairArg[];
 };
-export declare class BitGoPsbt implements IPsbtIntrospectionWithAddress {
+export declare class BitGoPsbt implements IPsbtWithAddress {
     protected _wasm: WasmBitGoPsbt;
     protected constructor(_wasm: WasmBitGoPsbt);
     /**
@@ -155,6 +155,8 @@ export declare class BitGoPsbt implements IPsbtIntrospectionWithAddress {
      * }, outputScript);
      * ```
      */
+    addInputAtIndex(index: number, txid: string, vout: number, value: bigint, script: Uint8Array, sequence?: number): number;
+    addInputAtIndex(index: number, options: AddInputOptions, script: Uint8Array): number;
     addInput(options: AddInputOptions, script: Uint8Array): number;
     /**
      * Add an output to the PSBT
@@ -168,41 +170,11 @@ export declare class BitGoPsbt implements IPsbtIntrospectionWithAddress {
      * const outputIndex = psbt.addOutput(outputScript, 50000n);
      * ```
      */
+    addOutputAtIndex(index: number, script: Uint8Array, value: bigint): number;
+    addOutputAtIndex(index: number, address: string, value: bigint): number;
+    addOutputAtIndex(index: number, options: AddOutputOptions): number;
     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;
     /**
      * Add a wallet input with full PSBT metadata
@@ -243,6 +215,7 @@ export declare class BitGoPsbt implements IPsbtIntrospectionWithAddress {
      * );
      * ```
      */
+    addWalletInputAtIndex(index: number, inputOptions: AddInputOptions, walletKeys: WalletKeysArg, walletOptions: AddWalletInputOptions): number;
     addWalletInput(inputOptions: AddInputOptions, walletKeys: WalletKeysArg, walletOptions: AddWalletInputOptions): number;
     /**
      * Add a wallet output with full PSBT metadata
@@ -274,6 +247,7 @@ export declare class BitGoPsbt implements IPsbtIntrospectionWithAddress {
      * });
      * ```
      */
+    addWalletOutputAtIndex(index: number, walletKeys: WalletKeysArg, options: AddWalletOutputOptions): number;
     addWalletOutput(walletKeys: WalletKeysArg, options: AddWalletOutputOptions): number;
     /**
      * Add a replay protection input to the PSBT
@@ -294,22 +268,21 @@ export declare class BitGoPsbt implements IPsbtIntrospectionWithAddress {
      * );
      * ```
      */
+    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;
+    unsignedTxId(): string;
     /**
      * Get the transaction version
      * @returns The transaction version number
      */
-    get version(): number;
-    /**
-     * Get the transaction lock time
-     * @returns The transaction lock time
-     */
-    get lockTime(): number;
+    version(): number;
+    lockTime(): number;
     /**
      * Parse transaction with wallet keys to identify wallet inputs/outputs
      * @param walletKeys - The wallet keys to use for identification
@@ -584,12 +557,8 @@ export declare class BitGoPsbt implements IPsbtIntrospectionWithAddress {
      * Get the number of inputs in the PSBT
      * @returns The number of inputs
      */
-    get inputCount(): number;
-    /**
-     * Get the number of outputs in the PSBT
-     * @returns The number of outputs
-     */
-    get outputCount(): number;
+    inputCount(): number;
+    outputCount(): number;
     /**
      * Get all PSBT inputs as an array
      *

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

@@ -56,28 +56,35 @@ class BitGoPsbt {
         const wasm = wasm_utxo_js_1.BitGoPsbt.from_bytes(bytes, network);
         return new BitGoPsbt(wasm);
     }
-    /**
-     * Add an input to the PSBT
-     *
-     * This adds a transaction input and corresponding PSBT input metadata.
-     * The witness_utxo is automatically populated for modern signing compatibility.
-     *
-     * @param options - Input options (txid, vout, value, sequence)
-     * @param script - Output script of the UTXO being spent
-     * @returns The index of the newly added input
-     *
-     * @example
-     * ```typescript
-     * const inputIndex = psbt.addInput({
-     *   txid: "abc123...",
-     *   vout: 0,
-     *   value: 100000n,
-     * }, outputScript);
-     * ```
-     */
+    addInputAtIndex(index, txidOrOptions, voutOrScript, value, script, sequence) {
+        if (typeof txidOrOptions === "string") {
+            return this._wasm.add_input_at_index(index, txidOrOptions, voutOrScript, value, script, sequence);
+        }
+        const options = txidOrOptions;
+        return this._wasm.add_input_at_index(index, options.txid, options.vout, options.value, voutOrScript, options.sequence, options.prevTx);
+    }
     addInput(options, script) {
         return this._wasm.add_input(options.txid, options.vout, options.value, script, options.sequence, options.prevTx);
     }
+    addOutputAtIndex(index, 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_at_index(index, scriptOrOptions, value);
+            }
+            return this._wasm.add_output_with_address_at_index(index, scriptOrOptions, value);
+        }
+        const options = scriptOrOptions;
+        if ("script" in options) {
+            return this._wasm.add_output_at_index(index, options.script, options.value);
+        }
+        if ("address" in options) {
+            return this._wasm.add_output_with_address_at_index(index, options.address, options.value);
+        }
+        throw new Error("Invalid output options");
+    }
     addOutput(scriptOrOptions, value) {
         if (scriptOrOptions instanceof Uint8Array || typeof scriptOrOptions === "string") {
             if (value === undefined) {
@@ -136,6 +143,10 @@ class BitGoPsbt {
      * );
      * ```
      */
+    addWalletInputAtIndex(index, inputOptions, walletKeys, walletOptions) {
+        const keys = RootWalletKeys_js_1.RootWalletKeys.from(walletKeys);
+        return this._wasm.add_wallet_input_at_index(index, inputOptions.txid, inputOptions.vout, inputOptions.value, keys.wasm, walletOptions.scriptId.chain, walletOptions.scriptId.index, walletOptions.signPath?.signer, walletOptions.signPath?.cosigner, inputOptions.sequence, inputOptions.prevTx);
+    }
     addWalletInput(inputOptions, walletKeys, walletOptions) {
         const keys = RootWalletKeys_js_1.RootWalletKeys.from(walletKeys);
         return this._wasm.add_wallet_input(inputOptions.txid, inputOptions.vout, inputOptions.value, keys.wasm, walletOptions.scriptId.chain, walletOptions.scriptId.index, walletOptions.signPath?.signer, walletOptions.signPath?.cosigner, inputOptions.sequence, inputOptions.prevTx);
@@ -170,6 +181,10 @@ class BitGoPsbt {
      * });
      * ```
      */
+    addWalletOutputAtIndex(index, walletKeys, options) {
+        const keys = RootWalletKeys_js_1.RootWalletKeys.from(walletKeys);
+        return this._wasm.add_wallet_output_at_index(index, options.chain, options.index, options.value, keys.wasm);
+    }
     addWalletOutput(walletKeys, options) {
         const keys = RootWalletKeys_js_1.RootWalletKeys.from(walletKeys);
         return this._wasm.add_wallet_output(options.chain, options.index, options.value, keys.wasm);
@@ -193,29 +208,35 @@ class BitGoPsbt {
      * );
      * ```
      */
+    addReplayProtectionInputAtIndex(index, inputOptions, key) {
+        const ecpair = ecpair_js_1.ECPair.from(key);
+        return this._wasm.add_replay_protection_input_at_index(index, ecpair.wasm, inputOptions.txid, inputOptions.vout, inputOptions.value, inputOptions.sequence, inputOptions.prevTx);
+    }
     addReplayProtectionInput(inputOptions, key) {
         const ecpair = ecpair_js_1.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() {
+    unsignedTxId() {
         return this._wasm.unsigned_txid();
     }
     /**
      * Get the transaction version
      * @returns The transaction version number
      */
-    get version() {
+    version() {
         return this._wasm.version();
     }
-    /**
-     * Get the transaction lock time
-     * @returns The transaction lock time
-     */
-    get lockTime() {
+    lockTime() {
         return this._wasm.lock_time();
     }
     /**
@@ -541,14 +562,10 @@ class BitGoPsbt {
      * Get the number of inputs in the PSBT
      * @returns The number of inputs
      */
-    get inputCount() {
+    inputCount() {
         return this._wasm.input_count();
     }
-    /**
-     * Get the number of outputs in the PSBT
-     * @returns The number of outputs
-     */
-    get outputCount() {
+    outputCount() {
         return this._wasm.output_count();
     }
     /**

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

@@ -82,6 +82,10 @@ declare module "./wasm/wasm_utxo.js" {
         validateSignatureAtInput(inputIndex: number, pubkey: Uint8Array): boolean;
         verifySignatureWithKey(inputIndex: number, key: WasmBIP32): boolean;
         extractTransaction(): WasmTransaction;
+        addInputAtIndex(index: number, txid: string, vout: number, value: bigint, script: Uint8Array, sequence?: number): number;
+        addOutputAtIndex(index: number, script: Uint8Array, value: bigint): number;
+        removeInput(index: number): void;
+        removeOutput(index: number): void;
         unsignedTxId(): string;
         lockTime(): number;
         version(): number;
@@ -91,4 +95,4 @@ export { WrapDescriptor as Descriptor } from "./wasm/wasm_utxo.js";
 export { WrapMiniscript as Miniscript } from "./wasm/wasm_utxo.js";
 export { WrapPsbt as Psbt } from "./wasm/wasm_utxo.js";
 export { DashTransaction, Transaction, ZcashTransaction } from "./transaction.js";
-export { hasPsbtMagic, type IPsbtIntrospection, type IPsbtIntrospectionWithAddress, } from "./psbt.js";
+export { hasPsbtMagic, type IPsbt, type IPsbtWithAddress } from "./psbt.js";

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

@@ -1,13 +1,20 @@
 import type { PsbtInputData, PsbtOutputData, PsbtOutputDataWithAddress } from "./wasm/wasm_utxo.js";
-/** Common interface for PSBT introspection methods */
-export interface IPsbtIntrospection {
-    readonly inputCount: number;
-    readonly outputCount: number;
+/** Common interface for PSBT types */
+export interface IPsbt {
+    inputCount(): number;
+    outputCount(): number;
     getInputs(): PsbtInputData[];
     getOutputs(): PsbtOutputData[];
+    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;
+    removeInput(index: number): void;
+    removeOutput(index: number): void;
 }
-/** Extended introspection with address resolution (no coin parameter needed) */
-export interface IPsbtIntrospectionWithAddress extends IPsbtIntrospection {
+/** Extended PSBT with address resolution (no coin parameter needed) */
+export interface IPsbtWithAddress extends IPsbt {
     getOutputsWithAddress(): PsbtOutputDataWithAddress[];
 }
 /**

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

@@ -30,13 +30,9 @@ export declare class Transaction implements ITransaction {
      * @param sequence - Optional sequence number (default: 0xFFFFFFFF)
      * @returns The index of the newly added input
      */
+    addInputAtIndex(index: number, txid: string, vout: number, sequence?: number): number;
     addInput(txid: string, vout: number, sequence?: number): number;
-    /**
-     * Add an output to the transaction
-     * @param script - Output script (scriptPubKey)
-     * @param value - Value in satoshis
-     * @returns The index of the newly added output
-     */
+    addOutputAtIndex(index: number, script: Uint8Array, value: bigint): number;
     addOutput(script: Uint8Array, value: bigint): number;
     toBytes(): Uint8Array;
     /**

package/dist/cjs/js/transaction.js

@@ -34,15 +34,15 @@ class Transaction {
      * @param sequence - Optional sequence number (default: 0xFFFFFFFF)
      * @returns The index of the newly added input
      */
+    addInputAtIndex(index, txid, vout, sequence) {
+        return this._wasm.add_input_at_index(index, txid, vout, sequence);
+    }
     addInput(txid, vout, sequence) {
         return this._wasm.add_input(txid, vout, sequence);
     }
-    /**
-     * Add an output to the transaction
-     * @param script - Output script (scriptPubKey)
-     * @param value - Value in satoshis
-     * @returns The index of the newly added output
-     */
+    addOutputAtIndex(index, script, value) {
+        return this._wasm.add_output_at_index(index, script, value);
+    }
     addOutput(script, value) {
         return this._wasm.add_output(script, value);
     }

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

@@ -116,6 +116,7 @@ export class BitGoPsbt {
     private constructor();
     free(): void;
     [Symbol.dispose](): void;
+    add_input(txid: string, vout: number, value: bigint, script: Uint8Array, sequence?: number | null, prev_tx?: Uint8Array | null): number;
     /**
      * Add an input to the PSBT
      *
@@ -129,29 +130,11 @@ export class BitGoPsbt {
      * # Returns
      * The index of the newly added input
      */
-    add_input(txid: string, vout: number, value: bigint, script: Uint8Array, sequence?: number | null, prev_tx?: Uint8Array | null): number;
-    /**
-     * Add an output to the PSBT
-     *
-     * # Arguments
-     * * `script` - The output script (scriptPubKey)
-     * * `value` - The value in satoshis
-     *
-     * # Returns
-     * The index of the newly added output
-     */
+    add_input_at_index(index: number, txid: string, vout: number, value: bigint, script: Uint8Array, sequence?: number | null, prev_tx?: Uint8Array | null): number;
     add_output(script: Uint8Array, value: bigint): number;
-    /**
-     * 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_at_index(index: number, script: Uint8Array, value: bigint): number;
     add_output_with_address(address: string, value: bigint): number;
+    add_output_with_address_at_index(index: number, address: string, value: bigint): number;
     /**
      * Add a PayGo attestation to a PSBT output
      *
@@ -165,61 +148,12 @@ export class BitGoPsbt {
      * - `Err(WasmUtxoError)` if the output index is out of bounds or entropy is invalid
      */
     add_paygo_attestation(output_index: number, entropy: Uint8Array, signature: Uint8Array): void;
-    /**
-     * Add a replay protection input to the PSBT
-     *
-     * Replay protection inputs are P2SH-P2PK inputs used on forked networks to prevent
-     * transaction replay attacks. They use a simple pubkey script without wallet derivation.
-     *
-     * # Arguments
-     * * `ecpair` - The ECPair containing the public key for the replay protection input
-     * * `txid` - The transaction ID (hex string) of the output being spent
-     * * `vout` - The output index being spent
-     * * `value` - The value in satoshis
-     * * `sequence` - Optional sequence number (default: 0xFFFFFFFE for RBF)
-     *
-     * # Returns
-     * The index of the newly added input
-     */
     add_replay_protection_input(ecpair: WasmECPair, txid: string, vout: number, value: bigint, sequence?: number | null, prev_tx?: Uint8Array | null): number;
-    /**
-     * Add a wallet input with full PSBT metadata
-     *
-     * This is a higher-level method that adds an input and populates all required
-     * PSBT fields (scripts, derivation info, etc.) based on the wallet's chain type.
-     *
-     * # Arguments
-     * * `txid` - The transaction ID (hex string)
-     * * `vout` - The output index being spent
-     * * `value` - The value in satoshis
-     * * `chain` - The chain code (0/1=p2sh, 10/11=p2shP2wsh, 20/21=p2wsh, 30/31=p2tr, 40/41=p2trMusig2)
-     * * `index` - The derivation index
-     * * `wallet_keys` - The root wallet keys
-     * * `signer` - The key that will sign ("user", "backup", or "bitgo") - required for p2tr/p2trMusig2
-     * * `cosigner` - The key that will co-sign - required for p2tr/p2trMusig2
-     * * `sequence` - Optional sequence number (default: 0xFFFFFFFE for RBF)
-     * * `prev_tx` - Optional full previous transaction bytes (for non-segwit)
-     *
-     * # Returns
-     * The index of the newly added input
-     */
+    add_replay_protection_input_at_index(index: number, ecpair: WasmECPair, txid: string, vout: number, value: bigint, sequence?: number | null, prev_tx?: Uint8Array | 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 a wallet output with full PSBT metadata
-     *
-     * This creates a verifiable wallet output (typically for change) with all required
-     * PSBT fields (scripts, derivation info) based on the wallet's chain type.
-     *
-     * # Arguments
-     * * `chain` - The chain code (0/1=p2sh, 10/11=p2shP2wsh, 20/21=p2wsh, 30/31=p2tr, 40/41=p2trMusig2)
-     * * `index` - The derivation index
-     * * `value` - The value in satoshis
-     * * `wallet_keys` - The root wallet keys
-     *
-     * # Returns
-     * The index of the newly added output
-     */
+    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;
+    add_wallet_output_at_index(index: number, chain: number, derivation_index: number, value: bigint, wallet_keys: WasmRootWalletKeys): number;
     /**
      * Combine/merge data from another PSBT into this one
      *
@@ -452,6 +386,8 @@ export class BitGoPsbt {
      * Parse transaction with wallet keys to identify wallet inputs/outputs
      */
     parse_transaction_with_wallet_keys(wallet_keys: WasmRootWalletKeys, replay_protection: WasmReplayProtection, paygo_pubkeys?: WasmECPair[] | null): any;
+    remove_input(index: number): void;
+    remove_output(index: number): void;
     /**
      * Serialize the PSBT to bytes
      *
@@ -1230,6 +1166,7 @@ export class WasmTransaction {
     private constructor();
     free(): void;
     [Symbol.dispose](): void;
+    add_input(txid: string, vout: number, sequence?: number | null): number;
     /**
      * Add an input to the transaction
      *
@@ -1241,18 +1178,9 @@ export class WasmTransaction {
      * # Returns
      * The index of the newly added input
      */
-    add_input(txid: string, vout: number, sequence?: number | null): number;
-    /**
-     * Add an output to the transaction
-     *
-     * # Arguments
-     * * `script` - The output script (scriptPubKey)
-     * * `value` - The value in satoshis
-     *
-     * # Returns
-     * The index of the newly added output
-     */
+    add_input_at_index(index: number, txid: string, vout: number, sequence?: number | null): number;
     add_output(script: Uint8Array, value: bigint): number;
+    add_output_at_index(index: number, script: Uint8Array, value: bigint): number;
     /**
      * Create an empty transaction (version 1, locktime 0)
      */
@@ -1373,6 +1301,7 @@ export class WrapMiniscript {
 export class WrapPsbt {
     free(): void;
     [Symbol.dispose](): void;
+    addInput(txid: string, vout: number, value: bigint, script: Uint8Array, sequence?: number | null): number;
     /**
      * Add an input to the PSBT
      *
@@ -1386,7 +1315,8 @@ export class WrapPsbt {
      * # Returns
      * The index of the newly added input
      */
-    addInput(txid: string, vout: number, value: bigint, script: Uint8Array, sequence?: number | null): number;
+    addInputAtIndex(index: number, txid: string, vout: number, value: bigint, script: Uint8Array, sequence?: number | null): number;
+    addOutput(script: Uint8Array, value: bigint): number;
     /**
      * Add an output to the PSBT
      *
@@ -1397,7 +1327,7 @@ export class WrapPsbt {
      * # Returns
      * The index of the newly added output
      */
-    addOutput(script: Uint8Array, value: bigint): number;
+    addOutputAtIndex(index: number, script: Uint8Array, value: bigint): number;
     clone(): WrapPsbt;
     static deserialize(psbt: Uint8Array): WrapPsbt;
     /**
@@ -1469,6 +1399,8 @@ export class WrapPsbt {
      * Get the number of outputs in the PSBT
      */
     outputCount(): number;
+    removeInput(index: number): void;
+    removeOutput(index: number): void;
     serialize(): Uint8Array;
     /**
      * Sign all inputs with a WasmBIP32 key