🛡️ Sentinel Oracle

AI-Powered, Privacy-Preserving Oracle Layer

Detecting anomalies in real-time price feeds and automating secure DeFi actions through decentralized infrastructure.

🔗 Quick Links

🤖 Live Agent: SentinelAI on Agentverse
📜 Smart Contract: 0x4c299a...dbFB0 on Sepolia
🎥 Demo Video: demo
📊 Dashboard: https://sentinel-oracle.vercel.app/
Vincent Published Ability: package
Vincent Published App ID: 8497142216

📖 Overview

Sentinel Oracle is an intelligent oracle system that combines:

🔗 Pyth Network - Real-time, accurate price feeds via Pull Oracle
🤖 ASI Alliance - AI-powered anomaly detection using uAgent + MeTTa reasoning
🔐 Lit Protocol / Vincent - Privacy-preserving automated execution

The Problem

DeFi protocols depend on oracles for critical pricing data. However, oracles can be:

Manipulated (flash loan attacks, MEV)
Delayed (network congestion)
Temporarily incorrect (API failures)

This leads to cascading liquidations and financial losses.

The Solution

Sentinel Oracle continuously monitors price feeds, detects anomalies using AI, and executes privacy-preserving automations to protect user positions.

Example Flow:

1. BTC price drops 10% in 2 minutes ⚠️
2. AI agent detects anomaly (z-score > 2.5) 🤖
3. Lit Protocol decrypts user's private trigger 🔓
4. Vincent executes stop-loss automatically ⚡
5. User's position is protected 🛡️

🏗️ Architecture

┌────────────────────────────┐
│      Pyth Network          │
│  (Hermes API → On-chain)   │
└─────────────┬──────────────┘
              │
              ▼
┌────────────────────────────┐
│   ASI Sentinel uAgent      │
│   - Fetch prices           │
│   - MeTTa reasoning        │
│   - Detect anomalies       │
│   - Flag on-chain          │
└─────────────┬──────────────┘
              │
              ▼
┌────────────────────────────┐
│  SentinelOracle.sol        │
│  - Store prices            │
│  - Manage deposits         │
│  - Trigger events          │
└─────────────┬──────────────┘
              │
              ▼
┌────────────────────────────┐
│  Vincent App (Lit Layer)   │
│  - StopLossAbility         │
│  - Encrypted triggers      │
│  - Automated execution     │
└─────────────┬──────────────┘
              │
              ▼
┌────────────────────────────┐
│   Frontend Dashboard       │
│   - Live prices            │
│   - Agent chat             │
│   - User controls          │
└────────────────────────────┘

🚀 Quick Start

Prerequisites

Node.js 18+ and npm
Python 3.9+
MetaMask or compatible Web3 wallet
Testnet ETH (Sepolia)

Installation

# Clone the repository
git clone https://github.com/YOUR_USERNAME/sentinel-oracle.git
cd sentinel-oracle

# Install contract dependencies
cd contracts
npm install
cp .env.example .env
# Edit .env with your keys

# Install agent dependencies
cd ../agent
python3 -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate
pip install -r requirements.txt
cp .env.example .env
# Edit .env with your keys

# Install frontend dependencies
cd ../frontend
npm install
cp .env.local.example .env.local
# Edit .env.local with your settings

# Install Lit/Vincent dependencies
cd ../lit_vincent
npm install

📦 Deployment

1. Deploy Smart Contract

cd contracts

# Compile
npx hardhat compile

# Deploy to Sepolia
npx hardhat run scripts/deploy.js --network sepolia

# Note the deployed contract address
# Update .env files in agent/ and frontend/

2. Start Price Pusher

cd contracts

# Start pushing prices (keep running)
node scripts/updatePythPrice.js

3. Start AI Agent

cd agent

# Activate virtual environment
source venv/bin/activate

# Start the agent (keep running)
python agent.py

# In another terminal, start API server
python api_server.py

4. Start Frontend

cd frontend

# Development mode
npm run dev

# Visit http://localhost:3000

🔵 Pyth Network

Most innovative use of Pyth Pull Oracle

✅ What we implemented:

Fetch price data via Hermes API
Update on-chain using Pull Oracle method
Use prices as base layer for anomaly detection
Innovative security use case (not just price display)

📍 Contract: SentinelOracle.sol - Deployed at 0x4c299a5c75Fd195e3418Daea67116Fd742adbFB0 📍 Script: contracts/scripts/updatePythPricePull.js - Hermes Pull Oracle integration 📍 Innovation: AI-powered anomaly detection on multi-asset Pyth feeds 📍 Network: Sepolia Testnet - View on Etherscan

🟣 Lit Protocol / Vincent

DeFi automation with Vincent App

✅ What we implemented:

Vincent App with StopLossAbility
Accepts user deposits on-chain
Encrypts user trigger conditions with Lit
Automated transaction execution when conditions met

📍 App: lit_vincent/vincent_ability.js 📍 Encryption: lit_vincent/lit_client.js 📍 Contract: SentinelOracle.sol - executeAction()

🟢 ASI Alliance

uAgent + MeTTa + ASI:One

✅ What we implemented:

Official uAgent with real-time anomaly detection (registered on Agentverse)
MeTTa knowledge graphs for explainable AI reasoning
ASI:One Chat Protocol for human-agent interaction
Multi-asset monitoring (5 cryptocurrencies: BTC, ETH, SOL, AVAX, MATIC)
Real-world impact: DeFi oracle security and automated protection

