cryptocol crate provides libraries for cryptography

Endianness

This crate is optimized for Little-endian CPUs because Little-Endian CPUs are far more popular than Big-endian CPUs. For the information about Endianness (including Little-endian and Big-endian) Read more.

Big-endian issue

This crate is just experimental for Big-endian CPUs. So, you are not encouraged to use this crate for Big-endian CPUs for serious purpose. Only use this crate for Big-endian CPUs with your own full responsibility.

Road Map for Version 1.0

This crate Cryptocol is planned to provide the following functionalities. The checked items have already been implemented including documentation at least 95%. The unchecked items have been implemented including documentation less than 95% or have not yet even been started to implement.

Small Numbers: meaningful as itself, and also the foundations mainly for Big Numbers as well as for other modules

• Unions for primitive data types and their implementation, and the implementation of trait SmallUInt for the Unions --- ShortUnion, IntUnion, LongUnion, LongerUnion, SizeUnion, SharedValues, and SharedArrays
• Trait SmallUInt, its implementation for primitive data types, and the implementation of it for the Unions --- SmallUInt

Big Numbers: meaningful as itself and also the foundation for Asymmetric-Key Algorithms

• Fixed Sized Big Unsigned Integer Operation --- You can find most of the methods you need for big integer calculation at BigUInt.
• Auxiliary Fixed Sized Big Unsigned Integer Operation --- If you don't find what you need at BigUInt, you may find it at BigUInt_More, BigUInt_Modular, BigUInt_Prime, and BigUInt_Panic_Free.

Hash Algorithms

• SHA-3 and Keccak hash algorithms based on 8/16/32/64 bits --- Includes SHA3-224, SHA3-256, SHA3-384, SHA3-512, SHAKE 128, SHAKE 256, and their expanded versions. Keccak_Generic
• SHA-2 hash algorithms based on 512/t bits --- Includes 512/256, SHA-512/224, and their expanded versions. SHA2_512_t_Generic
• SHA-2 hash algorithms based on 512 bits --- Includes SHA-512, SHA-384, SHA-512/256, and their expanded versions. SHA2_512_Generic
• SHA-2 hash algorithms based on 256 bits --- Includes SHA-256, SHA-224, and their expanded versions. SHA2_256_Generic
• SHA-1 hash algorithms based on 160 bits --- Includes SHA-1, SHA-0, and their expanded versions. SHA1_Generic

• MD5 hash algorithms based on 128 bits --- Includes MD5 and its expanded versions. MD5_Generic
• MD4 hash algorithms based on 128 bits --- Includes MD4 and its expanded versions. MD4_Generic

Symmetric-key Algorithms for Block Encryption/Decryption of digital data

• AES and Rijndael symmetric-key encryption/decryption algorithm and the trait implementations of Operation modes and padding bits for Rijndael_Generic --- Includes AES, Rijndael and its expanded versions, and ECB, CBC, PCBC, CFB, OFB, and CTR modes, and padding bits according to PKCS#7 and ISO 7816-4. Rijndael_Generic, ECB_PKCS7, ECB_ISO, CBC_PKCS7, CBC_ISO, PCBC_PKCS7, PCBC_ISO, CFB, OFB, and CTR.

• DES symmetric-key encryption/decryption algorithm and the traits and its implementations of Operation modes and padding bits for DES_Generic --- Includes DES and its expanded versions, and ECB, CBC, PCBC, CFB, OFB, and CTR modes, and padding bits according to PKCS#7 and ISO 7816-4. DES_Generic, ECB_PKCS7, ECB_ISO, CBC_PKCS7, CBC_ISO, PCBC_PKCS7, PCBC_ISO, CFB, OFB, and CTR.

• BigCryptor128 combinations of symmetric-key encryption/decryption algorithms and the trait implementations of Operation modes and padding bits for BigCryptor128 --- Includes 2AES, 3AES, 4AES, etc., and their expanded versions, and ECB, CBC, PCBC, CFB, OFB, and CTR modes, and padding bits according to PKCS#7 and ISO 7816-4. BigCryptor128, ECB_PKCS7, ECB_ISO, CBC_PKCS7, CBC_ISO, PCBC_PKCS7, PCBC_ISO, CFB, OFB, and CTR. However, it is considered that 2AES, 3AES, 4AES, etc. are not very meaningful because AES-256, Rijndael_128_384, Rijndael_128_512, etc. are considered to be better than 2AES, 3AES, 4AES, etc.
• BigCryptor64 combinations of symmetric-key encryption/decryption algorithms and the trait implementations of Operation modes and padding bits for BigCryptor64 --- Includes 2DES, 3DES, 4DES, etc., and their expanded versions, and ECB, CBC, PCBC, CFB, OFB, and CTR modes, and padding bits according to PKCS#7 and ISO 7816-4. BigCryptor64, ECB_PKCS7, ECB_ISO, CBC_PKCS7, CBC_ISO, PCBC_PKCS7, PCBC_ISO, CFB, OFB, and CTR.

Pseudo-Random Number Generator Algorithms

• Pseudo-random number generator --- struct Random_Generic and trait Random_Engine
• Pseudo-random number generator engines using hash algorithms --- Random_BIG_KECCAK_1024, Random_SHA3_512, Random_SHA2_512, Any_SHAKE_256, Any_SHAKE_128, Any_SHA3_512, Any_SHA3_256, Any_SHA2_512, Any_SHA2_256, Any_SHA1, Any_SHA0, Any_MD5, and Any_MD4.
• Pseudo-random number generator engines using symmetric-key block encryption algorithms --- Random_Rijndael, Any_Rijndael, and Any_DES.
• Pseudo-random number generator engines using simple randomization algorithm --- Any_Num_C.

Asymmetric-key Algorithms for Encryption/Decryption of digital data

• ECC (Elliptic Curve Cryptosystem)
• RSA (Ron Rivest, Adi Shamir, Leonard Adleman)

When the implementation of all the above functionalitis are completed, the version number 1.0.0.0 will be given. After that whenever another functionality is added to this crate, the version number will get higher beyond 1.0.0.0. Before the version number 1.0.0.0, the maximum version number will be 0.21.x.x since there are all twenty-five functionalities listed above. So, for example, even if the version number is 0.5.0.0, it does not mean that 50% of all functionalities are implemented.

Breaking Changes

Refer to the file BreakingChanges.md in this crate.