MinitQ

MinitQ is a full-stack web application that combines traditional quiz gameplay with blockchain rewards. Built using FastAPI for the backend and vanilla JavaScript for the frontend, it demonstrates the integration of Web3 functionality using the Coinbase Developer Platform (CDP).

Core Features:

1. Quiz Mechanics: Multiple-choice questions, Score tracking, Interactive web interface, Persistent leaderboard system

2. Web3 Integration: Custom ERC20 token (MNTQ) for rewards, Smart contract integration for token minting, Automated reward distribution (10 MNTQ tokens per correct answer), Token contract deployed at 0xc90278252098de206ae85A4cb879123d50a05456 on base sepolia

3. Architecture: Frontend: HTML5, CSS3, and vanilla JavaScript, Backend: FastAPI (Python), Database: Replit DB for leaderboard storage, Blockchain: CDP SDK for Web3 interactions, AI Agent: Custom TokenAgent for reward distribution,

4. User Flow: User input their Web3 wallet address, Answers 5 themed questions, Receives MNTQ tokens based on performance, Views their position on the global leaderboard, Option to play again

5. Technical Features: Asynchronous API endpoints, Secure token minting system, Real-time score updates, Optimized smart contract interactions, Automated reward calculations, Persistent leaderboard rankings, Clean separation of concerns (MVC pattern),

The project serves as an example of how traditional web applications can be enhanced with Web3 and AI Agent functionalities, providing both entertainment and rewards for user participation. The modular architecture allows for easy expansion of both quiz content and reward mechanisms.

Future Works

1. Quiz theme and questions generations using AI Agents
2. Wallet Connection and Management features in the frontend
3. Enhance UI/UX
4. Conduct live events using AI Agents

Built using FastAPI for the backend and vanilla JavaScript for the frontend. The game features a persistent leaderboard system using Replit's DB, real-time score tracking, and automated token distribution through smart contracts deployed at 0xc90278252098de206ae85A4cb879123d50a05456 on Base Sepolia. The integration with Coinbase Developer Platform (CDP) enables secure wallet validation and token minting, while the modular architecture allows for easy expansion of both quiz content and reward mechanisms.

Key Components:

1. Core Game Engine (game.py): Implements QuizGame class managing game logic, Handles question management and scoring, Manages reward calculations (10 MNTQ tokens per correct answer)

2. Token System (token_agent.py): Custom TokenAgent class for MNTQ token management, Deployed ERC20 contract at 0xc90278252098de206ae85A4cb879123d50a05456, Uses CDP SDK for smart contract interactions, Handles token minting and distribution,

3. API Layer (app.py): FastAPI routes for game interactions, /api/questions endpoint serves quiz content, /api/submit handles answer validation, /api/finish processes game completion and rewards, Static file serving for frontend assets

4. Frontend (static/): Responsive single-page application, Dynamic question rendering, Leaderboard display, Wallet integration

5. CDP Integration: Used CDP SDK for wallet management, CDP AgentKit for smart contract interaction and token minting capabilities,

6. Technical Innovations: Automated reward distribution using AI Agents and smart contracts, Real-time leaderboard updates via Replit DB, Secure wallet validation through CDP, Efficient token minting process, Serverless architecture leveraging Replit's infrastructure