superboring

Crates.iosuperboring
lib.rssuperboring
version0.1.3
sourcesrc
created_at2023-12-17 14:15:27.808854
updated_at2024-09-17 14:35:08.438819
descriptionA reimplementation of the 'boring' crate in pure Rust.
homepagehttps://github.com/jedisct1/rust-superboring
repositoryhttps://github.com/jedisct1/rust-superboring
max_upload_size
id1072523
size227,791
Frank Denis (jedisct1)

documentation

README

Superboring

A Boring(SSL)-compatible API abstraction for Rust cryptographic implementations.

What is Superboring?

Superboring hides the complexity, diversity and instability of cryptographic implementations written in Rust behind an emulation of the boring API (Rust excellent wrappers for BoringSSL).

This allows applications written using the boring API to be able to also use pure Rust implementations without having to maintain two code bases.

Why use emulation instead of always using boring?

Here are valid reasons why using boring may sometimes not be an option.

All of them are just features that haven't been implemented in the boring crate yet, and that the boring maintainers would probably love getting help with, rather than people finding workarounds.

WebAssembly

While BoringSSL itself can be compiled to WebAssembly, the boring crate currently doesn't support this.

Symbol collisions with OpenSSL

OpenSSL and BoringSSL share a lot of symbols, which can cause collisions.

BoringSSL has the ability to prefix symbols in order to avoid this. But the boring crate currently doesn't support this.

Static builds

The real boring crate supports static builds using musl, so emulation is not required. Just use cargo-zigbuild:

cargo zigbuild --target=x86_64-unknown-linux-musl

What is currently implemented?

Superboring currently implements pretty much everything required to handle RSA signatures.

Commit count: 17

cargo fmt