added xExplorer

Author: gfusee

cli/src/config/config.ts

@@ -4,6 +4,7 @@ export type CLIConfig = {
     shouldHaveRedis: boolean
     shouldHaveRabbitMQ: boolean
     shouldHaveApi: boolean
+    shouldHaveXExplorer: boolean
     numberOfShards: number
     initialEGLDAddress?: string
     mxOpsScenesPath?: string
@@ -16,6 +17,7 @@ export function getDefaultConfig(): CLIConfig {
         shouldHaveRedis: false,
         shouldHaveRabbitMQ: false,
         shouldHaveApi: false,
+        shouldHaveXExplorer: false,
         numberOfShards: 1
     }
 }

cli/src/config/constants.ts

@@ -55,6 +55,13 @@ export class Constants {
         }
     }
 
+    static get XEXPLORER_CONTAINER(): ContainerInfos {
+        return {
+            name: "xexplorer",
+            pauseBehavior: PauseBehavior.STOP
+        }
+    }
+
     static get ELASTIC_CONTAINER(): ContainerInfos {
         return {
             name: "elastic",

cli/src/questions/features/featuresQuestion.ts

@@ -2,32 +2,47 @@ import {CLIChoice, CLIQuestion} from "../question.js";
 import {Answers, CheckboxQuestion, Question} from "inquirer";
 import {CLIConfig} from "../../config/config";
 import {MxOpsScenesPathQuestion} from "./mxOpsScenesPathQuestion.js";
+import {CustomAddressToGiveEGLDQuestion} from "./customAddressToGiveEGLDQuestion.js";
 
-export abstract class FeaturesQuestion extends CLIQuestion {
+export class FeaturesQuestion extends CLIQuestion {
 
     private static apiChoice = 'Enable full API (like api.multiversx.com)'
+    private static xExplorerChoice = 'Enable xExplorer, requires the full API'
     private static mxOpsChoice = 'Run MxOps scenes at startup'
+    static readonly giveToCustomAddressChoice = 'Give 1,000,000 EGLD to a custom address (otherwise a new one will be generated for you)'
 
     override async getQuestion(): Promise<Question> {
         const question: CheckboxQuestion = {
             type: 'checkbox',
             name: 'choice',
             message: 'Which features do you want to enable ?',
-            choices: this.generalFeatures.concat(this.cliChoices)
+            choices: this.generalFeatures
         }
 
         return question
     }
 
     private generalFeatures: CLIChoice[] = [
         FeaturesQuestion.apiChoice,
-        FeaturesQuestion.mxOpsChoice
+        FeaturesQuestion.xExplorerChoice,
+        FeaturesQuestion.mxOpsChoice,
+        FeaturesQuestion.giveToCustomAddressChoice
     ]
 
-    abstract cliChoices: CLIChoice[]
-
     override async handleAnswer(answers: Answers, config: CLIConfig): Promise<CLIQuestion[]> {
-        if (answers.choice.includes(FeaturesQuestion.apiChoice)) {
+        const hasAPI = answers.choice.includes(FeaturesQuestion.apiChoice)
+        if (answers.choice.includes(FeaturesQuestion.xExplorerChoice)) {
+            if (hasAPI) {
+                config.shouldHaveXExplorer = true
+            } else {
+                const errorMessage = '\n❌ You have to opt for the full API in order to run xExplorer.\n'
+                console.log(errorMessage)
+
+                return [new FeaturesQuestion()]
+            }
+        }
+
+        if (hasAPI) {
             config.shouldHaveElasticSearch = true
             config.shouldHaveMySQL = true
             config.shouldHaveRabbitMQ = true
@@ -41,6 +56,10 @@ export abstract class FeaturesQuestion extends CLIQuestion {
             questions.push(new MxOpsScenesPathQuestion())
         }
 
+        if (answers.choice.includes(FeaturesQuestion.giveToCustomAddressChoice)) {
+            questions.push(new CustomAddressToGiveEGLDQuestion())
+        }
+
         return questions
     }
 }

cli/src/questions/features/freshLocalnetFeaturesQuestion.ts

@@ -1,7 +1,7 @@
 import {CLIQuestion} from "../question.js";
-import {FreshLocalnetFeaturesQuestion} from "../features/freshLocalnetFeaturesQuestion.js";
 import {Answers, Question} from "inquirer";
 import {CLIConfig} from "../../config/config.js";
+import {FeaturesQuestion} from "../features/featuresQuestion.js";
 
 export class NumberShardsQuestion extends CLIQuestion {
 
@@ -31,6 +31,6 @@ export class NumberShardsQuestion extends CLIQuestion {
 
         config.numberOfShards = answers.numberShards
 
-        return [new FreshLocalnetFeaturesQuestion()]
+        return [new FeaturesQuestion()]
     }
 }

cli/src/questions/features/shadowForkFeaturesQuestion.ts

@@ -60,6 +60,16 @@ export async function createNetwork(config: CLIConfig) {
             startingApiHealthCheckSpinner.succeed('API is ready')
         }
 
+        if (config.shouldHaveXExplorer) {
+            const startingApiSpinner = ora('Starting xExplorer container...').start()
+            await upContainer(Constants.XEXPLORER_CONTAINER.name)
+            startingApiSpinner.succeed('Started xExplorer container')
+
+            const startingApiHealthCheckSpinner = ora('Waiting for API to be ready').start()
+            await waitForAPIToBeReady()
+            startingApiHealthCheckSpinner.succeed('API is ready')
+        }
+
         if (config.mxOpsScenesPath) {
             const copyingScenesSpinner = ora('Copying mxops scenes...').start()
             await execCustomInRepo(`docker-compose cp ${config.mxOpsScenesPath} localnet:/home/ubuntu/mxops`)