#aes-gcm #aes #gcm #stream #encryption-decryption

aes-gcm-stream

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

7 releases

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

#350 in Cryptography

Download history 52/week @ 2024-10-20 50/week @ 2024-11-03 269/week @ 2024-11-10 119/week @ 2024-11-17 171/week @ 2024-11-24 61/week @ 2024-12-01 82/week @ 2024-12-08 136/week @ 2024-12-15 29/week @ 2024-12-22 13/week @ 2025-01-05 54/week @ 2025-01-12 49/week @ 2025-01-19 84/week @ 2025-01-26 56/week @ 2025-02-02

243 downloads per month
Used in 2 crates

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

~0.9–1.4MB
~31K SLoC