What is ChainTrack?

ChainTrack is a supply chain tracking system that uses SHA-256 cryptographic hash chains to create tamper-evident records of every event in a product's journey from manufacturer to customer.

Each supply chain event (manufacturing, shipping, customs clearance, warehousing, delivery) is recorded as a block in the chain. Each block contains the SHA-256 hash of the previous block, creating an unbreakable chain of evidence.

Key Features

🔒

SHA-256 Hash Chain

Every supply chain event is cryptographically linked to the previous one, ensuring data integrity.

📱

QR Code Tracking

Each product gets a unique QR code that links to its complete supply chain history.

🛡

Tamper Detection

Verification walks the entire chain, recomputing hashes to detect any unauthorized changes.

📊

Real-time Dashboard

Monitor your entire supply chain with live statistics and event feeds.

🌐

REST API

Full-featured API for integration with existing supply chain management systems.

📦

Product Registry

Register and manage products with unique tracking IDs and comprehensive metadata.

Technology Stack

Backend: FastAPI (Python)
Database: SQLite with SQLAlchemy ORM
Cryptography: SHA-256 (hashlib)
QR Codes: qrcode + Pillow
Templates: Jinja2
Validation: Pydantic v2

API Documentation

ChainTrack provides interactive API documentation via Swagger UI and ReDoc.

GET /api/products List all products
POST /api/products Register a new product
GET /api/chain/{product_id} Get hash chain for a product
POST /api/chain/event Record a supply chain event
GET /api/verify/{product_id} Verify chain integrity
GET /api/track/{tracking_id} Track product by ID