Summary

Latest Version	Unknown
License	MIT
CI Status	Failing
Downloads	0
Last Indexed	2026-07-21 05:24

Installation

nimble install monocypher

choosenim install monocypher

git clone https://github.com/markspanbroek/monocypher.nim

OS Compatibility

Platform	Linux	macOS	Windows	FreeBSD	OpenBSD	NetBSD	Android	iOS	WASM	Embedded
monocypher	✓	✓	✓	-	-	-	-	-	-	-

Source

Repository	https://github.com/markspanbroek/monocypher.nim
Homepage	https://github.com/markspanbroek/monocypher.nim
Registry Source	nimble_official

README

Monocypher for Nim

Allows the Monocypher cryptography library to be used in Nim. Please refer to its manual for detailed usage and security considerations.

Examples

Create a secret key using the sysrandom library, and ensure that it is erased from memory once it's no longer used:

import monocypher
import sysrandom

let secretKey = getRandomBytes(sizeof(Key))
defer: crypto_wipe(secretKey)

Exchange a shared symmetric key using public keys:

let yourPublicKey = crypto_x25519_public_key(secretKey)
let theirPublicKey = # obtain public key from other party
let sharedKey = crypto_x25519(secretKey, theirPublicKey)
defer: crypto_wipe(sharedKey)

Encrypt a message using a symmetric key:

let nonce = getRandomBytes(sizeof(Nonce))
let plaintext = cast[seq[byte]]("hello")
let (mac, ciphertext) = crypto_aead_lock(sharedKey, nonce, plaintext)

Decrypt a message using a symmetric key:

let decrypted = crypto_aead_unlock(mac, sharedKey, nonce, ciphertext)
defer: crypto_wipe(decrypted)

Sign a message:

let seed = getRandomBytes(sizeof(Seed))
defer: crypto_wipe(seed)
let (secretKey, publicKey) = crypto_eddsa_key_pair(seed)
defer: crypto_wipe(secretKey)
let message = cast[seq[byte]]("hello")
let signature = crypto_eddsa_sign(secretKey, message)

Hash a byte array or a string:

let hashOfBytes = crypto_blake2b([1u8, 2u8, 3u8])
let hashOfString = crypto_blake2b("hello")

Timing-safe comparisons for byte arrays of length 16, 32 or 64:

let hash1 = crypto_blake2b("one")
let hash2 = crypto_blake2b("two")
let hashesAreEqual = crypto_verify(hash1, hash2) # false

Updating to a newer version

Follow these steps when updating the wrapper to a newer version of sss:

update the git submodule in sources/ to point to the new version
run build.sh
update the version in monocypher.nimble
commit the changes

monocypher