chacha20-blake3 - GitLite

KO | EN

gitlite — search

#python #llm #golang #go #machine-learning #deep-learning #nodejs #java #windows #awesome #vue #pytorch #ios #openai

chacha20-blake3

(★ 103)

The official implementation of the ChaCha20-BLAKE3 AEAD cipher with SIMD acceleration - https://kerkour.com/chacha20-blake3

파일 탐색기

최종 버전 다운로드 (.zip)

- config.toml
- bashrc
- devcontainer.json
- Dockerfile
- vimrc
- - release.yml
- - benchmarks.yml
  - test.yml
- - chacha.rs
  - encrypt.rs
  - kdf.rs
- Cargo.toml
- - chacha_avx2.rs
  - chacha_avx512.rs
  - chacha_neon.rs
  - chacha_wasm_simd128.rs
  - lib.rs
- Cargo.toml
- README.md
- - mod.rs
- Cargo.toml
- chacha20_blake3.rs
- README.md
.gitignore
.rustfmt.toml
Cargo.lock
Cargo.toml
LICENSE.txt
Makefile
README.md

# 설치 가이드

1. 코드 내려받기

git clone https://github.com/skerkour/chacha20-blake3

깃허브에서 프로젝트 코드 전체를 내 컴퓨터로 내려받습니다.

cd chacha20-blake3

방금 내려받은 프로젝트 폴더 안으로 이동합니다.

2. Rust

보통 추천

사전 준비물

Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
Rust (rustup) rustup으로 설치하면 cargo도 함께 설치됩니다.

cargo build --release

Rust 프로젝트를 컴파일합니다.

cargo run

빌드 후 바로 실행까지 진행합니다.

✅ cargo build가 에러 없이 끝나면 성공입니다. target/ 폴더에 실행 파일이 생성됩니다.

3. Make

보통

사전 준비물

Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
Make Linux/macOS는 보통 기본 설치되어 있습니다. Windows는 별도 설치(예: MSYS2, WSL)가 필요합니다.

make

생성된 빌드 설정을 바탕으로 실제 컴파일을 진행해 실행 파일을 만듭니다.

✅ 에러 없이 끝나면 성공입니다. 생성된 실행 파일을 직접 실행해보세요.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# ChaCha20-BLAKE3

Simple, Secure and Fast encryption for any CPU.

ChaCha20-BLAKE3 is a secure Authenticated Encryption with Associated Data (AEAD) algorithm that is:
- more secure than classic AEADs by providing full context commitment
- uses long nonces that can be safely generated randomly
- doesn't require any specific harware instruction but instead scales with the width of the SIMD instructions of your CPU (AVX2 / AVX-512 on amd64 and NEON / SVE on arm)

Which make it a great fit for everything from microcontrollers to huge servers.

It has been designed to be the only encryption algorithm you will ever need.

## Specification

[https://kerkour.com/chacha20-blake3](https://kerkour.com/chacha20-blake3)

## Performance

Indicative single-core performance of pure-Rust, non-optimized implementations from the [official implementation](https://github.com/skerkour/chacha20-blake3) and the [Rust Crypto](https://github.com/RustCrypto) project.

| Message Size | ChaCha20-BLAKE3 | XChaCha20-Poly1305 | AES-256-GCM |
| ----- | ------------------- | ------------- | ------------- |
| 64 B  | 103 MB/s          | 116 MB/s   | **540 MB/s** |
| 1 KB  | 523 MB/s         | 767 MB/s   | **1,287 MB/s** |
| 64 KB | **2,153 MB/s**   | 1,636 MB/s | 1,475 MB/s |
| 1 MB  | **3,297 MB/s**   | 1,654 MB/s | 1,476 MB/s |
| 10 MB | **3,353 MB/s**   | 1,664 MB/s | 1,477 MB/s |

Machine: *AMD EPYC 9R45 (virtualized, AWS ma8.xlarge)*

## Usage

**Warning ⚠️: A (key, nonce) pair SHOULD NEVER be used to encrypt two messages. You can use either the same key with unique random nonces, an unique key with random or fixed nonces, or the same key with a non-repeating counter in the first X bytes of the nonce. See the specification to learn how much data you can safely encrypt.**

`Cargo.toml`
```toml
[dependencies]
chacha20-blake3 = { git = "https://github.com/skerkour/chacha20-blake3", branch = "main" }
```

```rust
use chacha20_blake3::ChaCha20Blake3;

fn main() {
    // DO NOT USE A ALL-ZERO KEY / NONCE, THIS CODE IS FOR DEMONSTRATION ONLY
    let key = [0u8; 32];
    let nonce = [0u8; 24];
    // or with an u64 counter to encrypt up to 2^64 messages with a single key:
    // let mut nonce = [0u8; 24];
    // nonce[..8].copy_from_slice(&counter.to_le_bytes());

let message = b"Hello World!";

let cipher = ChaCha20Blake3::new(key);

let ciphertext: Vec<u8> = cipher.encrypt(&nonce, message, &[]);

let plaintext: Vec<u8> = cipher.decrypt(&nonce, &ciphertext, &[]).unwrap();

assert_eq!(plaintext, message);
}
```

## Features

| Feature | Default? | Description |
| --------| ---------| ----------- |
| `std` | ✓ |  Enables use of the standard library such as runtime SIMD detection. Enabling `std` automatically enables `alloc`.  |
| `alloc` | ✓ | Enables the `encrypt` / `decrypt` APIs that allocate memory. |
| `zeroize` | ✓ | Enables [`zeroize`](https://crates.io/crates/zeroize) to erase sensitive secrets from memory. |

## ChaCha12-BLAKE3

The old version, ChaCha12-BLAKE3 is available on the `chacha12-blake3` branch but won't receive any further update.

## License

MIT. See `LICENSE.txt`