feat: change error type for password error in bulkshareoption

this is done so that we can differentiate on UI what error message
to show based on error instance.

Ticket: CSI-445

TICKET: CSI-445

Author: sdoshibitgo

modules/bitgo/test/v2/unit/wallets.ts

@@ -25,6 +25,7 @@ import {
   KeychainWithEncryptedPrv,
   WalletWithKeychains,
   multisigTypes,
+  IncorrectPasswordError,
 } from '@bitgo/sdk-core';
 import { BitGo } from '../../../src';
 import { afterEach } from 'mocha';
@@ -2605,6 +2606,52 @@ describe('V2 Wallets:', function () {
         ],
       });
     });
+
+    it('should throw error in processing share options when wallet password is incorrect', async () => {
+      const userId = '[email protected]';
+      const permissions = ['view', 'spend'];
+      const path = 'm/999999/1/1';
+      const walletPassphrase = 'bitgo1234';
+      const pub = 'Zo1ggzTUKMY5bYnDvT5mtVeZxzf2FaLTbKkmvGUhUQk';
+      nock(bgUrl)
+        .get(`/api/v2/tbtc/key/${wallet.keyIds()[0]}`)
+        .reply(200, {
+          id: wallet.keyIds()[0],
+          pub,
+          source: 'user',
+          encryptedPrv: bitgo.encrypt({ input: 'xprv1', password: walletPassphrase }),
+          coinSpecific: {},
+        });
+      const params: BulkWalletShareOptions = {
+        walletPassphrase: 'wrong password',
+        keyShareOptions: [
+          {
+            userId: userId,
+            permissions: permissions,
+            pubKey: '02705a6d33a2459feb537e7abe36aaad8c11532cdbffa3a2e4e58868467d51f532',
+            path: path,
+          },
+        ],
+      };
+
+      const prv1 = Math.random().toString();
+      const keychainTest: OptionalKeychainEncryptedKey = {
+        encryptedPrv: bitgo.encrypt({ input: prv1, password: walletPassphrase }),
+      };
+
+      sinon.stub(wallet, 'getEncryptedUserKeychain').resolves({
+        encryptedPrv: keychainTest.encryptedPrv,
+        pub,
+      } as KeychainWithEncryptedPrv);
+
+      try {
+        await wallet.createBulkWalletShare(params);
+        assert.fail('Expected error not thrown');
+      } catch (error) {
+        assert(error instanceof IncorrectPasswordError);
+        assert.equal(error.message, 'Password shared is incorrect for this wallet');
+      }
+    });
   });
 
   describe('List Wallets:', function () {

modules/sdk-core/src/bitgo/errors.ts

@@ -163,6 +163,12 @@ export class MissingEncryptedKeychainError extends Error {
   }
 }
 
+export class IncorrectPasswordError extends Error {
+  public constructor(message?: string) {
+    super(message || 'Incorrect password');
+  }
+}
+
 export class ApiResponseError<ResponseBodyType = any> extends BitGoJsError {
   message: string;
   status: number;

modules/sdk-core/src/bitgo/wallet/wallet.ts

@@ -18,7 +18,12 @@ import {
 import { makeRandomKey } from '../bitcoin';
 import { BitGoBase } from '../bitgoBase';
 import { getSharedSecret } from '../ecdh';
-import { AddressGenerationError, MethodNotImplementedError, MissingEncryptedKeychainError } from '../errors';
+import {
+  AddressGenerationError,
+  IncorrectPasswordError,
+  MethodNotImplementedError,
+  MissingEncryptedKeychainError,
+} from '../errors';
 import * as internal from '../internal/internal';
 import { drawKeycard } from '../internal';
 import { decryptKeychainPrivateKey, Keychain, KeychainWithEncryptedPrv } from '../keychain';
@@ -1685,7 +1690,7 @@ export class Wallet implements IWallet {
 
         const userPrv = decryptKeychainPrivateKey(this.bitgo, keychain, walletPassphrase);
         if (!userPrv) {
-          throw new Error('Unable to decrypt user keychain');
+          throw new IncorrectPasswordError('Password shared is incorrect for this wallet');
         }
 
         keychain.prv = userPrv;