🛡️ ChainGuard

Enterprise AML Compliance & Tamper-Evident Transaction Monitoring Platform

---

🌍 Vision

Modernize financial compliance with intelligent monitoring, instant alerts and immutable audit trails.

---

📌 Problem Statement

Financial institutions face growing challenges with:

• Suspicious transaction monitoring
• Manual compliance reviews
• Fraud risk exposure
• Regulatory reporting delays
• Data tampering concerns
• Slow investigation workflows

Legacy systems are fragmented, reactive and expensive to scale.

---

🚀 Solution

ChainGuard is an enterprise-grade AML compliance platform that combines:

• Real-time transaction risk scoring
• Automated suspicious activity alerts
• Analyst investigation workflows
• Tamper-evident ledger verification
• Secure role-based access control

It enables faster detection, cleaner audits and smarter compliance operations.

---

🏗️ System Architecture

         ┌──────────────────────┐
         │ Incoming Transaction │
         │ Amount / Sender / Geo│
         └──────────┬───────────┘
                    │
                    ▼
         ┌──────────────────────┐
         │   Express API Layer  │
         └──────────┬───────────┘
                    │
        ┌───────────┼────────────┐
        ▼                        ▼
┌────────────────┐      ┌────────────────────┐
│ AML Risk Engine│      │ Ledger Engine      │
│ Rule Scoring   │      │ SHA-256 Hash Chain │
└────────────────┘      └────────────────────┘
        │                        │
        ▼                        ▼
┌────────────────────────────────────┐
│ Prisma ORM + SQLite Data Store    │
└────────────────────────────────────┘
                    │
                    ▼
         ┌──────────────────────┐
         │ React Analyst Portal │
         │ Alerts + Case Review │
         └──────────────────────┘

---

⚙️ Core Features

🚨 AML Risk Scoring

Evaluate every transaction against configurable risk rules.

🔍 Suspicious Pattern Detection

Flags threshold breaches, velocity spikes and risky geographies.

🧾 Tamper-Evident Ledger

Linked SHA-256 hash chain protects historical integrity.

👥 Role-Based Access

Separate privileges for Admin, Analyst and Auditor roles.

📊 Compliance Dashboard

Monitor alerts, review cases and track activity trends.

🔐 Secure Authentication

JWT sessions with password hashing.

---

🔄 Operational Flow

Transaction Submitted
→ Backend Validation
→ AML Risk Score Generated
→ Ledger Hash Created
→ Alert Triggered (if risky)
→ Analyst Reviews Case
→ Resolution Logged

---

🛠️ Tech Stack

Layer	Technology
Frontend	React + TypeScript
Routing	TanStack Router
Styling	Tailwind CSS + shadcn/ui
Backend	Node.js + Express
ORM	Prisma
Database	SQLite
Auth	JWT + bcrypt
Validation	Zod

---

📂 Repository Structure

ChainGuard/
├── client/
│   ├── src/
│   └── components/
├── server/
│   ├── routes/
│   ├── services/
│   └── prisma/
├── package.json
└── README.md

---

⚙️ Quick Start

Install Dependencies

npm install

Run Frontend + Backend

npm run dev

---

🌐 Default Access

Frontend: http://localhost:5173
Backend:  http://localhost:3000

---

🎯 Why It Matters

❌ Manual reviews waste analyst time
❌ Missed alerts increase regulatory risk
❌ Weak audit trails create trust issues

✅ ChainGuard enables modern intelligent compliance operations

---

📈 Example Risk Signals

• Transaction > threshold limit
• Multiple transfers within 24h
• First-time counterparty
• Risky jurisdiction transfer
• Structuring / unusual round amounts

---

🔮 Future Improvements

• Machine learning fraud scoring
• SAR report automation
• Multi-bank tenant support
• Real-time sanctions screening
• Cloud deployment + analytics
• Case management workflows

---

Building secure systems for high-trust financial operations.