@devtion/devcli 0.0.0-92056fa → 0.0.0-9239207

package/dist/index.js

@@ -1,28 +1,28 @@
 #!/usr/bin/env node
 
 /**
- * @module @devtion/devcli
- * @version 1.0.6
+ * @module @p0tion/phase2cli
+ * @version 1.2.5
  * @file All-in-one interactive command-line for interfacing with zkSNARK Phase 2 Trusted Setup ceremonies
  * @copyright Ethereum Foundation 2022
  * @license MIT
  * @see [Github]{@link https://github.com/privacy-scaling-explorations/p0tion}
 */
 import { createCommand } from 'commander';
-import fs, { readFileSync, createWriteStream, renameSync } from 'fs';
-import { dirname } from 'path';
+import fs, { readFileSync, createWriteStream, existsSync, renameSync } from 'fs';
+import path, { dirname } from 'path';
 import { fileURLToPath } from 'url';
-import { zKey } from 'snarkjs';
+import { zKey, groth16 } from 'snarkjs';
 import boxen from 'boxen';
 import { pipeline } from 'node:stream';
 import { promisify } from 'node:util';
 import fetch$1 from 'node-fetch';
-import { commonTerms, formatZkeyIndex, getZkeyStorageFilePath, finalContributionIndex, createCustomLoggerForFile, getBucketName, progressToNextContributionStep, permanentlyStoreCurrentContributionTimeAndHash, convertToDoubleDigits, multiPartUpload, verifyContribution, generateGetObjectPreSignedUrl, convertBytesOrKbToGb, numExpIterations, getDocumentById, getParticipantsCollectionPath, fromQueryToFirebaseDocumentInfo, getAllCollectionDocs, extractPrefix, autoGenerateEntropy, vmConfigurationTypes, initializeFirebaseCoreServices, signInToFirebaseWithCredentials, getCurrentFirebaseAuthUser, isCoordinator, parseCeremonyFile, blake512FromPath, checkIfObjectExist, setupCeremony, genesisZkeyIndex, getR1csStorageFilePath, getWasmStorageFilePath, getPotStorageFilePath, extractPoTFromFilename, potFileDownloadMainUrl, createS3Bucket, potFilenameTemplate, getR1CSInfo, getOpenedCeremonies, getCeremonyCircuits, checkParticipantForCeremony, getCurrentActiveParticipantTimeout, getCircuitBySequencePosition, getCircuitContributionsFromContributor, progressToNextCircuitForContribution, resumeContributionAfterTimeoutExpiration, generateValidContributionsAttestation, getContributionsValidityForContributor, getClosedCeremonies, checkAndPrepareCoordinatorForFinalization, computeSHA256ToHex, finalizeCeremony, getVerificationKeyStorageFilePath, verificationKeyAcronym, getVerifierContractStorageFilePath, verifierSmartContractAcronym, finalizeCircuit, exportVkey, exportVerifierContract } from '@devtion/actions';
+import { commonTerms, formatZkeyIndex, getZkeyStorageFilePath, finalContributionIndex, createCustomLoggerForFile, getBucketName, progressToNextContributionStep, contribHashRegex, permanentlyStoreCurrentContributionTimeAndHash, convertToDoubleDigits, multiPartUpload, verifyContribution, generateGetObjectPreSignedUrl, convertBytesOrKbToGb, numExpIterations, getDocumentById, getParticipantsCollectionPath, fromQueryToFirebaseDocumentInfo, getAllCollectionDocs, extractPrefix, autoGenerateEntropy, vmConfigurationTypes, initializeFirebaseCoreServices, signInToFirebaseWithCredentials, getCurrentFirebaseAuthUser, isCoordinator, parseCeremonyFile, blake512FromPath, checkIfObjectExist, setupCeremony, genesisZkeyIndex, getR1csStorageFilePath, getWasmStorageFilePath, getPotStorageFilePath, extractPoTFromFilename, potFileDownloadMainUrl, createS3Bucket, potFilenameTemplate, getR1CSInfo, getOpenedCeremonies, getCeremonyCircuits, checkParticipantForCeremony, getCurrentActiveParticipantTimeout, getCircuitBySequencePosition, getCircuitContributionsFromContributor, progressToNextCircuitForContribution, resumeContributionAfterTimeoutExpiration, generateValidContributionsAttestation, getContributionsValidityForContributor, getClosedCeremonies, checkAndPrepareCoordinatorForFinalization, computeSHA256ToHex, finalizeCeremony, getVerificationKeyStorageFilePath, verificationKeyAcronym, getVerifierContractStorageFilePath, verifierSmartContractAcronym, finalizeCircuit, exportVkey, exportVerifierContract, getAllCeremonies } from '@devtion/actions';
 import fetch from '@adobe/node-fetch-retry';
 import { request } from '@octokit/request';
 import { SingleBar, Presets } from 'cli-progress';
 import dotenv from 'dotenv';
-import { GithubAuthProvider, getAuth, signOut } from 'firebase/auth';
+import { GithubAuthProvider, signInWithCustomToken, getAuth, signOut } from 'firebase/auth';
 import { getDiskInfoSync } from 'node-disk-info';
 import ora from 'ora';
 import { Timer } from 'timer-node';
@@ -36,7 +36,10 @@ import figlet from 'figlet';
 import { createOAuthDeviceAuth } from '@octokit/auth-oauth-device';
 import clipboard from 'clipboardy';
 import open from 'open';
-import { Timestamp, onSnapshot } from 'firebase/firestore';
+import { Identity } from '@semaphore-protocol/identity';
+import { httpsCallable } from 'firebase/functions';
+import { ApiSdk } from '@bandada/api-sdk';
+import { Timestamp, onSnapshot, doc, collection, getDocs } from 'firebase/firestore';
 import readline from 'readline';
 
 /**
@@ -97,7 +100,7 @@ const CORE_SERVICES_ERRORS = {
     FIREBASE_TOKEN_EXPIRED_REMOVED_PERMISSIONS: `The Github authorization has failed due to lack of association between your account and the CLI`,
     FIREBASE_USER_DISABLED: `The Github account has been suspended by the ceremony coordinator(s), blocking the possibility of contribution. Please, contact them to understand the motivation behind it.`,
     FIREBASE_FAILED_CREDENTIALS_VERIFICATION: `Firebase cannot verify your Github credentials due to network errors. Please, try once again later.`,
-    FIREBASE_NETWORK_ERROR: `Unable to reach Firebase due to network erros. Please, try once again later and make sure your Internet connection is stable.`,
+    FIREBASE_NETWORK_ERROR: `Unable to reach Firebase due to network errors. Please, try once again later and make sure your Internet connection is stable.`,
     FIREBASE_CEREMONY_NOT_OPENED: `There are no ceremonies opened to contributions`,
     FIREBASE_CEREMONY_NOT_CLOSED: `There are no ceremonies ready to finalization`,
     AWS_CEREMONY_BUCKET_CREATION: `Unable to create a new bucket for the ceremony. Something went wrong during the creation. Please, repeat the process by providing a new ceremony name of the ceremony.`,
@@ -119,7 +122,7 @@ const COMMAND_ERRORS = {
     COMMAND_SETUP_NO_R1CS: `Unable to retrieve R1CS files from current working directory. Please, run this command from a working directory where the R1CS files are located to continue with the setup process. We kindly ask you to run the command from an empty directory containing only the R1CS and WASM files.`,
     COMMAND_SETUP_NO_WASM: `Unable to retrieve WASM files from current working directory. Please, run this command from a working directory where the WASM files are located to continue with the setup process. We kindly ask you to run the command from an empty directory containing only the WASM and R1CS files.`,
     COMMAND_SETUP_MISMATCH_R1CS_WASM: `The folder contains more R1CS files than WASM files (or vice versa). Please, run this command from a working directory where each R1CS is paired with its corresponding file WASM.`,
-    COMMAND_SETUP_DOWNLOAD_PTAU: `Unable to download Powers of Tau file from Hermez Cryptography Phase 1 Trusted Setup. Possible causes may involve an error while making the request (be sure to have a stable internet connection). Please, we kindly ask you to terminate the current session and repeat the process.`,
+    COMMAND_SETUP_DOWNLOAD_PTAU: `Unable to download Powers of Tau file from PPoT Phase 1 Trusted Setup. Possible causes may involve an error while making the request (be sure to have a stable internet connection). Please, we kindly ask you to terminate the current session and repeat the process.`,
     COMMAND_SETUP_ABORT: `You chose to abort the setup process.`,
     COMMAND_CONTRIBUTE_NO_OPENED_CEREMONIES: `Unfortunately, there is no ceremony for which you can make a contribution at this time. Please, try again later.`,
     COMMAND_CONTRIBUTE_NO_PARTICIPANT_DATA: `Unable to retrieve your data as ceremony participant. Please, terminate the current session and try again later. If the error persists, please contact the ceremony coordinator.`,
@@ -235,6 +238,14 @@ const checkAndMakeNewDirectoryIfNonexistent = (directoryLocalPath) => {
 const writeLocalJsonFile = (filePath, data) => {
     fs.writeFileSync(filePath, JSON.stringify(data), "utf-8");
 };
+/**
+ * Return the local current project directory name.
+ * @returns <string> - the local project (e.g., dist/) directory name.
+ */
+const getLocalDirname = () => {
+    const filename = fileURLToPath(import.meta.url);
+    return path.dirname(filename);
+};
 
 // Get npm package name.
 const packagePath$4 = `${dirname(fileURLToPath(import.meta.url))}/..`;
