@devtion/devcli 0.0.0-7e983e3

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2022 Ethereum Foundation
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,118 @@
+<p align="center">
+    <h1 align="center">
+        Phase2 CLI 👨‍💻
+    </h1>
+    <p align="center">All-in-one command line tool for interfacing with Groth16 zkSNARKs Phase 2 Trusted Setup ceremonies</p>
+</p>
+
+<p align="center">
+    <a href="https://github.com/privacy-scaling-explorations/p0tion">
+        <img src="https://img.shields.io/badge/project-p0tion-blue.svg?style=flat-square">
+    </a>
+    <a href="https://github.com/privacy-scaling-explorations/p0tion/blob/main/LICENSE">
+        <img alt="Github License" src="https://img.shields.io/github/license/privacy-scaling-explorations/p0tion.svg?style=flat-square">
+    </a>
+    <a href="https://www.npmjs.com/package/@p0tion/phase2cli">
+        <img alt="NPM Version" src="https://img.shields.io/npm/v/@p0tion/phase2cli?style=flat-square" />
+    </a>
+    <a href="https://npmjs.org/package/@p0tion/phase2cli">
+        <img alt="Downloads" src="https://img.shields.io/npm/dm/@p0tion/phase2cli.svg?style=flat-square" />
+    </a>
+    <a href="https://eslint.org/">
+        <img alt="Linter" src="https://img.shields.io/badge/linter-eslint-8080f2?style=flat-square&logo=eslint" />
+    </a>
+    <a href="https://prettier.io/">
+        <img alt="Prettier" src="https://img.shields.io/badge/code%20style-prettier-f8bc45?style=flat-square&logo=prettier" />
+    </a>
+</p>
+
+<div align="center">
+    <h4>
+        <a href="https://github.com/privacy-scaling-explorations/p0tion/blob/main/CONTRIBUTING.md">
+            👥 Contributing
+        </a>
+        <span>&nbsp;&nbsp;|&nbsp;&nbsp;</span>
+        <a href="https://github.com/privacy-scaling-explorations/p0tion/blob/main/CODE_OF_CONDUCT.md">
+            🤝 Code of conduct
+        </a>
+        <span>&nbsp;&nbsp;|&nbsp;&nbsp;</span>
+        <a href="https://discord.gg/sF5CT5rzrR">
+            🗣️ Chat &amp; Support
+        </a>
+    </h4>
+</div>
+
+| The interaction with Trusted Setup ceremonies commonly involves the usage of different tools according to the roles (coordinator vs. participants) and ceremony stages (setup, contribution, finalization). The Phase2 CLI acts as an all-in-one independent interface with a custom set of user-friendly and interactive commands. |
+| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+
+Rounding up the option of using a unique tool for different ceremony stages makes it possible to reduce the context switch, level of expertise, and bug exposure. This standard tool (built on top of the `actions` package) contains only the core commands for interfacing with one or more Trusted Setup Phase 2 ceremonies. You could get advantage from these commands and customize (or extend them) based on your unique ceremony needs. By using the CLI, the computing power of the contributor's machine could be fully exploited thus enabling contributions up to larger sizes than with ordinary web-browser clients.
+
+## 🛠 Installation
+
+Install the `@p0tion/phase2cli` package globally
+
+```bash
+npm i -g @p0tion/phase2cli
+```
+
+or run specific commands with `npx`:
+
+```bash
+npx @p0tion/phase2cli contribute
+```
+
+## 📜 Usage
+
+### Local Development
+
+**Prerequisities**
+
+-   Node.js version 16.0 or higher.
+-   Yarn version 3.5.0 or higher.
+
+Copy the `.env.default` file as `.env`:
+
+```bash
+cp .env.default .env
+```
+
+And add your environment variables.
+
+⚠️ Your environment variables must match the corresponding properties values inside the `.env` file of the `actions` package ⚠️
+
+#### Core Commands
+
+```bash
+Usage: phase2cli [options] [command]
+
+All-in-one command line tool for interfacing with Groth16 zkSNARKs Phase 2 Trusted Setup ceremonies
+
+Options:
+  -V, --version   output the version number
+  -h, --help      display help for command
+
+Commands:
+  auth            authenticate yourself using your Github Account (Device Flow OAuth 2.0)
+  contribute      compute contributions for a Phase2 Trusted Setup ceremony circuits
+  clean           clean up output generated by commands from the current working directory
+  logout          sign out from Firebae Auth service and delete Github OAuth 2.0 token from your machine
+  coordinate      special subset of commands for coordinating a ceremony (coordinator only)
+  help [command]  display help for command
+```
+
+#### Coordinator Commands
+
+```bash
+Usage: phase2cli coordinate [options] [command]
+
+special subset of commands for coordinating a ceremony (coordinator only)
+
+Options:
+  -h, --help      display help for command
+
+Commands:
+  setup           setup a Groth16 Phase 2 Trusted Setup ceremony for zk-SNARK circuits
+  observe         real-time updates about queue status for each ceremony circuit
+  finalize        finalize a Phase2 Trusted Setup ceremony (beacon + artifacts exports)
+  help [command]  display help for command
+```

package/dist/.env

@@ -0,0 +1,41 @@
+### FIREBASE ###
+### These configs are related to the configuration of the Firebase services.
+
+
+# The Firebase Application API key for making request against the services.
+# nb. this is going to be auto-generated when creating a new application.
+FIREBASE_API_KEY=AIzaSyDVAu8U4zBpM3FFLPyktSjZnCmg1IR73Cg
+# The URL to Firebase Authentication service (should point to default).
+# nb. this is going to be auto-generated when creating a new application.
+FIREBASE_AUTH_DOMAIN=p0tion-ci-environment.firebaseapp.com
+# The Firebase Application project id (should match with application name).
+FIREBASE_PROJECT_ID=p0tion-ci-environment
+# The Firebase unique message sender identifier (to recognize the application user).
+# nb. this is going to be auto-generated when creating a new application.
+FIREBASE_MESSAGING_SENDER_ID=22680510841
+# The Firebase unique identifier for your application.
+# nb. this is going to be auto-generated when creating a new application.
+FIREBASE_APP_ID=1:22680510841:web:529a664e73dbabd1c7cfa8
+FIREBASE_CF_URL_VERIFY_CONTRIBUTION=https://verifycontribution-mq4aqokliq-ew.a.run.app
+
+### AUTHENTICATION ###
+### These configs are related to the authentication of users.
+
+# The unique identifier for the Github client associated to the OAuth Application.
+AUTH_GITHUB_CLIENT_ID=e9f8a5fabdfe0d95618c
+
+### AWS S3 STORAGE ###
+### These configs are related to the configuration of the interaction with the
+### AWS S3 bucket used as storage for ceremony artifacts.
+
+# The chunk size to be used when executing multi-part upload or downloads.
+# default 50 MBs.
+# (e.g. a 200 MB file setting a stream chunk size of 50 MB is going to be splitted and uploaded/downloaded in 4 chunks).
+CONFIG_STREAM_CHUNK_SIZE_IN_MB=50
+# The postfix string for each ceremony bucket.
+# default -ph2-ceremony
+CONFIG_CEREMONY_BUCKET_POSTFIX=-p0tion-development-environment
+# The amount of time in seconds which indicates the duration about the validity of a pre-signed URL.
+# default: 7200 seconds = 2 hours.
+CONFIG_PRESIGNED_URL_EXPIRATION_IN_SECONDS=7200
+