---

TOR-UNVEIL: Peel The Onion

Tor Network Analysis & Correlation Platform (Offline Demonstration System)

---

Project Overview

TOR-UNVEIL is a fully offline, synthetic-dataset–driven analytical system designed to demonstrate how Tor routing, relay correlation, and traffic reconstruction can be studied safely without accessing real Tor traffic. The platform provides a complete visual and investigative workflow that includes topology mapping, circuit reconstruction, forensic timelines, and correlation scoring.

---

Folder Structure

TOR-Unveil/
│── public/                     # Static assets for the UI
│── src/                        # Source code: UI pages, components, logic engines
│── Screenshots Folder/         # UI screenshots for reference
│── TOR-UNVEIL Abstract.pdf     # Submitted project abstract (required for shortlisting)
│── TOR-UNVEIL Prototype Demonstration.mp4  # Video demo of working prototype
│── package.json                # Project dependencies
│── vite.config.ts              # Build configuration
│── tailwind.config.ts          # UI styling/theme configuration
│── index.html                  # Application entrypoint
│── tsconfig*.json              # TypeScript configurations
│── READ ME (this file)

---

Key Functional Components

1. Dashboard

• Overview of Tor-style relay network
• Active flows, statistics, and distribution charts

2. Automated Topology Mapping

• Automatic construction of Tor-like relay graphs
• Node clustering by role, ASN, and region

3. Network Visualization

• 2D/3D interactive animated graph
• Guard, Middle, Exit role color-coding
• Node hover details & edge animations

4. Node Explorer

• Searchable and filterable relay database
• Detailed relay metadata (role, uptime, bandwidth, ASN, country)

5. Correlation Engine

• Circuit reconstruction using synthetic flows
• Timing accuracy, bandwidth matching, and correlation scoring
• Entry → Middle → Exit path visualization

6. Forensic Timeline

• Event sequence built from synthetic PCAP summaries
• Packet event markers, timeline slider, and flow replay

7. Guard Node Identification

• Probability-based ranking of potential entry nodes
• Reliability scoring and observed connection statistics

8. Report Export

• Generates a structured case report containing:

  • Circuit analysis
  • Timeline reconstruction
  • Node involvement
  • Confidence metrics

---

🛠️ Technology Stack

• Frontend: React + TypeScript
• UI Styling: TailwindCSS
• Visualization: D3.js + custom animated components
• Build Tool: Vite
• Data: Static JSON datasets (synthetic)
• Architecture: Modular, component-based, offline-ready

---

Included Deliverables

• TOR-UNVEIL Abstract.pdf

  • Contains Proof of Concept, Methodology, Innovation, Feasibility, and Working Prototype information as required by TN Police Hackathon guidelines.

• TOR-UNVEIL Prototype Demonstration.mp4

  • A detailed walkthrough showing the full working interface and all functional modules.

• Screenshots Folder

  • Contains UI screenshots for quick inspection.

---

Status

The system is fully functional, offline.

---