Safe Rust, #![no_std] implementation of Enocoro-128v2 [1], the updated variant [2] of a lightweight, CRYPTREC candidate [3] stream cipher.
No practical attacks against Enocoro-128v2 have been reported [4].
When the entirety of the plaintext or ciphertext is in-memory at once, a simplified API (associated functions) can be used:
```rust use enocoro128v2::Enocoro128;
let key: [u8; 16] = [ 0x4b, 0x8e, 0x29, 0x87, 0x80, 0x95, 0x96, 0xa3, 0xbb, 0x23, 0x82, 0x49, 0x9f, 0x1c, 0xe7, 0xc2, ];
let iv: [u8; 8] = [0x3c, 0x1d, 0xbb, 0x05, 0xe3, 0xca, 0x60, 0xd9];
let plaintext = [ 0x48, 0x65, 0x6c, 0x6c, 0x6f, 0x20, 0x57, 0x6f, 0x72, 0x6c, 0x64, 0x21, ]; // "Hello world!"
let mut msg: [u8; 12] = plaintext.clone();
// Encrypt in-place Enocoro128::applykeystreamstatic(&key, &iv, &mut msg); assert_ne!(msg, plaintext);
// Decrypt in-place Enocoro128::applykeystreamstatic(&key, &iv, &mut msg); assert_eq!(msg, plaintext); ```
If entirety of the plaintext or ciphertext is never in memory at once (e.g. data received/transmitted in chunks, potentially of varying sizes), the instance API can be used:
```rust use enocoro128v2::Enocoro128;
let key: [u8; 16] = [ 0x4b, 0x8e, 0x29, 0x87, 0x80, 0x95, 0x96, 0xa3, 0xbb, 0x23, 0x82, 0x49, 0x9f, 0x1c, 0xe7, 0xc2, ];
let iv: [u8; 8] = [0x3c, 0x1d, 0xbb, 0x05, 0xe3, 0xca, 0x60, 0xd9];
let plaintext1 = [0x48, 0x65, 0x6c, 0x6c, 0x6f]; // "Hello" let plaintext2 = [0x20, 0x57, 0x6f, 0x72, 0x6c, 0x64, 0x21]; // " world!"
let mut msg1 = plaintext1.clone(); let mut msg2 = plaintext2.clone();
// Create an instance of the cipher let mut e128 = Enocoro128::new(&key, &iv);
// Encrypt in-place e128.applykeystream(&mut msg1); e128.applykeystream(&mut msg2); assertne!(msg1, plaintext1); assertne!(msg2, plaintext2);
// Reset keystream prior to decryption e128.init_keystream();
// Decrypt in-place e128.applykeystream(&mut msg1); e128.applykeystream(&mut msg2); asserteq!(msg1, plaintext1); asserteq!(msg2, plaintext2); ```
To generate random buffers or numbers from the keystream (note the caller is responsible for using a platform specific entropy source to create the key and IV, these values seed the PRNG!):
```rust use enocoro128v2::Enocoro128;
// Assuming bytes gathered from a reliable, platform-specific entropy source let key: [u8; 16] = [ 0x4b, 0x8e, 0x29, 0x87, 0x80, 0x95, 0x96, 0xa3, 0xbb, 0x23, 0x82, 0x49, 0x9f, 0x1c, 0xe7, 0xc2, ];
// Assuming bytes gathered from a reliable, platform-specific entropy source let iv: [u8; 8] = [0x3c, 0x1d, 0xbb, 0x05, 0xe3, 0xca, 0x60, 0xd9];
let mut myrandbuf = [0; 3]; let mut myrandu16: u16 = 0; let mut myrandu64: u64 = 0;
let mut e128 = Enocoro128::new(&key, &iv);
e128.randbuf(&mut myrandbuf); assert!(myrand_buf.iter().all(|&x| x != 0));
myrandu16 = e128.randu16(); assertne!(myrandu16, 0);
myrandu64 = e128.randu64(); assertne!(myrandu64, 0); ```