darkbio-crypto 0.8.0

Cryptography primitives and wrappers
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37

# Rust Cryptography Wrappers

[![](https://img.shields.io/crates/v/darkbio-crypto.svg)](https://crates.io/crates/darkbio-crypto)
[![](https://docs.rs/darkbio-crypto/badge.svg)](https://docs.rs/darkbio-crypto)
[![](https://github.com/dark-bio/crypto-rs/workflows/tests/badge.svg)](https://github.com/dark-bio/crypto-rs/actions/workflows/ci.yml)

This repository is parameter selection and lightweight wrapper around a number of Rust cryptographic libraries. Its purpose isn't to implement primitives, rather to unify the API surface of existing libraries; limited to the tiny subset needed by the Dark Bio project.

It contains the following crypto primitives and parameters:

- **RSA** via `RSA2048`
- **EdDSA** via `Ed25519`
- **STREAM** via `ChaCha20` and `Poly1305` at `16B` tags and `64KiB` chunks
- **HPKE** via `X25519`, `HKDF`, `SHA256`, `ChaCha20` and `Poly1305` at `dark-bio-v1:` info prefix

It contains the following satellite utilities:

- **CBOR** restricted to `integer`, `text`, `bytes` and `array`
- **RAND** bytes generator with `OS` and `WASM` sources

All functionality is WASM ready.

## Feature flags

The entire library is hidden behind feature flags:

- `rsa` enables the RSA cryptography
- `hpke` enables the HPKE cryptography
- `eddsa` enables the EdDSA cryptography
- `stream` enables the STREAM cryptography
- `cbor` enables the type-restricted CBOR codecs
- `rand` enables the WASM friendly random generator

Some base features can be expanded with further flags:

- `cert` can expand `hpke` with certificate support, pulls in `eddsa`
- `async` can expand `stream` with futures support, pulls in `futures`