[BREAKGLASS] Append-only mirror of github.com/signalapp/noise-java
Go to file
Rhys Weatherley 0ccd438e61 Spec rev30: Remove NXfallback and IXfallback for now
The new fallback patterns have been bumped to a later revision.
2016-07-08 18:50:29 +10:00
NoiseJava Spec rev30: Remove NXfallback and IXfallback for now 2016-07-08 18:50:29 +10:00
NoiseJavaTests Spec rev30: Nonce value 2^64 - 1 is reserved; adjust rollover checks 2016-07-08 18:21:09 +10:00
.gitignore Documentation generation 2016-06-28 15:09:13 +10:00
LICENSE.txt README and LICENSE files 2016-06-28 14:43:54 +10:00
makedoc.sh Documentation generation 2016-06-28 15:09:13 +10:00
README.md Remove AESGCMCipherState for now 2016-06-30 08:37:55 +10:00

Noise-Java Library

Noise-Java is a plain Java implementation of the Noise Protocol, intended as a reference implementation. The code is distributed under the terms of the MIT license.

This library is written in plain Java, making use of the Java Cryptography Extension (JCE) to provide cryptographic primitives and infrastructure. When a primitive is not supported by the platform's JDK, Noise-Java provides a fallback implementation in plain Java.

The following algorithms are commonly available in standard JDK's and Noise-Java will try to use them if present:

  • SHA-256
  • SHA-512
  • AES/CTR/NoPadding

Some JDK installations restrict the use of 256-bit AES keys. You may need to install the "Unlimited Strength Policy Files" for your JDK to get around this restriction. Alternatively, the plain Java fallback implementation of AESGCM in Noise-Java does not have any such restrictions.

If you have better implementations of the cryptographic primitives available, you can modify the createDH(), createCipher(), and createHash() functions in the "Noise" class to integrate your versions.

The package documentation contains more information on the classes in the Noise-Java library.

For more information on this library, to report bugs, to contribute, or to suggest improvements, please contact the author Rhys Weatherley via email.