📍 Agent: agent/uagent_sentinel.py (Official uAgent) 📍 Reasoning: MeTTaReasoner class with MeTTa knowledge graphs 📍 Chat: ASI:One protocol via Agentverse 📍 Agentverse: https://agentverse.ai/agents/sentinelai-oracle

🎬 Demo

Running the Demo

# 1. Ensure all services are running:
#    - Price pusher
#    - AI agent
#    - API server
#    - Frontend

# 2. Open frontend in browser
open http://localhost:3000

# 3. Connect your wallet

# 4. In a new terminal, simulate an anomaly:
cd contracts
node scripts/simulate-anomaly.js

# 5. Watch the agent detect the anomaly
# 6. See the anomaly alert in the frontend
# 7. Chat with the agent to get explanations

Demo Video

🎥 [Link to demo video] (to be added)

What the demo shows:

Multi-asset dashboard - Live price feeds from Pyth Network (5 assets)
User deposits funds and sets encrypted stop-loss trigger
ASI:One Chat - Interact with the AI agent via Agentverse
Anomaly simulation - 10% price drop triggered
AI detection - Agent detects and flags anomaly on-chain
MeTTa reasoning - Explainable AI knowledge graph output
Lit + Vincent execution - Automated protective action
User position protected - Transaction completed

🧪 Testing

Contract Tests

cd contracts
npx hardhat test

Agent Tests

cd agent
python -m pytest tests/

Integration Test

# Run full integration test
./scripts/integration-test.sh

📚 Documentation

Key Files

Contracts: contracts/contracts/SentinelOracle.sol
Agent: agent/agent.py
Frontend: frontend/app/page.js
Lit/Vincent: lit_vincent/

API Endpoints

Agent API (http://localhost:5000)

GET /api/status - Get agent status
GET /api/price-history - Get price history
POST /api/chat - Chat with agent

🏆 Hackathon Deliverables

✅ Completed

📋 Submission Checklist

🔧 Configuration

Environment Variables

Contracts (.env):

SEPOLIA_RPC_URL=https://sepolia.infura.io/v3/YOUR_KEY
PRIVATE_KEY=your_private_key
SENTINEL_ORACLE_ADDRESS=0x...

Agent (.env):

ETH_RPC_URL=https://sepolia.infura.io/v3/YOUR_KEY
SENTINEL_ORACLE_ADDRESS=0x...
AGENT_PRIVATE_KEY=your_agent_key
ANOMALY_THRESHOLD=2.5

Frontend (.env.local):

NEXT_PUBLIC_ORACLE_ADDRESS=0x...
NEXT_PUBLIC_RPC_URL=https://sepolia.infura.io/v3/YOUR_KEY
NEXT_PUBLIC_AGENT_API_URL=http://localhost:5000

🛠️ Technology Stack

Component	Technology
Smart Contracts	Solidity 0.8.20, Hardhat
Blockchain	Ethereum Sepolia Testnet
Oracle	Pyth Network (Pull Model)
AI Agent	Python, uAgents, MeTTa
Encryption	Lit Protocol
Automation	Vincent Framework
Frontend	Next.js 14, React, Tailwind CSS
Charts	Recharts
Web3	Ethers.js v6

🚧 Production Considerations

For production deployment, consider:

Security Audits - Smart contract audit required
Multi-sig - Use multi-sig for Vincent executor
Rate Limiting - Implement cooldowns and gas management
Monitoring - Set up The Graph or event monitoring
IPFS - Store encrypted triggers on IPFS
Backup Executors - Implement fallback executors
Gas Optimization - Optimize contract calls
Real Pyth Integration - Use full updatePriceFeeds(bytes[]) method

🤝 Contributing

This is a hackathon project. For improvements or issues:

Fork the repository
Create a feature branch
Commit your changes
Push to the branch
Open a Pull Request

📄 License

MIT License - see LICENSE file for details

🙏 Acknowledgments

Pyth Network - For reliable price feeds
ASI Alliance / Fetch.ai - For uAgent framework
Lit Protocol - For encryption and programmable signing
Vincent - For DeFi automation framework

Sentinel Oracle is unique because it:

Solves a real problem - Oracle manipulation and DeFi liquidations
Integrates 3 ecosystems - Pyth + ASI + Lit working together
Privacy-first - User triggers remain encrypted until execution
AI-powered - Real reasoning with explainability (MeTTa)
Production-ready foundation - Clear path to mainnet deployment

We're not just building a demo — we're building the foundation for the next generation of secure, AI-driven DeFi infrastructure.

Built with ❤️ for the hackathon

Name		Name	Last commit message	Last commit date
Latest commit History 17 Commits
agent		agent
contracts		contracts
frontend		frontend
lit_vincent		lit_vincent
.gitignore		.gitignore
LICENSE		LICENSE
README.md		README.md
test_multi_asset.py		test_multi_asset.py

Folders and files

Latest commit

History

Repository files navigation

🛡️ Sentinel Oracle

🔗 Quick Links

📖 Overview

The Problem

The Solution

🏗️ Architecture

🚀 Quick Start

Prerequisites

Installation

📦 Deployment

1. Deploy Smart Contract

2. Start Price Pusher

3. Start AI Agent

4. Start Frontend

🔵 Pyth Network

🟣 Lit Protocol / Vincent

🟢 ASI Alliance

🎬 Demo

Running the Demo

Demo Video

🧪 Testing

Contract Tests

Agent Tests

Integration Test

📚 Documentation

Key Files

API Endpoints

🏆 Hackathon Deliverables

✅ Completed

📋 Submission Checklist

🔧 Configuration

Environment Variables

🛠️ Technology Stack

🚧 Production Considerations

🤝 Contributing

📄 License

🙏 Acknowledgments

About

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages