rust-mem-proofs 0.1.0

Various memory-related implementations and benchmarks
Documentation
use crate::Piece;
use rayon::prelude::*;
use std::io::Write;

const BLOCK_SIZE_BITS: u32 = 24;
const BLOCK_SIZE: usize = 3;
const AES_SBOX: [u8; 256] = [
    0x63, 0x7C, 0x77, 0x7B, 0xF2, 0x6B, 0x6F, 0xC5, 0x30, 0x01, 0x67, 0x2B, 0xFE, 0xD7, 0xAB, 0x76,
    0xCA, 0x82, 0xC9, 0x7D, 0xFA, 0x59, 0x47, 0xF0, 0xAD, 0xD4, 0xA2, 0xAF, 0x9C, 0xA4, 0x72, 0xC0,
    0xB7, 0xFD, 0x93, 0x26, 0x36, 0x3F, 0xF7, 0xCC, 0x34, 0xA5, 0xE5, 0xF1, 0x71, 0xD8, 0x31, 0x15,
    0x04, 0xC7, 0x23, 0xC3, 0x18, 0x96, 0x05, 0x9A, 0x07, 0x12, 0x80, 0xE2, 0xEB, 0x27, 0xB2, 0x75,
    0x09, 0x83, 0x2C, 0x1A, 0x1B, 0x6E, 0x5A, 0xA0, 0x52, 0x3B, 0xD6, 0xB3, 0x29, 0xE3, 0x2F, 0x84,
    0x53, 0xD1, 0x00, 0xED, 0x20, 0xFC, 0xB1, 0x5B, 0x6A, 0xCB, 0xBE, 0x39, 0x4A, 0x4C, 0x58, 0xCF,
    0xD0, 0xEF, 0xAA, 0xFB, 0x43, 0x4D, 0x33, 0x85, 0x45, 0xF9, 0x02, 0x7F, 0x50, 0x3C, 0x9F, 0xA8,
    0x51, 0xA3, 0x40, 0x8F, 0x92, 0x9D, 0x38, 0xF5, 0xBC, 0xB6, 0xDA, 0x21, 0x10, 0xFF, 0xF3, 0xD2,
    0xCD, 0x0C, 0x13, 0xEC, 0x5F, 0x97, 0x44, 0x17, 0xC4, 0xA7, 0x7E, 0x3D, 0x64, 0x5D, 0x19, 0x73,
    0x60, 0x81, 0x4F, 0xDC, 0x22, 0x2A, 0x90, 0x88, 0x46, 0xEE, 0xB8, 0x14, 0xDE, 0x5E, 0x0B, 0xDB,
    0xE0, 0x32, 0x3A, 0x0A, 0x49, 0x06, 0x24, 0x5C, 0xC2, 0xD3, 0xAC, 0x62, 0x91, 0x95, 0xE4, 0x79,
    0xE7, 0xC8, 0x37, 0x6D, 0x8D, 0xD5, 0x4E, 0xA9, 0x6C, 0x56, 0xF4, 0xEA, 0x65, 0x7A, 0xAE, 0x08,
    0xBA, 0x78, 0x25, 0x2E, 0x1C, 0xA6, 0xB4, 0xC6, 0xE8, 0xDD, 0x74, 0x1F, 0x4B, 0xBD, 0x8B, 0x8A,
    0x70, 0x3E, 0xB5, 0x66, 0x48, 0x03, 0xF6, 0x0E, 0x61, 0x35, 0x57, 0xB9, 0x86, 0xC1, 0x1D, 0x9E,
    0xE1, 0xF8, 0x98, 0x11, 0x69, 0xD9, 0x8E, 0x94, 0x9B, 0x1E, 0x87, 0xE9, 0xCE, 0x55, 0x28, 0xDF,
    0x8C, 0xA1, 0x89, 0x0D, 0xBF, 0xE6, 0x42, 0x68, 0x41, 0x99, 0x2D, 0x0F, 0xB0, 0x54, 0xBB, 0x16,
];

type Block = [u8; 3];

pub struct SBoxDirect(Vec<Block>);

impl SBoxDirect {
    /// Create direct SBox used for encoding
    pub fn new() -> Self {
        let mut result = vec![[0_u8; 3]; 2_usize.pow(BLOCK_SIZE_BITS)];

        for x in 0..2_u32.pow(BLOCK_SIZE_BITS) {
            let [.., x1, x2, x3] = x.to_be_bytes();
            let y = u32::from_be_bytes([
                0,
                AES_SBOX[x1 as usize],
                AES_SBOX[x2 as usize],
                AES_SBOX[x3 as usize],
            ]);
            result[y as usize] = [x1, x2, x3];
        }

        Self(result)
    }

