libaegis

Portable C implementations of the AEGIS family of high-performance authenticated ciphers (AEGIS-128L, AEGIS-128X2, AEGIS-128X4, AEGIS-256, AEGIS-256X2, AEGIS-256X4), with runtime CPU detection.

Features

AEGIS-128L with 16 and 32 bytes tags (software, AES-NI, ARM Crypto)
AEGIS-128X2 with 16 and 32 bytes tags (software, VAES + AVX2, AES-NI, ARM Crypto)
AEGIS-128X4 with 16 and 32 bytes tags (software, AVX512, VAES + AVX2, AES-NI, ARM Crypto)
AEGIS-256 with 16 and 32 bytes tags (software, AES-NI, ARM Crypto)
AEGIS-256X2 with 16 and 32 bytes tags (software, VAES + AVX2, AES-NI, ARM Crypto)
AEGIS-256X4 with 16 and 32 bytes tags (software, AVX512, VAES + AVX2, AES-NI, ARM Crypto)
Encryption and decryption with attached and detached tags
Incremental encryption and decryption.
Unauthenticated encryption and decryption (not recommended - only implemented for specific protocols)
Deterministic pseudorandom stream generation.

Installation

Note that the compiler makes a difference. Zig (or a recent clang with target-specific options such as -march=native) produces more efficient code than gcc.

Compilation with `zig`:

zig build -Drelease

The library and headers are installed in the zig-out folder.

To favor performance over side-channel mitigations on WebAssembly and on devices without hardware acceleration, add -Dfavor-performance:

zig build -Drelease -Dfavor-performance

A benchmark can also be built with the -Dwith-benchmark option:

zig build -Drelease -Dwith-benchmark

Compilation with `cmake`:

mkdir build
cd build
cmake -DCMAKE_INSTALL_PREFIX=/install/prefix ..
make install

To favor performance over side-channel mitigations on WebAssembly and on devices without hardware acceleration, add -DFAVOR_PERFORMANCE.

Direct inclusion

Copy everything in src directly into your project, and compile everything like regular C code. No special configuration is required.

Usage

Include <aegis.h> and call aegis_init() prior to doing anything else with the library.

aegis_init() checks the CPU capabilities in order to later use the fastest implementations.

Bindings

aegis is a set of bindings for Rust.

Libaegis users

picotls is a TLS 1.3 implementation in C, with support for the AEGIS cipher suites.
h2o is an HTTP/{1,2,3} serverwith support for the AEGIS cipher suites.

Benchmarks

Benchmarks of the aegis crate against other options for Rust:

AMD Zen4

rust 1.73, zig cc 0.11

cipher	speed
aes128-gcm (`aes-gcm` crate)	2.19 G/s
aes256-gcm (`aes-gcm` crate)	2.03 G/s
chacha20-poly1305	2.00 G/s
aes256-gcm (`boring` crate)	5.93 G/s
aes128-gcm (`boring` crate)	6.33 G/s
aegis256	15.40 G/s
aegis256x2	30.60 G/s
aegis256x4	46.17 G/s
aegis128l	26.16 G/s
aegis128x2	50.35 G/s
aegis128x4	66.22 G/s

Macbook Pro - Apple M1

rust 1.73, Xcode

cipher	speed
aes256-gcm (`aes-gcm` crate)	0.13 G/s
aes128-gcm (`aes-gcm` crate)	0.17 G/s
chacha20-poly1305	0.26 G/s
aes256-gcm (`boring` crate)	5.14 G/s
aes128-gcm (`boring` crate)	6.08 G/s
aegis256	7.94 G/s
aegis256x2	10.56 G/s
aegis256x4	11.20 G/s
aegis128l	14.27 G/s
aegis128x2	15.98 G/s
aegis128x4	12.01 G/s

AWS t4g (aarch64, Graviton)

rust 1.74, clang 15

cipher	speed
aes256-gcm (`aes-gcm` crate)	0.05 G/s
aes128-gcm (`aes-gcm` crate)	0.06 G/s
chacha20-poly1305	0.10 G/s
aes256-gcm (`boring` crate)	1.79 G/s
aes128-gcm (`boring` crate)	2.12 G/s
aegis256	3.14 G/s
aegis128l	4.30 G/s

WebAssembly (Wasmtime, Zen4)

cipher	speed
aes256-gcm	62.97 M/s
aes128-gcm	73.83 M/s
chacha20-poly1305	88.92 M/s
aegis128l	537.49 M/s

WebAssembly (Wasmtime, Apple M1)

cipher	speed
aes256-gcm	49.43 M/s
aes128-gcm	59.37 M/s
chacha20-poly1305	177.85 M/s
aegis128l	533.85 M/s

mfrischknecht/libaegis