feat(statics): add Pearl (PEARL) to statics and utxo-lib networks

Add Pearl mainnet/testnet coin definitions to @bitgo/statics and network
params to @bitgo/utxo-lib. Pearl is a Taproot-only UTXO chain (btcd fork)
using BIP-340 Schnorr signatures and BIP-341 script-path spending.

Bump @bitgo/wasm-utxo to ^4.27.0, which adds pearl/tpearl coin support.

TICKET: CECHO-1780

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

Author: manojkumar138

modules/abstract-utxo/package.json

@@ -67,7 +67,7 @@
     "@bitgo/utxo-descriptors": "^1.3.4",
     "@bitgo/utxo-lib": "^11.24.1",
     "@bitgo/utxo-ord": "^1.32.4",
-    "@bitgo/wasm-utxo": "^4.21.1",
+    "@bitgo/wasm-utxo": "^4.27.0",
     "@types/lodash": "^4.14.121",
     "@types/superagent": "4.1.15",
     "bignumber.js": "^9.0.2",

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

@@ -70,6 +70,9 @@ describe('utxoCoins', function () {
         ['ecashTest', 'tbcha'],
         ['litecoin', 'ltc'],
         ['litecoinTest', 'tltc'],
+        // Pearl has no AbstractUtxoCoin implementation yet - added in a follow-up PR.
+        ['pearl', undefined],
+        ['tpearl', undefined],
         ['zcash', 'zec'],
         ['zcashTest', 'tzec'],
       ]

modules/abstract-utxo/test/unit/transaction/fixedScript/parsePsbt.ts

@@ -8,7 +8,7 @@ import { fixedScriptWallet } from '@bitgo/wasm-utxo';
 import { parseTransaction } from '../../../../src/transaction/fixedScript/parseTransaction';
 import { ParsedTransaction } from '../../../../src/transaction/types';
 import { UtxoWallet } from '../../../../src/wallet';
-import { getCoinNameForNetwork, getUtxoCoin } from '../../util';
+import { getCoinNameForNetwork, getUtxoCoin, hasUtxoCoinForNetwork } from '../../util';
 import { explainPsbtWasm } from '../../../../src/transaction/fixedScript';
 import type { TransactionExplanation } from '../../../../src/transaction/fixedScript/explainTransaction';
 import { TransactionPrebuild } from '../../../../src/abstractUtxoCoin';
@@ -205,6 +205,7 @@ function describeParseTransactionWith(
 function describeTransaction(filter: (test: utxolib.testutil.AcidTest) => boolean = () => true) {
   describe(`parseTransaction`, function () {
     utxolib.testutil.AcidTest.suite()
+      .filter((test) => hasUtxoCoinForNetwork(test.network))
       .filter(filter)
       .forEach((test) => {
         // Default case: psbt format, infer recipients from explanation

modules/abstract-utxo/test/unit/util/utxoCoins.ts

@@ -65,6 +65,17 @@ export function getNetworkForCoinName(coinName: string): utxolib.Network {
   return network;
 }
 
+/**
+ * @return true iff an AbstractUtxoCoin implementation exists for the network.
+ *
+ * Networks can be defined in utxo-lib before their coin class lands here (pearl is
+ * added to utxo-lib first, its coin class follows in a later PR). Suites driven off
+ * utxolib.getNetworkList()/AcidTest.suite() use this to skip those networks.
+ */
+export function hasUtxoCoinForNetwork(network: utxolib.Network): boolean {
+  return Object.values(coinNameToNetwork).includes(network);
+}
+
 /**
  * Get coin name for a utxolib Network. For test infrastructure only.
  */

modules/statics/src/base.ts

@@ -110,6 +110,7 @@ export enum CoinFamily {
   OPETH = 'opeth',
   OSMO = 'osmo',
   PLUME = 'plume',
+  PEARL = 'pearl',
   RBTC = 'rbtc',
   SCROLLETH = 'scrolleth', // Scroll L2
   SGB = 'sgb',
@@ -1684,6 +1685,7 @@ export enum UnderlyingAsset {
   PRDX = 'prdx',
   PRINTS = 'prints',
   PRISM = 'prism',
+  PEARL = 'pearl',
   PRO = 'pro',
   PROM = 'prom',
   PROS = 'pros',

modules/statics/src/networks.ts

@@ -1431,6 +1431,20 @@ class ZCashTestnet extends Testnet implements UtxoNetwork {
   explorerUrl = 'https://testnet.zcashexplorer.app/transactions/';
 }
 
+class Pearl extends Mainnet implements UtxoNetwork {
+  name = 'Pearl';
+  family = CoinFamily.PEARL;
+  utxolibName = 'pearl';
+  explorerUrl = undefined;
+}
+
+class PearlTestnet extends Testnet implements UtxoNetwork {
+  name = 'PearlTestnet';
+  family = CoinFamily.PEARL;
+  utxolibName = 'tpearl';
+  explorerUrl = undefined;
+}
+
 class Near extends Mainnet implements AccountNetwork {
   name = 'Near';
   family = CoinFamily.NEAR;
@@ -2953,6 +2967,7 @@ export const Networks = {
     plume: Object.freeze(new Plume()),
     polygon: Object.freeze(new Polygon()),
     polyx: Object.freeze(new Polymesh()),
+    pearl: Object.freeze(new Pearl()),
     phrs: Object.freeze(new Pharos()),
     ctc: Object.freeze(new Creditcoin()),
     hypeevm: Object.freeze(new HypeEVM()),
@@ -3087,6 +3102,7 @@ export const Networks = {
     mantra: Object.freeze(new MantraTestnet()),
     polygon: Object.freeze(new PolygonTestnet()),
     polyx: Object.freeze(new PolymeshTestnet()),
+    pearl: Object.freeze(new PearlTestnet()),
     phrs: Object.freeze(new PharosTestnet()),
     ctc: Object.freeze(new CreditcoinTestnet()),
     hypeevm: Object.freeze(new HypeEVMTestnet()),

modules/statics/src/utxo.ts

@@ -143,6 +143,12 @@ const DOGE_FEATURES = [
 const DASH_FEATURES = [...UtxoCoin.DEFAULT_FEATURES, CoinFeature.CUSTODY_BITGO_FRANKFURT, CoinFeature.BULK_TRANSACTION];
 const TDASH_FEATURES = [...UtxoCoin.DEFAULT_FEATURES, CoinFeature.BULK_TRANSACTION];
 const ZEC_FEATURES = [...UtxoCoin.DEFAULT_FEATURES, CoinFeature.BULK_TRANSACTION, CoinFeature.CUSTODY_BITGO_FRANKFURT];
+const PEARL_FEATURES = [
+  ...UtxoCoin.DEFAULT_FEATURES,
+  CoinFeature.MULTISIG,
+  CoinFeature.BULK_TRANSACTION,
+  CoinFeature.DISTRIBUTED_CUSTODY,
+];
 export const utxoCoins: Readonly<BaseCoin>[] = [
   utxo(
     '8d6e08d5-399f-414f-8430-6ceca1798cbf',
@@ -320,6 +326,28 @@ export const utxoCoins: Readonly<BaseCoin>[] = [
     BaseUnit.ZEC,
     ZEC_FEATURES
   ),
+  utxo(
+    '4518a5b9-00d3-476e-bc40-d3f87eb82250',
+    'pearl',
+    'Pearl',
+    Networks.main.pearl,
+    UnderlyingAsset.PEARL,
+    BaseUnit.BTC,
+    PEARL_FEATURES,
+    '',
+    'PEARL'
+  ),
+  utxo(
+    '5d88723a-7e86-43c7-9fb1-f4cee7abc48f',
+    'tpearl',
+    'Testnet Pearl',
+    Networks.test.pearl,
+    UnderlyingAsset.PEARL,
+    BaseUnit.BTC,
+    PEARL_FEATURES,
+    '',
+    'TPEARL'
+  ),
   utxo(
     'c93a9160-458f-4a31-bea0-4a93ae8b1d2d',
     'doge',

modules/statics/test/unit/fixtures/expectedColdFeatures.ts

@@ -33,6 +33,7 @@ export const expectedColdFeatures = {
     'etc',
     'hbar',
     'ltc',
+    'pearl',
     'rbtc',
     'stx',
     'talgo',
@@ -53,6 +54,7 @@ export const expectedColdFeatures = {
     'tetc',
     'thbar',
     'tltc',
+    'tpearl',
     'trbtc',
     'tstx',
     'txlm',

modules/utxo-bin/package.json

@@ -31,7 +31,7 @@
     "@bitgo/unspents": "^0.51.7",
     "@bitgo/utxo-core": "^1.39.4",
     "@bitgo/utxo-lib": "^11.24.1",
-    "@bitgo/wasm-utxo": "^4.21.1",
+    "@bitgo/wasm-utxo": "^4.27.0",
     "@noble/curves": "1.8.1",
     "archy": "^1.0.0",
     "bech32": "^2.0.0",

modules/utxo-bin/src/args/parseNetwork.ts

@@ -33,6 +33,7 @@ const networkOrder = [
   utxolib.networks.dogecoin,
   utxolib.networks.ecash,
   utxolib.networks.litecoin,
+  utxolib.networks.pearl,
   utxolib.networks.zcash,
 ];