Skip to content

Commit

Permalink
docs: add a badges to README.md
Browse files Browse the repository at this point in the history
  • Loading branch information
baumstern committed Dec 22, 2022
1 parent eba33cf commit 888524b
Show file tree
Hide file tree
Showing 10 changed files with 148 additions and 3 deletions.
83 changes: 80 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,10 @@
# Minimal Anti-Collusion Infrastructure

[![CI](https://github.com/privacy-scaling-explorations/maci/actions/workflows/e2e.yml/badge.svg)](https://github.com/privacy-scaling-explorations/maci/actions/workflows/e2e.yml)
[![CI][cli-actions-badge]][cli-actions-link]
![License](https://img.shields.io/badge/license-MIT-green)
[![Telegram][telegram-badge]][telegram-link]



Please refer to
the original [ethresear.ch
Expand All @@ -11,7 +15,23 @@ Documentation for developers and integrators can be found here:
https://privacy-scaling-explorations.github.io/maci/

We welcome contributions to this project. Please join our
[Telegram group](https://t.me/joinchat/LUgOpE7J2gstRcZqdERyvw) to discuss.
[Telegram group][telegram-link] to discuss.

## Packages

Below you can find a list of the packages included in this repository.

| package | npm | tests |
|---------|-----|--------|
| [maci-circuits][circuits-package] | [![NPM Package][circuits-npm-badge]][circuits-npm-link] | [![Actions Status][circuits-actions-badge]][circuits-actions-link] |
| [maci-cli][cli-package] | [![NPM Package][cli-npm-badge]][cli-npm-link] | [![Actions Status][cli-actions-badge]][cli-actions-link] |
| [maci-common][common-package] | [![NPM Package][common-npm-badge]][common-npm-link] | [![Actions Status][common-actions-badge]][common-actions-link] |
| [maci-contracts][contracts-package] | [![NPM Package][contracts-npm-badge]][contracts-npm-link] | [![Actions Status][contracts-actions-badge]][contracts-actions-link] |
| [maci-core][core-package] | [![NPM Package][core-npm-badge]][core-npm-link] | [![Actions Status][core-actions-badge]][core-actions-link] |
| [maci-crypto][crypto-package] | [![NPM Package][crypto-npm-badge]][crypto-npm-link] | [![Actions Status][crypto-actions-badge]][crypto-actions-link] |
| [maci-domainobjs][domainobjs-package] | [![NPM Package][domainobjs-npm-badge]][domainobjs-npm-link] | [![Actions Status][domainobjs-actions-badge]][domainobjs-actions-link] |
| [maci-integrationTests][integrationTests-package] | [![NPM Package][integrationTests-npm-badge]][integrationTests-npm-link] | [![Actions Status][integrationTests-actions-badge]][integrationTests-actions-link] |
| [maci-server][server-package] | [![NPM Package][server-npm-badge]][server-npm-link] | [![Actions Status][server-actions-badge]][server-actions-link] |

## Local Development and testing

Expand Down Expand Up @@ -169,4 +189,61 @@ Note: a cached version of `builder` job must be on your system prior as it relie

### CI pipeline

CI pipeline ensures that we have automated tests that constantly validate. For more information about pipeline workflows, see https://github.com/privacy-scaling-explorations/maci/wiki/MACI-CI-pipeline.
CI pipeline ensures that we have automated tests that constantly validate. For more information about pipeline workflows, see https://github.com/privacy-scaling-explorations/maci/wiki/MACI-CI-pipeline.

[telegram-badge]: https://badges.aleen42.com/src/telegram.svg
[telegram-link]: https://t.me/joinchat/LUgOpE7J2gstRcZqdERyvw

[circuits-package]: ./circuits
[circuits-npm-badge]: https://img.shields.io/npm/v/maci-circuits.svg
[circuits-npm-link]: https://www.npmjs.com/package/maci-circuits
[circuits-actions-badge]: https://github.com/privacy-scaling-explorations/maci/actions/workflows/circuit-build.yml/badge.svg
[circuits-actions-link]: https://github.com/privacy-scaling-explorations/maci/actions?query=workflow%3ACircuit

[cli-package]: ./cli
[cli-npm-badge]: https://img.shields.io/npm/v/maci-cli.svg
[cli-actions-badge]: https://github.com/privacy-scaling-explorations/maci/actions/workflows/e2e.yml/badge.svg
[cli-npm-link]: https://www.npmjs.com/package/maci-cli
[cli-actions-link]: https://github.com/privacy-scaling-explorations/maci/actions?query=workflow%3ACI

[common-package]: ./common
[common-npm-badge]: https://img.shields.io/npm/v/maci-common.svg
[common-npm-link]: https://www.npmjs.com/package/maci-common
[common-actions-badge]: https://github.com/privacy-scaling-explorations/maci/actions/workflows/build.yml/badge.svg
[common-actions-link]: https://github.com/privacy-scaling-explorations/maci/actions?query=workflow%3Acommon

[contracts-package]: ./contracts
[contracts-npm-badge]: https://img.shields.io/npm/v/maci-contracts.svg
[contracts-npm-link]: https://www.npmjs.com/package/maci-contracts
[contracts-actions-badge]: https://github.com/privacy-scaling-explorations/maci/actions/workflows/contracts-build.yml/badge.svg
[contracts-actions-link]: https://github.com/privacy-scaling-explorations/maci/actions?query=workflow%3Acontracts

[core-package]: ./core
[core-npm-badge]: https://img.shields.io/npm/v/maci-core.svg
[core-npm-link]: https://www.npmjs.com/package/maci-core
[core-actions-badge]: https://github.com/privacy-scaling-explorations/maci/actions/workflows/core-build.yml/badge.svg
[core-actions-link]: https://github.com/privacy-scaling-explorations/maci/actions?query=workflow%3Acore

[crypto-package]: ./crypto
[crypto-npm-badge]: https://img.shields.io/npm/v/maci-crypto.svg
[crypto-npm-link]: https://www.npmjs.com/package/maci-crypto
[crypto-actions-badge]: https://github.com/privacy-scaling-explorations/maci/actions/workflows/crypto-build.yml/badge.svg
[crypto-actions-link]: https://github.com/privacy-scaling-explorations/maci/actions?query=workflow%3Acrypto

[domainobjs-package]: ./domainobjs
[domainobjs-npm-badge]: https://img.shields.io/npm/v/maci-domainobjs.svg
[domainobjs-npm-link]: https://www.npmjs.com/package/maci-domainobjs
[domainobjs-actions-badge]: https://github.com/privacy-scaling-explorations/maci/actions/workflows/domainobjs-build.yml/badge.svg
[domainobjs-actions-link]: https://github.com/privacy-scaling-explorations/maci/actions?query=workflow%3Adomainobjs

[integrationTests-package]: ./integrationTests
[integrationTests-npm-badge]: https://img.shields.io/npm/v/maci-integrationtests.svg
[integrationTests-npm-link]: https://www.npmjs.com/package/maci-integrationtests
[integrationTests-actions-badge]: https://github.com/privacy-scaling-explorations/maci/actions/workflows/e2e.yml/badge.svg
[integrationTests-actions-link]: https://github.com/privacy-scaling-explorations/maci/actions?query=workflow%3ACI

[server-package]: ./server
[server-npm-badge]: https://img.shields.io/npm/v/maci-server.svg
[server-npm-link]: https://www.npmjs.com/package/maci-server
[server-actions-badge]: https://github.com/privacy-scaling-explorations/maci/actions/workflows/build.yml/badge.svg
[server-actions-link]: https://github.com/privacy-scaling-explorations/maci/actions?query=workflow%3Aserver
7 changes: 7 additions & 0 deletions circuits/README.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,8 @@
# Circuits

[![NPM Package][circuits-npm-badge]][circuits-npm-link]
[![Actions Status][circuits-actions-badge]][circuits-actions-link]

This package contains the zk-SNARK circuits written in Circom 2.0.

The main circuits are:
Expand All @@ -24,3 +27,7 @@ In order to test the circuits package follow the instructions below:
3. run `npm run test` to run all tests or add `-$CIRCUIT_NAME` to test individually (e.g. `npm run test-processMessages`)
[circuits-npm-badge]: https://img.shields.io/npm/v/maci-circuits.svg
[circuits-npm-link]: https://www.npmjs.com/package/maci-circuits
[circuits-actions-badge]: https://github.com/privacy-scaling-explorations/maci/actions/workflows/circuit-build.yml/badge.svg
[circuits-actions-link]: https://github.com/privacy-scaling-explorations/maci/actions?query=workflow%3ACircuit
9 changes: 9 additions & 0 deletions cli/README.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,13 @@
# maci-cli

[![NPM Package][cli-npm-badge]][cli-npm-link]
[![Actions Status][cli-actions-badge]][cli-actions-link]

Please refer to the [documentation for the
CLI](http://privacy-scaling-explorations.github.io/maci/cli.html).


[cli-npm-badge]: https://img.shields.io/npm/v/maci-cli.svg
[cli-actions-badge]: https://github.com/privacy-scaling-explorations/maci/actions/workflows/e2e.yml/badge.svg
[cli-npm-link]: https://www.npmjs.com/package/maci-cli
[cli-actions-link]: https://github.com/privacy-scaling-explorations/maci/actions?query=workflow%3ACI
6 changes: 6 additions & 0 deletions common/README.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,10 @@
# maci-common

[![NPM Package][common-npm-badge]][common-npm-link]


This submodule contains utility/helper functions used by other maci submodules.

[common-npm-badge]: https://img.shields.io/npm/v/maci-common.svg
[common-npm-link]: https://www.npmjs.com/package/maci-common

9 changes: 9 additions & 0 deletions contracts/README.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,8 @@
# `maci-contracts`

[![NPM Package][contracts-npm-badge]][contracts-npm-link]
[![Actions Status][contracts-actions-badge]][contracts-actions-link]

This submodule contains all the Ethereum contracts and tests for MACI.

For more information please refer to the [documentation for Contracts](http://privacy-scaling-explorations.github.io/maci/contracts.html).
Expand Down Expand Up @@ -47,3 +50,9 @@ For more information please refer to the [documentation for Contracts](http://pr

* **`HasherBenchmarks/`**
- Contract with testing and gas benchmark functions only for development purposes


[contracts-npm-badge]: https://img.shields.io/npm/v/maci-contracts.svg
[contracts-npm-link]: https://www.npmjs.com/package/maci-contracts
[contracts-actions-badge]: https://github.com/privacy-scaling-explorations/maci/actions/workflows/contracts-build.yml/badge.svg
[contracts-actions-link]: https://github.com/privacy-scaling-explorations/maci/actions?query=workflow%3Acontracts
8 changes: 8 additions & 0 deletions core/README.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,8 @@
# `maci-core`

[![NPM Package][core-npm-badge]][core-npm-link]
[![Actions Status][core-actions-badge]][core-actions-link]

This submodule assists with handling key business logic functions and
processes.

Expand Down Expand Up @@ -96,3 +99,8 @@ main root) whenever the MACI contract's `mergeMessageAqSubRoots()` and

They should contain the same leaves, even if the `messageAq` is not yet merged.
`messageTree` exists for developer convenience.

[core-npm-badge]: https://img.shields.io/npm/v/maci-core.svg
[core-npm-link]: https://www.npmjs.com/package/maci-core
[core-actions-badge]: https://github.com/privacy-scaling-explorations/maci/actions/workflows/core-build.yml/badge.svg
[core-actions-link]: https://github.com/privacy-scaling-explorations/maci/actions?query=workflow%3Acore
8 changes: 8 additions & 0 deletions crypto/README.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,8 @@
# maci-crypto

[![NPM Package][crypto-npm-badge]][crypto-npm-link]
[![Actions Status][crypto-actions-badge]][crypto-actions-link]

This module implements abstractions over cryptographic functions which MACI
employs.

Expand Down Expand Up @@ -122,3 +125,8 @@ hash4(
i_11,
)
```

[crypto-npm-badge]: https://img.shields.io/npm/v/maci-crypto.svg
[crypto-npm-link]: https://www.npmjs.com/package/maci-crypto
[crypto-actions-badge]: https://github.com/privacy-scaling-explorations/maci/actions/workflows/crypto-build.yml/badge.svg
[crypto-actions-link]: https://github.com/privacy-scaling-explorations/maci/actions?query=workflow%3Acrypto
8 changes: 8 additions & 0 deletions domainobjs/README.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,8 @@
# maci-domainobjs

[![NPM Package][domainobjs-npm-badge]][domainobjs-npm-link]
[![Actions Status][domainobjs-actions-badge]][domainobjs-actions-link]

This module implements domain objects. A domain object is:

> a logical container of purely domain information, usually represents a
Expand Down Expand Up @@ -58,3 +61,8 @@ Encapsulates a Groth16 zk-SNARK verifying key.
## `Proof`

Encapsulates a Groth16 zk-SNARK proof.

[domainobjs-npm-badge]: https://img.shields.io/npm/v/maci-domainobjs.svg
[domainobjs-npm-link]: https://www.npmjs.com/package/maci-domainobjs
[domainobjs-actions-badge]: https://github.com/privacy-scaling-explorations/maci/actions/workflows/domainobjs-build.yml/badge.svg
[domainobjs-actions-link]: https://github.com/privacy-scaling-explorations/maci/actions?query=workflow%3Adomainobjs
8 changes: 8 additions & 0 deletions integrationTests/README.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,14 @@
# maci-integrationTests

[![NPM Package][integrationTests-npm-badge]][integrationTests-npm-link]
[![Actions Status][integrationTests-actions-badge]][integrationTests-actions-link]

This submodule contains test suites that span between different submodules.

The current approach that it takes is to test each CLI command and also chain
them together.

[integrationTests-npm-badge]: https://img.shields.io/npm/v/maci-integrationtests.svg
[integrationTests-npm-link]: https://www.npmjs.com/package/maci-integrationtests
[integrationTests-actions-badge]: https://github.com/privacy-scaling-explorations/maci/actions/workflows/e2e.yml/badge.svg
[integrationTests-actions-link]: https://github.com/privacy-scaling-explorations/maci/actions?query=workflow%3ACI
5 changes: 5 additions & 0 deletions server/README.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,5 @@
[![NPM Package][server-npm-badge]][server-npm-link]

## Local Development

### Setup
Expand Down Expand Up @@ -88,3 +90,6 @@ cd server
# v0.10
./user_v0_10.sh signup -p $pk -x $maci
```

[server-npm-badge]: https://img.shields.io/npm/v/maci-server.svg
[server-npm-link]: https://www.npmjs.com/package/maci-server

0 comments on commit 888524b

Please sign in to comment.