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

//! This crate contains generic implementation of [block cipher modes of
//! operation][1] defined in [GOST R 34.13-2015].
//!
//! CTR, CFB and OFB modes are implemented in terms of traits from the [`cipher`] crate.
//!
//! MAC function defined in the GOST is implemented in the [`cmac`] crate.
//!
//! # Examples
//! ```
//! use gost_modes::{GostCbc, GostPadding, BlockMode, consts::U2};
//! use kuznyechik::Kuznyechik;
//! use hex_literal::hex;
//!
//! let key = hex!("
//!     8899aabbccddeeff0011223344556677
//!     fedcba98765432100123456789abcdef
//! ");
//! let iv = hex!("
//!     1234567890abcef0a1b2c3d4e5f00112
//!     23344556677889901213141516171819
//! ");
//! let pt = b"my secret message";
//!
//! type Cipher = GostCbc<Kuznyechik, GostPadding, U2>;
//!
//! let cipher = Cipher::new_from_slices(&key, &iv).unwrap();
//! let ct = cipher.encrypt_vec(pt);
//!
//! let cipher = Cipher::new_from_slices(&key, &iv).unwrap();
//! let buf = cipher.decrypt_vec(&ct).unwrap();
//!
//! assert_eq!(buf, &pt[..]);
//!
//! // OFB mode example
//! use gost_modes::{GostOfb, StreamCipher, NewCipher};
//!
//! let mut cipher = GostOfb::<Kuznyechik, U2>::new_from_slices(&key, &iv).unwrap();
//! let mut buf = pt.to_vec();
//! cipher.apply_keystream(&mut buf);
//! assert_eq!(buf, hex!("fddb196e81812e4174d1c9f741a3457a88"));
//! ```
//!
//! [1]: https://en.wikipedia.org/wiki/Block_cipher_mode_of_operation
//! [GOST R 34.13-2015]: https://tc26.ru/standard/gost/GOST_R_3413-2015.pdf
//! [`cipher`]: https://docs.rs/cipher/
//! [`cmac`]: https://docs.rs/cmac/
#![no_std]
#![doc(
    html_logo_url = "https://raw.githubusercontent.com/RustCrypto/meta/master/logo.svg",
    html_favicon_url = "https://raw.githubusercontent.com/RustCrypto/meta/master/logo.svg"
)]
#![deny(unsafe_code)]
#![warn(missing_docs, rust_2018_idioms)]

pub use block_modes;
pub use block_modes::block_padding;
pub use cipher::{self, consts};
pub use generic_array;

pub use block_modes::{BlockMode, Ecb};
pub use cipher::{AsyncStreamCipher, NewCipher, StreamCipher, StreamCipherSeek};

mod cbc;
mod cfb;
mod ctr128;
mod ctr64;
mod ofb;
mod utils;

/// Block padding procedure number 2 as defined in GOST R 34.13-2015
///
/// Fully equivalent to ISO 7816.
pub type GostPadding = block_padding::Iso7816;

pub use cbc::GostCbc;
pub use cfb::GostCfb;
pub use ctr128::GostCtr128;
pub use ctr64::GostCtr64;
pub use ofb::GostOfb;