A monorepo of reusable libraries for zero-knowledge technologies.

♚ Yarn workspaces: minimal monorepo package management (yarn, yarn build, yarn docs)
♛ Conventional Commits: human and machine readable meaning to commit messages (yarn commit)
♜ Jest: tests and test coverage for all libraries (yarn test:libraries)
♜ Mocha: tests for circuits and contracts (yarn test:circuits, yarn test:contracts)
♞ ESLint, Prettier: code quality and formatting (yarn prettier & yarn lint)
♝ Typedocs: documentation generator for TypeScript (yarn docs)
♟ Benny: simple benchmarking framework for JavaScript/TypeScript (yarn benchmarks)
♟ Github actions: software workflows for automatic testing, documentation deploy and code quality checks

Package	Version	Downloads	Size
@zk-kit/circuits
@zk-kit/eddsa-poseidon (docs)
@zk-kit/poseidon-cipher (docs)
@zk-kit/baby-jubjub (docs)
@zk-kit/utils (docs)
@zk-kit/imt (docs)
@zk-kit/imt.sol
@zk-kit/smt (docs)
@zk-kit/poseidon-proof (docs)
@zk-kit/eddsa-proof (docs)

• 🔧 Work on open issues
• 📦 Suggest new packages
• 🚀 Share ideas for new features
• 🐛 Create a report if you find any bugs in the code

Clone this repository:

git clone https://github.com/privacy-scaling-explorations/zk-kit.git

and install the dependencies:

cd zk-kit && yarn

Run ESLint to analyze the code and catch bugs:

yarn lint

Run Prettier to check formatting rules:

yarn prettier

or to automatically format the code:

yarn prettier:write

Semaphore uses conventional commits. A command line utility to commit using the correct syntax can be used by running:

yarn commit

It will also automatically check that the modified files comply with ESLint and Prettier rules.

Test the code:

yarn test

Build all the packages and compile contracts:

yarn build

A dist folder will be created inside each JavaScript package.

Generate a documentation website for each package:

yarn docs

The output will be placed on the docs folder.

Bump a new version for your package with:

yarn version:bump <package-name> <version>
# e.g. yarn version:bump utils 2.0.0

It will create a commit and a git tag that you'll need to push on the main branch. A workflow will be triggered and will publish your package on npm and release a new version on Github with its changelogs automatically.

ZK-kit provides a set of pre-configured development tools. All you have to deal with is your own code, testing and documentation. To create a package follow these steps:

1. Fork this repository and clone it (or simply clone it directly if you are a collaborator),
2. Copy one of our current libraries and update the README.md and package.json files with your package name:

cd zk-kit
cp -r packages/smt packages/my-package
cd packages/my-package && rm -fr node_modules dist
grep -r -l "smt" . | xargs sed -i 's/smt/my-package/'
# Update the remaining description/usage sections, and write your code in the src & tests folders!

3. Create an issue for your package and open a PR.

You can see some examples in the benchmarks folder. All you have to do is create a file that exports a function to run your benchmark in that folder, and add that function to the index.ts file. The yarn benchmarks command can be run with no parameters (it will run all the benchmarks), or you can specify the name of your benchmark file to run just that. When you run the command it will create a benchmarks/results folder with your results.