orion

Build Status Build status codecov dependency status Documentation Crates.io

About

orion is a cryptography library written in pure Rust. It aims to provide easy and usable crypto while trying to minimize the use of unsafe code. You can read more about orion in the wiki.

Currently supports: * AEAD: (X)ChaCha20Poly1305. * Stream ciphers: (X)ChaCha20. * KDF: HKDF-HMAC-SHA512, PBKDF2-HMAC-SHA512. * MAC: HMAC-SHA512, Poly1305. * XOF: cSHAKE256. * Hashing: BLAKE2b, SHA512.

Security

This library is not suitable for production code and usage is at own risk.

More information about security regarding orion is available in the wiki.

Features and Requirements

When orion is used in a no_std context, access to nearly all functionality, except for that in hazardous, is not available. This is because the high-level functionality depends on the OsRng which is not available in no_std.

Documentation

Can be viewed here or built with:

cargo doc --no-deps

Tests/Fuzzing

The wiki has details on how orion is tested. To run all tests: cargo test

Fuzzing is done using either cargo-fuzz, with targets in the fuzz/ folder, or honggfuzz-rs in orion-fuzz. The fuzzing targets in orion-fuzz are newer and maintained more. See orion-fuzz on how to start fuzzing with honggfuzz-rs.

Fuzzing targets for cargo-fuzz can be run with: cargo +nightly fuzz run -O fuzz_target

Benchmarks

The library can be benchmarked as below. All benchmarking tests are located in benches/. cargo +nightly bench

Changelog

Can be found here.

License

orion is licensed under the MIT license. See the LICENSE file for more information.