feat(wasm-utxo): add BitGoPsbt class for transaction parsing

Implements a new BitGoPsbt class that allows parsing PSBT transactions to
identify wallet inputs and outputs. This implementation provides:

- PSBT deserialization with network-specific handling
- Transaction parsing with wallet script identification
- Input validation with replay protection support
- Output classification (internal vs external)
- Fee and spend amount calculations

The implementation extracts derivation info from PSBT inputs/outputs to
match against wallet keys, providing a structured view of transactions
for wallet UIs and validation purposes.

Added comprehensive tests for the new functionality across all supported
networks. Includes TypeScript definitions and integration with existing
fixed script wallet functionality.

Issue: BTC-2652

Co-authored-by: llm-git <[email protected]>

Author: OttoAllmendinger

packages/wasm-utxo/js/fixedScriptWallet.ts

@@ -1,8 +1,11 @@
 import { FixedScriptWalletNamespace } from "./wasm/wasm_utxo";
-import type { UtxolibNetwork, UtxolibRootWalletKeys } from "./utxolibCompat";
+import type { UtxolibName, UtxolibNetwork, UtxolibRootWalletKeys } from "./utxolibCompat";
+import type { CoinName } from "./coinName";
 import { Triple } from "./triple";
 import { AddressFormat } from "./address";
 
+export type NetworkName = UtxolibName | CoinName;
+
 export type WalletKeys =
   /** Just an xpub triple, will assume default derivation prefixes  */
   | Triple<string>
@@ -42,3 +45,65 @@ export function address(
 ): string {
   return FixedScriptWalletNamespace.address(keys, chain, index, network, addressFormat);
 }
+
+type ReplayProtection =
+  | {
+      outputScripts: Uint8Array[];
+    }
+  | {
+      addresses: string[];
+    };
+
+export type ScriptId = { chain: number; index: number };
+
+export type ParsedInput = {
+  address?: string;
+  script: Uint8Array;
+  value: bigint;
+  scriptId: ScriptId | undefined;
+};
+
+export type ParsedOutput = {
+  address?: string;
+  script: Uint8Array;
+  value: bigint;
+  scriptId?: ScriptId;
+};
+
+export type ParsedTransaction = {
+  inputs: ParsedInput[];
+  outputs: ParsedOutput[];
+  spendAmount: bigint;
+  minerFee: bigint;
+  virtualSize: number;
+};
+
+import { BitGoPsbt as WasmBitGoPsbt } from "./wasm/wasm_utxo";
+
+export class BitGoPsbt {
+  private constructor(private wasm: WasmBitGoPsbt) {}
+
+  /**
+   * Deserialize a PSBT from bytes
+   * @param bytes - The PSBT bytes
+   * @param network - The network to use for deserialization (either utxolib name like "bitcoin" or coin name like "btc")
+   * @returns A BitGoPsbt instance
+   */
+  static fromBytes(bytes: Uint8Array, network: NetworkName): BitGoPsbt {
+    const wasm = WasmBitGoPsbt.fromBytes(bytes, network);
+    return new BitGoPsbt(wasm);
+  }
+
+  /**
+   * Parse transaction with wallet keys to identify wallet inputs/outputs
+   * @param walletKeys - The wallet keys to use for identification
+   * @param replayProtection - Scripts that are allowed as inputs without wallet validation
+   * @returns Parsed transaction information
+   */
+  parseTransactionWithWalletKeys(
+    walletKeys: WalletKeys,
+    replayProtection: ReplayProtection,
+  ): ParsedTransaction {
+    return this.wasm.parseTransactionWithWalletKeys(walletKeys, replayProtection);
+  }
+}

packages/wasm-utxo/js/utxolibCompat.ts

@@ -2,6 +2,29 @@ import type { AddressFormat } from "./address";
 import { Triple } from "./triple";
 import { UtxolibCompatNamespace } from "./wasm/wasm_utxo";
 
+export type UtxolibName =
+  | "bitcoin"
+  | "testnet"
+  | "bitcoinTestnet4"
+  | "bitcoinPublicSignet"
+  | "bitcoinBitGoSignet"
+  | "bitcoincash"
+  | "bitcoincashTestnet"
+  | "ecash"
+  | "ecashTest"
+  | "bitcoingold"
+  | "bitcoingoldTestnet"
+  | "bitcoinsv"
+  | "bitcoinsvTestnet"
+  | "dash"
+  | "dashTest"
+  | "dogecoin"
+  | "dogecoinTest"
+  | "litecoin"
+  | "litecoinTest"
+  | "zcash"
+  | "zcashTest";
+
 export type BIP32Interface = {
   network: {
     bip32: {