Skip to content

dhruv-38/DAGVerse

BranchesTags

Repository files navigation

DAGVerse: Decentralized Workflow Automation Platform

Project Overview

DAGVerse is a decentralized platform that empowers users to design, execute, and share automated workflows using Directed Acyclic Graphs (DAGs). The platform leverages smart contracts (BlockDAG testnet integration in progress) and decentralized storage to provide transparent, trustless, and collaborative automation for developers, data scientists, and businesses.

Purpose

DAGVerse addresses the limitations of centralized workflow automation tools by offering a decentralized alternative. Users can create, execute, and share workflows securely, with all logic and results verifiable and accessible via decentralized storage.

Features

  • Decentralized Workflow Execution: (In progress) Run workflows using smart contracts on the BlockDAG testnet.
  • User-Friendly Interface: Intuitive frontend for workflow creation, execution, and monitoring.
  • Secure Authentication: User registration and login with JWT-based authentication.
  • Workflow Management: Create, edit, and manage workflows as DAGs.
  • Community Sharing: (Planned) Discover and share reusable workflows with the community.
  • IPFS Integration: (Planned) Store workflow definitions and results on IPFS for decentralized access.

Tech Stack

Frontend

  • React (with hooks)
  • React Router v6
  • Tailwind CSS
  • Vite

Backend

  • Node.js
  • Express.js
  • MongoDB (for user and workflow data)
  • JWT (for authentication)
  • bcrypt (for password hashing)

Project Structure

DAGVerse/
├── Frontend/                 # React frontend
│   ├── src/
│   │   ├── components/      # UI components
│   │   ├── pages/           # Page components
│   │   ├── services/        # API service layer
│   │   ├── utils/           # Utilities and context
│   │   └── App.jsx          # Main app component
│   ├── package.json
│   └── README.md
├── dagverse-backend/        # Node.js backend
│   ├── src/
│   │   ├── controllers/     # Route controllers
│   │   ├── middleware/      # Express middleware
│   │   ├── models/          # MongoDB models
│   │   ├── routes/          # API routes
│   │   └── app.js           # Main server file
│   ├── package.json
│   └── .env
├── docker_pull_image.bat
├── docker_pull_images.sh
├── LICENSE
├── Makefile
├── mongodb-docker-setup  
│   ├── docker-compose.yml
|   └── .env
│   └── init-scripts
├── package.json            # Root package.json
└── README.md

Flow Diagram

+------------------------------------------------------------------------------------+
|                                     FRONTEND (React)                               |
|                                                                                    |
|    +------------------+     +------------------+       +----------------------+    |
|    |  AuthContext     |<--->|   Wallet Connect |<----->| MetaMask Extension   |    |
|    |  (JWT & Wallet)  |     |  (ethers.js)     |       +----------------------+    |
|    +------------------+     +------------------+                                      |
|             |                      |                                                  |
|             v                      v                                                  |
|    +-----------------------------+        +----------------------------------------+ |
|    |    Sessions.jsx             |<-----> |     Monaco Editor (Live Code)          | |
|    | - WebSocket logic           |        +----------------------------------------+ |
|    | - Code sync & Chat          |         +----------------------------+            |
|    | - Active Users & Languages  | -----> |    uploadToIPFS / Pinata    |             |
|    +-----------------------------+         +----------------------------+             |
|             |                                                                          |
|             v                                                                          |
|    +---------------------------+                                                      |
|    | ExpertHelp.jsx / Dashboard|<--------------------------------------------------+  |
|    | - IPFS Save / Load        |                                                   |  |
|    | - Smart Contract Calls    |<-------------------[Blockchain (EVM)]<----------+ |  |
|    +---------------------------+                                                   | |
|             |                                                                      | |
|             v                                                                      | |
|    +----------------------------+                                                  | |
|    | uploadToIPFS / Pinata      |<----------+                                       | |
|    +----------------------------+           |                                       | |
|                                             |                                       | |
+---------------------------------------------+---------------------------------------+ |

                             ⇅
                    HTTP API & WebSocket
                             ⇅

