Merge pull request #9360 from BitGo/CECHO-1791-add-pearl-to-abstract-utxo

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/src/impl/index.ts

@@ -6,4 +6,5 @@ export * as btg from './btg';
 export * as ltc from './ltc';
 export * as dash from './dash';
 export * as doge from './doge';
+export * as pearl from './pearl';
 export * as zec from './zec';

modules/abstract-utxo/src/impl/pearl/index.ts

@@ -0,0 +1,2 @@
+export * from './pearl';
+export * from './tpearl';

modules/abstract-utxo/src/impl/pearl/pearl.ts

@@ -0,0 +1,21 @@
+import { BitGoBase } from '@bitgo/sdk-core';
+
+import { AbstractUtxoCoin } from '../../abstractUtxoCoin';
+import { UtxoCoinName } from '../../names';
+
+/**
+ * Pearl (Duplex) is a taproot-only UTXO chain, a btcd fork using BIP-340 Schnorr
+ * signatures and BIP-341 script-path spending with a NUMS internal key.
+ *
+ * Unlike the other utxo coins, Pearl has no `@bitgo/utxo-lib` network registration -
+ * it is served entirely through `@bitgo/wasm-utxo`. No script type override is needed
+ * here: `supportsAddressType` delegates to `fixedScriptWallet.supportsScriptType`,
+ * which already reports only p2tr and p2trMusig2 for this coin.
+ */
+export class Pearl extends AbstractUtxoCoin {
+  readonly name: UtxoCoinName = 'pearl';
+
+  static createInstance(bitgo: BitGoBase): Pearl {
+    return new Pearl(bitgo);
+  }
+}

modules/abstract-utxo/src/impl/pearl/tpearl.ts

@@ -0,0 +1,13 @@
+import { BitGoBase } from '@bitgo/sdk-core';
+
+import { UtxoCoinName } from '../../names';
+
+import { Pearl } from './pearl';
+
+export class Tpearl extends Pearl {
+  readonly name: UtxoCoinName = 'tpearl';
+
+  static createInstance(bitgo: BitGoBase): Tpearl {
+    return new Tpearl(bitgo);
+  }
+}

modules/abstract-utxo/src/index.ts

@@ -21,4 +21,5 @@ export * from './impl/btg';
 export * from './impl/ltc';
 export * from './impl/dash';
 export * from './impl/doge';
+export * from './impl/pearl';
 export * from './impl/zec';

modules/abstract-utxo/src/names.ts

