Sodium is a modern, easy-to-use software library for encryption, decryption, signatures, password hashing and more.
It is a portable, cross-compilable, installable, packageable fork of NaCl, with a compatible API, and an extended API to improve usability even further.
Its goal is to provide all of the core operations needed to build higher-level cryptographic tools.
The design choices emphasize security and ease of use. But despite the emphasis on high security, primitives are faster across-the-board than most implementations.
Version 1.0.18 was released on May 31, 2019.
A mailing-list is available to discuss libsodium.
In order to join, just send a random mail to
This documentation can be downloaded as a PDF file here: https://www.gitbook.com/book/jedisct1/libsodium/details
LICENSE file for details.
The development of libsodium is entirely made by volunteers. We would like to specially thank the following companies and organizations for their contribution:
Paragonie Initiative Enterprise, who donated a Raspberry Pi to ensure that the library works perfectly on this hardware.
Maximilian Blochberger and Joshua Small, who both generously donated $100. This will help a lot to cover the infrastructure costs. Thanks again, Max and Joshua!
People who designed the primitives and wrote implementations the library is based on can be found in the AUTHORS file. This project wouldn't exist without them.
Also a huge "thank you" to people and companies who contributed bindings for their favorite programming languages. A list can be found in the THANKS file.
Another huge "thank you" to package maintainers who have been doing an amazing job at building packages for many distributions and operating systems.
Finally, thanks to you for reading this documentation and for the awesome projects you are going to build with this library!