+------------------------------------------------------------------------------------+
|                                     BACKEND (Node.js/Express)                      |
|                                                                                    |
|    +----------------------+    +---------------------------+     +-------------+  |
|    | authController.js    |<-->| routes/auth.js            |     | JWT Auth MW |  |
|    | - walletChallenge()  |    +---------------------------+     +-------------+  |
|    | - walletVerify()     |                                                          |
|    +----------------------+                                                          |
|                                                                                    |
|    +----------------------+    +---------------------------+     +--------------+ |
|    | websocket.js         |<-->| /session/:sessionId WS    |<--->| WebSocket    | |
|    | - handle code/chat   |    +---------------------------+     | Server       | |
|    | - manage users       |                                          (ws://...)     |
|    +----------------------+                                                          |
|                                                                                    |
|    +----------------------+    +---------------------------+     +--------------+ |
|    | dockerExecutor.js    |<-->| routes/execute.js         |     | Docker Daemon| |
|    | - run code in Docker |    | - /api/execute            |     | + Images     | |
|    +----------------------+    | - /api/session            |     |   (Python,   | |
|                                | - /api/session/close      |     |    JS, Sol)  | |
|                                +---------------------------+     +--------------+ |
|                                                                                    |
|    +----------------------+    +---------------------------+                        |
|    | upload.js            |<-->| routes/upload.js          |<-------> Pinata API   |
|    | - /upload-to-ipfs    |    +---------------------------+                        |
|    +----------------------+                                                          |
+------------------------------------------------------------------------------------+

+------------------------------+
|      Blockchain (EVM)       |
| - Escrow Smart Contract     |
| - Stores IPFS Hashes        |
| - Handles BDAG Token Flow   |
+------------------------------+

+------------------------------+
|             IPFS             |
| - Stores Code Snapshots     |
| - Immutable Session History |
+------------------------------+

Sequence Diagrams Overview (Key Flows)

  1. Live Code Collaboration
User → Frontend → WebSocket (join session)
User → MonacoEditor → handleCodeChange() → send via WebSocket
Backend WebSocket → Broadcast code change → All users in session → update editor
  1. Code Execution
User → Frontend → API POST /execute with code & lang
Backend → dockerExecutor → run in container → return output
Frontend → show stdout/stderr to user
  1. Wallet Authentication
User → MetaMask Connect → sign challenge
Frontend → API /wallet-verify → Backend verifies → issue JWT
JWT used for secure API calls & WebSocket headers
  1. Escrow & Payment Flow
User A → Create request → Smart contract: createEscrow()
User B → Claim → Submit work → Smart contract: submitWork()
User A → Approve → Smart contract: releaseFunds()
  1. Session Save to IPFS
Frontend → prepare session code blob
→ API /upload-to-ipfs → Backend → Pinata API → Get CID
→ Store CID on-chain via contract → Immutable record

Quick Start

Prerequisites

  • Node.js (v16 or higher)
  • MongoDB (running locally or cloud instance)
  • Redis (optional, for session storage)
  • Docker
  • Make (Mac, Windows)

Installation

  1. Clone the repository

    git clone <repository-url>
cd DAGVerse

  2. Install backend dependencies

    cd dagverse-backend
npm install
npm start

  3. Install frontend dependencies

    cd ../Frontend
npm install
npm run dev

  4. Set up mongodb and other images MongoDB (.env in mongodb-docker-setup/)

    MONGO_USER=root
MONGO_PASSWORD=StrongRootPass123
MONGO_DB=dagverse

    For Mac

       chmod +x docker_pull_images.sh
   ./docker_pull_images.sh

    For Windows

       Double-click to run, or run in Command Prompt -- docker_pull_images.bat

    MakeFile

       make

  5. Access Mongo Express Web UI

    Visit http://localhost:8082 in your browser.

    Username: admin

    Password: admin123

    | 🔒 You can change these credentials in the docker-compose.yml file under the mongo-express service.

    Access to your MongoDB via IP 127.0.0.1 and port 27017

  6. Set up environment variables

    Backend (.env in dagverse-backend/):

    PORT=8000
MONGODB_URI=mongodb://localhost:27017/dagverse
JWT_SECRET=your-super-secret-jwt-key
PINATA_JWT=create-your-pinata-jwt-pinata.cloud

    Frontend (.env in Frontend/):

    VITE_API_URL=http://localhost:8000/api

  7. Start MongoDB (if running locally)

    mongod

  8. Start both frontend and backend

    npm run dev

    This will start:

    • Backend on http://localhost:8000
    • Frontend on http://localhost:5173

Individual Commands

  • Start only backend: npm run dev:backend
  • Start only frontend: npm run dev:frontend
  • Build frontend: npm run build
  • Start production: npm start

🔐 Authentication

Traditional Login/Register

  • Users can register with email/password
  • Passwords are hashed with bcrypt
  • JWT tokens are issued for authentication

Wallet Authentication

  • Users can connect their wallet
  • Challenge-response verification
  • Supports Ethereum-compatible wallets

📡 API Endpoints

Authentication

  • POST /api/auth/register - User registration
  • POST /api/auth/login - User login
  • GET /api/user/profile - Get user profile
  • GET /api/health - Server health status

Status

  • Smart contract deployment: Deployed (BlockDAG testnet integration)

  • Live demo: Coming soon

  • Demo video: [https://youtu.be/RXWu7r9pr6s]

  • Deployed contract address:

    [SessionLog.sol-0xeBE423bb8385cFF5fAD469464faB81a783ee244a]

    [PaymentEscrow.sol-0x969005435a2648e031Bf88F71d6DDA8D6a4E6DB3]

License

This project is licensed under the MIT License.

Support

For questions or issues:

  1. Check the documentation
  2. Review existing issues
  3. Create a new issue with details

Team

Happy coding with DAGVerse! 🚀

About

A full-stack Web3 application featuring smart contracts, a dedicated backend, and a frontend interface. Includes Dockerized setup for MongoDB and deployment workflows.

Resources

Readme

License

MIT license
Activity

Stars

2 stars

Watchers

0 watching

Forks

0 forks
Report repository

Releases

No releases published

Packages

 
 
 

Contributors

Languages