An AI-powered decentralized task Platform built on Celo Sepolia Testnet, where requesters post micro-tasks, workers complete them, AI verifies the results, and payments are automatically released in cUSD upon approval.

📋 Table of Contents

Overview
Tech Stack
AI Integration
Database Schema
Folder Structure
Setup Guide
Smart Contract Deployment
Workflow
API Examples
Architecture
Features
Testing
Deployment
Future Roadmap
License

⚡ Overview

D.M.T.P introduces verifiable trust between micro-task requesters and workers. AI moderation (powered by Google Gemini) ensures submissions are authentic and high-quality, while the TaskEscrow smart contract on Celo guarantees transparent, secure on-chain payments.

Key Features

🤖 AI-Powered Verification — Automated content moderation using Google Gemini
⛓️ Blockchain Escrow — Smart contract-based payment security
💰 Instant Payments — Automatic cUSD release upon task approval
🔐 Wallet Authentication — Secure login via MetaMask or MiniPay
📊 Real-Time Updates — Live task and submission status tracking
🎯 Quality Control — AI prevents spam, fraud, and low-effort submissions

🛠️ Tech Stack

🖥️ Frontend — Next.js (App Router)

Feature	Library/Framework
UI Components	shadcn/ui
Styling	TailwindCSS
State Management	Zustand
Data Fetching	TanStack Query
Wallet Integration	wagmi + viem
Blockchain SDK	@celo/contractkit
Wallets Supported	MiniPay and MetaMask
AI Moderation	Google Gemini 1.5

⚙️ Backend — Express.js + TypeScript

Feature	Technology
Framework	Express.js
Database	PostgreSQL + Prisma ORM
Job Queue	Bull + Redis
AI Verification	Gemini API
Blockchain	Celo Sepolia
Authentication	Wallet Signature (EIP-191)
File Verification	cUSD Escrow via TaskEscrow.sol
Notifications	Background service + WebSocket placeholder

⛓️ Blockchain — Celo Sepolia Testnet

Smart Contract: TaskEscrow.sol
- Holds task payments in escrow
- Releases funds when AI-verified
- Refunds requester if submissions are rejected
Token: cUSD (Stablecoin)
Network RPC: https://forno.celo-sepolia.celo-testnet.org
Explorer: CeloScan (Sepolia)

🤖 AI Integration (Google Gemini 2.5 Pro)

Used for:

✅ Spam, fraud, and duplicate prevention
✅ Toxic or low-effort content rejection
✅ Criteria-based submission scoring

Gemini runs asynchronously in a Bull Queue worker, sending results via webhook to approve or reject submissions.

🗄️ Database Schema (Core Entities)

Table	Description
users	Stores wallet addresses, roles (`requester` / `worker`), reputation & earnings
tasks	Contains task metadata, blockchain taskID, payment amount, expiry
submissions	Tracks worker submissions, AI verification results
payments	Logs payment releases (+txHash)
notifications	In-app notifications for verification or payment updates

💎 Folder Structure

D.M.T.P/
├── client/                 # Next.js frontend
│   ├── app/               # App Router pages
│   ├── components/        # shadcn + custom UI
│   ├── hooks/             # Zustand + wagmi hooks
│   ├── lib/               # API client + Celo utils
│   └── types/             # Shared TypeScript models
│
└── server/                # Express backend
    ├── src/
    │   ├── routes/        # /api/v1 tasks, submissions, users
    │   ├── controllers/   # Request handlers
    │   ├── services/      # AI, blockchain, queue, moderation
    │   ├── workers/       # Bull verification worker
    │   └── database/      # Prisma schema + migrations
    └── prisma/

⚙️ Setup Guide

Prerequisites

✅ Node.js >= 20
✅ npm >= 9
✅ Redis (running locally or hosted)
✅ PostgreSQL database
✅ Celo wallet with test cUSD

1️⃣ Environment Variables

`.env` (Backend)

# Server
PORT=3001
NODE_ENV=development

# Database
DATABASE_URL="postgresql://user:password@localhost:5432/D.M.T.P"

# Blockchain
PRIVATE_KEY=YOUR_PRIVATE_KEY_WITH_CUSD
CELO_RPC_URL=https://forno.celo-sepolia.celo-testnet.org
CONTRACT_ADDRESS=0xYourTaskEscrowAddress
CUSD_SEPOLIA_ADDRESS=0x874069fa1eb16d44d622f2e0ca25eea172369bc1

# AI (Gemini)
GEMINI_API_KEY=your_google_gemini_api_key

