feat: added createAccount intent for canton wallet init

Ticket: COIN-6101

Author: ravibitgo

modules/sdk-coin-canton/.gitignore

@@ -1,3 +1,4 @@
 node_modules/
 .idea/
 dist/
+.DS_Store

modules/sdk-coin-canton/src/canton.ts

@@ -65,6 +65,11 @@ export class Canton extends BaseCoin {
     return multisigTypes.tss;
   }
 
+  /** inherited doc */
+  requiresWalletInitialization(): boolean {
+    return true;
+  }
+
   getMPCAlgorithm(): MPCAlgorithm {
     return 'eddsa';
   }

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

@@ -381,6 +381,14 @@ export abstract class BaseCoin implements IBaseCoin {
     return false;
   }
 
+  /**
+   * Check whether a coin requires wallet initialization
+   * @returns {boolean}
+   */
+  requiresWalletInitialization(): boolean {
+    return false;
+  }
+
   /**
    * Check whether a coin supports signing of Typed data
    * @returns {boolean}

modules/sdk-core/src/bitgo/baseCoin/iBaseCoin.ts

@@ -604,4 +604,5 @@ export interface IBaseCoin {
    * @param {string} params.multiSigType - The type of multisig (e.g. 'onchain' or 'tss')
    */
   assertIsValidKey({ publicKey, encryptedPrv, walletPassphrase, multiSigType }: AuditKeyParams): void;
+  requiresWalletInitialization(): boolean;
 }

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

@@ -893,6 +893,11 @@ export type SendNFTResult = {
   pendingApproval: PendingApprovalData;
 };
 
+export type WalletInitResult = {
+  success: PrebuildTransactionResult[];
+  failure: Error[];
+};
+
 export interface IWallet {
   bitgo: BitGoBase;
   baseCoin: IBaseCoin;
@@ -985,6 +990,7 @@ export interface IWallet {
   buildTokenEnablements(params?: BuildTokenEnablementOptions): Promise<PrebuildTransactionResult[]>;
   sendTokenEnablement(params?: PrebuildAndSignTransactionOptions): Promise<any>;
   sendTokenEnablements(params?: BuildTokenEnablementOptions): Promise<any>;
+  sendWalletInitialization(params?: PrebuildTransactionOptions): Promise<WalletInitResult>;
   signMessage(params: WalletSignMessageOptions): Promise<SignedMessage>;
   buildSignMessageRequest(params: WalletSignMessageOptions): Promise<TxRequest>;
   signTypedData(params: WalletSignTypedDataOptions): Promise<SignedMessage>;

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

@@ -123,6 +123,7 @@ import {
   WalletSignTypedDataOptions,
   WalletType,
   BuildTokenApprovalResponse,
+  WalletInitResult,
 } from './iWallet';
 
 const debug = require('debug')('bitgo:v2:wallet');
@@ -3319,6 +3320,61 @@ export class Wallet implements IWallet {
     };
   }
 
+  /**
+   * The chain canton, requires the wallet to be initialized by sending out a transaction
+   * to be onboarded onto the validator.
+   * Builds, Signs and sends a transaction that initializes the canton wallet
+   * @param params
+   */
+  public async sendWalletInitialization(params: PrebuildAndSignTransactionOptions = {}): Promise<WalletInitResult> {
+    if (!this.baseCoin.requiresWalletInitialization()) {
+      throw new Error(`Wallet initialization is not required for ${this.baseCoin.getFullName()}`);
+    }
+    if (params.reqId) {
+      this.bitgo.setRequestTracer(params.reqId);
+    }
+    const buildParams: PrebuildTransactionOptions = _.pick(params, this.prebuildWhitelistedParams());
+    if (!buildParams.type) {
+      buildParams.type = 'createAccount';
+    }
+    const prebuildTx = await this.prebuildTransaction(buildParams);
+    const unsignedBuildWithOptions: PrebuildAndSignTransactionOptions = {
+      ...params,
+      prebuildTx,
+    };
+    if (typeof params.prebuildTx === 'string' || params.prebuildTx?.buildParams?.type !== 'createAccount') {
+      throw new Error('Invalid build of wallet init');
+    }
+    const successfulTxs: PrebuildTransactionResult[] = [];
+    const failedTxs = new Array<Error>();
+    try {
+      if (this._wallet.multisigType === 'tss') {
+        const sendTx = await this.sendManyTxRequests(unsignedBuildWithOptions);
+        successfulTxs.push(sendTx);
+      } else {
+        switch (this._wallet.type) {
+          case 'hot':
+          case 'cold':
+            const signedPrebuild = await this.prebuildAndSignTransaction(params);
+            const sendTxCold = await this.submitTransaction(signedPrebuild, params.reqId);
+            successfulTxs.push(sendTxCold);
+            break;
+          case 'custodial':
+          case 'backing':
+            const sendTxCustodial = await this.initiateTransaction(params.prebuildTx.buildParams, params.reqId);
+            successfulTxs.push(sendTxCustodial);
+            break;
+        }
+      }
+    } catch (e) {
+      failedTxs.push(e);
+    }
+    return {
+      success: successfulTxs,
+      failure: failedTxs,
+    };
+  }
+
   /* MARK: TSS Helpers */
 
   /**
@@ -3439,6 +3495,16 @@ export class Wallet implements IWallet {
           params.preview
         );
         break;
+      case 'createAccount':
+        txRequest = await this.tssUtils!.prebuildTxWithIntent(
+          {
+            reqId,
+            intentType: 'createAccount',
+          },
+          apiVersion,
+          params.preview
+        );
+        break;
       case 'customTx':
         txRequest = await this.tssUtils!.prebuildTxWithIntent(
           {