#aes-gcm #aes #stream #gcm #encryption #crypto

aes-gcm-stream

AES GCM stream encrypt and decrypt library, supports AES128/192/256 bit keys

6 releases

0.2.3 Nov 30, 2023
0.2.2 Oct 15, 2023
0.2.0 Sep 1, 2023
0.1.1 Aug 27, 2023

#629 in Cryptography

Download history 40/week @ 2024-01-19 100/week @ 2024-01-26 19/week @ 2024-02-02 94/week @ 2024-02-09 135/week @ 2024-02-16 212/week @ 2024-02-23 195/week @ 2024-03-01 188/week @ 2024-03-08 102/week @ 2024-03-15 120/week @ 2024-03-22 101/week @ 2024-03-29 51/week @ 2024-04-05

397 downloads per month
Used in tiny-encrypt

MIT/Apache

44KB
891 lines

aes-gcm-stream

Crates | Document

Encrypt

// IMPORTANT! key and nonce SHOULD generate by random
let mut key = [0u8; 32];
let mut nonce = [0; 12];

let mut encryptor = Aes256GcmStreamEncryptor::new(key.clone(), &nonce);

let mut ciphertext = vec![];
ciphertext.extend_from_slice(&encryptor.update(b"Hello "));
ciphertext.extend_from_slice(&encryptor.update(b" World"));
ciphertext.extend_from_slice(&encryptor.update(b"!"));
let (last_block, tag) = encryptor.finalize();
ciphertext.extend_from_slice(&last_block);
ciphertext.extend_from_slice(&tag);

println!("Ciphertext: {}", hex::encode(&ciphertext));

Run Example

Open example: encrypt_and_decrypt.rs

$ cargo run --example encrypt_and_decrypt
    Finished dev [unoptimized + debuginfo] target(s) in 0.10s
     Running `target/debug/examples/encrypt_and_decrypt`
Ciphertext: 86c22c5122404b39683ca9b79b889fd00a6212d1be2ebc3f4f8f22f90b
Plaintext: Hello  World!

Benchmark @MacBook Pro (Retina, 15-inch, Late 2013/2 GHz Quad-Core Intel Core i7)

$ cargo run --release --example bench
AES128 encrypt         : 483.04 M/s
AES192 encrypt         : 466.22 M/s
AES256 encrypt         : 451.38 M/s
AES256 en/decrypt      : 222.66 M/s
AES256 encrypt aes-gcm : 547.63 M/s

Thanks:

Dependencies

~1–1.5MB
~34K SLoC