#compile-time #string #encryption #cyber #redteam

str_crypter

A macro library for XOR encryption and decryption of strings at compile time, meaning no cleartext strings will be in your release binary (when using the macro). The encrypted strings will be decoded at runtime.

4 stable releases

2.0.2 Oct 11, 2024
2.0.1 Oct 6, 2024
1.0.3 Oct 16, 2024
1.0.2 May 26, 2024

#459 in Cryptography

Download history 3/week @ 2024-09-12 16/week @ 2024-09-19 10/week @ 2024-09-26 126/week @ 2024-10-03 269/week @ 2024-10-10 118/week @ 2024-10-17 2/week @ 2024-10-24

394 downloads per month

MIT license

7KB

str_crypter

str_crypter is a Rust library for XOR encryption and decryption of strings. It provides a macro to XOR encrypt strings from plaintext at compile time using a single byte key. When building in release mode, any plaintext strings encrypted with the macro sc!() will not be present in the binary. At runtime, the macro expands to decrypt the encrypted string.

Version info

This was originally turned into a 2.0 crate, however after additional testing the crate was not working as intended, so I have yanked those versions and reverted it to an older working copy under v1. The changes made in 2.0 weren't particularly groundbreaking nor did it add extra functionality, so I have no issues yanking it and working on it again when I have some more time.

Usage

use str_crypter::{decrypt_string, sc};

fn main() {
    let encrypted_str: String = match sc!("Hello world!", 20) {
        Ok(s) => s,
        Err(e) => panic!("Decryption failed: {:?}", e),
    };

    println!("Decrypted string: {}", encrypted_str);
}

Installation

Add str_crypter to your Cargo.toml:

[dependencies]
str_crypter = "1.0.3"

Or use the command cargo add str_crypter

No runtime deps