██████╗  █████╗ ████████╗ █████╗ ███████╗ ██████╗ ██████╗  ██████╗ ███████╗██╗  ██╗
██╔══██╗██╔══██╗╚══██╔══╝██╔══██╗██╔════╝██╔═══██╗██╔══██╗██╔════╝ ██╔════╝╚██╗██╔╝
██║  ██║███████║   ██║   ███████║█████╗  ██║   ██║██████╔╝██║  ███╗█████╗   ╚███╔╝ 
██║  ██║██╔══██║   ██║   ██╔══██║██╔══╝  ██║   ██║██╔══██╗██║   ██║██╔══╝   ██╔██╗ 
██████╔╝██║  ██║   ██║   ██║  ██║██║     ╚██████╔╝██║  ██║╚██████╔╝███████╗██╔╝ ██╗
╚═════╝ ╚═╝  ╚═╝   ╚═╝   ╚═╝  ╚═╝╚═╝      ╚═════╝ ╚═╝  ╚═╝ ╚═════╝ ╚══════╝╚═╝  ╚═╝

High-Performance Forensic Data Suite

Military-grade secure file destruction & advanced signature-based data recovery

---

Overview • Features • Installation • Usage • Architecture • API • Team

---

🎯 Overview

DataForgeX is a professional-grade forensic data tool designed for security professionals, digital forensics investigators, and privacy-conscious users. It combines two critical capabilities:

Capability	Description
🔥 Secure File Wiping	Permanently destroy files using military-grade algorithms (DoD 5220.22-M, Gutmann 35-pass)
🔍 Data Recovery	Recover deleted files using advanced signature-based carving techniques

Why DataForgeX?

Traditional file deletion leaves recoverable traces on disk. DataForgeX provides:

• ⚡ High Performance — Assembly-optimized I/O with 64KB buffers and 4MB scan blocks
• 🔒 Military-Grade Security — DoD 5220.22-M and Gutmann 35-pass algorithms
• 🔍 Smart Recovery — 12+ file type signatures with intelligent size detection
• 🌐 Modern Interface — Responsive web GUI with real-time progress tracking
• 📡 RESTful API — Full programmatic access for automation

---

✨ Features

🔥 Secure File Wiping

Four destruction methods with increasing security levels:

Method	Passes	Security	Speed	Description
Single Pass (Zeros)	1	Basic	⚡⚡⚡	Overwrites with zeros
Single Pass (Random)	1	Good	⚡⚡⚡	LFSR pseudo-random data
DoD 5220.22-M	3	High	⚡⚡	US Military standard
Gutmann Algorithm	35	Maximum	⚡	Research-grade security

Key Features:

• Assembly-optimized LFSR random number generation
• Direct file I/O with fsync guarantees
• Automatic file removal after secure wipe
• Real-time progress monitoring

🔍 Data Recovery

Signature-based file carving from raw disks and disk images:

Format	Signature	Extension	Size Detection
JPEG	FF D8 FF	.jpg	EOI marker scan
PNG	89 50 4E 47	.png	IEND chunk detection
PDF	25 50 44 46	.pdf	%%EOF marker
ZIP/DOCX/XLSX	50 4B 03 04	.zip/.docx	Central directory
MP3	49 44 33 / FF FB	.mp3	Default estimation
WAV	52 49 46 46	.wav	RIFF header parsing
7-Zip	37 7A BC AF	.7z	Default estimation
RAR	52 61 72 21	.rar	Default estimation
GIF	47 49 46 38	.gif	Default estimation
BMP	42 4D	.bmp	Header parsing
ELF	7F 45 4C 46	.elf	ELF header parsing

⚠️ Note: Plain text files (TXT) cannot be recovered as they have no magic signature. DOCX/XLSX/PPTX files are detected as ZIP archives (rename after recovery).

🎨 User Interface

• Modern Dark Theme — Glassmorphism design with smooth animations
• Real-Time Progress — Live scan and wipe status updates
• Native Dialogs — OS-integrated file/folder browser
• Toast Notifications — Instant feedback for all operations
• Responsive Design — Works on desktop and tablet screens

---

🚀 Installation

Prerequisites

Requirement	Version
OS	Linux x86_64 (Ubuntu/Debian/Kali) or Windows
CMake	3.10+
Compiler	GCC/G++ with C++20 support
Assembler	NASM (for Linux builds)

Build from Source

# Install dependencies (Debian/Ubuntu/Kali)
sudo apt update
sudo apt install -y build-essential cmake nasm g++ libpthread-stubs0-dev

# Clone repository
git clone https://github.com/MH4S33B/DataForgeX.git
cd DataForgeX

# Build
mkdir -p build && cd build
cmake ..
make -j$(nproc)

# Run
./DataForgeX

The web interface launches automatically at http://localhost:8080

---

📖 Usage

Web Interface

1. Launch — Run ./DataForgeX and open http://localhost:8080
2. Navigate — Choose between Dashboard, Secure Wipe, Recovery, or Settings
3. Configure — Select target file or device
4. Execute — Start operation and monitor real-time progress
5. Verify — Check results in the operation log