@@ -1,4 +1,4 @@
-export const utxoCoinsMainnet = ['btc', 'bch', 'bcha', 'bsv', 'btg', 'dash', 'doge', 'ltc', 'zec'] as const;
+export const utxoCoinsMainnet = ['btc', 'bch', 'bcha', 'bsv', 'btg', 'dash', 'doge', 'ltc', 'pearl', 'zec'] as const;
 export const utxoCoinsTestnet = [
   'tbtc',
   'tbtc4',
@@ -11,6 +11,7 @@ export const utxoCoinsTestnet = [
   'tdash',
   'tdoge',
   'tltc',
+  'tpearl',
   'tzec',
 ] as const;
 
@@ -62,6 +63,8 @@ function getBaseNameFromMainnet(coinName: UtxoCoinNameMainnet): string {
       return 'Dogecoin';
     case 'ltc':
       return 'Litecoin';
+    case 'pearl':
+      return 'Pearl';
     case 'zec':
       return 'ZCash';
   }

modules/abstract-utxo/test/unit/impl/pearl/unit/index.ts

@@ -0,0 +1,85 @@
+import assert from 'node:assert/strict';
+
+import { BitGoAPI } from '@bitgo/sdk-api';
+import { TestBitGo, TestBitGoAPI } from '@bitgo/sdk-test';
+import * as utxolib from '@bitgo/utxo-lib';
+
+import { AbstractUtxoCoin } from '../../../../../src/abstractUtxoCoin';
+import { Pearl, Tpearl } from '../../../../../src/impl/pearl';
+
+describe('Pearl', function () {
+  let bitgo: TestBitGoAPI;
+
+  /** `bitgo.coin()` is typed as BaseCoin; these are registered as AbstractUtxoCoin */
+  function getCoin(coinName: 'pearl' | 'tpearl'): AbstractUtxoCoin {
+    return bitgo.coin(coinName) as unknown as AbstractUtxoCoin;
+  }
+
+  before(function () {
+    bitgo = TestBitGo.decorate(BitGoAPI, {
+      env: 'mock',
+    });
+    bitgo.initializeTestVars();
+    bitgo.safeRegister('pearl', Pearl.createInstance);
+    bitgo.safeRegister('tpearl', Tpearl.createInstance);
+  });
+
+  it('should instantiate the coin', function () {
+    assert.ok(bitgo.coin('pearl') instanceof Pearl);
+    assert.ok(bitgo.coin('tpearl') instanceof Tpearl);
+  });
+
+  it('should return the chain', function () {
+    assert.strictEqual(bitgo.coin('pearl').getChain(), 'pearl');
+    assert.strictEqual(bitgo.coin('tpearl').getChain(), 'tpearl');
+  });
+
+  it('should return full name', function () {
+    assert.strictEqual(bitgo.coin('pearl').getFullName(), 'Pearl');
+    assert.strictEqual(bitgo.coin('tpearl').getFullName(), 'Testnet Pearl');
+  });
+
+  it('should have tpearl as the testnet variant of pearl', function () {
+    assert.ok(bitgo.coin('tpearl') instanceof Pearl);
+  });
+
+  /**
+   * Pearl is taproot-only. This is not enforced by an override here - it comes from
+   * `supportsAddressType` delegating to wasm-utxo, which reports only the taproot
+   * script types for this coin. Pinned so a regression in either layer is caught.
+   */
+  it('should support only the taproot script types', function () {
+    for (const coinName of ['pearl', 'tpearl'] as const) {
+      const coin = getCoin(coinName);
+      assert.strictEqual(coin.supportsAddressType('p2tr'), true);
+      assert.strictEqual(coin.supportsAddressType('p2trMusig2'), true);
+      assert.strictEqual(coin.supportsAddressType('p2sh'), false);
+      assert.strictEqual(coin.supportsAddressType('p2shP2wsh'), false);
+      assert.strictEqual(coin.supportsAddressType('p2wsh'), false);
+    }
+  });
+
+  it('should support only the taproot address chains', function () {
+    for (const coinName of ['pearl', 'tpearl'] as const) {
+      const coin = getCoin(coinName);
+      // 30/31 = p2tr, 40/41 = p2trMusig2
+      for (const chain of [30, 31, 40, 41]) {
+        assert.strictEqual(coin.supportsAddressChain(chain), true, `chain ${chain} should be supported`);
+      }
+      // 0/1 = p2sh, 10/11 = p2shP2wsh, 20/21 = p2wsh
+      for (const chain of [0, 1, 10, 11, 20, 21]) {
+        assert.strictEqual(coin.supportsAddressChain(chain), false, `chain ${chain} should not be supported`);
+      }
+    }
+  });
+
+  /**
+   * Pearl is served through @bitgo/wasm-utxo and is deliberately absent from
+   * @bitgo/utxo-lib. No other checked-in coin has this profile, so it cannot be
+   * inferred from an existing coin - assert it explicitly.
+   */
+  it('should have no utxo-lib network registration', function () {
+    assert.ok(!('pearl' in utxolib.networks));
+    assert.ok(!('tpearl' in utxolib.networks));
+  });
+});

modules/sdk-coin-pearl/.eslintignore

@@ -0,0 +1,5 @@
+node_modules
+.idea
+public
+dist
+

modules/sdk-coin-pearl/.gitignore

@@ -0,0 +1,3 @@
+node_modules/
+.idea/
+dist/