Skip to content

DhanteyUD/DeFiGuard

Repository files navigation

πŸ›‘οΈ DeFiGuard-2.0: Multi-Agent Risk Management System

Solana tag:innovationlab tag:hackathon Python License

AI-powered, multi-chain DeFi portfolio risk monitoring with autonomous agents

Monitor crypto portfolios across Solana + 12 EVM chains, analyze risks using SingularityNET MeTTa AI, detect fraud, and receive real-time alerts via ASI:One chat.


πŸ“‹ Table of Contents


πŸ†• Solana Integration

DeFiGuard now features comprehensive Solana blockchain support:

Solana Features

Feature Description
Wallet Monitoring Track SOL + all SPL token balances
Fraud Detection Solana-specific scam analysis
Mint Authority Check Detects tokens with active mint authority (rug risk)
Freeze Authority Check Warns when tokens can be frozen
RugCheck Integration Community-verified scam database
Jupiter Verification Confirms tokens on trusted lists
Holder Analysis Concentration risk for Solana tokens

Supported Solana Assets

  • Native: SOL
  • Stablecoins: USDC, USDT
  • DeFi: RAY, ORCA, JUP, MNDE, Jito
  • Liquid Staking: mSOL, jitoSOL
  • Meme Coins: BONK, WIF (flagged as high-risk)

✨ Key Features

Feature Chains Technology
βŒ• Multi-Chain Monitoring Solana + 12 EVM Native RPC integration
🧠 AI Risk Analysis All chains SingularityNET MeTTa
πŸ’¬ Chat Interface N/A ASI:One + ASI-1 model
🚨 Real-Time Alerts All chains Instant notifications
πŸ•΅οΈ Fraud Detection Solana + EVM GoPlus, RugCheck, Jupiter

πŸ—οΈ Architecture

β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚                  USER INTERFACE                    β”‚
β”‚                  (ASI:One Chat)                    β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
                       β”‚
                       β–Ό
              β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
              β”‚      Alert Agent       β”‚ ◄── Real-time Notifications
              β”‚    (Chat Protocol)     β”‚
              β””β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
                       β”‚
           β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”Όβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
           β–Ό           β–Ό           β–Ό          β–Ό
    β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β” β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
    β”‚Portfolio β”‚ β”‚   Risk   β”‚ β”‚ Market  β”‚ β”‚  Fraud   β”‚
    β”‚ Monitor  β”‚ β”‚ Analysis β”‚ β”‚  Data   β”‚ β”‚ Detectionβ”‚
    β”‚  Agent   β”‚ β”‚  Agent   β”‚ β”‚  Agent  β”‚ β”‚  Agent   β”‚
    β””β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”˜ β””β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”˜ β””β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”˜ β””β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”˜
         β”‚            β”‚            β”‚           β”‚
         β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
                             β”‚
              β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
              β”‚      Blockchain APIs        β”‚
              β”‚  β—Ž Solana RPC               β”‚
              β”‚  ⟠ EVM RPCs (12 chains)     β”‚
              β”‚  β‚Ώ CoinGecko                β”‚
              β”‚  βŒ• GoPlus / RugCheck        β”‚
              β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜

πŸš€ Quick Start

Prerequisites

python --version  # 3.10+

Installation

# Clone repository
git clone https://github.com/DhanteyUD/DeFiGuard.git
cd DeFiGuard

# Create virtual environment
python -m venv venv
source venv/bin/activate  # Mac/Linux
# venv\Scripts\activate   # Windows

# Install dependencies
pip install -r requirements.txt

# Configure environment
cp .env.example .env
# Add your AGENT_SEEDS

# Run tests
python tests/test_solana_integration.py

# Start all agents
python main.py

β—Ž Solana Usage

Register a Solana Wallet

Via ASI:One Chat:

register 9WzDXwBbmPdCBoccoc9Ra8JVoJLxp6YhHvCKioeNFfZY solana

Analyze a Solana Token

from uagents import Agent, Context, Model


class TokenAnalysisRequest(Model):
    token_address: str
    chain: str


# Request fraud analysis for a Solana token
request = TokenAnalysisRequest(
    token_address="DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263",  # BONK
    chain="solana"
)

await ctx.send(FRAUD_AGENT_ADDRESS, request)

Solana-Specific Risk Factors

Risk Factor Weight Description
Mint Authority Active 25% Can create unlimited tokens
Freeze Authority Active 30% Can freeze your tokens
Holder Concentration 25% Top holder owns >30%
Low Liquidity 20% Hard to exit position

πŸ“Š Risk Scoring Methodology

Formula

Risk Score = (Concentration Γ— 0.30) + (Volatility Γ— 0.35) + 
             (Asset Quality Γ— 0.20) + (Chain Diversity Γ— 0.15)

Solana Token Risk Levels

Risk Level Score Indicators
🟒 Safe 0-19 Verified, authority revoked
🟑 Low 20-39 Minor concerns
🟠 Medium 40-59 Multiple warnings
πŸ”΄ High 60-79 Significant red flags
⚫ Critical 80-100 Likely scam/rug pull

πŸ”— Supported Chains

Solana Ecosystem

  • β—Ž Solana Mainnet - Full SPL token support

EVM Chains (12)

  • Ethereum, BSC, Polygon, Arbitrum, Optimism
  • Avalanche, Base, Fantom, Gnosis
  • Moonbeam, Celo, Cronos

πŸ“š Documentation

Document Description
MeTTa Integration AI knowledge graph
Agent Docs Individual agent specs

πŸ› οΈ Technologies

Component Technology
Agent Framework Fetch.ai uAgents v0.22.10
AI Reasoning SingularityNET MeTTa
Solana solana-py, RugCheck API
EVM Web3.py, GoPlus API
Chat ASI:One Protocol
Language Python 3.12

πŸ† Recognition

  • πŸ₯‡ Colosseum Cypherpunk Hackathon Winner
  • 🎯 ASI Alliance Hackathon Participant

πŸ” Security

  • βœ… Read-only monitoring (no private keys)
  • βœ… ERC-55 + Base58 address validation
  • βœ… Rate limiting on all APIs
  • βœ… Error isolation across agents

πŸ“ž Contact


πŸ“„ License

MIT License - Open Source


Built with ❀️ by DhanteyUD

Protecting DeFi portfolios across Solana and beyond πŸ›‘οΈβ—Ž


Powered by ASI Alliance | Fetch.ai uAgents | SingularityNET MeTTa | Solana

About

Multi-Agent Risk Management System

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages