📚 Documentation

Mercy is a public Rust crate created to assist with building cybersecurity frameworks (offensive and defensive) and assessment tools. The goal is to create a sustainable crate to make creating security tools in Rust a little easier.

Usage

Since Mercy is a standard crate, it can easily be utilized in any project already initialized with Cargo.

Add the following line to your Cargo.toml file: toml mercy = "1.2.16"

Once the Cargo.toml file is updated, you can import the crate and use the provided methods by running cargo run. There are lots of different examples available below.

Cryptographic Processes

Here's a quick example of decoding and encoding using the base64 protocol: ```rust use mercy::{ mercydecode, mercyencode };

fn main() { // Encode string "azazelm3dj3d" mercy_encode("base64", "azazelm3dj3d");

// Decode string "YXphemVsbTNkajNk"
mercy_decode("base64", "YXphemVsbTNkajNk");

} ```

Hexadecimal Dumping

Here's how to dump hexadecimal values in a single line using Mercy: ```rust use mercy::mercy_hex;

fn main() { mercyhex("hexdump", "/Location/of/file"); } ```

Malware/Malicious Detection

You can check if a domain (i.e. google.com) is currently classified as malicious using the InQuest API: ```rust use mercy::mercy_malicious;

fn main() { mercy_malicious("status", "azazelm3dj3d.com"); } ```

Miscellaneous Methods

Some extra methods have been included to assist with data collection. You can currently collect the internal IP address of the host system, defang a URL or IP address, run a WHOIS domain lookup, or dump host system information, specified by the user. ```rust use mercy::mercy_extra;

fn main() { // Contains the internal ip address of the user's system mercyextra("internalip", ""); // Second parameter MUST be an empty string to work

// This method is extensive, but the "all" parameter allows the user to dump everything we have set in Mercy
mercy_extra("system_info", "all");

// Method now available which allows you to defang a url or ip address
mercy_extra("defang", "azazelm3dj3d.com");

// Run a WHOIS lookup for a domain
mercy_extra("whois", "azazelm3dj3d.com");

} `` You can also use the following parameters, replacing the "all" keyword undersystem_info`:

More Info

If ever in doubt, feel free to run this special function to display more information about the crate. ```rust use mercy::source;

fn main() { mercy_source(); } ```