JudgeChain (Dev3pack Top 6 Global and Top 1 Asia Project)

🏆 Top 6 Global & Top 1 Asia - International Dev3pack Hackathon

This project was officially developed as a submission for the International Dev3pack Hackathon and proudly achieved the Top 6 Global and Top 1 Asia tier.

---

📖 Overview

JudgeChain is an innovative Web3 platform that transforms the complex evaluation of crypto assets into a simulated, interactive courtroom debate. By merging live on-chain intelligence with AI-driven narrative modeling, JudgeChain creates a "Mirofish Style Court" where AI judges and public sentiment swarms argue the merits, risks, and narratives of Solana tokens and wallets. The final verdict is securely published to the Solana blockchain, ensuring an immutable record of the assessment.

⚠️ Problem Statement

In the rapidly moving Web3 ecosystem, evaluating a token's legitimacy, market sentiment, and underlying risk is incredibly challenging. Investors and analysts are often forced to manually cross-reference obscure on-chain metrics (such as holder concentration, liquidity depth, and whale movements) with chaotic, rapidly shifting social media narratives. There is currently no unified, objective framework that balances deep technical analysis with the "public chaos" of market sentiment, leading to uninformed decisions and susceptibility to manipulation.

💡 Solution

JudgeChain bridges this gap by providing a gamified yet highly analytical Courtroom Simulation. The architecture ingests raw Solana RPC data (mint authorities, tokenomics, DEX flows) alongside simulated public opinion to fuel an AI debate.

• Technical Analysis (Whale Movement): Evaluates hard data like top 10 holder concentration and liquidity ratios.
• Narrative Analysis (Public Chaos): Weighs bullish/bearish public sentiment and memetic strength.

By running these factors through a multi-round debate (First Impression, Parallel World, Cross-Examination, Final Verdict), the system distills complex data into an actionable, easy-to-understand verdict. Finally, it acts as an oracle of truth by hashing and publishing the report directly to the Solana Devnet.

✨ Key Features

• Cinematic Courtroom Interface: A highly polished, interactive UI utilizing Framer Motion to visualize debates between Bull and Bear benches.
• Dual Interpretation Engine: Seamlessly toggle between "Technical Onchain Context" and "Live Narrative Focus" to see how different perspectives alter the verdict.
• Real-Time On-Chain Integration: Connects directly to Solana RPCs to fetch real-time tokenomics, liquidity stats, and DEX flow.
• Dynamic Swarm Visualization: Uses interactive particle boards to represent public sentiment and argument intake visually.
• Ledger Accountability: Hashes the final debate, score, and verdict, publishing the immutable proof to the Solana blockchain.

🛠 Tech Stack

Frontend:

• React 19 & TypeScript
• Vite
• Tailwind CSS & Framer Motion
• Recharts (for data visualization)

Web3 & Blockchain:

• @solana/web3.js
• @solana/wallet-adapter-react

Backend / API:

• Rust (Custom JudgeChain API worker)

🚀 Getting Started

Follow these steps to set up the project locally.

Prerequisites

• Node.js (v18+ recommended)
• Rust & Cargo (for the backend API)
• A Solana Wallet (e.g., Phantom) for testing Devnet transactions

Installation

1. Clone the repository:

   git clone https://github.com/yourusername/judgechain.git
   cd judgechain

2. Install frontend dependencies:

   npm install

3. Start the Frontend Development Server:

   npm run dev

4. Start the Rust Backend API:

   npm run api:dev

Open http://localhost:5173 to view it in the browser and start presiding over your first on-chain case!