Skip to content
Java binding to the Networking and Cryptography (NaCl) library with the awesomeness of libsodium
Branch: master
Clone or download
Type Name Latest commit message Commit time
Failed to load latest commit information.
src Added functionality for crypto_scalarmult_base for deriving public ke… May 24, 2018
.travis.yml Fix the build May 25, 2018
LICENSE.txt Formatting on headers Mar 31, 2013

License Maven Central Build Status Build status Say Thanks

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.




kalium is implemented using jnr-ffi to bind the shared libraries from libsodium. For a more detailed explanation, please refer to RbNaCl's documentation.


OS X users can get libsodium via homebrew with:

brew install libsodium


Windows users will need to provide the pre-build binaries from libsodium.

  • Download libsodium from
  • Choose the version of libsodium you wish to use
    • The archives follow the following pattern: libsodium-{version}
  • 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)
  • Extract from the archive the dll library files into one of the following locations:
    • into the lib at the root of the working directory directory of your project.
    • into a location that is included in your PATH environment variable.

For example, on Windows 10 machine with a x64 architecture:

{archive root}
            └───dynamic <- copy the library files from this locaiton.

kalium installation

Add as a Maven dependency to your project.


Is Android supported?


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.


Kalium is the effort of a really small group of people, feedback, bug reports and patches are always welcome.

You can’t perform that action at this time.