AZTEC Ignition Monorepo
This repository contains all code relating to the AZTEC trusted setup multi-party computation. An overview of the different projects, in order of relevance and interest:
- setup-tools - C++ codebase of the actual computation code, verification code etc.
- setup-mpc-server - Coordination server for participants partaking in the MPC.
- setup-mpc-client - Client terminal application for execution of client side tools and reporting to server.
- setup-mpc-client-bash - Helpful reference bash scripts for running the trusted setup without the client application above.
- setup-mpc-common - Shared code between server and client applications.
- setup-mpc-map - The globe visualisation webapp.
- job-server - Coordination server for the post-processing phase.
- setup-post-process - Task application for post-processing phase.
- setup-iac - Global Terraform for the ignition application infrastructure.
- ci-scripts - Build scripts.
Brief technical overview of participating in the MPC. Further information available here.
The Easy Way
The simplest way to participate is to run setup-mpc-client. The only input required to the application is the private key of the address used to register. The application will then display the current ceremony status, and will automatically handle your computation when your turn comes around.
For participants that did not sign up with AZTEC personally (i.e. you registered by sending 1 wei to the registration address). This is the only recommended option. While it's possible to perform the computation the hard way, additional time constraints are applied that institutional participants are not subject to, and you will need to ensure you are meeting the targeted verification rate throughout the process.
The Hard Way
If you want to get ambitious, you may wish to run the computation on, for example, an air-gapped laptop within a faraday cage in the middle of a desert.
Further, you may wish to run either your own implementation, or build the
setup-tools binaries and run those.
Either way, it's still necessary to signal to the server that you are online, in order to be allocated your position in the queue. This can be acheived by running
setup-mpc-client in a special offline mode,
or you can use something like the
simulate_client.sh script in
setup-mpc-client-bash to acheive the same without running the container, sacrificing visualisation of the ceremony.
The instructions in setup-tools should guide you on how to build and run the binaries.
During the ceremony it is not necessary to validate the previous participants, nor the server, have acted honestly. As a participant what's important is for you to validate that your randomness has been included in the final set of published transcripts. As a non-participant, what's important is to verify that every participant that claimed to have included randomness, did so.
- Signal to the server you are online, and wait until your position in queue shifts to the
RUNNINGstate. You can monitor the ceremony here, or by calling the server directly as per the server API documentation.
- Download the previous participants transcripts.
- Transfer the previous participants transcripts to your safe environment.
- Run either the provided
setupbinary in your safe environment, or your own implementation. If writing your own implementation you can follow the transcript specification here.
- Generate signatures of the SHA256 digest of each transcript signed with your private key.
- Transfer the output transcripts and signatures back to your online environment.
- Upload the transcripts and signatures to the server (see
upload.shas a reference).
- Download the full set of transcripts and signatures for all participants.
- Verify that SHA256 digests of the transcripts were signed by the expected participants.
- Verify that the first transcript of each participant was built on top of the previous participants first transcript.
- Verify that each subsequent transcript follows from the transcript before.
Building The Entire Repository
After cloning the repo:
git submodule init && git submodule update
In order to efficiently manage the monorepo we are using
mbt. It's not necessary to install
mbt to build each project but it may simplify things.
Binaries are available below, install in your
mbt build local
Building Just The Client
Troubleshooting The Build
Some older hardware has trouble running a specific code path that results in an “Illegal instruction” error when running tests. This results in a secondary container failing to find the setup-tools image layer.
If you have this error, please comment out the last line of
/setup-tools/Dockerfile.build and try again.