From e9db15214919a425d7323c9de80ef7feee77db4a Mon Sep 17 00:00:00 2001
From: NicolasPurr <123591418+NicolasPurr@users.noreply.github.com>
Date: Sun, 30 Nov 2025 10:22:46 +0100
Subject: [PATCH] README.md

---
 submissions/challenge1/mikolaj_kot/README.md | 33 ++++++++++++++++++++
 1 file changed, 33 insertions(+)
 create mode 100644 submissions/challenge1/mikolaj_kot/README.md

diff --git a/submissions/challenge1/mikolaj_kot/README.md b/submissions/challenge1/mikolaj_kot/README.md
new file mode 100644
index 0000000..f419ead
--- /dev/null
+++ b/submissions/challenge1/mikolaj_kot/README.md
@@ -0,0 +1,33 @@
+# Cryptopals Solutions (Rust)
+
+A "roll-your-own-crypto" library and CLI tool implementing solutions to the [Cryptopals Crypto Challenges](https://cryptopals.com/). This project demonstrates low-level cryptographic concepts including XOR ciphers, frequency analysis, and SHA-1 implementation from scratch.
+
+## Getting Started
+
+Ensure you have Rust and Cargo installed.
+
+```bash
+# Build the project
+cargo build --release
+
+# View help menu
+cargo run -- --help
+```
+
+## Assignment Demos
+To run specific challenge solutions, use the `demo` subcommand. The ID format is SXCY (Set X, Challenge Y).
+
+### Recommended Demos for Evaluation
+
+| Difficulty | ID | Description | Command |
+| :--- | :--- | :--- | :--- |
+| **Easy** | `S1C1` | Hex to Base64 Conversion | `cargo run -- demo s1c1` |
+| **Medium** | `S1C4` | Detect Single-Byte XOR | `cargo run -- demo s1c4` |
+| **Hard** | `S4C29`| SHA-1 Length Extension Attack | `cargo run -- demo s4c29` |
+
+### Listing all demos
+
+To see all implemented challenges:
+```bash
+cargo run -- demo --list  # (Or just use --help on the demo subcommand)
+```