# Redis
REDIS_HOST=localhost
REDIS_PORT=6379

`.env.local` (Frontend)

NEXT_PUBLIC_API_URL=http://localhost:3001
NEXT_PUBLIC_CELO_RPC_URL=https://forno.celo-sepolia.celo-testnet.org
NEXT_PUBLIC_CUSD_ADDRESS=0x874069fa1eb16d44d622f2e0ca25eea172369bc1
NEXT_PUBLIC_CONTRACT_ADDRESS=0xYourTaskEscrowAddress
NEXT_PUBLIC_CHAIN_ID=44787

2️⃣ Backend Setup

cd server
npm install

# Prisma setup + migrate
npx prisma generate
npx prisma db push

# Start Redis (using Docker)
docker run -d -p 6379:6379 redis:alpine

# Start backend in dev mode
npm run dev

3️⃣ Frontend Setup

cd client
npm install
npm run dev

Visit → http://localhost:3000

💰 Smart Contract Deployment

Our Deployed Smart Contract- 0xa520d207c91C0FE0e9cFe8D63AbE02fd18B2254e

Deploy TaskEscrow.sol on Celo Sepolia using Remix or Hardhat.

Compile & Deploy

npx hardhat run scripts/deploy.ts --network celo-sepolia

Verify Contract

npx hardhat verify --network celo-sepolia 0xYourContractAddress "0x874069fa1eb16d44d622f2e0ca25eea172369bc1"

🧠 Workflow

✳️ Requester Flow

Connect wallet → Create Task
Payment locked in smart contract
Task visible to workers

🛠️ Worker Flow

Accept Task → Submit Response
Gemini AI verifies content
If approved ✅ → Payment auto-released (cUSD)
If rejected ❌ → Refund to requester

🧾 Example API Calls

Create Task

POST /api/v1/tasks/create
Content-Type: application/json

{
  "title": "Label Images",
  "description": "Tag each image with emotion category",
  "paymentAmount": 3.5,
  "expiresAt": "2025-11-10T12:00:00Z"
}

Submit Task

POST /api/v1/submissions/submit
Content-Type: application/json

{
  "taskId": "uuid",
  "submissionData": {
    "imageUrls": ["https://ipfs.tech/image1.png"],
    "metadata": { "label": "happy" }
  }
}

AI Queue → Gemini Verification → Payment Released

🧱 Architecture Diagram

┌────────────┐
│  Next.js   │────┐
└────────────┘    │
                  ▼
┌───────────┐  ┌──────────────┐
│Express.js │◄─│ PostgreSQL   │
└───────────┘  └──────────────┘
      │
┌─────┼──────┐
▼     ▼      ▼
Gemini   Redis   Celo
AI      /Bull    Network
(Verify) (Queue) (Escrow)

✅ Features Checklist

Wallet Signature Login (EIP-191)
Gemini-based Content Moderation
Blockchain-Backed Escrow Payments
Task + Submission CRUD
Bull Queue Worker Verification
Real-Time Status Updates
cUSD Balance Tracking
Transaction Confirmation + CeloScan Link
Admin + Requester Dashboard
Fully Responsive UI

🧪 Testing

# Run backend tests
cd server
npm run test

# Database Studio
npx prisma studio

# Queue dashboard
npm run bull:dashboard

🌍 Deployment

Suggested Setup

Layer	Platform	Notes
Frontend	Vercel	Auto-deploy from main
Backend	Railway / Render	Node + Postgres service
Database	Neon / Supabase	Free Postgres DB
Redis	Upstash / Redis Cloud	Connection for Bull jobs

🧠 Future Roadmap

🪄 On-chain Gemini verification proofs
🧩 Decentralized task reputation scoring
💬 Worker messaging + chat
🪶 File uploads to IPFS / Web3.Storage
⚙️ Multi-network support (Base, Polygon)

🪙 Credits

Developed with 💚 on the Celo blockchain.

Built using Next.js, Celo ContractKit, Gemini AI, and Prisma.

📝 License

This project is licensed under the MIT License — feel free to fork and extend 💡

👥 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Fork the repository
Create your feature branch (git checkout -b feature/AmazingFeature)
Commit your changes (git commit -m 'Add some AmazingFeature')
Push to the branch (git push origin feature/AmazingFeature)
Open a Pull Request

📧 Contact

For questions or support, please open an issue on GitHub.

Made with ❤️ for the Celo ecosystem

README.md Unescape Escape

🪙 D.M.T.P — Agentic AI-Verified Micro-Task Platform on Celo Blockchain