awesome-circom/README.md
README.mdRaw
1# Awesome Circom
2
3> A curated list of repos related to [Circom](https://github.com/iden3/circom).
4
5## Contents
6- [Cryptographic primitives](#cryptographic-primitives)
7 - [In Circom](#cryptographic-primitives-in-circom)
8 - [In other languages](#cryptographic-primitives-in-other-languages)
9- [Provers](#provers)
10- [Code editors](#code-editors)
11- [Tutorials & docs](#tutorials--docs)
12- [Papers](#papers)
13- [Projects using Circom](#projects-using-circom)
14
15
16## Cryptographic primitives
17
18### Cryptographic primitives in Circom
19- [circomlib](https://github.com/iden3/circomlib) - main 'standard lib' in Circom
20- [circom-ecdsa](https://github.com/0xPARC/circom-ecdsa) - secp256k1 ECDSA operations
21- [circom-pairing](https://github.com/yi-sun/circom-pairing) - BLS12-381 curve
22- [zk-attestor](https://github.com/yi-sun/zk-attestor) - Scalable on-chain trustless attestations to data from any past Ethereum block or state (ethereum storage proofs)
23- [keccak256-circom](https://github.com/vocdoni/keccak256-circom) - keccak256 implementation
24
25### Cryptographic primitives in other languages
26> Cryptographic primitives implemented in other languages which are compatible with Circom implementations
27
28- Javascript
29 - [circomlibjs](https://github.com/iden3/circomlibjs) - Javascript library to work with circomlib circuits
30- Go
31 - [go-iden3-crypto](https://github.com/iden3/go-iden3-crypto) - Poseidon & mimc hash, babyjubjub elliptic curve
32 - [arbo](https://github.com/vocdoni/arbo) - Efficient MerkleTree compatible with circomlib, which parallelizes computation by CPUs
33 - [go-merkletree](https://github.com/iden3/go-merkletree) - MerkleTree compatible with circomlib
34- Rust
35 - [poseidon-rs](https://github.com/arnaucube/poseidon-rs) - Poseidon hash function compatible with circomlib
36 - [babyjubjub-rs](https://github.com/arnaucube/babyjubjub-rs) - BabyJubJub elliptic curve compatible with circomlib
37
38## Provers
39- [snarkjs](https://github.com/iden3/snarkjs) - zkSNARK implementation in JavaScript & WASM
40- [rapidsnark](https://github.com/iden3/rapidsnark) - zkSNARK proof generation written in C++ and intel assembly
41- [ark-circom](https://github.com/gakonst/ark-circom) - Arkworks bindings to Circom's R1CS, for Groth16 Proof and Witness generation in Rust
42- [go-circom-prover-verifier](https://github.com/iden3/go-circom-prover-verifier/) - Go implementation of the Groth16 zkSNARK Prover and Verifier compatible with Circom
43- [go-circom-witnesscalc](https://github.com/iden3/go-circom-witnesscalc) - Witness Calculator in go, calling WASM
44
45## Code editors
46- [zkrepl](https://github.com/0xPARC/zkrepl) - Online playground for Circom circuits
47- [vscode plugin](https://github.com/iden3/circom-highlighting-vscode) - VSCode syntax highlighting plugin
48- [vim plugin](https://github.com/iden3/vim-circom-syntax) - Vim syntax highlighting plugin
49
50## Tutorials & docs
51- [docs.circom.io](https://docs.circom.io/) - official Circom docs
52- [Circom & Snarkjs talk](https://www.youtube.com/watch?v=-9TJa1hVsKA) - Jordi Baylina's talk at zkSummit 2019
53- [Electron Labs - Intro to Circom](https://docs.electronlabs.org/intro-to-circom) - Usage of language syntax and programming practices
54- [BattleZips Zero Knowledge Crash Course](https://www.youtube.com/channel/UCcVGZqz46ELMsjVRIr0VOxw) - Tutorial on building a battleship game on Ethereum & Circom
55- [Introduction to Zero Knowledge Proof](https://github.com/enricobottazzi/ZKverse) - Tutorial inspired by the presentation "All About the ZkVerse | Polygon" performed by Jordi Baylina at EthDenver22
56
57## Papers
58> Papers on Circom related constructions and primitives implemented in the circomlib standard library
59
60- [CIRCOM: A Robust and Scalable Language for Building Complex Zero-Knowledge CircuitsComplex Zero-Knowledge Circuits](https://www.techrxiv.org/articles/preprint/CIRCOM_A_Robust_and_Scalable_Language_for_Building_Complex_Zero-Knowledge_Circuits/19374986/1/files/34409498.pdf)
61- [Sparse Merkle Trees](https://docs.iden3.io/publications/pdfs/Merkle-Tree.pdf)
62- [Baby Jubjub Elliptic Curve](https://iden3-docs.readthedocs.io/en/latest/_downloads/33717d75ab84e11313cc0d8a090b636f/Baby-Jubjub.pdf) & [EIP-2494](https://eips.ethereum.org/EIPS/eip-2494)
63- [Poseidon: A New Hash Function for Zero-Knowledge Proof Systems](https://eprint.iacr.org/2019/458)
64
65## Projects using Circom
66- [hermeznetwork/circuits](https://github.com/hermeznetwork/circuits) - Hermez network circuits
67- [iden3/circuits](https://github.com/iden3/circuits/) - Circom circuits used by the iden3 core protocol
68- [appliedzkp/maci](https://github.com/appliedzkp/maci) - Minimal anti collusion infrastructure
69- [appliedzkp/semaphore](https://github.com/appliedzkp/semaphore) - A privacy gadget for creating anonymous proof of membership on Ethereum
70- [tornadocash/tornado-core](https://github.com/tornadocash/tornado-core) - Non-custodial private transactions on Ethereum
71- [worldcoin/semaphore-rs](https://github.com/worldcoin/semaphore-rs) - Rust support library for using semaphore
72- [0xPARC/zk-group-sigs](https://github.com/0xPARC/zk-group-sigs) - Group signatures implemented with zkSNARKs
73- [vocdoni/zk-franchise-proof-circuit](https://github.com/vocdoni/zk-franchise-proof-circuit) - Census proof anonymous voting circuit