liushooter / jblake2

A pure Java implementation of BLAKE2 (RFC 7693)

JBlake2

A pure Java (8+) implementation of BLAKE2 (RFC 7693).

Getting started

JBlake2 binaries are available from Maven Central repositories. Download the latest jar or get it directly from your favorite build tool:

Maven

  <dependency>
    <groupId>org.kocakosm</groupId>
    <artifactId>jblake2</artifactId>
    <version>0.4</version>
  </dependency>

Gradle

  compile 'org.kocakosm:jblake2:0.4'

Note: module name for the Java Module System is org.kocakosm.jblake2.

Usage

Browse API docs for the most recent release.

Reproducing/verifying a release build

JBlake2's release builds are reproducible/verifiable since version 0.4. This means that you can reproduce the released jar by building JBlake2 from source. For more information on reproducible builds, see the reproducible-builds.org website.

To verify a particular release build, you'll need an x86_64 machine with GNU Bash (4.1+), Docker (17.05+), and, at your option, Mercurial or Git installed. First, clone the repository (either the official Mercurial repository or the Git mirror). Then, checkout the desired version tag. Finally, run the verify-build.sh script located at the project's root. This script recreates the build environment used to release the version, builds the project from source, downloads the released jar from Maven Central and checks that the build output matches (bit for bit) the downloaded artifact.

License

This program is free software: you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but without any warranty; without even the implied warranty of merchantability or fitness for a particular purpose.

See the GNU Lesser General Public License for more details.

Contact

kocakosm[@]gmail[dot]com