feat(statics): add Pearl to statics

Define Pearl (PEARL/TPEARL) coin identity in @bitgo/statics: CoinFamily,
UnderlyingAsset, the Pearl/PearlTestnet network classes and the pearl and
tpearl coin entries.

Pearl is a taproot-only UTXO chain (btcd fork) using BIP-340 Schnorr
signatures and BIP-341 script-path spending. It is backed by
@bitgo/wasm-utxo, which has carried pearl and tpearl in CoinName since
4.27.0.

No @bitgo/utxo-lib network is registered. Pearl is intended to be served
through the wasm-utxo path, matching the wasm-only profile already used
by ims-utxo, so utxolibName names the wasm CoinName rather than a
utxo-lib network entry.

TICKET: CECHO-1780

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

Author: manojkumar138

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,31 @@ class ZCashTestnet extends Testnet implements UtxoNetwork {
   explorerUrl = 'https://testnet.zcashexplorer.app/transactions/';
 }
 
+/*
+ * Pearl is served through @bitgo/wasm-utxo and is deliberately NOT registered as a
+ * network in @bitgo/utxo-lib.
+ *
+ * `utxolibName` is required by UtxoNetwork, so it carries the wasm-utxo `CoinName`
+ * instead. It must not be resolved via `utxolib.networks[...]` - that yields
+ * undefined for Pearl and throws `TypeError: invalid network` downstream. Use the
+ * wasm-utxo coin name directly.
+ */
+class Pearl extends Mainnet implements UtxoNetwork {
+  name = 'Pearl';
+  family = CoinFamily.PEARL;
+  /** wasm-utxo CoinName, not a utxo-lib network - see note above */
+  utxolibName = 'pearl';
+  explorerUrl = undefined;
+}
+
+class PearlTestnet extends Testnet implements UtxoNetwork {
+  name = 'PearlTestnet';
+  family = CoinFamily.PEARL;
+  /** wasm-utxo CoinName, not a utxo-lib network - see note above */
+  utxolibName = 'tpearl';
+  explorerUrl = undefined;
+}
+
 class Near extends Mainnet implements AccountNetwork {
   name = 'Near';
   family = CoinFamily.NEAR;
@@ -2953,6 +2978,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 +3113,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,7 @@ 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.BULK_TRANSACTION, CoinFeature.DISTRIBUTED_CUSTODY];
 export const utxoCoins: Readonly<BaseCoin>[] = [
   utxo(
     '8d6e08d5-399f-414f-8430-6ceca1798cbf',
@@ -320,6 +321,24 @@ 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
+  ),
+  utxo(
+    '5d88723a-7e86-43c7-9fb1-f4cee7abc48f',
+    'tpearl',
+    'Testnet Pearl',
+    Networks.test.pearl,
+    UnderlyingAsset.PEARL,
+    BaseUnit.BTC,
+    PEARL_FEATURES
+  ),
   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',