Skip to content
OionosPublic

About

Blockchain supply-chain platform | Solidity, FastAPI, React.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

Veritras

Transparent supply chain tracking powered by blockchain.

Live Demo Backend


What is Veritras?

Veritras is a blockchain-powered supply chain analytics platform that brings transparency, traceability, and trust to product journeys. From manufacturer to doorstep, every checkpoint is recorded on the Ethereum Sepolia testnet — creating an immutable, verifiable history that anyone can audit.


Features

Feature Description
Product Registration Register products on-chain with unique IDs, manufacturer details, and IPFS metadata.
Shipment Tracking Follow shipments through a state-machine-driven lifecycle: Created → In Transit → At Checkpoint → Delivered.
Custody Transfers Every handoff is logged with timestamps, locations, and handler addresses.
Verification Portal Enter any product ID to instantly verify its on-chain provenance against off-chain records.
Analytics Dashboard Real-time KPIs, anomaly detection, and bottleneck analysis powered by Pandas.
Export Reports Download analytics as CSV or PDF for auditing and compliance.
Web3 Wallet Login Connect with MetaMask, Rainbow, or WalletConnect — no passwords needed.

Tech Stack

Layer Technology
Blockchain Solidity 0.8.19, Hardhat, Sepolia Testnet
Smart Contracts ProductRegistry, ShipmentTracker (92.86% test coverage)
Backend Python, FastAPI, SQLAlchemy, Web3.py, Neon PostgreSQL
Frontend React 18, TypeScript, Vite, Tailwind CSS, RainbowKit
Analytics Recharts, Pandas, Z-score anomaly detection
Deployment Vercel (Frontend), Render (Backend), Neon (Database)

Live Application

Service URL Status
Frontend veritras.vercel.app Online
API chainlens-4qvy.onrender.com Online
Health Check /health Database & Web3 Connected

Note: The app runs on the Sepolia Testnet. You'll need test ETH to register products and create shipments. Get free Sepolia ETH


How It Works

Manufacturer registers product
        |
        v
Product ID minted on-chain (Sepolia)
        |
        v
Shipment created with origin & destination
        |
        v
Checkpoints added at each handoff (location, handler, status)
        |
        v
Dashboard visualizes real-time analytics
        |
        v
Anyone can verify provenance by product ID

Project Origins

Veritras was built as a portfolio project to demonstrate full-stack blockchain application development. It combines on-chain provenance with off-chain indexing and an interactive analytics layer, bridging the gap between smart contracts and user-friendly interfaces.


License

MIT


Try the Live Demo

About

Blockchain supply-chain platform | Solidity, FastAPI, React.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages