Rust Cryptographic Primitives

This repository contains a collection of cryptographic primitives implemented in Rust. The goal is to provide a comprehensive set of cryptographic primitives that are easy to use and hard to misuse.

This library was done as a personal project to learn Rust and cryptography, implementing some of the algorithms I learned in the "Secure and Dependable Systems" course at my university. The code is open source and I am happy to receive contributions and feedback. Feel free to open an issue or a pull request on this repository.

Features

The library currently provides the following cryptographic primitives, with an encryption and decryption function for each:

• Rail Fence Cipher
• Route Cipher
• Feistel Network
• Substitution-Permutation Network (SPN)

The following cryptographic primitives are planned to be implemented in the future:

• Advanced Encryption Standard (AES)
• Electronic Codebook (ECB) mode
• Cipher Block Chaining (CBC) mode
• Counter (CTR) mode
• Output Feedback (OFB) mode
• Rivest-Shamir-Adleman (RSA) algorithm

For any suggestions or requests, feel free to open an issue on this repository.

Usage

Add this to your Cargo.toml:

[dependencies]
cryptographic_primitives = "0.1.0"

You can also use cargo to add the dependency to your Cargo.toml:

cargo add cryptographic_primitives

Then, simply import the library and use the cryptographic primitives:

use cryptographic_primitives::*;

Example

Here is an example of using the sub_per_box_encrypt and sub_per_box_decrypt functions to encrypt and decrypt a message using the substitution-permutation network (SPN) algorithm.

use cryptographic_primitives::{sub_per_box_encrypt, sub_per_box_decrypt};

let plaintext = b"Hello, world!";
// key = 15, rounds = 3
let ciphertext = sub_per_box_encrypt(plaintext, 15, 3).unwrap();
let decrypted = sub_per_box_decrypt(&ciphertext, 15, 3).unwrap();

assert_eq!(plaintext, decrypted);

License

This project is licensed under the MIT license.