@@ -250,6 +261,14 @@ const config = new Conf({
         accessToken: {
             type: "string",
             default: ""
+        },
+        bandadaIdentity: {
+            type: "string",
+            default: ""
+        },
+        authMethod: {
+            type: "string",
+            default: ""
         }
     }
 });
@@ -310,6 +329,39 @@ const setLocalAccessToken = (token) => config.set("accessToken", token);
  * Delete the stored access token.
  */
 const deleteLocalAccessToken = () => config.delete("accessToken");
+/**
+ * Return the Bandada identity, if present.
+ * @returns <string | undefined> - the Bandada identity if present, otherwise undefined.
+ */
+const getLocalBandadaIdentity = () => config.get("bandadaIdentity");
+/**
+ * Check if the Bandada identity exists in the local storage.
+ * @returns <boolean>
+ */
+const checkLocalBandadaIdentity = () => config.has("bandadaIdentity") && !!config.get("bandadaIdentity");
+/**
+ * Set the Bandada identity.
+ * @param identity <string> - the Bandada identity to be stored.
+ */
+const setLocalBandadaIdentity = (identity) => config.set("bandadaIdentity", identity);
+/**
+ * Delete the stored Bandada identity.
+ */
+const deleteLocalBandadaIdentity = () => config.delete("bandadaIdentity");
+/**
+ * Return the authentication method, if present.
+ * @returns <string | undefined> - the authentication method if present, otherwise undefined.
+ */
+const getLocalAuthMethod = () => config.get("authMethod");
+/**
+ * Set the authentication method.
+ * @param method <string> - the authentication method to be stored.
+ */
+const setLocalAuthMethod = (method) => config.set("authMethod", method);
+/**
+ * Delete the stored authentication method.
+ */
+const deleteLocalAuthMethod = () => config.delete("authMethod");
 /**
  * Get the complete local file path.
  * @param cwd <string> - the current working directory path.
@@ -365,6 +417,12 @@ const getVerificationKeyLocalFilePath = (completeFilename) => `${verificationKey
  * @returns <string> - the complete final verifier contract path to the file.
  */
 const getVerifierContractLocalFilePath = (completeFilename) => `${verifierContractsLocalFolderPath}/${completeFilename}`;
+/**
+ * Get the complete final attestation file path.
+ * @param completeFilename <string> - the complete filename of the file (name.ext).
+ * @returns <string> - the complete final final attestation path to the file.
+ */
+const getFinalAttestationLocalFilePath = (completeFilename) => `${finalAttestationsLocalFolderPath}/${completeFilename}`;
 /**
  * Get the final transcript file path.
  * @param completeFilename <string> - the complete filename of the file (name.ext).
@@ -414,7 +472,7 @@ const getGithubAuthenticatedUserGists = async (githubToken, params) => {
         headers: {
             authorization: `token ${githubToken}`
         },
-        per_page: params.perPage,
+        per_page: params.perPage, // max items per page = 100.
         page: params.page
     });
     if (response && response.status === 200)
@@ -462,9 +520,10 @@ const getPublicAttestationGist = async (githubToken, publicAttestationFilename)
  * @returns <string> - the third-party provider handle of the user.
  */
 const getUserHandleFromProviderUserId = (providerUserId) => {
-    if (providerUserId.indexOf("-") === -1)
-        showError(THIRD_PARTY_SERVICES_ERRORS.GITHUB_GET_GITHUB_ACCOUNT_INFO, true);
-    return providerUserId.split("-")[0];
+    if (providerUserId.indexOf("-") === -1) {
+        return providerUserId;
+    }
+    return providerUserId.substring(0, providerUserId.lastIndexOf("-"));
 };
 /**
  * Return a custom spinner.
@@ -579,8 +638,18 @@ const publishGist = async (token, content, ceremonyTitle, ceremonyPrefix) => {
  * @returns <string> - the ready to share tweet url.
  */
 const generateCustomUrlToTweetAboutParticipation = (ceremonyName, gistUrl, isFinalizing) => isFinalizing
-    ? `https://twitter.com/intent/tweet?text=I%20have%20finalized%20the%20${ceremonyName}%20Phase%202%20Trusted%20Setup%20ceremony!%20You%20can%20view%20my%20final%20attestation%20here:%20${gistUrl}%20#Ethereum%20#ZKP%20#PSE`
-    : `https://twitter.com/intent/tweet?text=I%20contributed%20to%20the%20${ceremonyName}%20Phase%202%20Trusted%20Setup%20ceremony!%20You%20can%20contribute%20here:%20https://github.com/privacy-scaling-explorations/p0tion%20You%20can%20view%20my%20attestation%20here:%20${gistUrl}%20#Ethereum%20#ZKP`;
+    ? `https://twitter.com/intent/tweet?text=I%20have%20finalized%20the%20${ceremonyName}${ceremonyName.toLowerCase().includes("trusted") ||
+        ceremonyName.toLowerCase().includes("setup") ||
+        ceremonyName.toLowerCase().includes("phase2") ||
+        ceremonyName.toLowerCase().includes("ceremony")
+        ? "!"
+        : "%20Phase%202%20Trusted%20Setup%20ceremony!"}%20You%20can%20view%20my%20final%20attestation%20here:%20${gistUrl}%20#Ethereum%20#ZKP%20#PSE`
+    : `https://twitter.com/intent/tweet?text=I%20contributed%20to%20the%20${ceremonyName}${ceremonyName.toLowerCase().includes("trusted") ||
+        ceremonyName.toLowerCase().includes("setup") ||
+        ceremonyName.toLowerCase().includes("phase2") ||
+        ceremonyName.toLowerCase().includes("ceremony")
+        ? "!"
+        : "%20Phase%202%20Trusted%20Setup%20ceremony!"}%20You%20can%20view%20the%20steps%20to%20contribute%20here:%20https://ceremony.pse.dev%20You%20can%20view%20my%20attestation%20here:%20${gistUrl}%20#Ethereum%20#ZKP`;
 /**
  * Return a custom progress bar.
  * @param type <ProgressBarType> - the type of the progress bar.
@@ -708,13 +777,14 @@ const getLatestUpdatesFromParticipant = async (firestoreDatabase, ceremonyId, pa
  * @param entropyOrBeaconHash <string> - the entropy or beacon hash (only when finalizing) for the contribution.
  * @param contributorOrCoordinatorIdentifier <string> - the identifier of the contributor or coordinator (only when finalizing).
  * @param isFinalizing <boolean> - flag to discriminate between ceremony finalization (true) and contribution (false).
+ * @param circuitsLength <number> - the total number of circuits in the ceremony.
  */
