feat(abstract-utxo): default to wasm-utxo on testnet

Change the default SDK backend to wasm-utxo for testnet coins, keeping
utxolib for mainnet. Also enhance PSBT transaction handling to support
key path spend input detection in both backends.

Issue: BTC-3018

Co-authored-by: llm-git <llm-git@ttll.de>

Author: OttoAllmendinger

modules/abstract-utxo/src/abstractUtxoCoin.ts

@@ -57,7 +57,7 @@ import {
   v1Sweep,
   V1SweepParams,
 } from './recovery';
-import { isReplayProtectionUnspent } from './transaction/fixedScript/replayProtection';
+import { getReplayProtectionPubkeys, isReplayProtectionUnspent } from './transaction/fixedScript/replayProtection';
 import { supportedCrossChainRecoveries } from './config';
 import {
   assertValidTransactionRecipient,
@@ -81,6 +81,7 @@ import {
   getMainnetCoinName,
   getNetworkFromCoinName,
   isTestnetCoin,
+  isUtxoCoinNameMainnet,
   UtxoCoinName,
   UtxoCoinNameMainnet,
 } from './names';
@@ -143,6 +144,28 @@ type UtxoCustomSigningFunction<TNumber extends number | bigint> = {
 
 const { isChainCode, scriptTypeForChain, outputScripts } = bitgo;
 
+/**
+ * Check if a decoded transaction has at least one taproot key path spend (MuSig2) input.
+ * Works for both utxolib UtxoPsbt and wasm-utxo BitGoPsbt.
+ */
+function hasKeyPathSpendInput<TNumber extends number | bigint>(
+  tx: DecodedTransaction<TNumber>,
+  pubs: string[] | undefined,
+  coinName: UtxoCoinName
+): boolean {
+  if (tx instanceof bitgo.UtxoPsbt) {
+    return bitgo.isTransactionWithKeyPathSpendInput(tx);
+  }
+  if (tx instanceof fixedScriptWallet.BitGoPsbt) {
+    assert(pubs && isTriple(pubs), 'pub triple is required to check for key path spend inputs in wasm-utxo PSBT');
+    const rootWalletKeys = fixedScriptWallet.RootWalletKeys.fromXpubs(pubs);
+    const replayProtection = { publicKeys: getReplayProtectionPubkeys(coinName) };
+    const parsed = tx.parseTransactionWithWalletKeys(rootWalletKeys, replayProtection);
+    return parsed.inputs.some((input) => input.scriptType === 'p2trMusig2KeyPath');
+  }
+  return false;
+}
+
 /**
  * Convert ValidationError to TxIntentMismatchRecipientError with structured data
  *
@@ -379,14 +402,17 @@ export abstract class AbstractUtxoCoin
 
   public altScriptHash?: number;
   public supportAltScriptDestination?: boolean;
-  public defaultSdkBackend: SdkBackend = 'utxolib';
   public readonly amountType: 'number' | 'bigint';
 
   protected constructor(bitgo: BitGoBase, amountType: 'number' | 'bigint' = 'number') {
     super(bitgo);
     this.amountType = amountType;
   }
 
+  get defaultSdkBackend(): SdkBackend {
+    return isUtxoCoinNameMainnet(this.name) ? 'utxolib' : 'wasm-utxo';
+  }
+
   /**
    * @deprecated - will be removed when we drop support for utxolib
    * Use `name` property instead.
@@ -814,7 +840,7 @@ export abstract class AbstractUtxoCoin
 
     const tx = this.decodeTransaction(txHex);
 
-    const isTxWithKeyPathSpendInput = tx instanceof bitgo.UtxoPsbt && bitgo.isTransactionWithKeyPathSpendInput(tx);
+    const isTxWithKeyPathSpendInput = hasKeyPathSpendInput(tx, signTransactionParams.pubs, this.name);
 
     if (!isTxWithKeyPathSpendInput) {
       return await customSigningFunction({ ...signTransactionParams, coin: this });

modules/abstract-utxo/test/unit/customSigner.ts

@@ -43,13 +43,14 @@ describe('UTXO Custom Signer Function', function () {
   });
 
   function nocks(txPrebuild: { txHex: string }) {
+    const pubs = rootWalletKey.triple.map((k) => k.neutered().toBase58());
     nock(bgUrl)
       .post(`/api/v2/${wallet.coin()}/wallet/${wallet.id()}/tx/build`)
       .reply(200, { ...txPrebuild, txInfo: {} });
     nock(bgUrl).get(`/api/v2/${wallet.coin()}/public/block/latest`).reply(200, { height: 1000 });
-    nock(bgUrl).persist().get(`/api/v2/${wallet.coin()}/key/${wallet.keyIds()[0]}`).reply(200, { pub: 'pub' });
-    nock(bgUrl).persist().get(`/api/v2/${wallet.coin()}/key/${wallet.keyIds()[1]}`).reply(200, { pub: 'pub' });
-    nock(bgUrl).persist().get(`/api/v2/${wallet.coin()}/key/${wallet.keyIds()[2]}`).reply(200, { pub: 'pub' });
+    nock(bgUrl).persist().get(`/api/v2/${wallet.coin()}/key/${wallet.keyIds()[0]}`).reply(200, { pub: pubs[0] });
+    nock(bgUrl).persist().get(`/api/v2/${wallet.coin()}/key/${wallet.keyIds()[1]}`).reply(200, { pub: pubs[1] });
+    nock(bgUrl).persist().get(`/api/v2/${wallet.coin()}/key/${wallet.keyIds()[2]}`).reply(200, { pub: pubs[2] });
     return nock(bgUrl).post(`/api/v2/${wallet.coin()}/wallet/${wallet.id()}/tx/send`).reply(200, { ok: true });
   }
 

modules/abstract-utxo/test/unit/explainTransaction.ts

@@ -1,18 +1,46 @@
 import assert from 'assert';
 
-import { Triple } from '@bitgo/sdk-core';
+import { common, Triple, Wallet } from '@bitgo/sdk-core';
+import nock = require('nock');
 
 import { bip322Fixtures } from './fixtures/bip322/fixtures';
 import { psbtTxHex } from './fixtures/psbtHexProof';
-import { getUtxoCoin } from './util';
+import { defaultBitGo, getUtxoCoin } from './util';
+
+nock.disableNetConnect();
+
+const bgUrl = common.Environments[defaultBitGo.getEnv()].uri;
 
 describe('Explain Transaction', function () {
+  afterEach(function () {
+    nock.cleanAll();
+  });
+
   describe('Verify paygo output when explaining psbt transaction', function () {
     const coin = getUtxoCoin('tbtc4');
 
+    const pubs: Triple<string> = [
+      'xpub661MyMwAqRbcFaKvNBFdV6HY7ibXxFSbL7rDjY1cVM8s3pGPTNKfjTu8SmatNZ7AcZQehSqcEnC7vezMoprQvhqQUszLhuY4G8ruv6PGEr7',
+      'xpub661MyMwAqRbcGkAVVQVHrEYQA4hfbDW9Rpn35b6sXA9TSBd5Qzjwz7F6Weje57kBVeVfimfJjXutwUDBSMz5yRwsWik9gNyxrdvSaJbjgi6',
+      'xpub661MyMwAqRbcGCCL3GYNbvKs1t5k5yeKZcV5smto9T5Z17zkcgRF4X9uzDfPxMHHedwF4JcJ6kpg8M2NWHEFC5LMSv1t3nMMm1GC9PcVmq5',
+    ];
+
+    const keyIds = ['key-user', 'key-backup', 'key-bitgo'];
+
+    function nockKeyFetch(): void {
+      keyIds.forEach((id, i) => {
+        nock(bgUrl).get(`/api/v2/${coin.getChain()}/key/${id}`).reply(200, { pub: pubs[i] });
+      });
+    }
+
     it('should detect and verify paygo address proof in PSBT', async function () {
-      // Call explainTransaction
-      await coin.explainTransaction(psbtTxHex);
+      nockKeyFetch();
+      const wallet = new Wallet(defaultBitGo, coin, {
+        id: 'mock-wallet-id',
+        coin: coin.getChain(),
+        keys: keyIds,
+      });
+      await coin.explainTransaction(psbtTxHex, wallet);
     });
   });
 

modules/abstract-utxo/test/unit/wallet.ts

@@ -52,11 +52,11 @@ describe('manage unspents', function () {
     );
 
     nocks.push(
-      ...psbts.map((psbt) =>
+      ...psbts.map(() =>
         nock(bgUrl)
           .post(
             `/api/v2/${wallet.coin()}/wallet/${wallet.id()}/tx/send`,
-            _.matches({ txHex: psbt.signAllInputsHD(rootWalletKey.user).toHex() })
+            _.matches({ type: 'consolidate', bulk: true })
           )
           .reply(200)
       )
@@ -92,10 +92,7 @@ describe('manage unspents', function () {
 
     nocks.push(
       nock(bgUrl)
-        .post(
-          `/api/v2/${wallet.coin()}/wallet/${wallet.id()}/tx/send`,
-          _.matches({ txHex: psbt.signAllInputsHD(rootWalletKey.user).toHex() })
-        )
+        .post(`/api/v2/${wallet.coin()}/wallet/${wallet.id()}/tx/send`, _.matches({ type: 'consolidate' }))
         .reply(200)
     );