Secure Wipe Workflow

1. Open "Secure Wipe" tab
2. Click "Browse" to select target file
3. Choose wipe algorithm (Zeros/Random/DoD/Gutmann)
4. Click "START SECURE WIPE"
5. Confirm the operation
6. Monitor progress until complete

Data Recovery Workflow

1. Open "Recovery" tab
2. Enter device path (e.g., /dev/sda1) or browse for disk image
3. Click "SCAN DEVICE"
4. Wait for signature scanning to complete
5. Review discovered files in results table
6. Click "Carve" to recover individual files, or "Recover All"
7. Choose save location when prompted

💡 Tip: For testing, create a disk image with dd rather than scanning live partitions.

---

🏗️ Architecture

┌─────────────────────────────────────────────────────────────────┐
│                    DataForgeX Web Interface                     │
│  ┌──────────────────┬──────────────────┬─────────────────────┐  │
│  │   Secure Wipe    │   Data Recovery  │      Settings       │  │
│  └──────────────────┴──────────────────┴─────────────────────┘  │
└────────────────────────────┬────────────────────────────────────┘
                             │ HTTP REST API (Port 8080)
┌────────────────────────────▼────────────────────────────────────┐
│                   C++ HTTP Server (server.cpp)                  │
│     Endpoints: /api/wipe  /api/scan  /api/carve  /api/browse    │
└────────────────────────────┬────────────────────────────────────┘
                             │
┌────────────────────────────▼────────────────────────────────────┐
│                  Core Backend (backend.cpp)                     │
│  ┌────────────────┬─────────────────┬────────────────────────┐  │
│  │  SecureWipe    │   RecoveryMgr   │     FileOperations     │  │
│  │  - Zero/Random │   - Signature   │     - Browse Dialog    │  │
│  │  - DoD/Gutmann │   - Carving     │     - Save Dialog      │  │
│  └────────────────┴─────────────────┴────────────────────────┘  │
└────────────────────────────┬────────────────────────────────────┘
                             │
┌────────────────────────────▼────────────────────────────────────┐
│               Assembly Modules (NASM x86_64)                    │
│         wiper.asm: LFSR PRNG    recovery.asm: Scanner           │
└─────────────────────────────────────────────────────────────────┘

Technology Stack

Layer	Technology
Core	C++20 with modern features
Performance	NASM x86_64 assembly modules
I/O	POSIX direct file operations
Server	Custom HTTP/1.1 implementation
Frontend	HTML5, CSS3 (Tailwind), Vanilla JS
Icons	Font Awesome 6

---

📁 Project Structure

DataForgeX/
├── CMakeLists.txt          # Build configuration
├── DataForgeX.h            # Main header exports
├── main.cpp                # Application entry point
├── LICENSE                 # MIT License
├── README.md               # Documentation
│
├── asm/                    # Assembly modules
│   ├── wiper.asm           # LFSR random buffer generation
│   └── recovery.asm        # File signature scanning
│
├── backend/                # C++ backend
│   ├── backend.h           # Core API declarations
│   ├── backend.cpp         # Wipe/recovery implementations
│   ├── server.h            # HTTP server declarations
│   └── server.cpp          # HTTP server & API handlers
│
└── gui/                    # Web frontend
    ├── index.html          # Main application GUI
    ├── index.css           # Application styles
    ├── script.js           # Application logic
    ├── landing.html        # Landing page
    ├── landing.css         # Landing styles
    ├── landing.js          # Landing scripts
    └── logo.png            # Project logo

---

🔧 API Reference

Endpoints

Method	Endpoint	Description
GET	/	Serve main application GUI
GET	/api/browse	Open native file browser dialog
GET	/api/progress	Get current scan progress (0-100%)
GET	/api/results	Get scan results with file list

Method	Endpoint	Request Body
POST	/api/wipe	{"filepath": "/path/to/file", "method": "0-3"}
POST	/api/scan	{"devicePath": "/dev/sda1"}
POST	/api/carve	{"devicePath": "...", "offset": "...", "size": "...", "type": "...", "outputPath": "..."}
POST	/api/save-dialog	{"type": "JPEG", "offset": "0x1000"}

Response Format

All API responses are JSON:

{
  "status": "success",
  "message": "Operation completed",
  "data": { ... }
}

---

⚠️ Security Notice

🔴 CRITICAL WARNING

⚠️	File wiping is PERMANENT and IRREVERSIBLE
�	Double-check target files before execution
🚫	Wiped data cannot be recovered by any means
🎯	Ensure you have selected the correct file
🔐	Use recovery features only on authorized devices
⚖️	Ensure compliance with local data protection laws

---

👥 Team

👨‍💻 Developer	� Connect
Muhammad Haseeb
Ahmad Saleem
Ahtesham Hussain

---

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

• Fork the repository
• Open a Pull Request

---

Made with ❤️