milo

KO | EN

gitlite — search

#python #ai #llm #golang #linux #docker #macos #windows #kubernetes #awesome-list #vue #security #ios #mcp

(★ 78)

Cryptography library for modern C++.

File Explorer

Download Latest Version (.zip)

- CMakeLists.txt
- main.cpp
- - milo-test-constexpr-msvc.png
- algorithms.md
- benchmarking.md
- integration.md
- reference.md
- reference_aead.md
- reference_cipher.md
- reference_codec.md
- reference_hash.md
- reference_kdf.md
- reference_mac.md
- roadmap.md
- - container.h
  - def.h
  - error.h
  - internal.h
  - literal.h
  - meta.h
  - option.h
- - CMakeLists.txt
  - memory_load.cpp
  - memory_stor.cpp
- - aead_chacha_20_poly_1305_decrypt.cpp
  - aead_chacha_20_poly_1305_encrypt.cpp
  - cipher_chacha_20_decrypt.cpp
  - cipher_chacha_20_encrypt.cpp
  - CMakeLists.txt
  - codec_base_16_decode.cpp
  - codec_base_16_encode.cpp
  - codec_base_64_decode.cpp
  - codec_base_64_encode.cpp
  - hash_sha_1_160.cpp
  - hash_sha_2_224.cpp
  - hash_sha_2_256.cpp
  - hash_sha_2_384.cpp
  - hash_sha_2_512.cpp
  - hash_sha_2_512_224.cpp
  - hash_sha_2_512_256.cpp
  - kdf_hkdf_hmac_sha_1_160.cpp
  - kdf_hkdf_hmac_sha_2_224.cpp
  - kdf_hkdf_hmac_sha_2_256.cpp
  - kdf_hkdf_hmac_sha_2_384.cpp
  - kdf_hkdf_hmac_sha_2_512.cpp
  - kdf_hkdf_hmac_sha_2_512_224.cpp
  - kdf_hkdf_hmac_sha_2_512_256.cpp
  - kdf_pbkdf_2_hmac_sha_1_160.cpp
  - kdf_pbkdf_2_hmac_sha_2_224.cpp
  - kdf_pbkdf_2_hmac_sha_2_256.cpp
  - kdf_pbkdf_2_hmac_sha_2_384.cpp
  - kdf_pbkdf_2_hmac_sha_2_512.cpp
  - kdf_pbkdf_2_hmac_sha_2_512_224.cpp
  - kdf_pbkdf_2_hmac_sha_2_512_256.cpp
  - mac_hmac_sha_1_160.cpp
  - mac_hmac_sha_2_224.cpp
  - mac_hmac_sha_2_256.cpp
  - mac_hmac_sha_2_384.cpp
  - mac_hmac_sha_2_512.cpp
  - mac_hmac_sha_2_512_224.cpp
  - mac_hmac_sha_2_512_256.cpp
  - mac_poly_1305.cpp
- CMakeLists.txt
- - main.py
  - setup.py
.gitignore
CMakeLists.txt
LICENSE.txt
Pipfile
Pipfile.lock
README.md

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

## Description

Cryptography library for modern C++.

Features:

- Constexpr.
- Oneliners.
- Assembly optimized.
- Backend dispatching based on CPU capabilities.
- Throwing and non-throwing overloads.
- Allocation and allocation-free interfaces.
- Support for the majority of container types as inputs and outputs.
- Support for user defined container types.
- Overloads that remove playing with pointers.
- Pointer type casting free api, casting from `char*` to `unsigned char*` is not necessary.
- Returns a value of the type the user needs, specified by template parameter.
- Swapping algorithm by swapping the type.
- Zeroing all sensitive data.

Requirements:

- C++ 20 Compiler
- C++ 20 Standard library

Optional:

- Netwide Assembler

Tested with:

- `x86-64-linux`
    - `clang version 14.0.6`
    - `gcc version 12.2.0`
    - `nasm version 2.16.01`
- `x86-64-windows-11`
    - `msvc version 14.00.24245`
    - `nasm version 2.16.01`

## Motivation

The library aims to provide modern and user-friendly interfaces:

```c++
auto digest = milo::primitive::hash::digest<milo::primitive::hash::sha_2_256<>>("message"sv);
```

```c++
try
{
    using namespace milo::literal;
    
    using aead = milo::primitive::aead::chacha_20_poly_1305<>;
    
    auto key = "000102030405060708090a0b0c0d0e0f101112131415161718191a1b1c1d1e1f"_base_16;
    auto iv  = "000102030405060708090a0b"_base_16;
    
    auto [ciphertext, mac] = milo::primitive::aead::encrypt<aead, std::string>(key, iv, "aad"_cv, "message"_cv);
    auto plaintext         = milo::primitive::aead::decrypt<aead, std::string>(key, iv, "aad"_cv, ciphertext, mac);
}
catch (const milo::error& error)
{
    
}
```

More algorithms and interfaces are available, including stateful streaming interfaces.
Information on how to use them can be found in the [reference](doc/reference.md).

## Roadmap

Roadmap is [here](doc/roadmap.md).

## Integration

Integration guide is [here](doc/integration.md).

## Reference

Reference guide is [here](doc/reference.md).

## Algorithms

Algorithms index is [here](doc/algorithms.md).

## Benchmarking

Benchmarking guide is [here](doc/benchmarking.md).

## Contact

Can reach me via email address available on my [GitHub profile](https://github.com/milosob).
Need to be logged in to see it.

milo

File Explorer

Today's picks

Was this content helpful?

Recent Feedback

milo

File Explorer

Today's picks

Was this content helpful?

Recent Feedback

Download README