cryptocol 0.19.10

A cryptographic library that includes big number arithmetic operations, hash algorithms, symmetric-key encryption/decryption algorithms, asymmetric-key (public-key) encryption/decryption algorithms, pseudo random number generators, etc. Hash algorithms includes MD4, MD5, SHA224, SHA256, SHA384, SHA512, SHA3, etc. Symmetric key encryption algorithms include DES, AES, etc. Public key encryption algorithms include RSA, ECC, etc.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92

// Copyright 2024, 2025, 2026 PARK Youngho.
//
// Licensed under the Apache License, Version 2.0 <LICENSE-APACHE or
// https://www.apache.org/licenses/LICENSE-2.0> or the MIT license
// <LICENSE-MIT or https://opensource.org/licenses/MIT>, at your option.
// This file may not be copied, modified, or distributed
// except according to those terms.


use crate::hash::{ BIG_KECCAK_1024, SHA3_512, SHA3_256, SHAKE_256, SHAKE_128,
                   SHA2_512, SHA2_256, SHA1, SHA0, MD5, MD4 };
use crate::symmetric::{ AES_128, DES };
use crate::random::{ Random_Generic, CPRNG_Engine, PRNG_Engine };
use crate::random::{ PRNG_Creator_methods, DOC_STRING, LESS_SECURE_COUNT };


pub trait PRNG
{
    fn box_new() -> Box::<Self> where Self: Sized;
    fn box_new_with(main_generator: Box<dyn PRNG_Engine>, aux_generator: Box<dyn PRNG_Engine>) -> Box::<Self> where Self: Sized;
    fn random_u8(&mut self) -> u8;
}

impl PRNG for Random_Generic<LESS_SECURE_COUNT>
{
    #[inline] fn box_new() -> Box::<Self>
    where Self: Sized
    {
        Box::new(Self::new_with(BIG_KECCAK_1024::box_new(), BIG_KECCAK_1024::box_new()))
    }

    #[inline]
    fn box_new_with(main_generator: Box<dyn PRNG_Engine>, aux_generator: Box<dyn PRNG_Engine>) -> Box::<Self>
    where Self: Sized
    {
        Box::new(Self::new_with(main_generator, aux_generator))
    }

    #[inline]
    fn random_u8(&mut self) -> u8
    {
        self.random_u8()
    }
}


macro_rules! PRNG_Creator {
    ($creator:ident, $engine:ident, $count:expr) => {
        #[doc = DOC_STRING!($engine, ASYMMETRIC)]
        #[doc = DOC_EXAMPLE!($engine)]
        #[allow(non_camel_case_types)]
        pub struct $creator {}
        impl $creator
        {
            PRNG_Creator_methods!{$engine, $count}
        }
    };
}
// pub(crate) use PRNG_Creator;

macro_rules! DOC_EXAMPLE {
    ($engine:ident) => {
        concat!(
r###"## Example
```
use cryptocol::asymmetric::{ RSA_1024, PKCS1V15, Asymmetric_PRNG_Creator_"###,
stringify!($engine), r#" };
use cryptocol::define_utypes_with;
define_utypes_with!(u64);

let mut rand = Asymmetric_PRNG_Creator_"#, stringify!($engine), r#"::create();
let rsa = RSA_1024::new_with(rand.clone(), rand);
```
"#)
    };
}


PRNG_Creator!{ Asymmetric_PRNG_Creator_BIG_KECCAK_1024, BIG_KECCAK_1024, LESS_SECURE_COUNT }
PRNG_Creator!{ Asymmetric_PRNG_Creator_SHA3_512, SHA3_512, LESS_SECURE_COUNT }
PRNG_Creator!{ Asymmetric_PRNG_Creator_SHA3_256, SHA3_256, LESS_SECURE_COUNT }
PRNG_Creator!{ Asymmetric_PRNG_Creator_SHAKE_256, SHAKE_256, LESS_SECURE_COUNT }
PRNG_Creator!{ Asymmetric_PRNG_Creator_SHAKE_128, SHAKE_128, LESS_SECURE_COUNT }
PRNG_Creator!{ Asymmetric_PRNG_Creator_SHA2_512, SHA2_512, LESS_SECURE_COUNT }
PRNG_Creator!{ Asymmetric_PRNG_Creator_SHA2_256, SHA2_256, LESS_SECURE_COUNT }
PRNG_Creator!{ Asymmetric_PRNG_Creator_SHA1, SHA1, LESS_SECURE_COUNT }
PRNG_Creator!{ Asymmetric_PRNG_Creator_SHA0, SHA0, LESS_SECURE_COUNT }
PRNG_Creator!{ Asymmetric_PRNG_Creator_MD5, MD5, LESS_SECURE_COUNT }
PRNG_Creator!{ Asymmetric_PRNG_Creator_MD4, MD4, LESS_SECURE_COUNT }
PRNG_Creator!{ Asymmetric_PRNG_Creator_AES_128, AES_128, LESS_SECURE_COUNT }
PRNG_Creator!{ Asymmetric_PRNG_Creator_DES, DES, LESS_SECURE_COUNT }
PRNG_Creator!{ Asymmetric_PRNG_Creator_CPRNG_Engine, CPRNG_Engine, LESS_SECURE_COUNT }