First Steps

Project structure overviewPermalink

Cryptimeleon is composed of several libraries. Overview of Cryptimeleon libraries

Base librariesPermalink

MathPermalink

The Math library contains all the basics like bilinear groups, hashing, randomness generation, and serialization. It is the basis for every other Cryptimeleon library.

Craco (the name has historical reasons) implements various cryptographic primitives and low-level constructions. This includes reusable primitives such as accumulators, commitment schemes, signature and encryption schemes, Sigma protocols, and many more.

The goal of Craco is to provide common cryptographic schemes for use in more high-level protocols.

MclwrapPermalink

Mclwrap provides an efficient BN-254 bilinear group implementation (powered by MCL). You should definitely use this if you want to run timing benchmarks.

Predenc, GroupsigPermalink

Implementations of various predicate encryption schemes and group signature schemes.

Starting from scratchPermalink

If you don’t have anything right now, it’s easiest to get started with our template projects.

Java
Android

If you want to use Zero-knowledge proofs, you can generate a basic project containing your protocol with subzero.

Including our libraries into your existing projectPermalink

Our libraries are hosted on Maven Central. For the sake of this, we assume you want to import Math and Craco (which is usually what you need).

MavenPermalink

Add these dependencies to your pom.xml:

<dependency>
    <groupId>org.cryptimeleon</groupId>
    <artifactId>math</artifactId>
    <version>[3.0,)</version>
</dependency>
<dependency>
    <groupId>org.cryptimeleon</groupId>
    <artifactId>craco</artifactId>
    <version>[4.0,)</version>
</dependency>

GradlePermalink

Add these entries to your build.gradle.

plugins {
  id 'java-library'
}

repositories {
  mavenCentral()
}

dependencies {
  implementation 'org.cryptimeleon:math:3.+'
  implementation 'org.cryptimeleon:craco:4.+'
}

Mclwrap InstallationPermalink

Eventually, you should probably install mclwrap because it is a much more efficient bilinear group than what is available in the Math library by default.

To use MCL in your project, you need to (1) compile and install MCL, and then (2) add the dependency to our the Java bindings. This process is explained here.