YAR-Coin-2.0 Official Architecture

A decentralized bussiness model for contribution & incentive ecosystem powered by real-time auctions, NFT minting, DEX conversion, and contribution-based penalties.

---

 
  # Clone repo
  $ git clone https://github.com/aijadugar/YAR-Coin-2.0.git 
  $ cd YAR-Coin-2.0 
  $ cd server/yarlabs-hh && npm install && npx hardhat node 
  
  # Open new terminal
  $ cd server/yarlabs-py && python deploy_yarcoin.py 
  
  # Open another terminal
  $ cd server/yarlabs-be && npm start

  # Open next termial
  $ cd client && npm run dev

---

Overview

YAR-Coin-2.0 is a full-stack blockchain-integrated ecosystem designed to:

• Reward academic contributions
• Enforce contribution-based penalties
• Mint NFTs for achievements
• Enable token conversion via DEX
• Run live real-time bidding auctions
• Provide socket-based chat communication
• Automate auction settlements using cron jobs

---

High-Level Architecture

flowchart TD

    A[Frontend - React] -->|REST APIs| B[Backend - Express]
    A -->|WebSocket| C[Socket Server]
    
    B --> D[(MongoDB Database)]
    B --> E[Sepolia Blockchain Layer]
    B --> F[Smart Contract Deployment]
    
    B --> G[Auction Settlement Engine]
    
    E --> H[(Smart Contracts)]
    
    C --> D
    
    style A fill:#1f2937,color:#fff
    style B fill:#111827,color:#fff
    style C fill:#0f172a,color:#fff
    style D fill:#1e3a8a,color:#fff
    style E fill:#7c3aed,color:#fff
    style H fill:#9333ea,color:#fff

Loading

---

Core System Modules

---

1 Authentication & Role System

Roles:

• Admin (Teacher / Mentor / Evaluator / Governor)
• Member (Student / Contributor / Builder / Participant)

Flow

sequenceDiagram
    participant User
    participant Frontend
    participant Backend
    participant Database

    User->>Frontend: Login Request
    Frontend->>Backend: Send Credentials
    Backend->>Database: Validate User
    Database-->>Backend: User Data
    Backend-->>Frontend: Auth Token and Role

Loading

---

2 Real-Time Chat Tunnel (WebSocket)

• Room-based messaging
• Admin and it's aquired Member's communication
• Used during auctions & dispute discussions

flowchart LR
    A[Client A] -->|WebSocket| S(Socket Server)
    B[Client B] -->|WebSocket| S
    S -->|Store| DB[(Message Store)]

Loading

---

3 Contribution Tracking & Repository Stats

Admins can evaluate:

• GitHub contribution stats of each members
• Repository analysis
• Contribution scoring logic

flowchart LR
    A[Admin Dashboard] --> B[Backend]
    B --> C[GitHub Stats Engine]
    C --> D[Score Calculation]
    D --> E[Admin Dashboard]

Loading

---

4 Penalty System

Used when:

• Member misses contribution targets
• Rule violations occurs

Architecture

flowchart LR
    A[Admin Applies Penalty] --> B[Backend]
    B --> C[Checking Collections]
    C --> D[Member Wallet Update]
    D --> E[Admin Wallet Update]
    E --> F[(Penalty History Log)]

Loading

---

5 NFT Minting System

Achievements & milestones are minted as NFTs.

flowchart LR
    A[Admin Mint NFT] --> B[Backend]
    B --> C[Sepolia Layer]
    C --> D[Smart Contract]
    D --> E[(Metamask)]
    D --> F[(Transaction Hash Stored)]

Loading

---

6 Live Auction & Bidding Engine

Real-Time Auction Model

flowchart TD
    A[Members Set Base Price] --> B[Backend]
    B --> C[(Base Price Store)]
    
    D[Admin Places Bid] --> E[Backend]
    E --> F[Bid Validation with Base Price]
    F --> G[Bid Collection]
    G --> H[(Bids Store)]
    
    E --> I[Metamask]
    I --> J[Live Dashboard Update]

Loading

---

7 Automated Auction Settlement (Cron Engine)

Now for testing it runs runs every minute.

flowchart LR
    A[Cron Trigger] --> B[Fetch Active Auctions]
    B --> C{Auction Expired?}
    C -->|Yes| D[Determine Winner]
    D --> E[Transfer Ownership]
    E --> F[Update Wallet Balances]
    F --> G[Log Transaction]
    C -->|No| H[Wait]

Loading

---

8 DEX Conversion Engine

Convert:

• YAR ↔ USD (Internal ledger based)

flowchart LR
    A[Member Requests Conversion] --> B[Backend]
    B --> C[Validate Balance]
    C --> D[Update Ledger]
    D --> E[(Transaction History)]

Loading

---

Database Design Overview (MongoDB)

Collections:

• Admins
• Members
• Biddings
• Penalties
• NFTs
• DEXs
• Messages

erDiagram
    ADMINS ||--o{ MEMBERS : acquires
    ADMINS ||--o{ BIDDINGS : places
    ADMINS ||--o{ PENALTIES : gives
    ADMINS ||--o{ TASKS : assigns
    ADMINS ||--o{ STATS : views

    MEMBERS ||--|| BASEPRICE : sets
    MEMBERS ||--o{ BIDDINGS : participates
    MEMBERS ||--o{ YARCS : wins
    MEMBERS ||--o{ PENALTIES : receives
    MEMBERS ||--o{ DEX : converts
    MEMBERS ||--o{ NFTS : wins

Loading

---

Technology Stack

Layer	Technology
Frontend	React js
Backend	Express js
Database	MongoDB
Blockchain	Sepolia
Smart Contracts	Solidity (Web3)
DApp	Metamask
Deployment	Python Scripts
Real-time	Socket.io
Scheduler	node-cron
Hosting	Vercel

---

Why YAR Coin instead of an AI tool?

Inspired from master–slave architecture, YAR-Coin-2.0 fills the structural gaps that most large organizations and the education sector face. It’s like a GitHub for developers, but designed for institutional ecosystems.

• Member base price system
• Admin bidding and acquisition model
• Live auction engine with real-time updates
• YAR reward distribution system
• Penalty governance and accountability tracking
• NFT minting for achievements
• DEX conversion for YAR ↔ USD value
• Real-time communication layer
• Admin dashboard with member stats and task management
• Hybrid Web2 backend + Web3 ownership integration

YAR-Coin-2.0 turns contributions into measurable value, makes accountability transparent, and converts performance into digital ownership.

New version of YARCoin...YAR-Coin-2.0

Build. Contribute. Compete. Earn. Own.