@bitgo/wasm-utxo 1.44.0 → 2.1.0

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

@@ -1,13 +1,22 @@
 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;
+import type { BIP32 } from "./bip32.js";
+/** Common interface for PSBT types */
+export interface IPsbt {
+    inputCount(): number;
+    outputCount(): number;
     getInputs(): PsbtInputData[];
     getOutputs(): 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;
+    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/esm/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/esm/js/transaction.js

@@ -31,15 +31,15 @@ export 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/esm/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
      *
@@ -384,6 +318,10 @@ 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;
+    /**
+     * Returns the global xpubs from the PSBT as an array of WasmBIP32 instances.
+     */
+    get_global_xpubs(): any;
     /**
      * Get all PSBT inputs as an array of PsbtInputData
      *
@@ -452,6 +390,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
      *
@@ -782,6 +722,12 @@ export class FixedScriptWalletNamespace {
      * - Dogecoin only supports legacy scripts (p2sh)
      */
     static supports_script_type(coin: string, script_type: string): boolean;
+    /**
+     * Sort an xpub triple into [user, backup, bitgo] order by validating
+     * against the PSBT's wallet inputs. Returns a RootWalletKeys with the
+     * correct ordering.
+     */
+    static to_wallet_keys(psbt: BitGoPsbt, user_or_a: WasmBIP32, backup_or_b: WasmBIP32, bitgo_or_c: WasmBIP32): WasmRootWalletKeys;
 }
 
 /**
@@ -1230,6 +1176,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 +1188,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 +1311,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 +1325,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 +1337,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;
     /**
@@ -1412,6 +1352,10 @@ export class WrapPsbt {
      */
     extractTransaction(): WasmTransaction;
     finalize(): void;
+    /**
+     * Get global xpubs from the PSBT as an array of WasmBIP32 instances.
+     */
+    getGlobalXpubs(): any;
     /**
      * Get all PSBT inputs as an array of PsbtInputData
      *
@@ -1469,6 +1413,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