Lightnet sub-commands implementation (start/stop/status).

src/bin/index.js

@@ -11,6 +11,11 @@ import Constants from '../lib/constants.js';
 import { deploy } from '../lib/deploy.js';
 import { example } from '../lib/example.js';
 import { file } from '../lib/file.js';
+import {
+  lightnetStatus,
+  startLightnet,
+  stopLightnet,
+} from '../lib/lightnet.js';
 import { project } from '../lib/project.js';
 import system from '../lib/system.js';
 
@@ -39,6 +44,9 @@ yargs(hideBin(process.argv))
     'Argument: %s, Given: %s, Choices: %s': chalk.red(
       `%s was %s. Must be one of: %s.`
     ),
+    'Not enough non-option arguments: %s': {
+      one: chalk.red('Not enough non-option arguments: %s'),
+    },
   })
   .demandCommand(1, chalk.red('Please provide a command.'))
 
@@ -94,6 +102,120 @@ yargs(hideBin(process.argv))
     async (argv) => await example(argv.name)
   )
   .command(['system', 'sys', 's'], 'Show system info', {}, () => system())
+  .command(
+    ['lightnet <sub-command> [options]'],
+    'Manage the lightweight Mina blockchain for zkApps development and testing purposes.\nYou can find more information about the Docker image in use at\nhttps://hub.docker.com/r/o1labs/mina-local-network',
+    (yargs) => {
+      yargs
+        .command(
+          [
+            'start [mode] [type] [proof-level] [mina-branch] [archive] [sync] [pull]',
+          ],
+          'Start the lightweight Mina blockchain network Docker container.',
+          {
+            mode: {
+              alias: 'm',
+              demand: false,
+              string: true,
+              hidden: false,
+              choices: Constants.lightnetModes,
+              default: 'single-node',
+              description:
+                'Whether to form the network with one node or with multiple network participants.\n"single-node" value will make the network faster.',
+            },
+            type: {
+              alias: 't',
+              demand: false,
+              string: true,
+              hidden: false,
+              choices: Constants.lightnetTypes,
+              default: 'fast',
+              description:
+                'Whether to configure the network to be fast or slower with closer-to-real-world properties.',
+            },
+            'proof-level': {
+              alias: 'p',
+              demand: false,
+              string: true,
+              hidden: false,
+              choices: Constants.lightnetProofLevels,
+              default: 'none',
+              description: '"none" value will make the network faster.',
+            },
+            'mina-branch': {
+              alias: 'b',
+              demand: false,
+              string: true,
+              hidden: false,
+              choices: Constants.lightnetMinaBranches,
+              default: 'rampup',
+              description:
+                'One of the major Mina repository branches the artifacts were compiled against.',
+            },
+            archive: {
+              alias: 'a',
+              demand: false,
+              boolean: true,
+              hidden: false,
+              default: true,
+              description:
+                'Whether to start the Mina Archive process and Archive Node API application within the Docker container.',
+            },
+            sync: {
+              alias: 's',
+              demand: false,
+              boolean: true,
+              hidden: false,
+              default: true,
+              description:
+                'Whether to wait for the network to reach the synchronized state.',
+            },
+            pull: {
+              alias: 'u',
+              demand: false,
+              boolean: true,
+              hidden: false,
+              default: true,
+              description:
+                'Whether to pull the latest version of the Docker image from the Docker Hub.',
+            },
+          },
+          async (argv) => await startLightnet(argv)
+        )
+        .command(
+          ['stop [save-logs] [clean-up]'],
+          'Stop the lightweight Mina blockchain network Docker container and perform the clean up.',
+          {
+            'save-logs': {
+              alias: 'l',
+              demand: false,
+              boolean: true,
+              hidden: false,
+              default: true,
+              description:
+                'Whether to save the Docker container processes logs to the host file system.',
+            },
+            'clean-up': {
+              alias: 'c',
+              demand: false,
+              boolean: true,
+              hidden: false,
+              default: true,
+              description:
+                'Whether to remove the Docker container, dangling Docker images, consumed Docker volume and the blockchain network configuration.',
+            },
+          },
+          async (argv) => await stopLightnet(argv)
+        )
+        .command(
+          ['status'],
+          'Get the lightweight Mina blockchain network status.',
+          {},
+          async () => await lightnetStatus()
+        )
+        .demandCommand();
+    }
+  )
   .version(
     fs.readJsonSync(path.join(__dirname, '..', '..', 'package.json')).version
   )

src/lib/constants.js

@@ -3,13 +3,22 @@ import { homedir } from 'os';
 /**
  * @typedef {'next' | 'svelte' | 'nuxt' | 'empty' | 'none'} UiType
  * @typedef {'sudoku' | 'tictactoe'} ExampleType
+ * @typedef {'single-node' | 'multi-node'} LightnetMode
+ * @typedef {'fast' | 'real'} LightnetType
+ * @typedef {'none' | 'full'} LightnetProofLevel
+ * @typedef {'rampup' | 'berkeley' | 'develop'} LightnetMinaBranch
  *
- * @type {{ uiTypes: UiType[], exampleTypes: ExampleType[], feePayerCacheDir: string }}
+ * @type {{ uiTypes: UiType[], exampleTypes: ExampleType[], feePayerCacheDir: string, lightnetWorkDir: string, lightnetModes: LightnetMode[], lightnetTypes: LightnetType[], lightnetProofLevels: LightnetProofLevel[], lightnetMinaBranches: LightnetMinaBranch[] }}
  */
 const Constants = Object.freeze({
   uiTypes: ['next', 'svelte', 'nuxt', 'empty', 'none'],
   exampleTypes: ['sudoku', 'tictactoe'],
   feePayerCacheDir: `${homedir()}/.cache/zkapp-cli/keys`,
+  lightnetWorkDir: `${homedir()}/.cache/zkapp-cli/lightnet`,
+  lightnetModes: ['single-node', 'multi-node'],
+  lightnetTypes: ['fast', 'real'],
+  lightnetProofLevels: ['none', 'full'],
+  lightnetMinaBranches: ['rampup', 'berkeley', 'develop'],
 });
 
 export default Constants;