Welcome to HUNCH

Overview

HUNCH is a decentralized prediction markets platform built on CHIPS and compatible EVM blockchains. It enables users to create, trade, and resolve prediction markets on any topic, from sports and politics to cryptocurrency prices and world events.

Fee Schedule

  • On Trade: 1% fee deducted from your trade amount

  • On Earnings or Losses: 0% fee deducted from payout

  • On Market Creation: Creators earn a 1% fee on every trade placed in the markets they launch

Key Features

  • Binary and Multi-Choice Markets: Support for both simple Yes/No markets and complex multi-option markets

  • Automated Market Maker (AMM): Dynamic pricing based on supply and demand

  • Web3 Integration: Full blockchain integration with MetaMask and WalletConnect

  • Real-time Trading: Live price updates and instant trade execution

  • Oracle Resolution: Decentralized market resolution system

  • Cross-Chain Support: Ethereum, Polygon, and testnets

  • User Portfolio: Track positions, P&L, and trading history

  • Gamification: Badges, leaderboards, and achievement system

Technology Stack

Frontend

  • React 18 with TypeScript

  • Vite for fast development and building

  • Tailwind CSS for styling

  • shadcn/ui component library

  • Wagmi for Web3 integration

  • React Query for state management

Backend

  • Supabase for database and backend services

  • PostgreSQL for data storage

  • Edge Functions for serverless computation

Blockchain

  • Solidity smart contracts

  • Hardhat for development and deployment

  • OpenZeppelin for security standards

  • Ethers.js for blockchain interaction

Architecture

┌─────────────────┐    ┌──────────────────┐    ┌─────────────────┐
│   Frontend      │    │    Backend       │    │   Blockchain    │
│   (React)       │◄──►│   (Supabase)     │◄──►│ (Smart Contracts)│
│                 │    │                  │    │                 │
│ • Trading UI    │    │ • Database       │    │ • MarketFactory │
│ • Market Views  │    │ • Auth           │    │ • Market        │
│ • Wallet        │    │ • API            │    │ • Oracle        │
│ • Portfolio     │    │ • Edge Functions │    │ • MultiOption   │
└─────────────────┘    └──────────────────┘    └─────────────────┘

Quick Start

Prerequisites

  • Node.js 18+ and npm

  • MetaMask or compatible Web3 wallet

  • Git

Installation

git clone <repository-url>
cd hunch
npm install
npm run dev

Environment Setup

cp .env.example .env.local
# Add your configuration values

Documentation Structure

Community

License

MIT License

NextHUNCH API Reference

Last updated