@devtion/devcli 0.0.0-5d170d3 → 0.0.0-67a4629

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (40) hide show
  1. package/README.md +3 -1
  2. package/dist/.env +10 -3
  3. package/dist/index.js +315 -104
  4. package/dist/public/mini-semaphore.wasm +0 -0
  5. package/dist/public/mini-semaphore.zkey +0 -0
  6. package/dist/types/commands/authBandada.d.ts +2 -0
  7. package/dist/types/commands/ceremony/index.d.ts +3 -0
  8. package/dist/types/commands/ceremony/listParticipants.d.ts +2 -0
  9. package/dist/types/commands/contribute.d.ts +1 -1
  10. package/dist/types/commands/finalize.d.ts +4 -3
  11. package/dist/types/commands/index.d.ts +1 -0
  12. package/dist/types/commands/observe.d.ts +1 -1
  13. package/dist/types/commands/setup.d.ts +2 -2
  14. package/dist/types/lib/bandada.d.ts +6 -0
  15. package/dist/types/lib/files.d.ts +1 -0
  16. package/dist/types/lib/localConfigs.d.ts +19 -0
  17. package/dist/types/lib/prompts.d.ts +6 -6
  18. package/dist/types/lib/utils.d.ts +3 -2
  19. package/dist/types/types/index.d.ts +12 -0
  20. package/package.json +11 -4
  21. package/src/commands/auth.ts +21 -7
  22. package/src/commands/authBandada.ts +110 -0
  23. package/src/commands/ceremony/index.ts +20 -0
  24. package/src/commands/ceremony/listParticipants.ts +30 -0
  25. package/src/commands/contribute.ts +25 -17
  26. package/src/commands/finalize.ts +22 -13
  27. package/src/commands/index.ts +2 -1
  28. package/src/commands/listCeremonies.ts +2 -3
  29. package/src/commands/logout.ts +2 -1
  30. package/src/commands/observe.ts +3 -3
  31. package/src/commands/setup.ts +56 -45
  32. package/src/commands/validate.ts +2 -3
  33. package/src/index.ts +30 -13
  34. package/src/lib/bandada.ts +51 -0
  35. package/src/lib/errors.ts +1 -1
  36. package/src/lib/localConfigs.ts +28 -1
  37. package/src/lib/prompts.ts +20 -20
  38. package/src/lib/services.ts +27 -16
  39. package/src/lib/utils.ts +45 -10
  40. package/src/types/index.ts +13 -0
@@ -14,7 +14,7 @@ import {
14
14
  CircuitContributionVerificationMechanism,
15
15
  vmConfigurationTypes,
16
16
  DiskTypeForVM
17
- } from "@p0tion/actions"
17
+ } from "@devtion/actions"
18
18
  import theme from "./theme.js"
19
19
  import { COMMAND_ERRORS, showError } from "./errors.js"
20
20
 
@@ -203,7 +203,7 @@ export const promptCircomCompiler = async (): Promise<CircomCompilerData> => {
203
203
  * Shows a list of circuits for a single option selection.
204
204
  * @dev the circuit names are derived from local R1CS files.
205
205
  * @param options <Array<string>> - an array of circuits names.
206
- * @returns Promise<string> - the name of the choosen circuit.
206
+ * @returns Promise<string> - the name of the chosen circuit.
207
207
  */
208
208
  export const promptCircuitSelector = async (options: Array<string>): Promise<string> => {
209
209
  const { circuitFilename } = await prompts({
@@ -223,7 +223,7 @@ export const promptCircuitSelector = async (options: Array<string>): Promise<str
223
223
  * Shows a list of standard EC2 VM instance types for a single option selection.
224
224
  * @notice the suggested VM configuration type is calculated based on circuit constraint size.
225
225
  * @param constraintSize <number> - the amount of circuit constraints
226
- * @returns Promise<string> - the name of the choosen VM type.
226
+ * @returns Promise<string> - the name of the chosen VM type.
227
227
  */
228
228
  export const promptVMTypeSelector = async (constraintSize): Promise<string> => {
229
229
  let suggestedConfiguration: number = 0
@@ -325,7 +325,7 @@ export const promptVMDiskTypeSelector = async (): Promise<DiskTypeForVM> => {
325
325
  /**
326
326
  * Show a series of questions about the circuits.
327
327
  * @param constraintSize <number> - the amount of circuit constraints.
328
- * @param timeoutMechanismType <CeremonyTimeoutType> - the choosen timeout mechanism type for the ceremony.
328
+ * @param timeoutMechanismType <CeremonyTimeoutType> - the chosen timeout mechanism type for the ceremony.
329
329
  * @param needPromptCircomCompiler <boolean> - a boolean value indicating if the questions related to the Circom compiler version and commit hash must be asked.
330
330
  * @param enforceVM <boolean> - a boolean value indicating if the contribution verification could be supported by VM-only approach or not.
331
331
  * @returns Promise<Array<Circuit>> - circuit info prompted by the coordinator.
@@ -343,7 +343,7 @@ export const promptCircuitInputData = async (
343
343
  let circomVersion: string = ""
344
344
  let circomCommitHash: string = ""
345
345
  let circuitInputData: CircuitInputData
346
- let useCfOrVm: CircuitContributionVerificationMechanism
346
+ let cfOrVm: CircuitContributionVerificationMechanism
347
347
  let vmDiskType: DiskTypeForVM
348
348
  let vmConfigurationType: string = ""
349
349
 
@@ -422,19 +422,23 @@ export const promptCircuitInputData = async (
422
422
  circomCommitHash = commitHash
423
423
  }
424
424
 
425
- // Ask for prefered contribution verification method (CF vs VM).
425
+ // Ask for preferred contribution verification method (CF vs VM).
426
426
  if (!enforceVM) {
427
427
  const { confirmation } = await askForConfirmation(
428
428
  `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`,
429
429
  `CF`, // eq. true.
430
430
  `VM` // eq. false.
431
431
  )
432
- useCfOrVm = confirmation
433
- } else useCfOrVm = CircuitContributionVerificationMechanism.VM
432
+ cfOrVm = confirmation
433
+ ? CircuitContributionVerificationMechanism.CF
434
+ : CircuitContributionVerificationMechanism.VM
435
+ } else {
436
+ cfOrVm = CircuitContributionVerificationMechanism.VM
437
+ }
434
438
 
435
- if (useCfOrVm === undefined) showError(COMMAND_ERRORS.COMMAND_ABORT_PROMPT, true)
439
+ if (cfOrVm === undefined) showError(COMMAND_ERRORS.COMMAND_ABORT_PROMPT, true)
436
440
 
437
- if (!useCfOrVm) {
441
+ if (cfOrVm === CircuitContributionVerificationMechanism.VM) {
438
442
  // Ask for selecting the specific VM configuration type.
439
443
  vmConfigurationType = await promptVMTypeSelector(constraintSize)
440
444
 
@@ -478,9 +482,7 @@ export const promptCircuitInputData = async (
478
482
  paramsConfiguration: circuitConfigurationValues
479
483
  },
480
484
  verification: {
481
- cfOrVm: useCfOrVm
482
- ? CircuitContributionVerificationMechanism.CF
483
- : CircuitContributionVerificationMechanism.VM,
485
+ cfOrVm,
484
486
  vm: {
485
487
  vmConfigurationType,
486
488
  vmDiskType
@@ -520,9 +522,7 @@ export const promptCircuitInputData = async (
520
522
  paramsConfiguration: circuitConfigurationValues
521
523
  },
522
524
  verification: {
523
- cfOrVm: useCfOrVm
524
- ? CircuitContributionVerificationMechanism.CF
525
- : CircuitContributionVerificationMechanism.VM,
525
+ cfOrVm,
526
526
  vm: {
527
527
  vmConfigurationType,
528
528
  vmDiskType
@@ -586,7 +586,7 @@ export const promptCircuitAddition = async (): Promise<boolean> => {
586
586
  * Shows a list of pre-computed zKeys for a single option selection.
587
587
  * @dev the names are derived from local zKeys files.
588
588
  * @param options <Array<string>> - an array of pre-computed zKeys names.
589
- * @returns Promise<string> - the name of the choosen pre-computed zKey.
589
+ * @returns Promise<string> - the name of the chosen pre-computed zKey.
590
590
  */
591
591
  export const promptPreComputedZkeySelector = async (options: Array<string>): Promise<string> => {
592
592
  const { preComputedZkeyFilename } = await prompts({
@@ -633,13 +633,13 @@ export const promptNeededPowersForCircuit = async (suggestedSmallestNeededPowers
633
633
  * Shows a list of PoT files for a single option selection.
634
634
  * @dev the names are derived from local PoT files.
635
635
  * @param options <Array<string>> - an array of PoT file names.
636
- * @returns Promise<string> - the name of the choosen PoT.
636
+ * @returns Promise<string> - the name of the chosen PoT.
637
637
  */
638
638
  export const promptPotSelector = async (options: Array<string>): Promise<string> => {
639
639
  const { potFilename } = await prompts({
640
640
  type: "select",
641
641
  name: "potFilename",
642
- message: theme.text.bold("Select the Powers of Tau file choosen for the circuit"),
642
+ message: theme.text.bold("Select the Powers of Tau file chosen for the circuit"),
643
643
  choices: options.map((option: string) => {
644
644
  console.log(option)
645
645
  return { title: option, value: option }
@@ -731,7 +731,7 @@ export const promptToTypeEntropyOrBeacon = async (isEntropy = true): Promise<str
731
731
  * @return <Promise<string>> - the entropy.
732
732
  */
733
733
  export const promptForEntropy = async (): Promise<string> => {
734
- // Prompt for entropy generation prefered method.
734
+ // Prompt for entropy generation preferred method.
735
735
  const { confirmation } = await askForConfirmation(
736
736
  `Do you prefer to type your entropy or generate it randomly?`,
737
737
  "Manually",
@@ -2,17 +2,22 @@ import {
2
2
  getCurrentFirebaseAuthUser,
3
3
  initializeFirebaseCoreServices,
4
4
  signInToFirebaseWithCredentials
5
- } from "@p0tion/actions"
5
+ } from "@devtion/actions"
6
6
  import clear from "clear"
7
7
  import figlet from "figlet"
8
8
  import { FirebaseApp } from "firebase/app"
9
- import { OAuthCredential } from "firebase/auth"
9
+ import { OAuthCredential, getAuth, signInWithCustomToken } from "firebase/auth"
10
10
  import dotenv from "dotenv"
11
11
  import { fileURLToPath } from "url"
12
12
  import { dirname } from "path"
13
13
  import { AuthUser } from "../types/index.js"
14
14
  import { CONFIG_ERRORS, CORE_SERVICES_ERRORS, showError, THIRD_PARTY_SERVICES_ERRORS } from "./errors.js"
15
- import { checkLocalAccessToken, deleteLocalAccessToken, getLocalAccessToken } from "./localConfigs.js"
15
+ import {
16
+ checkLocalAccessToken,
17
+ checkLocalBandadaIdentity,
18
+ deleteLocalAccessToken,
19
+ getLocalAccessToken
20
+ } from "./localConfigs.js"
16
21
  import theme from "./theme.js"
17
22
  import { exchangeGithubTokenForCredentials, getGithubProviderUserId, getUserHandleFromProviderUserId } from "./utils.js"
18
23
 
@@ -117,8 +122,6 @@ export const signInToFirebase = async (firebaseApp: FirebaseApp, credentials: OA
117
122
  }
118
123
  }
119
124
 
120
-
121
-
122
125
  /**
123
126
  * Ensure that the callee is an authenticated user.
124
127
  * @notice The token will be passed as parameter.
@@ -166,22 +169,30 @@ export const checkAuth = async (firebaseApp: FirebaseApp): Promise<AuthUser> =>
166
169
  // Retrieve local access token.
167
170
  const token = String(getLocalAccessToken())
168
171
 
169
- // Get credentials.
170
- const credentials = exchangeGithubTokenForCredentials(token)
171
-
172
- // Sign in to Firebase using credentials.
173
- await signInToFirebase(firebaseApp, credentials)
172
+ let providerUserId: string
173
+ let username: string
174
+ const isLocalBandadaIdentityStored = checkLocalBandadaIdentity()
175
+ if (isLocalBandadaIdentityStored) {
176
+ const userCredentials = await signInWithCustomToken(getAuth(), token)
177
+ providerUserId = userCredentials.user.uid
178
+ username = providerUserId
179
+ } else {
180
+ // Get credentials.
181
+ const credentials = exchangeGithubTokenForCredentials(token)
182
+
183
+ // Sign in to Firebase using credentials.
184
+ await signInToFirebase(firebaseApp, credentials)
185
+
186
+ // Get Github unique identifier (handle-id).
187
+ providerUserId = await getGithubProviderUserId(String(token))
188
+ username = getUserHandleFromProviderUserId(providerUserId)
189
+ }
174
190
 
175
191
  // Get current authenticated user.
176
192
  const user = getCurrentFirebaseAuthUser(firebaseApp)
177
193
 
178
- // Get Github unique identifier (handle-id).
179
- const providerUserId = await getGithubProviderUserId(String(token))
180
-
181
194
  // Greet the user.
182
- console.log(
183
- `Greetings, @${theme.text.bold(getUserHandleFromProviderUserId(providerUserId))} ${theme.emojis.wave}\n`
184
- )
195
+ console.log(`Greetings, @${theme.text.bold(username)} ${theme.emojis.wave}\n`)
185
196
 
186
197
  return {
187
198
  user,
package/src/lib/utils.ts CHANGED
@@ -19,7 +19,7 @@ import {
19
19
  permanentlyStoreCurrentContributionTimeAndHash,
20
20
  progressToNextContributionStep,
21
21
  verifyContribution
22
- } from "@p0tion/actions"
22
+ } from "@devtion/actions"
23
23
  import { Presets, SingleBar } from "cli-progress"
24
24
  import dotenv from "dotenv"
25
25
  import { GithubAuthProvider, OAuthCredential } from "firebase/auth"
@@ -155,7 +155,9 @@ export const getPublicAttestationGist = async (
155
155
  * @returns <string> - the third-party provider handle of the user.
156
156
  */
157
157
  export const getUserHandleFromProviderUserId = (providerUserId: string): string => {
158
- if (providerUserId.indexOf("-") === -1) showError(THIRD_PARTY_SERVICES_ERRORS.GITHUB_GET_GITHUB_ACCOUNT_INFO, true)
158
+ if (providerUserId.indexOf("-") === -1) {
159
+ return providerUserId
160
+ }
159
161
 
160
162
  return providerUserId.split("-")[0]
161
163
  }
@@ -311,8 +313,22 @@ export const generateCustomUrlToTweetAboutParticipation = (
311
313
  isFinalizing: boolean
312
314
  ) =>
313
315
  isFinalizing
314
- ? `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`
315
- : `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`
316
+ ? `https://twitter.com/intent/tweet?text=I%20have%20finalized%20the%20${ceremonyName}${
317
+ ceremonyName.toLowerCase().includes("trusted") ||
318
+ ceremonyName.toLowerCase().includes("setup") ||
319
+ ceremonyName.toLowerCase().includes("phase2") ||
320
+ ceremonyName.toLowerCase().includes("ceremony")
321
+ ? "!"
322
+ : "%20Phase%202%20Trusted%20Setup%20ceremony!"
323
+ }%20You%20can%20view%20my%20final%20attestation%20here:%20${gistUrl}%20#Ethereum%20#ZKP%20#PSE`
324
+ : `https://twitter.com/intent/tweet?text=I%20contributed%20to%20the%20${ceremonyName}${
325
+ ceremonyName.toLowerCase().includes("trusted") ||
326
+ ceremonyName.toLowerCase().includes("setup") ||
327
+ ceremonyName.toLowerCase().includes("phase2") ||
328
+ ceremonyName.toLowerCase().includes("ceremony")
329
+ ? "!"
330
+ : "%20Phase%202%20Trusted%20Setup%20ceremony!"
331
+ }%20You%20can%20view%20the%20steps%20to%20contribute%20here:%20https://ceremony.pse.dev%20You%20can%20view%20my%20attestation%20here:%20${gistUrl}%20#Ethereum%20#ZKP`
316
332
 
317
333
  /**
318
334
  * Return a custom progress bar.
@@ -521,6 +537,7 @@ export const getLatestUpdatesFromParticipant = async (
521
537
  * @param entropyOrBeaconHash <string> - the entropy or beacon hash (only when finalizing) for the contribution.
522
538
  * @param contributorOrCoordinatorIdentifier <string> - the identifier of the contributor or coordinator (only when finalizing).
523
539
  * @param isFinalizing <boolean> - flag to discriminate between ceremony finalization (true) and contribution (false).
540
+ * @param circuitsLength <number> - the total number of circuits in the ceremony.
524
541
  */
525
542
  export const handleStartOrResumeContribution = async (
526
543
  cloudFunctions: Functions,
@@ -530,7 +547,8 @@ export const handleStartOrResumeContribution = async (
530
547
  participant: FirebaseDocumentInfo,
531
548
  entropyOrBeaconHash: any,
532
549
  contributorOrCoordinatorIdentifier: string,
533
- isFinalizing: boolean
550
+ isFinalizing: boolean,
551
+ circuitsLength: number
534
552
  ): Promise<void> => {
535
553
  // Extract data.
536
554
  const { prefix: ceremonyPrefix } = ceremony.data
@@ -538,7 +556,9 @@ export const handleStartOrResumeContribution = async (
538
556
  const { completedContributions } = waitingQueue // = current progress.
539
557
 
540
558
  console.log(
541
- `${theme.text.bold(`\n- Circuit # ${theme.colors.magenta(`${sequencePosition}`)}`)} (Contribution Steps)`
559
+ `${theme.text.bold(
560
+ `\n- Circuit # ${theme.colors.magenta(`${sequencePosition}/${circuitsLength}`)}`
561
+ )} (Contribution Steps)`
542
562
  )
543
563
 
544
564
  // Get most up-to-date data from the participant document.
@@ -607,6 +627,8 @@ export const handleStartOrResumeContribution = async (
607
627
  `${theme.symbols.success} Contribution ${theme.text.bold(`#${lastZkeyIndex}`)} correctly downloaded`
608
628
  )
609
629
 
630
+ await sleep(3000)
631
+
610
632
  // Advance to next contribution step (COMPUTING) if not finalizing.
611
633
  if (!isFinalizing) {
612
634
  spinner.text = `Preparing for contribution computation...`
@@ -650,6 +672,8 @@ export const handleStartOrResumeContribution = async (
650
672
  // Format contribution hash.
651
673
  const contributionHash = matchContributionHash?.at(0)?.replace("\n\t\t", "")!
652
674
 
675
+ await sleep(500)
676
+
653
677
  // Make request to cloud functions to permanently store the information.
654
678
  await permanentlyStoreCurrentContributionTimeAndHash(
655
679
  cloudFunctions,
@@ -675,6 +699,9 @@ export const handleStartOrResumeContribution = async (
675
699
  )}`
676
700
  )
677
701
 
702
+ // ensure the previous step is completed
703
+ await sleep(5000)
704
+
678
705
  // Advance to next contribution step (UPLOADING) if not finalizing.
679
706
  if (!isFinalizing) {
680
707
  spinner.text = `Preparing for uploading the contribution...`
@@ -696,10 +723,12 @@ export const handleStartOrResumeContribution = async (
696
723
  !isFinalizing ? theme.text.bold(`#${nextZkeyIndex}`) : ""
697
724
  } to storage.\n${
698
725
  theme.symbols.warning
699
- } This step may take a while based on circuit size and your contribution speed. Everything's fine, just be patient.`
726
+ } This step may take a while based on circuit size and your internet speed. Everything's fine, just be patient.`
700
727
  spinner.start()
701
728
 
702
- if (!isFinalizing)
729
+ const progressBar = customProgressBar(ProgressBarType.UPLOAD, `your contribution`)
730
+
731
+ if (!isFinalizing) {
703
732
  await multiPartUpload(
704
733
  cloudFunctions,
705
734
  bucketName,
@@ -707,9 +736,12 @@ export const handleStartOrResumeContribution = async (
707
736
  nextZkeyLocalFilePath,
708
737
  Number(process.env.CONFIG_STREAM_CHUNK_SIZE_IN_MB),
709
738
  ceremony.id,
710
- participantData.tempContributionData
739
+ participantData.tempContributionData,
740
+ progressBar
711
741
  )
712
- else
742
+
743
+ progressBar.stop()
744
+ } else
713
745
  await multiPartUpload(
714
746
  cloudFunctions,
715
747
  bucketName,
@@ -718,6 +750,9 @@ export const handleStartOrResumeContribution = async (
718
750
  Number(process.env.CONFIG_STREAM_CHUNK_SIZE_IN_MB)
719
751
  )
720
752
 
753
+ // small sleep to ensure the previous step is completed
754
+ await sleep(5000)
755
+
721
756
  spinner.succeed(
722
757
  `${
723
758
  isFinalizing ? `Contribution` : `Contribution ${theme.text.bold(`#${nextZkeyIndex}`)}`
@@ -68,3 +68,16 @@ export type GithubGistFile = {
68
68
  raw_url: string
69
69
  size: number
70
70
  }
71
+
72
+ /**
73
+ * Define the return object of the function that verifies the Bandada membership and proof.
74
+ * @typedef {Object} VerifiedBandadaResponse
75
+ * @property {boolean} valid - true if the proof is valid and the user is a member of the group; otherwise false.
76
+ * @property {string} message - a message describing the result of the verification.
77
+ * @property {string} token - the custom access token.
78
+ */
79
+ export type VerifiedBandadaResponse = {
80
+ valid: boolean
81
+ message: string
82
+ token: string
83
+ }