https://github.com/randombit/botan-rs

:shrimp: Rust cryptography library
https://github.com/randombit/botan-rs

cryptography rust

Last synced: 3 months ago
JSON representation

:shrimp: Rust cryptography library

• Host: GitHub
• URL: https://github.com/randombit/botan-rs
• Owner: randombit
• License: mit
• Created: 2018-07-19T14:57:12.000Z (almost 7 years ago)
• Default Branch: master
• Last Pushed: 2025-03-12T12:07:47.000Z (4 months ago)
• Last Synced: 2025-03-28T12:09:29.234Z (4 months ago)
• Topics: cryptography, rust
• Language: Rust
• Homepage:
• Size: 521 KB
• Stars: 37
• Watchers: 4
• Forks: 16
• Open Issues: 6
• Metadata Files:
  • Readme: README.md
  • Changelog: NEWS.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# botan-rs

[![Build status](https://github.com/randombit/botan-rs/actions/workflows/ci.yml/badge.svg?branch=master)](https://github.com/randombit/botan-rs/actions)

[![crates.io](https://img.shields.io/crates/v/botan.svg)](https://crates.io/crates/botan)

[![docs.rs](https://docs.rs/botan/badge.svg)](https://docs.rs/botan)

This crate wraps the C API exposed by the [Botan](https://botan.randombit.net/)

cryptography library.

Currently the crate exposes ciphers, hashes, MACs, KDFs, password based key

derivation (PBKDF2, Scrypt, Argon2, etc), bcrypt password hashes, random number

generators, X.509 certificates, format preserving encryption, HOTP/TOTP, NIST

key wrapping, multiprecision integers, and the usual public key algorithms (RSA,

ECDSA, ECDH, DH, ...)

PRs and comments/issues happily accepted.

MSRV

-----

The Minimum Supported Rust Version (MSRV) of this crate is Rust 1.64.0.

Any future increase in the MSRV will be accompanied by increasing the minor

version number.

Botan Versions Supported

--------------------------

The latest version of Botan3 is highly recomended for best security and

performance. At least 2.13.0 is required.

Features

---------

The following features are supported:

* `std` (enabled by default): Enable using std library features.  If

  disabled then the crates are `no_std`, however support for `alloc`

  is still required.

* `vendored`: Build a copy of the C++ library directly, without

  relying on a system installed version.

* `static`: Enable static linking for a non-vendored, externally

  provided Botan dependency.

* `pkg-config`: Enable finding a non-vendored, externally provided

  Botan with pkg-config. Can be used in combination with `static`.

The crate detects at build time what features are exported from the C interface,

and adjusts itself accordingly. These feature sets can be checked using

`#[cfg(botan_ffi_YYYYMMDD)]` where YYYYMMDD can be any of

* 20230403: Botan 3.0

* 20240408: Botan 3.4

* 20250506: Botan 3.8