Skip to content

README.md

Latest commit

 

History

History
85 lines (62 loc) · 3.94 KB

README.md

File metadata and controls

85 lines (62 loc) · 3.94 KB
Raw

🔮 V-Oracle: Decentralized AI Market Predictions

OpenGradient License: MIT React Python

V-Oracle is a state-of-the-art decentralized application (dApp) that provides real-time AI-powered market predictions. Built on the OpenGradient Testnet, it leverages on-chain AI inference to provide cryptographically verifiable market sentiment analysis.

V-Oracle UI Screenshot Placeholder

🌟 Key Features

  • 🧠 On-Chain AI Inference: Predictions are executed and verified on the OpenGradient network using TEE (Trusted Execution Environments).
  • 📊 110+ Trading Pairs: Real-time OHLC data for a vast selection of tokens directly from Binance.
  • 🔗 Web3 Native: Seamless integration with MetaMask and other EIP-1193 wallets.
  • ⚡ Verifiable Proofs: Every prediction generates an on-chain transaction hash for transparency.
  • 🎨 Premium Cyber-Obsidian UI: High-end glassmorphism design with kinetic animations and modern aesthetics.
  • 📱 Fully Responsive: Optimized experience for both desktop and mobile users.
  • ✍️ Gasless Signatures: Users only need to sign a free message for authentication; the backend handles the gas fees for the AI execution.

⚙️ How It Works

  1. Authentication: Users sign a free digital signature to verify wallet ownership.
  2. Data Fetching: The dApp retrieves the latest market data (OHLC) for the selected asset and timeframe.
  3. AI Inference: The backend sends the data to the OpenGradient SDK, which runs the prediction using the og-1hr-volatility model.
  4. On-Chain Verification: The prediction result is recorded on the OpenGradient Testnet.
  5. Real-Time Result: The dApp displays the AI sentiment (Bullish/Bearish) along with a direct link to the transaction proof.

🛠 Tech Stack

Layer Technology
Frontend React 18, Vite, CSS3 (Vanilla), lightweight-charts
Backend Python (Serverless Functions), OpenGradient SDK
AI Model og-1hr-volatility-ethusdt
Blockchain OpenGradient Testnet (Chain ID: 10744)
Data Provider Binance API (WebSockets & REST)

🚀 Deployment & Installation

Local Development

  1. Clone the repository:

    git clone https://github.com/iAbstrus/Voracle-OpenGradient.git
cd Voracle-OpenGradient

  2. Frontend Setup:

    cd frontend
npm install
npm run dev

  3. Backend Setup: Ensure you have Python 3.9+ installed.

    pip install opengradient numpy firebase-rest-api

Environment Variables

To run the full prediction feature, configure the following environment variables in your deployment environment (e.g., Vercel):

  • OG_PRIVATE_KEY: Your OpenGradient wallet private key.
  • OG_EMAIL: OpenGradient ModelHub email.
  • OG_PASSWORD: OpenGradient ModelHub password.
  • OG_MODEL_CID: Model CID (default: OpenGradient/og-1hr-volatility-ethusdt).
  • FIREBASE_API_KEY: Required by the OpenGradient SDK for authentication.

🔗 Links

📜 License

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

Built with 🔮 for the OpenGradient community.