mirror of
https://github.com/jixunmoe/tc_tea_rust
synced 2026-03-08 04:29:49 +00:00
53 lines
1.4 KiB
Markdown
53 lines
1.4 KiB
Markdown
# tc_tea
|
|
|
|
Rusty implementation of _Tencent modified TEA_ (tc_tea).
|
|
|
|
Test data generated using its C++ implementation: [tc_tea.cpp][tc_tea_cpp] (BSD-3-Clause).
|
|
|
|
Code implemented according to the spec described in
|
|
[iweizime/StepChanger:腾讯 TEA 加密算法][tc_tea_spec].
|
|
|
|
## Features
|
|
|
|
* `secure_random` (default: `on`): Enable secure RNG when generating padding bytes for tc_tea.
|
|
|
|
## Install
|
|
|
|
Add the following to `[dependencies]` section in your `Cargo.toml` file:
|
|
|
|
```toml
|
|
tc_tea = "0.1.2"
|
|
```
|
|
|
|
## Troubleshooting
|
|
|
|
* Key need to have `16` bytes or more.
|
|
* `None` will be returned if less than `16` bytes provided.
|
|
* If more bytes were provided, only the first 16 bytes will be used.
|
|
* Encrypted data should have a size that is multiple of 8.
|
|
* `None` will be returned if `encrypted_data.len() % 8 > 0`.
|
|
|
|
## Usage
|
|
|
|
```rust
|
|
use tc_tea;
|
|
|
|
fn hello_tc_tea() {
|
|
let key = "12345678ABCDEFGH";
|
|
let encrypted = tc_tea::encrypt(&"hello", &key).unwrap();
|
|
let decrypted = tc_tea::decrypt(&encrypted, &key).unwrap();
|
|
assert_eq!("hello", std::str::from_utf8(&decrypted).unwrap());
|
|
}
|
|
```
|
|
|
|
## License
|
|
|
|
Dual licensed under MIT OR Apache-2.0 license.
|
|
|
|
```license
|
|
SPDX-License-Identifier: MIT OR Apache-2.0
|
|
```
|
|
|
|
[tc_tea_cpp]: https://github.com/TarsCloud/TarsCpp/blob/a6d5ed8/util/src/tc_tea.cpp
|
|
[tc_tea_spec]: https://github.com/iweizime/StepChanger/wiki/%E8%85%BE%E8%AE%AFTEA%E5%8A%A0%E5%AF%86%E7%AE%97%E6%B3%95
|