Building

We use Gradle for builds. You do not have to install Gradle manually; you only need to have Java available.

Once you have Java installed, just run

./gradlew build

to build the code. This will also run all tests, so if this command works, you are good to go.

On Unix environments, you can run the compiler using ./viaduct from project root. This will use Gradle to automatically rebuild the application as necessary, so you do not have to worry about calling ./gradlew build each time you change something. To start, try

./viaduct --help

Building back ends

ABY

We use ABY for our secure multiparty computation back end. We have bundled ABY as a Java library (see aby-java), so no additional setup is necessary to make it work.

Warning

aby-java currently does not support Windows.

libsnark

We use libsnark for our zero-knowledge proofs back end. You have to manually build the JNI wrapper for libsnark to use the ZKP back end.

First, clone libfqfft: https://github.com/scipr-lab/libfqfft. libsnark actually depends on this library, but we have to build it ourselves because we need to set the -fPIC flag manually to get the wrapper to build. To build, navigate to the root of the repository and run this on your shell: mkdir build && cd build && cmake -DCMAKE_POSITION_INDEPENDENT_CODE=ON ... Then run make and then make install to install the libraries and header files.

Next, clone libsnark: https://github.com/scipr-lab/libsnark. Run this command in the root of the repository: mkdir build && cd build && cmake -DUSE_LINKED_LIBRARIES=ON ... The cmake flag makes the build use the installed version of libfqfft instead of building it again in the depends subrepository. Then run make and then make install to install the libraries and header files.

Finally, build the libsnark wrapper. Navigate to this directory of the viaduct repository: runtime/src/main/cwrapper. Next, inspect the Makefile and make sure that the INCLUDES variable points to the JVM directories. Then inspect the libsnarkwrapper.so target and make sure the link directory (-L) points to the directory where libff and libsnark were installed. Run make to build libsnarkwrapper. Finally, run make install to install the wrapper in a directory known by the JVM to include JNI libraries. By default, the install target will copy the wrapper in /usr/lib/.