Skip to main content

Quickstart (Scaffold)

This guide will set up a project scaffold using crypto3 and run an example. This will enable you to test ideas quickly and further explore the API’s of the suite. This guide will use a generic setup.


Please ensure you have set up your environment by following the guide here.

Scaffold Setup

Get crypto3 scaffold

git clone
cd crypto3-template

Project structure

The project is an example of generic usage of the suite, adding the whole crypto3 suite as a sub-module dependency.

├── libs : submodule including the repository for crypto3 suite
├── src
│ ├── bls
│ │ │──── src: source for bls signing example.

Build/test scaffold

  • Clone sub-modules recursively
git submodule update --init --recursive
  • Build: The project is built using the cmake system.
mkdir build && cd build && cmake .. && make
  • Run executable

You should see the output Verified signature successfully on your console.


Congratulations! You now have the environment to start experimenting with the crypto3 suite. Modules also have examples/tests in their repositories, ex: algebra examples.