-const handleStartOrResumeContribution = async (cloudFunctions, firestoreDatabase, ceremony, circuit, participant, entropyOrBeaconHash, contributorOrCoordinatorIdentifier, isFinalizing) => {
+const handleStartOrResumeContribution = async (cloudFunctions, firestoreDatabase, ceremony, circuit, participant, entropyOrBeaconHash, contributorOrCoordinatorIdentifier, isFinalizing, circuitsLength) => {
     // Extract data.
     const { prefix: ceremonyPrefix } = ceremony.data;
     const { waitingQueue, avgTimings, prefix: circuitPrefix, sequencePosition } = circuit.data;
     const { completedContributions } = waitingQueue; // = current progress.
-    console.log(`${theme.text.bold(`\n- Circuit # ${theme.colors.magenta(`${sequencePosition}`)}`)} (Contribution Steps)`);
+    console.log(`${theme.text.bold(`\n- Circuit # ${theme.colors.magenta(`${sequencePosition}/${circuitsLength}`)}`)} (Contribution Steps)`);
     // Get most up-to-date data from the participant document.
     let participantData = await getLatestUpdatesFromParticipant(firestoreDatabase, ceremony.id, participant.id);
     const spinner = customSpinner(`${participantData.contributionStep === "DOWNLOADING" /* ParticipantContributionStep.DOWNLOADING */
@@ -760,6 +830,7 @@ const handleStartOrResumeContribution = async (cloudFunctions, firestoreDatabase
         // Download the latest contribution from bucket.
         await downloadCeremonyArtifact(cloudFunctions, bucketName, lastZkeyStorageFilePath, lastZkeyLocalFilePath);
         console.log(`${theme.symbols.success} Contribution ${theme.text.bold(`#${lastZkeyIndex}`)} correctly downloaded`);
+        await sleep(3000);
         // Advance to next contribution step (COMPUTING) if not finalizing.
         if (!isFinalizing) {
             spinner.text = `Preparing for contribution computation...`;
@@ -782,16 +853,19 @@ const handleStartOrResumeContribution = async (cloudFunctions, firestoreDatabase
         spinner.start();
         // Read local transcript file info to get the contribution hash.
         const transcriptContents = readFile(transcriptLocalFilePath);
-        const matchContributionHash = transcriptContents.match(/Contribution.+Hash.+\n\t\t.+\n\t\t.+\n.+\n\t\t.+\n/);
+        const matchContributionHash = transcriptContents.match(contribHashRegex);
         if (!matchContributionHash)
             showError(COMMAND_ERRORS.COMMAND_CONTRIBUTE_FINALIZE_NO_TRANSCRIPT_CONTRIBUTION_HASH_MATCH, true);
         // Format contribution hash.
         const contributionHash = matchContributionHash?.at(0)?.replace("\n\t\t", "");
+        await sleep(500);
         // Make request to cloud functions to permanently store the information.
         await permanentlyStoreCurrentContributionTimeAndHash(cloudFunctions, ceremony.id, computingTime, contributionHash);
         // Format computing time.
         const { seconds: computationSeconds, minutes: computationMinutes, hours: computationHours } = getSecondsMinutesHoursFromMillis(computingTime);
         spinner.succeed(`${isFinalizing ? "Contribution" : `Contribution ${theme.text.bold(`#${nextZkeyIndex}`)}`} computation took ${theme.text.bold(`${convertToDoubleDigits(computationHours)}:${convertToDoubleDigits(computationMinutes)}:${convertToDoubleDigits(computationSeconds)}`)}`);
+        // ensure the previous step is completed
+        await sleep(5000);
         // Advance to next contribution step (UPLOADING) if not finalizing.
         if (!isFinalizing) {
             spinner.text = `Preparing for uploading the contribution...`;
@@ -807,12 +881,17 @@ const handleStartOrResumeContribution = async (cloudFunctions, firestoreDatabase
         console.log(`${theme.symbols.success} Contribution ${theme.text.bold(`#${nextZkeyIndex}`)} already computed`);
     // Contribution step = UPLOADING.
     if (isFinalizing || participantData.contributionStep === "UPLOADING" /* ParticipantContributionStep.UPLOADING */) {
-        spinner.text = `Uploading ${isFinalizing ? "final" : "your"} contribution ${!isFinalizing ? theme.text.bold(`#${nextZkeyIndex}`) : ""} to storage.\n${theme.symbols.warning} This step may take a while based on circuit size and your contribution speed. Everything's fine, just be patient.`;
+        spinner.text = `Uploading ${isFinalizing ? "final" : "your"} contribution ${!isFinalizing ? theme.text.bold(`#${nextZkeyIndex}`) : ""} to storage.\n${theme.symbols.warning} This step may take a while based on circuit size and your internet speed. Everything's fine, just be patient.`;
         spinner.start();
-        if (!isFinalizing)
-            await multiPartUpload(cloudFunctions, bucketName, nextZkeyStorageFilePath, nextZkeyLocalFilePath, Number(process.env.CONFIG_STREAM_CHUNK_SIZE_IN_MB), ceremony.id, participantData.tempContributionData);
+        const progressBar = customProgressBar(ProgressBarType.UPLOAD, `your contribution`);
+        if (!isFinalizing) {
+            await multiPartUpload(cloudFunctions, bucketName, nextZkeyStorageFilePath, nextZkeyLocalFilePath, Number(process.env.CONFIG_STREAM_CHUNK_SIZE_IN_MB), ceremony.id, participantData.tempContributionData, progressBar);
+            progressBar.stop();
+        }
         else
             await multiPartUpload(cloudFunctions, bucketName, nextZkeyStorageFilePath, nextZkeyLocalFilePath, Number(process.env.CONFIG_STREAM_CHUNK_SIZE_IN_MB));
+        // small sleep to ensure the previous step is completed
+        await sleep(5000);
         spinner.succeed(`${isFinalizing ? `Contribution` : `Contribution ${theme.text.bold(`#${nextZkeyIndex}`)}`} correctly saved to storage`);
         // Advance to next contribution step (VERIFYING) if not finalizing.
         if (!isFinalizing) {
@@ -990,7 +1069,7 @@ const promptCircomCompiler = async () => {
  * Shows a list of circuits for a single option selection.
  * @dev the circuit names are derived from local R1CS files.
  * @param options <Array<string>> - an array of circuits names.
- * @returns Promise<string> - the name of the choosen circuit.
+ * @returns Promise<string> - the name of the chosen circuit.
  */
 const promptCircuitSelector = async (options) => {
     const { circuitFilename } = await prompts({
@@ -1008,7 +1087,7 @@ const promptCircuitSelector = async (options) => {
  * Shows a list of standard EC2 VM instance types for a single option selection.
  * @notice the suggested VM configuration type is calculated based on circuit constraint size.
  * @param constraintSize <number> - the amount of circuit constraints
- * @returns Promise<string> - the name of the choosen VM type.
+ * @returns Promise<string> - the name of the chosen VM type.
  */
 const promptVMTypeSelector = async (constraintSize) => {
     let suggestedConfiguration = 0;
@@ -1105,7 +1184,7 @@ const promptVMDiskTypeSelector = async () => {
 /**
  * Show a series of questions about the circuits.
  * @param constraintSize <number> - the amount of circuit constraints.
- * @param timeoutMechanismType <CeremonyTimeoutType> - the choosen timeout mechanism type for the ceremony.
+ * @param timeoutMechanismType <CeremonyTimeoutType> - the chosen timeout mechanism type for the ceremony.
  * @param needPromptCircomCompiler <boolean> - a boolean value indicating if the questions related to the Circom compiler version and commit hash must be asked.
  * @param enforceVM <boolean> - a boolean value indicating if the contribution verification could be supported by VM-only approach or not.
  * @returns Promise<Array<Circuit>> - circuit info prompted by the coordinator.
@@ -1118,7 +1197,7 @@ const promptCircuitInputData = async (constraintSize, timeoutMechanismType, same
     let circomVersion = "";
     let circomCommitHash = "";
     let circuitInputData;
-    let useCfOrVm;
+    let cfOrVm;
     let vmDiskType;
     let vmConfigurationType = "";
     const questions = [
@@ -1173,18 +1252,21 @@ const promptCircuitInputData = async (constraintSize, timeoutMechanismType, same
         circomVersion = version;
         circomCommitHash = commitHash;
     }
-    // Ask for prefered contribution verification method (CF vs VM).
+    // Ask for preferred contribution verification method (CF vs VM).
     if (!enforceVM) {
         const { confirmation } = await askForConfirmation(`The contribution verification can be performed using Cloud Functions (CF, cheaper for small contributions but limited to 1M constraints) or custom virtual machines (expensive but could scale up to 30M constraints). Be aware about VM costs and if you wanna learn more, please visit the documentation to have a complete overview about cost estimation of the two mechanisms.\nChoose the contribution verification mechanism`, `CF`, // eq. true.
         `VM` // eq. false.
         );
-        useCfOrVm = confirmation;
+        cfOrVm = confirmation
+            ? "CF" /* CircuitContributionVerificationMechanism.CF */
+            : "VM" /* CircuitContributionVerificationMechanism.VM */;
     }
-    else
-        useCfOrVm = "VM" /* CircuitContributionVerificationMechanism.VM */;
-    if (useCfOrVm === undefined)
+    else {
+        cfOrVm = "VM" /* CircuitContributionVerificationMechanism.VM */;
+    }
+    if (cfOrVm === undefined)
         showError(COMMAND_ERRORS.COMMAND_ABORT_PROMPT, true);
-    if (!useCfOrVm) {
+    if (cfOrVm === "VM" /* CircuitContributionVerificationMechanism.VM */) {
         // Ask for selecting the specific VM configuration type.
         vmConfigurationType = await promptVMTypeSelector(constraintSize);
         // Ask for selecting the specific VM disk (volume) type.
@@ -1218,9 +1300,7 @@ const promptCircuitInputData = async (constraintSize, timeoutMechanismType, same
                 paramsConfiguration: circuitConfigurationValues
             },
             verification: {
-                cfOrVm: useCfOrVm
-                    ? "CF" /* CircuitContributionVerificationMechanism.CF */
-                    : "VM" /* CircuitContributionVerificationMechanism.VM */,
+                cfOrVm,
                 vm: {
                     vmConfigurationType,
                     vmDiskType
@@ -1256,9 +1336,7 @@ const promptCircuitInputData = async (constraintSize, timeoutMechanismType, same
                 paramsConfiguration: circuitConfigurationValues
             },
             verification: {
-                cfOrVm: useCfOrVm
-                    ? "CF" /* CircuitContributionVerificationMechanism.CF */
-                    : "VM" /* CircuitContributionVerificationMechanism.VM */,
+                cfOrVm,
                 vm: {
                     vmConfigurationType,
                     vmDiskType
@@ -1302,7 +1380,7 @@ const promptCircuitAddition = async () => {
  * Shows a list of pre-computed zKeys for a single option selection.
  * @dev the names are derived from local zKeys files.
  * @param options <Array<string>> - an array of pre-computed zKeys names.
- * @returns Promise<string> - the name of the choosen pre-computed zKey.
+ * @returns Promise<string> - the name of the chosen pre-computed zKey.
  */
 const promptPreComputedZkeySelector = async (options) => {
     const { preComputedZkeyFilename } = await prompts({
@@ -1340,13 +1418,13 @@ const promptNeededPowersForCircuit = async (suggestedSmallestNeededPowers) => {
  * Shows a list of PoT files for a single option selection.
  * @dev the names are derived from local PoT files.
  * @param options <Array<string>> - an array of PoT file names.
- * @returns Promise<string> - the name of the choosen PoT.
+ * @returns Promise<string> - the name of the chosen PoT.
  */
 const promptPotSelector = async (options) => {
     const { potFilename } = await prompts({
         type: "select",
         name: "potFilename",
-        message: theme.text.bold("Select the Powers of Tau file choosen for the circuit"),
+        message: theme.text.bold("Select the Powers of Tau file chosen for the circuit"),
         choices: options.map((option) => {
             console.log(option);
             return { title: option, value: option };
@@ -1364,7 +1442,7 @@ const promptPotSelector = async (options) => {
  * @param isFinalizing <boolean> - true when the coordinator must select a ceremony for finalization; otherwise false (participant selects a ceremony for contribution).
  * @returns Promise<FirebaseDocumentInfo> - the Firestore document of the selected ceremony.
  */
-const promptForCeremonySelection = async (ceremoniesDocuments, isFinalizing) => {
+const promptForCeremonySelection = async (ceremoniesDocuments, isFinalizing, messageToDisplay) => {
     // Prepare state.
     const choices = [];
     // Prepare choices x ceremony.
@@ -1382,9 +1460,7 @@ const promptForCeremonySelection = async (ceremoniesDocuments, isFinalizing) =>
     const { ceremony } = await prompts({
         type: "select",
         name: "ceremony",
-        message: theme.text.bold(!isFinalizing
-            ? "Which ceremony would you like to contribute to?"
-            : "Which ceremony would you like to finalize?"),
+        message: theme.text.bold(messageToDisplay),
         choices,
         initial: 0
     });
@@ -1416,7 +1492,7 @@ const promptToTypeEntropyOrBeacon = async (isEntropy = true) => {
  * @return <Promise<string>> - the entropy.
  */
 const promptForEntropy = async () => {
-    // Prompt for entropy generation prefered method.
+    // Prompt for entropy generation preferred method.
     const { confirmation } = await askForConfirmation(`Do you prefer to type your entropy or generate it randomly?`, "Manually", "Randomly");
     if (confirmation === undefined)
         showError(COMMAND_ERRORS.COMMAND_ABORT_PROMPT, true);
@@ -1535,16 +1611,37 @@ const checkAuth = async (firebaseApp) => {
         showError(THIRD_PARTY_SERVICES_ERRORS.GITHUB_NOT_AUTHENTICATED, true);
     // Retrieve local access token.
     const token = String(getLocalAccessToken());
-    // Get credentials.
-    const credentials = exchangeGithubTokenForCredentials(token);
-    // Sign in to Firebase using credentials.
-    await signInToFirebase(firebaseApp, credentials);
+    let providerUserId;
+    let username;
+    const authMethod = getLocalAuthMethod();
+    switch (authMethod) {
+        case "github": {
+            // Get credentials.
+            const credentials = exchangeGithubTokenForCredentials(token);
+            // Sign in to Firebase using credentials.
+            await signInToFirebase(firebaseApp, credentials);
+            // Get Github unique identifier (handle-id).
+            providerUserId = await getGithubProviderUserId(String(token));
+            username = getUserHandleFromProviderUserId(providerUserId);
+            break;
+        }
+        case "bandada": {
+            const userCredentials = await signInWithCustomToken(getAuth(), token);
+            providerUserId = userCredentials.user.uid;
+            username = providerUserId;
+            break;
+        }
+        case "siwe": {
+            const userCredentials = await signInWithCustomToken(getAuth(), token);
+            providerUserId = userCredentials.user.uid;
+            username = providerUserId;
+            break;
+        }
+    }
     // Get current authenticated user.
     const user = getCurrentFirebaseAuthUser(firebaseApp);
-    // Get Github unique identifier (handle-id).
-    const providerUserId = await getGithubProviderUserId(String(token));
     // Greet the user.
-    console.log(`Greetings, @${theme.text.bold(getUserHandleFromProviderUserId(providerUserId))} ${theme.emojis.wave}\n`);
+    console.log(`Greetings, @${theme.text.bold(username)} ${theme.emojis.wave}\n`);
     return {
         user,
         token,
@@ -1633,7 +1730,7 @@ const handleAdditionOfCircuitsToCeremony = async (r1csOptions, wasmOptions, cere
             wasmFilename.split(`.${commonTerms.foldersAndPathsTerms.wasm}`)[0]);
         if (matchingWasms.length !== 1)
             showError(COMMAND_ERRORS.COMMAND_SETUP_MISMATCH_R1CS_WASM, true);
-        // Get input data for choosen circuit.
+        // Get input data for chosen circuit.
         const circuitInputData = await getInputDataToAddCircuitToCeremony(choosenCircuitFilename, matchingWasms[0], ceremonyTimeoutMechanismType, sameCircomCompiler, circuitSequencePosition, sharedCircomCompilerData);
         // Store circuit data.
         inputDataForCircuits.push(circuitInputData);
@@ -1686,7 +1783,7 @@ const displayCeremonySummary = (ceremonyInputData, circuits) => {
 };
 /**
  * Check if the smallest Powers of Tau has already been downloaded/stored in the correspondent local path
- * @dev we are downloading the Powers of Tau file from Hermez Cryptography Phase 1 Trusted Setup.
+ * @dev we are downloading the Powers of Tau file from Perpetual Powers of Tau Phase 1 Trusted Setup.
  * @param powers <string> - the smallest amount of powers needed for the given circuit (should be in a 'XY' stringified form).
  * @param ptauCompleteFilename <string> - the complete file name of the powers of tau file to be downloaded.
  * @returns <Promise<void>>
@@ -1700,7 +1797,7 @@ const checkAndDownloadSmallestPowersOfTau = async (powers, ptauCompleteFilename)
         .map((dirent) => dirent.name);
     // Check if already downloaded or not.
     if (smallestPtauFileForGivenPowers.length === 0) {
-        const spinner = customSpinner(`Downloading the ${theme.text.bold(`#${powers}`)} smallest PoT file needed from the Hermez Cryptography Phase 1 Trusted Setup...`, `clock`);
+        const spinner = customSpinner(`Downloading the ${theme.text.bold(`#${powers}`)} smallest PoT file needed from the Perpetual Powers of Tau Phase 1 Trusted Setup...`, `clock`);
         spinner.start();
         // Download smallest Powers of Tau file from remote server.
         const streamPipeline = promisify(pipeline);
@@ -1723,7 +1820,7 @@ const checkAndDownloadSmallestPowersOfTau = async (powers, ptauCompleteFilename)
  * number of powers greater than or equal to the powers needed by the zKey), the coordinator will be asked
  * to provide a number of powers manually, ranging from the smallest possible to the largest.
  * @param neededPowers <number> - the smallest amount of powers needed by the zKey.
- * @returns Promise<string, string> - the information about the choosen Powers of Tau file for the pre-computed zKey
+ * @returns Promise<string, string> - the information about the chosen Powers of Tau file for the pre-computed zKey
  * along with related powers.
  */
 const handlePreComputedZkeyPowersOfTauSelection = async (neededPowers) => {
@@ -1815,7 +1912,7 @@ const handleCircuitArtifactUploadToStorage = async (firebaseFunctions, bucketNam
  * @notice The setup command allows the coordinator of the ceremony to prepare the next ceremony by interacting with the CLI.
  * @dev For proper execution, the command must be run in a folder containing the R1CS files related to the circuits
  * for which the coordinator wants to create the ceremony. The command will download the necessary Tau powers
- * from Hermez's ceremony Phase 1 Reliable Setup Ceremony.
+ * from PPoT ceremony Phase 1 Setup Ceremony.
  * @param cmd? <any> - the path to the ceremony setup file.
  */
 const setup = async (cmd) => {
@@ -1824,7 +1921,9 @@ const setup = async (cmd) => {
     let ceremonyId = ""; // The unique identifier of the ceremony.
     const { firebaseApp, firebaseFunctions, firestoreDatabase } = await bootstrapCommandExecutionAndServices();
     // Check for authentication.
-    const { user, providerUserId } = cmd.auth ? await authWithToken(firebaseApp, cmd.auth) : await checkAuth(firebaseApp);
+    const { user, providerUserId } = cmd.auth
+        ? await authWithToken(firebaseApp, cmd.auth)
+        : await checkAuth(firebaseApp);
     // Preserve command execution only for coordinators.
     if (!(await isCoordinator(user)))
         showError(COMMAND_ERRORS.COMMAND_NOT_COORDINATOR, true);
@@ -1841,7 +1940,7 @@ const setup = async (cmd) => {
     // if there is the file option, then set up the non interactively
     if (cmd.template) {
         // 1. parse the file
-        // tmp data - do not cleanup files as we need them 
+        // tmp data - do not cleanup files as we need them
         const spinner = customSpinner(`Parsing ${theme.text.bold(cmd.template)} setup configuration file...`, `clock`);
         spinner.start();
         const setupCeremonyData = await parseCeremonyFile(cmd.template);
@@ -1864,12 +1963,20 @@ const setup = async (cmd) => {
             // 3. generate the zKey
             const spinner = customSpinner(`Generating genesis zKey for circuit ${theme.text.bold(circuit.name)}...`, `clock`);
             spinner.start();
-            await zKey.newZKey(r1csLocalPathAndFileName, getPotLocalFilePath(circuit.files.potFilename), zkeyLocalPathAndFileName, undefined);
-            spinner.succeed(`Generation of the genesis zKey for citcui ${theme.text.bold(circuit.name)} completed successfully`);
+            if (existsSync(zkeyLocalPathAndFileName)) {
+                spinner.succeed(`The genesis zKey for circuit ${theme.text.bold(circuit.name)} is already present on disk`);
+            }
+            else {
+                await zKey.newZKey(r1csLocalPathAndFileName, getPotLocalFilePath(circuit.files.potFilename), zkeyLocalPathAndFileName, undefined);
+                spinner.succeed(`Generation of the genesis zKey for circuit ${theme.text.bold(circuit.name)} completed successfully`);
+            }
+            const hashSpinner = customSpinner(`Calculating hashes for circuit ${theme.text.bold(circuit.name)}...`, `clock`);
+            hashSpinner.start();
             // 4. calculate the hashes
             const wasmBlake2bHash = await blake512FromPath(wasmLocalPathAndFileName);
             const potBlake2bHash = await blake512FromPath(getPotLocalFilePath(circuit.files.potFilename));
             const initialZkeyBlake2bHash = await blake512FromPath(zkeyLocalPathAndFileName);
+            hashSpinner.succeed(`Hashes for circuit ${theme.text.bold(circuit.name)} calculated successfully`);
             // 5. upload the artifacts
             // Upload zKey to Storage.
             await handleCircuitArtifactUploadToStorage(firebaseFunctions, bucketName, circuit.files.initialZkeyStoragePath, zkeyLocalPathAndFileName, circuit.files.initialZkeyFilename);
@@ -1887,9 +1994,9 @@ const setup = async (cmd) => {
             // 6 update the setup data object
             ceremonySetupData.circuits[index].files = {
                 ...circuit.files,
-                potBlake2bHash: potBlake2bHash,
-                wasmBlake2bHash: wasmBlake2bHash,
-                initialZkeyBlake2bHash: initialZkeyBlake2bHash
+                potBlake2bHash,
+                wasmBlake2bHash,
+                initialZkeyBlake2bHash
             };
             ceremonySetupData.circuits[index].zKeySizeInBytes = getFileStats(zkeyLocalPathAndFileName).size;
         }
@@ -2097,17 +2204,29 @@ const expirationCountdownForGithubOAuth = (expirationInSeconds) => {
  */
 const onVerification = async (verification) => {
     // Copy code to clipboard.
-    clipboard.writeSync(verification.user_code);
-    clipboard.readSync();
+    let noClipboard = false;
+    try {
+        clipboard.writeSync(verification.user_code);
+        clipboard.readSync();
+    }
+    catch (error) {
+        noClipboard = true;
+    }
     // Display data.
     console.log(`${theme.symbols.warning} Visit ${theme.text.bold(theme.text.underlined(verification.verification_uri))} on this device to generate a new token and authenticate\n`);
-    console.log(theme.colors.magenta(figlet.textSync("Code is Below", { font: "ANSI Shadow" })), '\n');
-    console.log(`${theme.symbols.info} Your auth code: ${theme.text.bold(verification.user_code)} has been copied to your clipboard (${theme.emojis.clipboard} ${theme.symbols.success})\n`);
+    console.log(theme.colors.magenta(figlet.textSync("Code is Below", { font: "ANSI Shadow" })), "\n");
+    const message = !noClipboard ? `has been copied to your clipboard (${theme.emojis.clipboard})` : ``;
+    console.log(`${theme.symbols.info} Your auth code: ${theme.text.bold(verification.user_code)} ${message} ${theme.symbols.success}\n`);
     const spinner = customSpinner(`Redirecting to Github...`, `clock`);
     spinner.start();
     await sleep(10000); // ~10s to make users able to read the CLI.
-    // Automatically open the page (# Step 2).
-    await open(verification.verification_uri);
+    try {
+        // Automatically open the page (# Step 2).
+        await open(verification.verification_uri);
+    }
+    catch (error) {
+        console.log(`${theme.symbols.info} Please authenticate via GitHub at ${verification.verification_uri}`);
+    }
     spinner.stop();
     // Countdown for time expiration.
     expirationCountdownForGithubOAuth(verification.expires_in);
@@ -2158,6 +2277,7 @@ const auth = async () => {
         // Generate a new access token using Github Device Flow (OAuth 2.0).
         const newToken = await executeGithubDeviceFlow(String(process.env.AUTH_GITHUB_CLIENT_ID));
         // Store the new access token.
+        setLocalAuthMethod("github");
         setLocalAccessToken(newToken);
     }
     else
@@ -2178,6 +2298,249 @@ const auth = async () => {
     terminate(providerUserId);
 };
 
+const { BANDADA_API_URL } = process.env;
+const bandadaApi = new ApiSdk(BANDADA_API_URL);
+const addMemberToGroup = async (groupId, dashboardUrl, identity) => {
+    const commitment = identity.commitment.toString();
+    const group = await bandadaApi.getGroup(groupId);
+    const providerName = group.credentials.id.split("_")[0].toLowerCase();
+    // 6. open a new window with the url:
+    const url = `${dashboardUrl}credentials?group=${groupId}&member=${commitment}&provider=${providerName}`;
+    console.log(`${theme.text.bold(`Verification URL:`)} ${theme.text.underlined(url)}`);
+    open(url);
+    const { confirmation } = await askForConfirmation("Did you join the Bandada group in the browser?");
+    if (!confirmation)
+        showError("You must join the Bandada group to continue the login process", true);
+};
+const isGroupMember = async (groupId, identity) => {
+    const commitment = identity.commitment.toString();
+    const isMember = await bandadaApi.isGroupMember(groupId, commitment);
+    return isMember;
+};
+
+const { BANDADA_DASHBOARD_URL, BANDADA_GROUP_ID } = process.env;
+const authBandada = async () => {
+    try {
+        const { firebaseFunctions } = await bootstrapCommandExecutionAndServices();
+        const spinner = customSpinner(`Checking identity string for Semaphore...`, `clock`);
+        spinner.start();
+        // 1. check if _identity string exists in local storage
+        let identityString;
+        const isIdentityStringStored = checkLocalBandadaIdentity();
+        if (isIdentityStringStored) {
+            identityString = getLocalBandadaIdentity();
+            spinner.succeed(`Identity seed found\n`);
+        }
+        else {
+            spinner.warn(`Identity seed not found\n`);
+            // 2. generate a random _identity string and save it in local storage
+            const { seed } = await prompts({
+                type: "text",
+                name: "seed",
+                message: theme.text.bold(`Enter a secret string to use as your identity seed in Semaphore:`),
+                initial: false
+            });
+            identityString = seed;
+            setLocalBandadaIdentity(identityString);
+        }
+        // 3. create a semaphore identity with _identity string as a seed
+        const identity = new Identity(identityString);
+        // 4. check if the user is a member of the group
+        console.log(`Checking Bandada membership...`);
+        const isMember = await isGroupMember(BANDADA_GROUP_ID, identity);
+        if (!isMember) {
+            await addMemberToGroup(BANDADA_GROUP_ID, BANDADA_DASHBOARD_URL, identity);
+        }
+        // 5. generate a proof that the user owns the commitment.
+        spinner.text = `Generating proof of identity...`;
+        spinner.start();
+        // publicSignals = [hash(externalNullifier, identityNullifier), commitment]
+        const initDirectoryName = getLocalDirname();
+        const directoryName = initDirectoryName.includes("/src") ? "." : initDirectoryName;
+        const { proof, publicSignals } = await groth16.fullProve({
+            identityTrapdoor: identity.trapdoor,
+            identityNullifier: identity.nullifier,
+            externalNullifier: BANDADA_GROUP_ID
+        }, `${directoryName}/public/mini-semaphore.wasm`, `${directoryName}/public/mini-semaphore.zkey`);
+        spinner.succeed(`Proof generated.\n`);
+        spinner.text = `Sending proof to verification...`;
+        spinner.start();
+        // 6. send proof to a cloud function that verifies it and checks membership
+        const cf = httpsCallable(firebaseFunctions, commonTerms.cloudFunctionsNames.bandadaValidateProof);
+        const result = await cf({
+            proof,
+            publicSignals
+        });
+        const { valid, token, message } = result.data;
+        if (!valid) {
+            showError(message, true);
+            deleteLocalAuthMethod();
+            deleteLocalAccessToken();
+            deleteLocalBandadaIdentity();
+        }
+        spinner.succeed(`Proof verified.\n`);
+        spinner.text = `Authenticating...`;
+        spinner.start();
+        // 7. Auth to p0tion firebase
+        const credentials = await signInWithCustomToken(getAuth(), token);
+        setLocalAuthMethod("bandada");
+        setLocalAccessToken(token);
+        spinner.succeed(`Authenticated as ${theme.text.bold(credentials.user.uid)}.`);
+        console.log(`\n${theme.symbols.warning} You can always log out by running the ${theme.text.bold(`phase2cli logout`)} command`);
+    }
+    catch (error) {
+        // Delete local token.
+        console.log("An error crashed the process. Deleting local token and identity.");
+        console.error(error);
+        deleteLocalAuthMethod();
+        deleteLocalAccessToken();
+        deleteLocalBandadaIdentity();
+    }
+    process.exit(0);
+};
+
+const showVerificationCodeAndUri = async (OAuthDeviceCode) => {
+    // Copy code to clipboard.
+    let noClipboard = false;
+    try {
+        clipboard.writeSync(OAuthDeviceCode.user_code);
+        clipboard.readSync();
+    }
+    catch (error) {
+        noClipboard = true;
+    }
+    // Display data.
+    console.log(`${theme.symbols.warning} Visit ${theme.text.bold(theme.text.underlined(OAuthDeviceCode.verification_uri_complete))} on this device to generate a new token and authenticate\n`);
+    console.log(theme.colors.magenta(figlet.textSync("Code is Below", { font: "ANSI Shadow" })), "\n");
+    const message = !noClipboard ? `has been copied to your clipboard (${theme.emojis.clipboard})` : ``;
+    console.log(`${theme.symbols.info} Your auth code: ${theme.text.bold(OAuthDeviceCode.user_code)} ${message} ${theme.symbols.success}\n`);
+    const spinner = customSpinner(`Redirecting to Sign In With Ethereum...`, `clock`);
+    spinner.start();
+    await sleep(10000); // ~10s to make users able to read the CLI.
+    try {
+        // Automatically open the page (# Step 2).
+        await open(OAuthDeviceCode.verification_uri_complete);
+    }
+    catch (error) {
+        console.log(`${theme.symbols.info} Please authenticate via SIWE at ${OAuthDeviceCode.verification_uri_complete}`);
+    }
+    spinner.stop();
+};
+/**
+ * Return the token to sign in to Firebase after passing the SIWE Device Flow
+ * @param clientId <string> - The client id of the Auth0 application.
+ * @param firebaseFunctions <any> - The Firebase functions instance to call the cloud function
+ * @returns <string> - The token to sign in to Firebase
+ */
+const executeSIWEDeviceFlow = async (clientId, firebaseFunctions) => {
+    // Call Auth0 endpoint to request device code uri
+    const OAuthDeviceCode = (await fetch$1(`${process.env.AUTH0_APPLICATION_URL}/oauth/device/code`, {
+        method: "POST",
+        headers: { "content-type": "application/json" },
+        body: JSON.stringify({
+            client_id: clientId,
+            scope: "openid",
+            audience: `${process.env.AUTH0_APPLICATION_URL}/api/v2/`
+        })
+    }).then((_res) => _res.json()));
+    if (OAuthDeviceCode.error) {
+        showError(OAuthDeviceCode.error_description, true);
+        deleteLocalAuthMethod();
+        deleteLocalAccessToken();
+    }
+    await showVerificationCodeAndUri(OAuthDeviceCode);
+    // Poll Auth0 endpoint until you get token or request expires
+    let isSignedIn = false;
+    let isExpired = false;
+    let auth0Token = "";
+    while (!isSignedIn && !isExpired) {
+        // Call Auth0 endpoint to request token
+        const OAuthToken = (await fetch$1(`${process.env.AUTH0_APPLICATION_URL}/oauth/token`, {
+            method: "POST",
+            headers: { "content-type": "application/json" },
+            body: JSON.stringify({
+                client_id: clientId,
+                device_code: OAuthDeviceCode.device_code,
+                grant_type: "urn:ietf:params:oauth:grant-type:device_code"
+            })
+        }).then((_res) => _res.json()));
+        if (OAuthToken.error) {
+            if (OAuthToken.error === "authorization_pending") {
+                // Wait for the user to sign in
+                await sleep(OAuthDeviceCode.interval * 1000);
+            }
+            else if (OAuthToken.error === "slow_down") {
+                // Wait for the user to sign in
+                await sleep(OAuthDeviceCode.interval * 1000 * 2);
+            }
+            else if (OAuthToken.error === "expired_token") {
+                // The user didn't sign in on time
+                isExpired = true;
+            }
+        }
+        else {
+            // The user signed in
+            isSignedIn = true;
+            auth0Token = OAuthToken.access_token;
+        }
+    }
+    // Send token to cloud function to check nonce, create user and retrieve token
+    const cf = httpsCallable(firebaseFunctions, commonTerms.cloudFunctionsNames.checkNonceOfSIWEAddress);
+    const result = await cf({
+        auth0Token
+    });
+    const { token, valid, message } = result.data;
+    if (!valid) {
+        showError(message, true);
+        deleteLocalAuthMethod();
+        deleteLocalAccessToken();
+    }
+    return token;
+};
+/**
+ * Auth command using Sign In With Ethereum
+ * @notice The auth command allows a user to make the association of their Ethereum account with the CLI by leveraging SIWE as an authentication mechanism.
+ * @dev Under the hood, the command handles a manual Device Flow following the guidelines in the SIWE documentation.
+ */
+const authSIWE = async () => {
+    try {
+        const { firebaseFunctions } = await bootstrapCommandExecutionAndServices();
+        // Console more context for the user.
+        console.log(`${theme.symbols.info} ${theme.text.bold(`You are about to authenticate on this CLI using your Ethereum address (device flow - OAuth 2.0 mechanism).\n${theme.symbols.warning} Please, note that only a Sign-in With Ethereum signature will be required`)}\n`);
+        const spinner = customSpinner(`Checking authentication token...`, `clock`);
+        spinner.start();
+        await sleep(5000);
+        // Manage OAuth Github or SIWE token.
+        const isLocalTokenStored = checkLocalAccessToken();
+        if (!isLocalTokenStored) {
+            spinner.fail(`No local authentication token found\n`);
+            // Generate a new access token using Github Device Flow (OAuth 2.0).
+            const newToken = await executeSIWEDeviceFlow(String(process.env.AUTH_SIWE_CLIENT_ID), firebaseFunctions);
+            // Store the new access token.
+            setLocalAuthMethod("siwe");
+            setLocalAccessToken(newToken);
+        }
+        else
+            spinner.succeed(`Local authentication token found\n`);
+        // Get access token from local store.
+        const token = String(getLocalAccessToken());
+        spinner.text = `Authenticating...`;
+        spinner.start();
+        // Exchange token for credential.
+        const credentials = await signInWithCustomToken(getAuth(), token);
+        spinner.succeed(`Authenticated as ${theme.text.bold(credentials.user.uid)}.`);
+        console.log(`\n${theme.symbols.warning} You can always log out by running the ${theme.text.bold(`phase2cli logout`)} command`);
+        process.exit(0);
+    }
+    catch (error) {
+        // Delete local token.
+        console.log("An error crashed the process. Deleting local token and identity.");
+        console.error(error);
+        deleteLocalAuthMethod();
+        deleteLocalAccessToken();
+    }
+};
+
 /**
  * Return the verification result for latest contribution.
  * @param firestoreDatabase <Firestore> - the Firestore service instance associated to the current Firebase application.
@@ -2300,8 +2663,8 @@ const handleDiskSpaceRequirementForNextContribution = async (cloudFunctions, cer
         spinner.fail(`You may not have enough memory to calculate the contribution for the Circuit ${theme.colors.magenta(`${circuitSequencePosition}`)}.\n\n${theme.symbols.info} The required amount of disk space is ${contributionDiskSpaceRequirement < 0.01
             ? theme.text.bold(`< 0.01`)
             : theme.text.bold(contributionDiskSpaceRequirement)} GB but you only have ${participantFreeDiskSpace > 0 ? theme.text.bold(participantFreeDiskSpace.toFixed(2)) : theme.text.bold(0)} GB available memory \nThe estimate ${theme.text.bold("may not be 100% correct")} since is based on the aggregate free memory on your disks but some may not be detected!\n`);
-        const { confirmation } = await askForConfirmation(`Please, we kindly ask you to continue with the contribution if you have noticed the estimate is wrong and you have enough memory in your machine`, "Continue", "Exit");
-        wannaContributeOrHaveEnoughMemory = !!confirmation;
+        const { confirmationEnoughMemory } = await askForConfirmation(`Please, we kindly ask you to continue with the contribution if you have noticed the estimate is wrong and you have enough memory in your machine`, "Continue", "Exit");
+        wannaContributeOrHaveEnoughMemory = !!confirmationEnoughMemory;
         if (circuitSequencePosition > 1) {
             console.log(`${theme.symbols.info} Please note, you have time until ceremony ends to free up your memory and complete remaining contributions`);
             // Asks the contributor if their wants to terminate contributions for the ceremony.
@@ -2369,8 +2732,12 @@ const handlePublicAttestation = async (firestoreDatabase, circuits, ceremonyId,
     // Write public attestation locally.
     writeFile(getAttestationLocalFilePath(`${ceremonyPrefix}_${commonTerms.foldersAndPathsTerms.attestation}.log`), Buffer.from(publicAttestation));
     await sleep(1000); // workaround for file descriptor unexpected close.
-    const gistUrl = await publishGist(participantAccessToken, publicAttestation, ceremonyName, ceremonyPrefix);
-    console.log(`\n${theme.symbols.info} Your public attestation has been successfully posted as Github Gist (${theme.text.bold(theme.text.underlined(gistUrl))})`);
+    let gistUrl = "";
+    const isGithub = getLocalAuthMethod() === "github";
+    if (isGithub) {
+        gistUrl = await publishGist(participantAccessToken, publicAttestation, ceremonyName, ceremonyPrefix);
+        console.log(`\n${theme.symbols.info} Your public attestation has been successfully posted as Github Gist (${theme.text.bold(theme.text.underlined(gistUrl))})`);
+    }
     // Prepare a ready-to-share tweet.
     await handleTweetGeneration(ceremonyName, gistUrl);
 };
@@ -2423,6 +2790,7 @@ const listenToCeremonyCircuitDocumentChanges = (firestoreDatabase, ceremonyId, p
         }
     });
 };
+let contributionInProgress = false;
 /**
  * Listen to current authenticated participant document changes.
  * @dev this is the core business logic related to the execution of the contribute command.
@@ -2550,11 +2918,21 @@ const listenToParticipantDocumentChanges = async (firestoreDatabase, cloudFuncti
                 (!noTemporaryContributionData && resumingWithSameTemporaryData);
             // Scenario (3.B).
             if (isCurrentContributor && hasResumableStep && startingOrResumingContribution) {
+                if (contributionInProgress) {
+                    console.warn(`\n${theme.symbols.warning} Received instruction to start/resume contribution but contribution is already in progress...[skipping]`);
+                    return;
+                }
                 // Communicate resume / start of the contribution to participant.
                 await simpleLoader(`${changedContributionStep === "DOWNLOADING" /* ParticipantContributionStep.DOWNLOADING */ ? `Starting` : `Resuming`} your contribution...`, `clock`, 3000);
-                // Start / Resume the contribution for the participant.
-                await handleStartOrResumeContribution(cloudFunctions, firestoreDatabase, ceremony, circuit, participant, entropy, providerUserId, false // not finalizing.
-                );
+                try {
+                    contributionInProgress = true;
+                    // Start / Resume the contribution for the participant.
+                    await handleStartOrResumeContribution(cloudFunctions, firestoreDatabase, ceremony, circuit, participant, entropy, providerUserId, false, // not finalizing.
+                    circuits.length);
+                }
+                finally {
+                    contributionInProgress = false;
+                }
             }
             // Scenario (3.A).
             else if (isWaitingForContribution)
@@ -2603,7 +2981,9 @@ const listenToParticipantDocumentChanges = async (firestoreDatabase, cloudFuncti
                     // Get latest contribution verification result.
                     await getLatestVerificationResult(firestoreDatabase, ceremony.id, circuit.id, participant.id);
                 // Get next circuit for contribution.
-                const nextCircuit = timeoutExpired ? getCircuitBySequencePosition(circuits, changedContributionProgress) : getCircuitBySequencePosition(circuits, changedContributionProgress + 1);
+                const nextCircuit = timeoutExpired
+                    ? getCircuitBySequencePosition(circuits, changedContributionProgress)
+                    : getCircuitBySequencePosition(circuits, changedContributionProgress + 1);
                 // Check disk space requirements for participant.
                 const wannaGenerateAttestation = await handleDiskSpaceRequirementForNextContribution(cloudFunctions, ceremony.id, nextCircuit.data.sequencePosition, nextCircuit.data.zKeySizeInBytes, timeoutExpired, providerUserId);
                 // Check if the participant would like to generate a new attestation.
@@ -2641,11 +3021,12 @@ const listenToParticipantDocumentChanges = async (firestoreDatabase, cloudFuncti
  */
 const contribute = async (opt) => {
     const { firebaseApp, firebaseFunctions, firestoreDatabase } = await bootstrapCommandExecutionAndServices();
-    // Check for authentication.
-    const { user, providerUserId, token } = await checkAuth(firebaseApp);
     // Get options.
     const ceremonyOpt = opt.ceremony;
     const entropyOpt = opt.entropy;
+    const { auth } = opt;
+    // Check for authentication.
+    const { user, providerUserId, token } = auth ? await authWithToken(firebaseApp, auth) : await checkAuth(firebaseApp);
     // Prepare data.
     let selectedCeremony;
     // Retrieve the opened ceremonies.
@@ -2671,7 +3052,7 @@ const contribute = async (opt) => {
     }
     else {
         // Prompt the user to select a ceremony from the opened ones.
-        selectedCeremony = await promptForCeremonySelection(ceremoniesOpenedForContributions, false);
+        selectedCeremony = await promptForCeremonySelection(ceremoniesOpenedForContributions, false, "Which ceremony would you like to contribute to?");
     }
     // Get selected ceremony circuit(s) documents.
     const circuits = await getCeremonyCircuits(firestoreDatabase, selectedCeremony.id);
@@ -2681,7 +3062,7 @@ const contribute = async (opt) => {
     const userDoc = await getDocumentById(firestoreDatabase, commonTerms.collections.users.name, user.uid);
     const userData = userDoc.data();
     if (!userData) {
-        spinner.fail(`Unfortunately we could not find a user document with your information. This likely means that you did not pass the GitHub reputation checks and therefore are not elegible to contribute to any ceremony. Please contact the coordinator if you believe this to be an error.`);
+        spinner.fail(`Unfortunately we could not find a user document with your information. This likely means that you did not pass the GitHub reputation checks and therefore are not eligible to contribute to any ceremony. If you believe you pass the requirements, it might be possible that your profile is private and we were not able to fetch your real statistics, in this case please consider making your profile public for the duration of the contribution. Please contact the coordinator if you believe this to be an error.`);
         process.exit(0);
     }
     // Check the user's current participant readiness for contribution status (eligible, already contributed, timed out).
@@ -2832,10 +3213,10 @@ const observe = async () => {
         // Preserve command execution only for coordinators].
         if (!(await isCoordinator(user)))
             showError(COMMAND_ERRORS.COMMAND_NOT_COORDINATOR, true);
-        // Get running cerimonies info (if any).
+        // Get running ceremonies info (if any).
         const runningCeremoniesDocs = await getOpenedCeremonies(firestoreDatabase);
         // Ask to select a ceremony.
-        const ceremony = await promptForCeremonySelection(runningCeremoniesDocs, false);
+        const ceremony = await promptForCeremonySelection(runningCeremoniesDocs, false, "Which ceremony would you like to observe?");
         console.log(`${logSymbols.info} Refresh rate set to ~3 seconds for waiting queue updates\n`);
         let cursorPos = 0; // Keep track of current cursor position.
         const spinner = customSpinner(`Getting ready...`, "clock");
@@ -2881,7 +3262,7 @@ const handleVerificationKey = async (cloudFunctions, bucketName, finalZkeyLocalF
     spinner.text = "Writing verification key...";
     // Write the verification key locally.
     writeLocalJsonFile(verificationKeyLocalFilePath, vKey);
-    await sleep(3000); // workaound for file descriptor.
+    await sleep(3000); // workaround for file descriptor.
     // Upload verification key to storage.
     await multiPartUpload(cloudFunctions, bucketName, verificationKeyStorageFilePath, verificationKeyLocalFilePath, Number(process.env.CONFIG_STREAM_CHUNK_SIZE_IN_MB));
     spinner.succeed(`Verification key correctly saved on storage`);
@@ -2901,13 +3282,13 @@ const handleVerifierSmartContract = async (cloudFunctions, bucketName, finalZkey
     const packagePath = `${dirname(fileURLToPath(import.meta.url))}`;
     const verifierPath = packagePath.includes(`src/commands`)
         ? `${dirname(fileURLToPath(import.meta.url))}/../../../../node_modules/snarkjs/templates/verifier_groth16.sol.ejs`
-        : `${dirname(fileURLToPath(import.meta.url))}/../../../node_modules/snarkjs/templates/verifier_groth16.sol.ejs`;
+        : `${dirname(fileURLToPath(import.meta.url))}/../node_modules/snarkjs/templates/verifier_groth16.sol.ejs`;
     // Export the Solidity verifier smart contract.
     const verifierCode = await exportVerifierContract(finalZkeyLocalFilePath, verifierPath);
     spinner.text = `Writing verifier smart contract...`;
     // Write the verification key locally.
     writeFile(verifierContractLocalFilePath, verifierCode);
-    await sleep(3000); // workaound for file descriptor.
+    await sleep(3000); // workaround for file descriptor.
     // Upload verifier smart contract to storage.
     await multiPartUpload(cloudFunctions, bucketName, verifierContractStorageFilePath, verifierContractLocalFilePath, Number(process.env.CONFIG_STREAM_CHUNK_SIZE_IN_MB));
     spinner.succeed(`Verifier smart contract correctly saved on storage`);
@@ -2928,11 +3309,12 @@ const handleVerifierSmartContract = async (cloudFunctions, bucketName, finalZkey
  * @param participant <FirebaseDocumentInfo> - the Firestore document of the participant (coordinator).
  * @param beacon <string> - the value used to compute the final contribution while finalizing the ceremony.
  * @param coordinatorIdentifier <string> - the identifier of the coordinator.
+ * @param circuitsLength <number> - the number of circuits in the ceremony.
  */
-const handleCircuitFinalization = async (cloudFunctions, firestoreDatabase, ceremony, circuit, participant, beacon, coordinatorIdentifier) => {
+const handleCircuitFinalization = async (cloudFunctions, firestoreDatabase, ceremony, circuit, participant, beacon, coordinatorIdentifier, circuitsLength) => {
     // Step (1).
-    await handleStartOrResumeContribution(cloudFunctions, firestoreDatabase, ceremony, circuit, participant, computeSHA256ToHex(beacon), coordinatorIdentifier, true);
-    await sleep(2000); // workaound for descriptors.
+    await handleStartOrResumeContribution(cloudFunctions, firestoreDatabase, ceremony, circuit, participant, computeSHA256ToHex(beacon), coordinatorIdentifier, true, circuitsLength);
+    await sleep(2000); // workaround for descriptors.
     // Extract data.
     const { prefix: circuitPrefix } = circuit.data;
     const { prefix: ceremonyPrefix } = ceremony.data;
@@ -2966,10 +3348,11 @@ const handleCircuitFinalization = async (cloudFunctions, firestoreDatabase, cere
  * @dev For proper execution, the command requires the coordinator to be authenticated with a GitHub account (run auth command first) in order to
  * handle sybil-resistance and connect to GitHub APIs to publish the gist containing the final public attestation.
  */
-const finalize = async () => {
+const finalize = async (opt) => {
     const { firebaseApp, firebaseFunctions, firestoreDatabase } = await bootstrapCommandExecutionAndServices();
     // Check for authentication.
-    const { user, providerUserId, token: coordinatorAccessToken } = await checkAuth(firebaseApp);
+    const { auth } = opt;
+    const { user, providerUserId, token: coordinatorAccessToken } = auth ? await authWithToken(firebaseApp, auth) : await checkAuth(firebaseApp);
     // Preserve command execution only for coordinators.
     if (!(await isCoordinator(user)))
         showError(COMMAND_ERRORS.COMMAND_NOT_COORDINATOR, true);
@@ -2980,7 +3363,7 @@ const finalize = async () => {
         showError(COMMAND_ERRORS.COMMAND_FINALIZED_NO_CLOSED_CEREMONIES, true);
     console.log(`${theme.symbols.warning} The computation of the final contribution could take the bulk of your computational resources and memory based on the size of the circuit ${theme.emojis.fire}\n`);
     // Prompt for ceremony selection.
-    const selectedCeremony = await promptForCeremonySelection(ceremoniesClosedForFinalization, true);
+    const selectedCeremony = await promptForCeremonySelection(ceremoniesClosedForFinalization, true, "Which ceremony would you like to finalize?");
     // Get coordinator participant document.
     let participant = await getDocumentById(firestoreDatabase, getParticipantsCollectionPath(selectedCeremony.id), user.uid);
     const isCoordinatorReadyForCeremonyFinalization = await checkAndPrepareCoordinatorForFinalization(firebaseFunctions, selectedCeremony.id);
@@ -3004,7 +3387,7 @@ const finalize = async () => {
     const circuits = await getCeremonyCircuits(firestoreDatabase, selectedCeremony.id);
     // Handle finalization for each ceremony circuit.
     for await (const circuit of circuits)
-        await handleCircuitFinalization(firebaseFunctions, firestoreDatabase, selectedCeremony, circuit, participant, beacon, providerUserId);
+        await handleCircuitFinalization(firebaseFunctions, firestoreDatabase, selectedCeremony, circuit, participant, beacon, providerUserId, circuits.length);
     process.stdout.write(`\n`);
     const spinner = customSpinner(`Wrapping up the finalization of the ceremony...`, "clock");
     spinner.start();
@@ -3019,7 +3402,7 @@ const finalize = async () => {
     // Generate attestation with final contributions.
     const publicAttestation = await generateValidContributionsAttestation(firestoreDatabase, circuits, selectedCeremony.id, participant.id, contributions, providerUserId, ceremonyName, true);
     // Write public attestation locally.
-    writeFile(getAttestationLocalFilePath(`${prefix}_${finalContributionIndex}_${commonTerms.foldersAndPathsTerms.attestation}.log`), Buffer.from(publicAttestation));
+    writeFile(getFinalAttestationLocalFilePath(`${prefix}_${finalContributionIndex}_${commonTerms.foldersAndPathsTerms.attestation}.log`), Buffer.from(publicAttestation));
     await sleep(3000); // workaround for file descriptor unexpected close.
     const gistUrl = await publishGist(coordinatorAccessToken, publicAttestation, ceremonyName, prefix);
     console.log(`\n${theme.symbols.info} Your public final attestation has been successfully posted as Github Gist (${theme.text.bold(theme.text.underlined(gistUrl))})`);
@@ -3080,7 +3463,9 @@ const logout = async () => {
             const auth = getAuth();
             await signOut(auth);
             // Delete local token.
+            deleteLocalAuthMethod();
             deleteLocalAccessToken();
+            deleteLocalBandadaIdentity();
             await sleep(3000); // ~3s.
             spinner.stop();
             console.log(`${theme.symbols.success} Logout successfully completed`);
@@ -3142,6 +3527,55 @@ const listCeremonies = async () => {
     }
 };
 
+const listParticipants = async () => {
+    try {
+        const { firestoreDatabase } = await bootstrapCommandExecutionAndServices();
+        const allCeremonies = await getAllCeremonies(firestoreDatabase);
+        const selectedCeremony = await promptForCeremonySelection(allCeremonies, true, "Which ceremony would you like to see participants?");
+        const docRef = doc(firestoreDatabase, commonTerms.collections.ceremonies.name, selectedCeremony.id);
+        const participantsRef = collection(docRef, "participants");
+        const participantsSnapshot = await getDocs(participantsRef);
+        const participants = participantsSnapshot.docs.map((participantDoc) => participantDoc.data());
+        const usersRef = collection(firestoreDatabase, "users");
+        const usersSnapshot = await getDocs(usersRef);
+        const users = usersSnapshot.docs.map((userDoc) => {
+            const data = userDoc.data();
+            return { id: userDoc.id, ...data };
+        });
+        const participantDetails = participants
+            .map((participant) => {
+            const user = users.find((_user) => _user.id === participant.userId);
+            if (!user)
+                return null;
+            return {
+                id: user.name,
+                status: participant.status,
+                contributionStep: participant.contributionStep,
+                lastUpdated: new Date(participant.lastUpdated)
+            };
+        })
+            .filter((user) => user !== null);
+        const participantsDone = participantDetails.filter((participant) => participant.status === "DONE");
+        console.log(participantDetails);
+        console.log(`${theme.text.underlined("Total participants:")} ${participantDetails.length}`);
+        console.log(`${theme.text.underlined("Total participants finished:")} ${participantsDone.length}`);
+    }
+    catch (err) {
+        showError(`Something went wrong: ${err.toString()}`, true);
+    }
+    process.exit(0);
+};
+
+const setCeremonyCommands = (program) => {
+    const ceremony = program.command("ceremony").description("manage ceremonies");
+    ceremony
+        .command("participants")
+        .description("retrieve participants list of a ceremony")
+        .requiredOption("-c, --ceremony <string>", "the prefix of the ceremony you want to retrieve information about", "")
+        .action(listParticipants);
+    return ceremony;
+};
+
 // Get pkg info (e.g., name, version).
 const packagePath = `${dirname(fileURLToPath(import.meta.url))}/..`;
 const { description, version, name } = JSON.parse(readFileSync(`${packagePath}/package.json`, "utf8"));
@@ -3150,44 +3584,52 @@ const program = createCommand();
 program.name(name).description(description).version(version);
 // User commands.
 program.command("auth").description("authenticate yourself using your Github account (OAuth 2.0)").action(auth);
+program
+    .command("auth-bandada")
+    .description("authenticate yourself in a privacy-perserving manner using Bandada")
+    .action(authBandada);
+program
+    .command("auth-siwe")
+    .description("authenticate yourself using your Ethereum account (Sign In With Ethereum - SIWE)")
+    .action(authSIWE);
 program
     .command("contribute")
     .description("compute contributions for a Phase2 Trusted Setup ceremony circuits")
     .option("-c, --ceremony <string>", "the prefix of the ceremony you want to contribute for", "")
     .option("-e, --entropy <string>", "the entropy (aka toxic waste) of your contribution", "")
+    .option("-a, --auth <string>", "the Github OAuth 2.0 token", "")
     .action(contribute);
 program
     .command("clean")
     .description("clean up output generated by commands from the current working directory")
     .action(clean);
-program
-    .command("list")
-    .description("List all ceremonies prefixes")
-    .action(listCeremonies);
+program.command("list").description("List all ceremonies prefixes").action(listCeremonies);
 program
     .command("logout")
     .description("sign out from Firebae Auth service and delete Github OAuth 2.0 token from local storage")
     .action(logout);
 program
     .command("validate")
-    .description("Validate that a Ceremony Setup file is correct")
+    .description("validate that a Ceremony Setup file is correct")
     .requiredOption("-t, --template <path>", "The path to the ceremony setup template", "")
     .option("-c, --constraints <number>", "The number of constraints to check against")
     .action(validate);
 // Only coordinator commands.
-const ceremony = program.command("coordinate").description("commands for coordinating a ceremony");
-ceremony
+const coordinate = program.command("coordinate").description("commands for coordinating a ceremony");
+coordinate
     .command("setup")
     .description("setup a Groth16 Phase 2 Trusted Setup ceremony for zk-SNARK circuits")
-    .option('-t, --template <path>', 'The path to the ceremony setup template', '')
-    .option('-a, --auth <string>', 'The Github OAuth 2.0 token', '')
+    .option("-t, --template <path>", "The path to the ceremony setup template", "")
+    .option("-a, --auth <string>", "The Github OAuth 2.0 token", "")
     .action(setup);
-ceremony
+coordinate
     .command("observe")
     .description("observe in real-time the waiting queue of each ceremony circuit")
     .action(observe);
-ceremony
+coordinate
     .command("finalize")
     .description("finalize a Phase2 Trusted Setup ceremony by applying a beacon, exporting verification key and verifier contract")
+    .option("-a, --auth <string>", "the Github OAuth 2.0 token", "")
     .action(finalize);
+setCeremonyCommands(program);
 program.parseAsync(process.argv);