    fn get(&self, y: Block) -> Block {
        let index = u32::from_be_bytes([0, y[0], y[1], y[2]]);
        self.0[index as usize]
    }
}

pub struct SBoxInverse();

impl SBoxInverse {
    /// Create inverse SBox used for decoding
    pub fn new() -> Self {
        Self()
    }

    fn get(&self, x: Block) -> Block {
        [
            AES_SBOX[x[0] as usize],
            AES_SBOX[x[1] as usize],
            AES_SBOX[x[2] as usize],
        ]
    }
}

pub fn encode_simple(piece: &mut Piece, iv: Block, breadth_iterations: usize, sbox: &SBoxDirect) {
    for _ in 0..breadth_iterations {
        let mut feedback = iv;
        piece.chunks_exact_mut(BLOCK_SIZE).for_each(|mut block| {
            feedback = sbox.get([
                block[0] ^ feedback[0],
                block[1] ^ feedback[1],
                block[2] ^ feedback[2],
            ]);

            block.write_all(&feedback[..]).unwrap();
        });
    }
}

pub fn encode_pipelined_x4(
    mut pieces: [&mut Piece; 4],
    ivs: [Block; 4],
    breadth_iterations: usize,
    sbox: &SBoxDirect,
) {
    for _ in 0..breadth_iterations {
        for (piece, iv) in pieces.iter_mut().zip(ivs.iter()) {
            let mut feedback = *iv;
            piece.chunks_exact_mut(BLOCK_SIZE).for_each(|mut block| {
                feedback = sbox.get([
                    block[0] ^ feedback[0],
                    block[1] ^ feedback[1],
                    block[2] ^ feedback[2],
                ]);

                block.write_all(&feedback[..]).unwrap();
            });
        }
    }
}

pub fn encode_pipelined_x8(
    mut pieces: [&mut Piece; 8],
    ivs: [Block; 8],
    breadth_iterations: usize,
    sbox: &SBoxDirect,
) {
    for _ in 0..breadth_iterations {
        for (piece, iv) in pieces.iter_mut().zip(ivs.iter()) {
            let mut feedback = *iv;
            piece.chunks_exact_mut(BLOCK_SIZE).for_each(|mut block| {
                feedback = sbox.get([
                    block[0] ^ feedback[0],
                    block[1] ^ feedback[1],
                    block[2] ^ feedback[2],
                ]);

                block.write_all(&feedback[..]).unwrap();
            });
        }
    }
}

pub fn encode_pipelined_x16(
    mut pieces: [&mut Piece; 16],
    ivs: [Block; 16],
    breadth_iterations: usize,
    sbox: &SBoxDirect,
) {
    for _ in 0..breadth_iterations {
        for (piece, iv) in pieces.iter_mut().zip(ivs.iter()) {
            let mut feedback = *iv;
            piece.chunks_exact_mut(BLOCK_SIZE).for_each(|mut block| {
                feedback = sbox.get([
                    block[0] ^ feedback[0],
                    block[1] ^ feedback[1],
                    block[2] ^ feedback[2],
                ]);

                block.write_all(&feedback[..]).unwrap();
            });
        }
    }
}

pub fn encode_pipelined_x32(
    mut pieces: [&mut Piece; 32],
    ivs: [Block; 32],
    breadth_iterations: usize,
    sbox: &SBoxDirect,
) {
    for _ in 0..breadth_iterations {
        for (piece, iv) in pieces.iter_mut().zip(ivs.iter()) {
            let mut feedback = *iv;
            piece.chunks_exact_mut(BLOCK_SIZE).for_each(|mut block| {
                feedback = sbox.get([
                    block[0] ^ feedback[0],
                    block[1] ^ feedback[1],
                    block[2] ^ feedback[2],
                ]);

                block.write_all(&feedback[..]).unwrap();
            });
        }
    }
}

pub fn encode_pipelined_x64(
    mut pieces: [&mut Piece; 64],
    ivs: [Block; 64],
    breadth_iterations: usize,
    sbox: &SBoxDirect,
) {
    for _ in 0..breadth_iterations {
        for (piece, iv) in pieces.iter_mut().zip(ivs.iter()) {
            let mut feedback = *iv;
            piece.chunks_exact_mut(BLOCK_SIZE).for_each(|mut block| {
                feedback = sbox.get([
                    block[0] ^ feedback[0],
                    block[1] ^ feedback[1],
                    block[2] ^ feedback[2],
                ]);

                block.write_all(&feedback[..]).unwrap();
            });
        }
    }
}

pub fn encode_simple_parallel(
    pieces: &mut [Piece],
    iv: Block,
    breadth_iterations: usize,
    sbox: &SBoxDirect,
    thread_pipelining: usize,
) {
    pieces
        .par_chunks_mut(thread_pipelining)
        .for_each(|pieces: &mut [Piece]| {
            for piece in pieces {
                encode_simple(piece, iv, breadth_iterations, &sbox);
            }
        });
}

