Starknet-Indemnify Risk Analytics

The Starknet-Indemnify Risk Analytics is a Django-powered microservice that provides AI-driven risk assessment for DeFi insurance underwriting. Running on port 5001, it analyzes on-chain and off-chain data to calculate insurance premiums and detect fraudulent claims.

---

🔗 API Documentation

View Swagger Docs | Risk Model Docs

---

✨ Risk Analytics Features

• Underwriting Intelligence:
  • 🧠 ML-powered risk scoring (XGBoost/Neural Nets)
  • 📉 Historical claim probability analysis
  • 🕵️‍♂️ Sybil attack detection
• Data Processing:
  • On-chain behavior analysis (StarkNet L2)
  • Off-chain KYC data correlation
  • Real-time oracle feeds processing
• Visualization:
  • Risk heatmaps for insurance pools
  • Claim prediction dashboards

---

🛠️ Tech Stack

Component	Technology
Framework	Django 4.2 + DRF
Machine Learning	PyTorch + XGBoost
Blockchain Data	StarkNet.py
Database	PostgreSQL + TimescaleDB
Visualization	Plotly Dash

---

🚀 Quick Start

Prerequisites

• Python 3.10+
• PostgreSQL 15+ with TimescaleDB
• CUDA 11.7+ (for GPU acceleration)
• Starknet full node access

Installation

1. Clone the repo:

   git clone https://github.com/CRYPTOInsured-Foundation/starknet-indemnify-risk-analytics.git
   cd starknet-indemnify-risk-analytics

2. Setup virtual environment:

   python -m venv ven
   source venv/ven/bin/activate  # Linux/Mac
   workon ven    # Windows

3. Install dependencies:

   pip install -r requirements.txt

4. Configure environment:

   cp .env.example .env

5. Run migrations:

   python manage.py migrate

6. Start the service:

   python manage.py runserver 5001

🤝 Contributing

1. Fork the repository
2. Create your feature branch:

git checkout -b feat/your-feature

3. Commit changes following Conventional Commits
4. Push to the branch
5. Open a Pull Request