#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

#862 in Cryptography

Download history 128/week @ 2024-06-02 57/week @ 2024-06-09 50/week @ 2024-06-16 63/week @ 2024-06-23 14/week @ 2024-07-07 9/week @ 2024-07-14 63/week @ 2024-07-21 39/week @ 2024-07-28 83/week @ 2024-08-04 7/week @ 2024-08-11 4/week @ 2024-08-18 3/week @ 2024-08-25 65/week @ 2024-09-01 30/week @ 2024-09-08 22/week @ 2024-09-15

120 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.4MB
~33K SLoC