kalium - Java binding to the Networking and Cryptography (NaCl) library
A Java binding to Networking and Cryptography library by Daniel J. Bernstein. All the hard work of making a portable NaCl API version was done by Frank Denis on libsodium and kalium was totally inspired by Tony Arcieri's work with RbNaCl.
Requirements
- JDK 6 or higher
- Apache Maven
Installation
libsodium
kalium is implemented using jnr-ffi to bind the shared libraries from libsodium. For a more detailed explanation, please refer to RbNaCl's documentation.
OSX
OS X users can get libsodium via homebrew with:
brew install libsodium
Windows
Windows users will need to provide the pre-build binaries from libsodium.
- Download
libsodiumfrom https://download.libsodium.org/libsodium/releases/ - Choose the version of
libsodiumyou wish to use- The archives follow the following pattern: libsodium-{version}-msvc.zip
- From the archive find the artifacts compiled for your architecture and then the MSVC tool set of your choice
- For example:
v141 // these were compiled against the MSVC v141 (i.e. Visual Studio 2017)
- For example:
- Extract from the archive the
dlllibrary files into one of the following locations:- into the
libat the root of the working directory directory of your project. - into a location that is included in your
PATHenvironment variable.
- into the
For example, on Windows 10 machine with a x64 architecture:
{archive root}
└───x64
...
└───Release
...
└───v141
...
└───dynamic <- copy the library files from this locaiton.
kalium installation
Add as a Maven dependency to your project.
FAQ
Is Android supported?
No.
Would be nice to have some documentation. Do you have some?
Look at the libsodium docs, they are self explanatory. Or, contribute with docs.
I'm experiencing some issues on Windows. Do you have any idea?
I'm sorry but I'm completely clueless about Windows environment, but if you have any suggestions or PR changes. They will be more than welcome.
Notes
Kalium is the effort of a really small group of people, feedback, bug reports and patches are always welcome.