pub fn encode_pipelined_x64_parallel(
    pieces: &mut [Piece],
    // TODO: Should IV be different?
    iv: Block,
    breadth_iterations: usize,
    sbox: &SBoxDirect,
) {
    assert!(pieces.len() % 64 == 0);
    pieces.par_chunks_mut(64).for_each(|pieces: &mut [Piece]| {
        for _ in 0..breadth_iterations {
            for piece in pieces.iter_mut() {
                let mut feedback = iv;
                piece.chunks_exact_mut(BLOCK_SIZE).for_each(|mut block| {
                    feedback = sbox.get([
                        block[0] ^ feedback[0],
                        block[1] ^ feedback[1],
                        block[2] ^ feedback[2],
                    ]);

                    block.write_all(&feedback[..]).unwrap();
                });
            }
        }
    });
}

pub fn decode_simple(piece: &mut Piece, iv: Block, breadth_iterations: usize, sbox: &SBoxInverse) {
    for _ in 0..breadth_iterations {
        let mut feedback = iv;
        piece.chunks_exact_mut(BLOCK_SIZE).for_each(|block| {
            let previous_feedback = feedback;
            feedback = [block[0], block[1], block[2]];
            let decoded = sbox.get([block[0], block[1], block[2]]);

            block[0] = decoded[0] ^ previous_feedback[0];
            block[1] = decoded[1] ^ previous_feedback[1];
            block[2] = decoded[2] ^ previous_feedback[2];
        });
    }
}

pub fn decode_simple_parallel(
    pieces: &mut [Piece],
    iv: Block,
    breadth_iterations: usize,
    sbox: &SBoxInverse,
    thread_pipelining: usize,
) {
    pieces
        .par_chunks_mut(thread_pipelining)
        .for_each(|pieces: &mut [Piece]| {
            for piece in pieces {
                decode_simple(piece, iv, breadth_iterations, &sbox);
            }
        });
}

#[cfg(test)]
mod tests {
    use super::*;
    use crate::PIECE_SIZE;
    use rand::Rng;

    #[test]
    fn test_simple() {
        let iv = [1, 2, 3];
        let sbox = SBoxDirect::new();
        let sbox_inverse = SBoxInverse::new();
        let mut input = [0u8; PIECE_SIZE];
        rand::thread_rng().fill(&mut input[..]);

        for &iterations in &[1, 10] {
            let mut encoding = input;
            encode_simple(&mut encoding, iv, iterations, &sbox);

            assert_ne!(encoding[..], input[..]);

            decode_simple(&mut encoding, iv, iterations, &sbox_inverse);

            assert_eq!(encoding[..], input[..]);
        }

        for &iterations in &[1, 10] {
            let mut encodings_1 = input;
            let mut encodings_2 = input;
            let mut encodings_3 = input;
            let mut encodings_4 = input;
            encode_pipelined_x4(
                [
                    &mut encodings_1,
                    &mut encodings_2,
                    &mut encodings_3,
                    &mut encodings_4,
                ],
                [iv; 4],
                iterations,
                &sbox,
            );

            assert_ne!(encodings_1[..], input[..]);
            assert_ne!(encodings_2[..], input[..]);
            assert_ne!(encodings_3[..], input[..]);
            assert_ne!(encodings_4[..], input[..]);

            decode_simple(&mut encodings_1, iv, iterations, &sbox_inverse);
            decode_simple(&mut encodings_2, iv, iterations, &sbox_inverse);
            decode_simple(&mut encodings_3, iv, iterations, &sbox_inverse);
            decode_simple(&mut encodings_4, iv, iterations, &sbox_inverse);
            assert_eq!(encodings_1[..], input[..]);
            assert_eq!(encodings_2[..], input[..]);
            assert_eq!(encodings_3[..], input[..]);
            assert_eq!(encodings_4[..], input[..]);
        }

        for &iterations in &[1, 10] {
            let inputs = vec![input; 3];
            let mut encodings = inputs.clone();
            encode_simple_parallel(&mut encodings, iv, iterations, &sbox, 1);

            assert_ne!(
                encodings
                    .iter()
                    .map(|array| array.to_vec())
                    .collect::<Vec<_>>(),
                inputs
                    .iter()
                    .map(|array| array.to_vec())
                    .collect::<Vec<_>>()
            );

            decode_simple_parallel(&mut encodings, iv, iterations, &sbox_inverse, 1);

            assert_eq!(
                encodings
                    .iter()
                    .map(|array| array.to_vec())
                    .collect::<Vec<_>>(),
                inputs
                    .iter()
                    .map(|array| array.to_vec())
                    .collect::<Vec<_>>()
            );
        }
    }
}