Skip to content

OpenOurMinds/CloudCraftLab

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

146 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

CloudCraft Lab - Decentralized Computing Marketplace

Transform your idle computing power into valuable credits in a secure, containerized P2P marketplace.

๐Ÿš€ Features

Host Dashboard - "The Earning Command Center"

  • Real-Time Status Monitor: Live heartbeat indicator showing Ethernet/Wi-Fi status with automatic eligibility alerts
  • Resource Load Monitoring: Visual gauges for CPU/GPU usage, temperature, and fan speed
  • Earnings & Credit Wallet: Session earnings counter and complete transaction history
  • Availability Toggle: Instant Online/Offline switch to reclaim PC performance

Client API - "The Task Submission Portal"

  • POST /tasks/submit: Submit container images, datasets, and performance requirements
  • GET /tasks/status: Real-time progress tracking across distributed hosts
  • GET /tasks/results: Secure retrieval of compiled results
  • Budget Control: Set max credit spend to limit task costs

Mock Network Environment

  • 8 Simulated Hosts: Different IP addresses and geographic locations
    • Seoul, South Korea (192.168.1.101) - 85 score, Ethernet
    • Tokyo, Japan (10.0.0.45) - 92 score, Ethernet
    • Singapore (172.16.0.22) - 78 score, WiFi
    • Sydney, Australia (203.0.113.15) - 88 score, Ethernet
    • Mumbai, India (198.51.100.8) - 73 score, WiFi (Offline)
    • Hong Kong (192.0.2.55) - 95 score, Ethernet
    • Bangkok, Thailand (10.1.0.33) - 68 score, WiFi
    • Taipei, Taiwan (172.20.0.18) - 90 score, Ethernet

๐Ÿ—๏ธ Architecture

Technical Infrastructure

  1. Network Stability Monitor: Ethernet requirement with packet loss detection
  2. Hardware Benchmark Suite: CPU/GPU/RAM performance scoring
  3. Docker Containerization: Secure sandbox for task execution
  4. Encrypted Task Framework: End-to-end workload encryption
  5. Credit Transfer System: Digital wallet with P2P transfers
  6. Reputation System: 5-tier levels with multipliers and badges

Economic Model

  • B1 - Credit Transfer: Earn credits by hosting, spend on computing
  • B2 - P2P Marketplace: 5-10% platform fee for facilitation
  • Reputation Multipliers: Higher tiers earn 1.0x - 2.0x credit bonuses

๐ŸŽฏ Getting Started

For Hosts (Resource Providers)

  1. Network Check: Verify Ethernet connection stability
  2. Hardware Test: Benchmark system capabilities
  3. Go Online: Toggle availability to start earning
  4. Monitor: Track earnings and system health in real-time

For Clients (Task Requesters)

  1. Submit Task: Configure container image and requirements
  2. Set Budget: Define maximum credit spend
  3. Monitor Progress: Track execution across distributed hosts
  4. Retrieve Results: Download compiled outputs securely

๐Ÿ› ๏ธ Development

Tech Stack

  • Frontend: React 18 + TypeScript + Vite
  • UI Components: shadcn/ui + Tailwind CSS
  • State Management: React hooks + local storage
  • Icons: Lucide React
  • Build Tool: Vite with HMR

Project Structure

src/
โ”œโ”€โ”€ components/          # React components
โ”‚   โ”œโ”€โ”€ HostDashboard.tsx    # Host monitoring interface
โ”‚   โ”œโ”€โ”€ ClientAPI.tsx        # Client task submission
โ”‚   โ”œโ”€โ”€ NetworkMonitor.tsx   # Network stability checker
โ”‚   โ”œโ”€โ”€ HardwareBenchmark.tsx # System performance testing
โ”‚   โ”œโ”€โ”€ TaskMarketplace.tsx  # Task browsing/execution
โ”‚   โ”œโ”€โ”€ CreditWallet.tsx     # Credit management
โ”‚   โ””โ”€โ”€ ReputationSystem.tsx # Reputation tracking
โ”œโ”€โ”€ lib/                # Core business logic
โ”‚   โ”œโ”€โ”€ host-dashboard.ts     # Host monitoring logic
โ”‚   โ”œโ”€โ”€ client-api.ts        # Client API simulation
โ”‚   โ”œโ”€โ”€ network-monitor.ts    # Network stability monitoring
โ”‚   โ”œโ”€โ”€ hardware-benchmark.ts # Hardware testing
โ”‚   โ”œโ”€โ”€ task-execution.ts    # Task execution engine
โ”‚   โ”œโ”€โ”€ credit-system.ts      # Credit management
โ”‚   โ””โ”€โ”€ reputation-system.ts # Reputation scoring
โ””โ”€โ”€ pages/               # Application pages
    โ””โ”€โ”€ Index.tsx          # Main dashboard

๐Ÿš€ Quick Start

  1. Install Dependencies:

    npm install
  2. Start Development Server:

    npm run dev
  3. Open Application: Navigate to http://localhost:8080

๐Ÿ“Š Mock Data & Simulation

Network Simulation

  • Dynamic Host Status: Random online/offline changes
  • Network Type Switching: Ethernet โ†” WiFi transitions
  • Geographic Distribution: Global host locations
  • Performance Variations: Different hardware capabilities

Task Execution

  • Progress Simulation: Realistic task completion times
  • Resource Usage: CPU/GPU load during execution
  • Failure Scenarios: Random host failures
  • Credit Escrow: Secure payment handling

๐Ÿ”ง Configuration

Host Requirements

  • Network: Ethernet connection preferred
  • Hardware: Minimum performance score of 50
  • Storage: Sufficient disk space for containers
  • Temperature: CPU < 85ยฐC, GPU < 80ยฐC

Client Configuration

  • Container Images: Docker Hub URLs
  • Datasets: Publicly accessible links
  • Performance Requirements: Minimum scores for hosts
  • Budget Controls: Credit spend limits

๐ŸŽฎ Interactive Features

Host Dashboard

  • Real-time Monitoring: Live resource usage gauges
  • Network Alerts: Automatic notifications for status changes
  • Session Tracking: Current task progress and earnings
  • Simulation Controls: Test different network conditions

Client API

  • Task Submission: Form-based task creation
  • Progress Tracking: Multi-host progress visualization
  • Results Download: JSON formatted output data
  • Host Management: View and control available hosts

Reputation System

  • 5 Tiers: Bronze โ†’ Silver โ†’ Gold โ†’ Platinum โ†’ Diamond
  • Credit Multipliers: 1.0x to 2.0x based on tier
  • Badge System: Earn achievements for milestones
  • Performance Metrics: Success rate, uptime, reliability

๐Ÿ”’ Security Features

  • Container Isolation: Docker sandbox for all tasks
  • Encrypted Workloads: End-to-end data protection
  • Credit Escrow: Secure payment holding
  • Host Verification: Performance and reputation checks

๐Ÿ“ˆ Future Enhancements

  • Real Docker Integration: Actual container execution
  • Blockchain Integration: Decentralized credit system
  • Mobile App: Host monitoring on mobile devices
  • Advanced Analytics: Detailed performance insights
  • API Documentation: Comprehensive developer docs

๐Ÿค Contributing

  1. Fork the repository
  2. Create a feature branch
  3. Make your changes
  4. Add tests if applicable
  5. Submit a pull request

๐Ÿ“„ License

This project is licensed under the MIT License - see the LICENSE file for details.


Built with โค๏ธ for the decentralized computing revolution

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors