OrcaSignal - Whale Influence & Market Manipulation Intelligence

Advanced whale influence and market manipulation intelligence platform for Web3 traders

🚀 Live Demo • 📖 Documentation • 🔗 Smart Contract

🌟 Features

• 🐋 Whale Influence Scoring - Analyze token concentration and whale wallet distribution
• 📊 Manipulation Risk Assessment - AI-powered risk scoring for market manipulation detection
• ⚡ Pump/Dump Forecasting - Short-term probability analysis based on whale activity
• 🔔 Real-time Alerts - Whale movement notifications and accumulation signals
• 📈 Professional Dashboard - Trading-grade interface with advanced charts
• 🔗 Blockchain Integration - Smart contracts deployed on Monad testnet
• 💎 $ORCA Token Utility - Premium features and governance (coming soon)

🎯 Quick Start

One-Command Setup

git clone https://github.com/yourusername/OrcaSignal.git
cd OrcaSignal
node setup.js
npm run dev

Access Points

• Frontend: http://localhost:5173
• Backend API: http://localhost:3001
• Smart Contract: 0xd29726CC70C53B0Af8c5B2E5A3CF11C2dFe0892B

🏗️ Architecture

OrcaSignal/
├── frontend/           # React + Vite + TailwindCSS
├── backend/            # Node.js + Express API  
├── contracts/          # Solidity + Foundry
└── docs/              # Documentation

Tech Stack

• Frontend: React, Vite, TailwindCSS, Recharts, Wagmi
• Backend: Node.js, Express, RESTful API
• Blockchain: Solidity, Foundry, OpenZeppelin
• Network: Monad Testnet (Chain ID: 41454)

🚀 Demo Flow

1. Paste any token address (e.g., 0xA0b86a33E6441b8435b662303c0f479c7e1d5916)
2. Get instant analytics - Whale influence, manipulation risk, pump probability
3. Connect MetaMask to Monad testnet
4. Store results on-chain - Permanent blockchain record
5. Explore leaderboards - Most manipulated vs safest tokens
6. Monitor alerts - Real-time whale movement notifications

🔧 Development

Prerequisites

• Node.js 18+
• MetaMask wallet
• Foundry (optional, for contract development)

Installation

# Clone repository
git clone https://github.com/yourusername/OrcaSignal.git
cd OrcaSignal

# Quick setup
node setup.js

# Or manual setup
npm run install:all

Running Services

# Start all services
npm run dev

# Individual services
npm run dev:frontend    # Frontend only
npm run dev:backend     # Backend only

Testing

npm run test           # All tests
npm run test:backend   # Backend tests
npm run test:contracts # Contract tests

🔗 Smart Contract

Deployed Contract

• Address: 0xd29726CC70C53B0Af8c5B2E5A3CF11C2dFe0892B
• Network: Monad Testnet
• Explorer: View on Explorer

Key Functions

// Store whale analytics on-chain
function submitAnalytics(
    address tokenAddress,
    uint8 whaleInfluenceScore,
    uint8 manipulationRiskScore, 
    uint8 pumpProbability
) external

// Retrieve stored analytics
function getAnalytics(address tokenAddress) 
    external view returns (TokenAnalytics memory)

// Get all tracked tokens
function getTrackedTokens() 
    external view returns (address[] memory)

📊 API Endpoints

Analytics

• GET /api/scan?address=TOKEN_ADDRESS - Analyze token
• POST /api/scan/batch - Batch analyze multiple tokens
• GET /api/analytics/history?address=TOKEN_ADDRESS - Historical data

Leaderboard

• GET /api/leaderboard?type=all&limit=10 - Token rankings
• GET /api/leaderboard/trending?limit=5 - Trending tokens
• GET /api/leaderboard/stats - Platform statistics

Alerts

• GET /api/alerts?type=all&limit=20 - Whale alerts
• POST /api/alerts/subscribe - Subscribe to alerts

🌐 Deployment

Frontend (Vercel/Netlify)

cd frontend
npm run build
# Deploy dist/ folder

Backend (Railway/Render)

cd backend  
npm start

Smart Contracts (Monad)

cd contracts
npm run deploy:monad

See DEPLOYMENT.md for detailed deployment instructions.

🎯 Roadmap

Phase 1: Foundation ✅

• Core analytics engine
• Professional UI/UX
• Smart contract deployment
• Monad integration

Phase 2: Real Data 🚧

• Live blockchain data integration
• Advanced ML models
• Multi-chain support
• WebSocket real-time updates

Phase 3: Token Utility 🔮

• $ORCA token launch
• Premium features
• Governance system
• Revenue sharing

Phase 4: Enterprise 🌟

• Institutional API
• Advanced analytics
• Custom alerts
• White-label solutions

🤝 Contributing

We welcome contributions! Please see CONTRIBUTING.md for guidelines.

Development Setup

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

📄 License

This project is licensed under the MIT License - see LICENSE file for details.

🙏 Acknowledgments

• Monad - For the high-performance blockchain infrastructure
• OpenZeppelin - For secure smart contract libraries
• Recharts - For beautiful data visualization
• TailwindCSS - For the modern UI framework

📞 Contact

• Website: https://orcasignal.com
• Twitter: @OrcaSignal
• Discord: Join Community
• Email: team@orcasignal.com

---

Built with ❤️ for the Web3 community

⭐ Star this repo • 🐛 Report Bug • 💡 Request Feature