Natron

Crystal binding to libsodium. The production crypto backend for omq.cr; also the reference against which nuckle.cr benchmarks itself.

Installation

Add to shard.yml:

dependencies:
  natron:
    github: paddor/natron.cr

Requires libsodium ≥ 1.0.18 installed system-wide (apt install libsodium-dev, brew install libsodium, etc.). sodium_init is called automatically at load time.

Usage

API mirrors nuckle.cr exactly — swap the module name and you're done.

require "natron"

# Keypair generation
sk = Natron::PrivateKey.generate
pk = sk.public_key

# Public-key authenticated encryption
alice = Natron::PrivateKey.generate
bob   = Natron::PrivateKey.generate
nonce = Natron::Random.random_bytes(24)

box = Natron::Box.new(bob.public_key, alice)
ciphertext = box.encrypt(nonce, "hello".to_slice)

box2 = Natron::Box.new(alice.public_key, bob)
plaintext = box2.decrypt(nonce, ciphertext)
# => "hello"

# Symmetric authenticated encryption
key   = Natron::Random.random_bytes(32)
nonce = Natron::Random.random_bytes(24)
box   = Natron::SecretBox.new(key)

ciphertext = box.encrypt(nonce, "hello".to_slice)
plaintext  = box.decrypt(nonce, ciphertext)

Primitives

Not included

BLAKE3 and ChaCha20-BLAKE3 AEAD — libsodium doesn't ship either. Use nuckle.cr or a dedicated BLAKE3 binding for those.

License

ISC