From 1f0b00c679a9f595914100d44dac33cc7ef68f11 Mon Sep 17 00:00:00 2001
From: Davide Grilli <davide.grilli@outlook.com>
Date: Mon, 30 Mar 2026 01:07:25 +0200
Subject: [PATCH] docs: update README for C build and launcher usage

---
 README.md | 32 +++++++++++++++++++++++++++++++-
 1 file changed, 31 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 52fbdb9..1fcc173 100644
--- a/README.md
+++ b/README.md
@@ -1,4 +1,34 @@
-# SHA-256 Miner (From Scratch, Python Starter)
+# SHA-256 Miner (From Scratch, Python + C)
+
+## C Rewrite (Modular)
+
+This repository now includes a modular C implementation that mirrors the Python module split:
+
+- `config.c/.h` + `miner.conf`
+- `rpc.c/.h`
+- `block_builder.c/.h`
+- `miner.c/.h`
+- `mining_loop.c/.h`
+- `launcher.c`
+- `main.c`
+
+Build:
+
+```bash
+make
+```
+
+Run single worker:
+
+```bash
+./miner --config miner.conf
+```
+
+Run multiprocess launcher:
+
+```bash
+./launcher --config miner.conf -n 4
+```
 
 A clean, production-minded **starting point** for building SHA-256 miners from scratch.