eth-r/lithium

Experimental libsodium API focusing on usability and practically realizable safety

lithium

Cryptography that's slightly less likely to blow up on you

This library is not production-ready and should not be used for purposes where cryptographic failure may endanger anyone's life, liberty or pursuit of happiness. Neither stability nor quality of either API or implementation is guaranteed at the moment.

A libsodium wrapper that aims to make it as hard as possible to shoot yourself in the foot, and thus make it as easy as possible to use crypto in your software. The design of Lithium is heavily informed by research on practical usability and aims to include a "full-stack" design covering most common use-cases.

The Crypto.Lithium.* modules expose an API designed to make all the choices for you, and remove as many pitfalls as possible. For example, nonce handling is a source of unnecessary complexity and danger, and has thus been completely removed from the interface.

The Crypto.Lithium.Unsafe.* modules expose mostly raw libsodium functionality with a reasonable type system, but in a complex or risky way users of the library should not need to have to deal with.

Requires libsodium 1.0.15 or later

lithium's Issues

Is this library still maintained?

Hi @eth-r, I'm currently trying to tidy up the bindings linked on the libsodium website. If this library is still maintained, then please let me know; otherwise, the link to this library will likely be removed from the bindings page to help users find up to date and maintained bindings.

Lithium impossible to build: sized-memory Data.ByteArray.Sized collides with same in memory

$ $ runhaskell Setup.hs build
Preprocessing library for lithium-0.0.0..
Building library for lithium-0.0.0..
[ 1 of 45] Compiling Crypto.Lithium.Internal.Init ( Crypto/Lithium/Internal/Init.hs, dist/build/Crypto/Lithium/Internal/Init.o )
[ 2 of 45] Compiling Crypto.Lithium.Internal.Random ( Crypto/Lithium/Internal/Random.hs, dist/build/Crypto/Lithium/Internal/Random.o )
[ 3 of 45] Compiling Crypto.Lithium.Util.Init ( Crypto/Lithium/Util/Init.hs, dist/build/Crypto/Lithium/Util/Init.o )
[ 4 of 45] Compiling Crypto.Lithium.Util.Phantom ( Crypto/Lithium/Util/Phantom.hs, dist/build/Crypto/Lithium/Util/Phantom.o )
[ 5 of 45] Compiling Crypto.Lithium.Util.Secret ( Crypto/Lithium/Util/Secret.hs, dist/build/Crypto/Lithium/Util/Secret.o )

Crypto/Lithium/Util/Secret.hs:63:1: error:
    Ambiguous module name ‘Data.ByteArray.Sized’:
      it was found in multiple packages:
      memory-0.14.16 sized-memory-0.0.0
   |
63 | import Data.ByteArray.Sized as Sized
   | ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
$ cabal --version
cabal-install version 2.0.0.1
compiled using version 2.0.1.1 of the Cabal library 
$ stack --version
Version 1.6.5, Git revision 24ab0d6ff07f28276e082c3ce74dfdeb1a2ca9e9 (5514 commits) x86_64 hpack-0.20.0
$ ghc --version
The Glorious Glasgow Haskell Compilation System, version 8.2.2
$