Skip to content

devcode-srish/vouch-the-student-marketplace

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

19 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

๐Ÿ›๏ธ Vouch โ€“ The Student Marketplace (Powered by Algorand)

A secure, campus-focused peer-to-peer marketplace with escrow protection and QR-based handoff verification โ€” powered by the Algorand blockchain.

๐Ÿ“Œ Overview

Vouch is a student-only digital marketplace designed to eliminate fraud in campus buying and selling.

Unlike traditional marketplaces, Vouch uses:

  • ๐Ÿ” Blockchain-backed escrow (Algorand)
  • ๐Ÿ“ฑ QR-based physical exchange validation
  • โญ Trust score & reputation system
  • ๐Ÿ† Reward economy for active users
  • ๐Ÿ“Š Admin monitoring & analytics dashboard

The goal is simple:

No scams. No fake payments. No unsafe exchanges.


๐Ÿš€ Core Features

1๏ธโƒฃ Secure Escrow System (Algorand-Based)

Funds are locked in a smart escrow wallet until both buyer and seller confirm the exchange.

โœ” Buyer pays โ†’ Funds locked on Algorand โœ” QR generated for transaction โœ” Seller scans QR during meetup โœ” Funds released automatically


2๏ธโƒฃ QR-Based Transaction Validation

Every transaction generates a unique QR containing:

  • Transaction ID
  • Escrow reference
  • Buyer ID
  • Seller ID
  • Timestamp

This ensures physical exchange verification before fund release.


3๏ธโƒฃ Trust & Reputation Engine

Users earn trust points based on:

  • Successful transactions
  • Positive ratings
  • Account age
  • Dispute-free history

Higher trust = Higher visibility.


4๏ธโƒฃ Reward Economy

Users earn platform credits for:

  • Completing transactions
  • Referring students
  • Maintaining high trust

Credits can be used for:

  • Promoted listings
  • Fee discounts

5๏ธโƒฃ Admin Dashboard

Admins can:

  • Monitor transactions
  • View dispute logs
  • Track user activity
  • Freeze suspicious accounts

๐Ÿ—๏ธ System Architecture

flowchart LR
    A[User - Buyer] --> B[Frontend - Next.js]
    C[User - Seller] --> B
    B --> D[Backend APIs]
    D --> E[Escrow Smart Contract]
    E --> F[Algorand Blockchain]
    D --> G[Database]
    D --> H[QR Generator Service]
Loading

๐Ÿ”„ Complete Transaction Flow

sequenceDiagram
    participant Buyer
    participant Frontend
    participant Backend
    participant Escrow
    participant Seller

    Buyer->>Frontend: Select item & Pay
    Frontend->>Backend: Create transaction
    Backend->>Escrow: Lock funds (Algorand)
    Escrow-->>Backend: Escrow ID
    Backend-->>Frontend: Generate QR
    Buyer->>Seller: Meet physically
    Seller->>Frontend: Scan QR
    Frontend->>Backend: Validate QR
    Backend->>Escrow: Release funds
    Escrow-->>Seller: Transfer payment
Loading

๐Ÿ’ฐ Escrow Logic Flowchart

flowchart TD
    A[Buyer Initiates Purchase] --> B[Payment Sent to Escrow]
    B --> C[Escrow Confirms Lock]
    C --> D[Generate Unique QR Code]
    D --> E[Physical Meetup]
    E --> F{QR Valid?}
    F -- Yes --> G[Release Funds to Seller]
    F -- No --> H[Transaction Blocked]
Loading

๐Ÿง  Trust Score Calculation Model

flowchart LR
    A[Successful Transactions] --> D[Trust Engine]
    B[Positive Ratings] --> D
    C[Account Age] --> D
    E[Disputes] --> D
    D --> F[Final Trust Score]
Loading

๐Ÿ—‚๏ธ Project Structure

Vouch/
โ”‚
โ”œโ”€โ”€ src/
โ”‚   โ”œโ”€โ”€ components/      # UI Components
โ”‚   โ”œโ”€โ”€ pages/           # Application Routes
โ”‚   โ”œโ”€โ”€ api/             # Backend API Routes
โ”‚   โ”œโ”€โ”€ services/        # Escrow + Blockchain Logic
โ”‚   โ””โ”€โ”€ utils/           # Helper functions
โ”‚
โ”œโ”€โ”€ docs/                # Diagrams & documentation
โ”œโ”€โ”€ public/              # Static assets
โ”œโ”€โ”€ package.json
โ””โ”€โ”€ next.config.ts

๐Ÿ” Why Algorand?

Algorand provides:

  • โšก High-speed finality (~4 seconds)
  • ๐Ÿ’ธ Extremely low transaction fees
  • ๐Ÿ”’ Secure smart contracts
  • ๐ŸŒ Energy-efficient blockchain

This makes it ideal for micro-transactions in a student economy.


โš™๏ธ Tech Stack

Layer Technology
Frontend Next.js + TypeScript
Styling Tailwind CSS
Backend API Routes
Blockchain Algorand
Database Firestore / NoSQL
QR System Dynamic QR Generator

๐Ÿ›ก๏ธ Security Model

โœ” Escrow-based smart contract logic โœ” QR validation before release โœ” Server-side transaction verification โœ” Admin monitoring โœ” Dispute handling system


๐Ÿ“ˆ Scalability Design

The system supports scaling by:

  • Stateless backend APIs
  • Blockchain-based payment handling
  • Cloud-hosted database
  • Modular microservice-ready structure

๐Ÿ”ฎ Future Enhancements

  • ๐Ÿ“ฑ Mobile app version
  • ๐Ÿงพ On-chain transaction history viewer
  • ๐Ÿง  AI fraud detection engine
  • ๐ŸŽ“ University email verification integration
  • ๐Ÿ’ณ Native Algorand wallet integration

๐ŸŽฏ Problem Solved

Campus marketplaces often suffer from:

โŒ Fake UPI screenshots โŒ Non-payment after handoff โŒ Anonymous scammers

Vouch eliminates these through blockchain-backed escrow and QR confirmation.


๐Ÿ Conclusion

Vouch is not just a marketplace.

It is a trust infrastructure for student commerce, built on the reliability of Algorand and modern full-stack architecture.


๐Ÿ’ก Built For

Hackathons โ€ข Campus Deployments โ€ข Web3 Innovation โ€ข Secure Peer Commerce

About

Secure the deal. Skip the sketchiness. Vouch is a peer-to-peer (P2P) escrow marketplace designed exclusively for the college ecosystem. No more awkward "did they actually send the money?" moments at the campus gate. We hold the bag until the hand-off is 100% verified.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages