Skip to content

A comprehensive decentralized analytics platform for Hyro Protocol traders. Built on Solana, featuring real-time trading analytics, profit split calculations, and on-chain trader identity NFTs. Hyro Bot, Hyro Trading Bot etc

License

Notifications You must be signed in to change notification settings

lorine93s/hyro-protocol

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

2 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

HyroX Analytics

Empowering Hyro & Prop Traders with Real-Time Analytics, Profit Calculation, and On-Chain Identity Tools

๐ŸŽฏ Overview

HyroX Analytics is a comprehensive, decentralized analytics platform designed specifically for Hyro Protocol traders and prop trading firms. Built on Solana blockchain, it provides traders with powerful tools to track performance, calculate profit splits, and establish on-chain trading identitiesโ€”all while maintaining transparency and decentralization.

Why HyroX Analytics?

  • ๐Ÿ” Non-Custodial: Your data, your controlโ€”powered by Solana's decentralized infrastructure
  • ๐Ÿ“Š Real-Time Analytics: Track your trading performance with advanced metrics and visualizations
  • ๐Ÿ’ฐ Profit Calculator: Instantly calculate payouts and scaling eligibility
  • ๐ŸŽซ On-Chain Identity: Mint NFT badges that represent your trading achievements
  • โšก Lightning Fast: Built on Solana for speed and low transaction costs
  • ๐Ÿ”’ Transparent: All trading data verifiable on-chain

๐ŸŽฏ Mission

To democratize access to trading capital and analytics by providing a transparent, decentralized infrastructure that empowers traders, investors, and liquidity providers in the Hyro Protocol ecosystem.

โœจ Features

๐ŸŽฏ MVP (v1.0) - Core Features

1. User Management & Authentication

  • ๐Ÿ” Wallet-based login (Phantom Wallet integration)
  • ๐Ÿ“ง Optional email authentication
  • ๐Ÿ‘ค Trader profile creation and management
  • ๐Ÿ”— Exchange API connection (Bybit, Binance) for future auto-sync

2. Trading Journal & Analytics

  • ๐Ÿ“ Manual trade entry (date, pair, size, entry, exit, P/L)
  • ๐Ÿ“ค CSV import/export functionality
  • ๐Ÿ“Š Auto-calculated metrics:
    • Win rate percentage
    • Risk-reward ratio (RR)
    • Maximum daily drawdown
    • Average profit/loss per trade
    • Best and worst trading days
    • Profit factor
    • Sharpe ratio
  • ๐Ÿ“ˆ Interactive charts and dashboards
  • ๐Ÿ” Advanced filtering (date range, asset, strategy)

3. Profit Split & Scaling Calculator

  • ๐Ÿ’ต Input parameters:
    • Total profit made
    • Account size
    • Profit share percentage
    • Current scaling stage
  • ๐Ÿ“Š Output results:
    • Exact payout amount after fees
    • Next scaling level eligibility
    • Projected earnings at next stage
    • Tax breakdown (if applicable)
  • ๐Ÿ“„ Downloadable payout reports (PDF)

4. Unified Dashboard

  • ๐Ÿ“Š Summary statistics at a glance
  • ๐Ÿ“‹ Last 10 trades overview
  • ๐ŸŽฏ Current status (Challenge โ†’ Funded โ†’ Scaling)
  • โฑ๏ธ Payout countdown timer
  • ๐Ÿ“ˆ Performance trends visualization
  • ๐ŸŽจ Customizable widgets

๐Ÿš€ Phase 2 (v2.0) - Advanced Features

On-Chain Trader Identity

  • ๐ŸŽซ Mint "Trader NFT Badge" tied to Solana wallet
  • ๐Ÿ“Š Stores verified trading stats:
    • Win rate
    • Total profit
    • Account tier
    • Trading history hash
  • ๐Ÿ† Use for rankings, rewards, and access control
  • ๐Ÿ”„ Transferable and tradeable on secondary markets

Risk Compliance Monitor

  • โš ๏ธ Real-time risk limit tracking:
    • Daily maximum loss
    • Maximum position size
    • Leverage limits
    • Trading hour restrictions
  • ๐Ÿ”” Multi-channel alerts:
    • In-app notifications
    • Email alerts
    • Telegram bot integration
  • ๐Ÿ“Š Risk score calculation

Auto Trade Sync (Beta)

  • ๐Ÿ”„ Connect Bybit/Binance API for automatic trade import
  • ๐Ÿ” Secure API key management
  • โšก Real-time trade synchronization
  • ๐Ÿ“Š Historical data backfill

๐ŸŒŸ Phase 3 (v3.0) - Expansion & Growth

Copy-Trading Module

  • ๐Ÿ‘ฅ Traders share strategies publicly with NFT badge verification
  • ๐Ÿ”„ Followers mirror trades with customizable risk controls
  • ๐Ÿ’ฐ Performance-based fee structure
  • ๐Ÿ“Š Strategy performance leaderboard

Investor Dashboard

  • ๐Ÿ’ผ Investors stake USDC into trader vaults
  • ๐Ÿค– Smart contracts auto-distribute profits
  • ๐Ÿ“ˆ Portfolio performance tracking
  • ๐Ÿ” Trader discovery and filtering

๐Ÿ—๏ธ Tech Stack

Frontend

Backend

Blockchain

DevOps & Tools

๐Ÿ›๏ธ Architecture

โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
โ”‚                        Frontend Layer                        โ”‚
โ”‚  Next.js + Tailwind + ShadCN UI + Recharts                  โ”‚
โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
                       โ”‚
โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ–ผโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
โ”‚                      API Gateway Layer                      โ”‚
โ”‚              FastAPI / NestJS REST API                      โ”‚
โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
                       โ”‚
        โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ดโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
        โ”‚                             โ”‚
โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ–ผโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”          โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ–ผโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
โ”‚   Database     โ”‚          โ”‚   Solana Chain     โ”‚
โ”‚  Supabase /    โ”‚          โ”‚  Anchor Programs   โ”‚
โ”‚   MongoDB      โ”‚          โ”‚  NFT Minting       โ”‚
โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜          โ”‚  Smart Contracts   โ”‚
                             โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜

Key Components

  1. Frontend Application (Next.js)

    • Dashboard, Trading Journal, Calculator, Profile
    • Wallet connection and transaction signing
    • Real-time data visualization
  2. Backend API (FastAPI/NestJS)

    • Trade data CRUD operations
    • Analytics calculation engine
    • User authentication and authorization
    • Exchange API integration
  3. Solana Programs (Anchor)

    • Trader NFT Badge minting
    • On-chain identity verification
    • Future: Profit distribution contracts
  4. Database (Supabase/MongoDB)

    • User profiles and settings
    • Trade history
    • Analytics cache
    • API keys (encrypted)

๐Ÿš€ Getting Started

Prerequisites

  • Node.js 18+ and npm/yarn/pnpm
  • Rust 1.70+ (for Solana/Anchor development)
  • Solana CLI 1.16+
  • Anchor 0.28+
  • Phantom Wallet browser extension

Installation

  1. Clone the repository

    git clone https://github.com/yourusername/hyro-protocol.git
    cd hyro-protocol
  2. Install dependencies

    # Frontend
    cd frontend
    npm install
    
    # Backend
    cd ../backend
    pip install -r requirements.txt  # or npm install for NestJS
  3. Set up environment variables

    # Frontend (.env.local)
    NEXT_PUBLIC_SOLANA_NETWORK=devnet
    NEXT_PUBLIC_RPC_URL=https://api.devnet.solana.com
    NEXT_PUBLIC_PROGRAM_ID=your_program_id
    NEXT_PUBLIC_SUPABASE_URL=your_supabase_url
    NEXT_PUBLIC_SUPABASE_ANON_KEY=your_supabase_key
    
    # Backend (.env)
    DATABASE_URL=your_database_url
    JWT_SECRET=your_jwt_secret
    SOLANA_RPC_URL=your_rpc_url
  4. Set up Solana program

    cd programs/hyro-analytics
    anchor build
    anchor deploy
  5. Run development servers

    # Frontend (Terminal 1)
    cd frontend
    npm run dev
    
    # Backend (Terminal 2)
    cd backend
    npm run dev  # or uvicorn main:app --reload for FastAPI
  6. Open your browser

    http://localhost:3000
    

Development Workflow

  1. Connect your Phantom wallet (devnet)
  2. Create a trader profile
  3. Add some sample trades
  4. Explore the analytics dashboard
  5. Test the profit calculator

๐Ÿ“… Project Roadmap

โœ… Phase 1: MVP

  • Project setup and architecture
  • User authentication (Wallet + Email)
  • Trading journal (manual entry)
  • Basic analytics calculation
  • Profit split calculator
  • Dashboard UI

๐Ÿšง Phase 2: Advanced Features

  • Solana program development (Anchor)
  • Trader NFT Badge minting
  • Risk compliance monitor
  • Auto trade sync (API integration)
  • Advanced analytics and charts

๐Ÿ”ฎ Phase 3: Expansion

  • Copy-trading module
  • Investor dashboard
  • Smart contract profit distribution
  • Mobile app (React Native)
  • Public API for third-party integrations

๐Ÿ‘ฅ User Roles

Role Description Permissions
Trader Primary user - logs trades, views analytics, calculates payouts Full access to personal dashboard
Investor Allocates capital to traders (Phase 3) View trader performance, stake funds
Admin Manages platform settings and compliance Full system access

๐Ÿค Contributing

We welcome contributions! Please follow these steps:

  1. Fork the repository
  2. Create a feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add some amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

Contribution Guidelines

  • Follow the existing code style
  • Write meaningful commit messages
  • Add tests for new features
  • Update documentation as needed
  • Ensure all checks pass before submitting PR

๐Ÿ”— Links & Resources

Built with โค๏ธ for the Hyro Protocol community

โญ Star this repo if you find it helpful!

About

A comprehensive decentralized analytics platform for Hyro Protocol traders. Built on Solana, featuring real-time trading analytics, profit split calculations, and on-chain trader identity NFTs. Hyro Bot, Hyro Trading Bot etc

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published