Awesome Open Source
Awesome Open Source

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.

Requirements

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 libsodium from https://download.libsodium.org/libsodium/releases/
  • Choose the version of libsodium you 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)
  • 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}
└───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.



Alternative Project Comparisons
Related Awesome Lists
Top Programming Languages
Top Projects

Get A Weekly Email With Trending Projects For These Topics
No Spam. Unsubscribe easily at any time.
Java (388,172
Bindings (17,152
Cryptography (10,728
Archive (9,980
Networking (5,341
Libsodium (550
Cryptography Library (310
Java Bindings (15