Built with Hardhat 3 Beta & Next.js 15 - The Future of DeFi Protection

DeFi Guardians is competing in multiple tracks:

• 🔗 Chainlink CCIP Best Usage ($6,000) - Revolutionary cross-chain insurance using CCIP for seamless Sepolia ↔ Hedera communication
• 🚀 PYUSD Most Innovative Payment ($3,500) - Novel cross-chain insurance premium splitting and claim payout automation
• 👷 Hardhat 3 Best Projects ($5,000) - Built entirely with Hardhat 3 Beta featuring 154 comprehensive tests, lightning-fast compilation, cross-chain deployment capabilities, and modern TypeScript integration demonstrating the full potential of next-generation Solidity development
• 🏛️ Hedera EVM Smart Contracts ($3,500) - Advanced smart contract deployment with CCIP enabled.
• 💼 Dynamic Best Financial App ($3,333) - Seamless DeFi insurance platform with embedded wallet infrastructure
• 🤖 Nora AI Coding Best Use ($5,000) - Advanced AI-assisted Solidity development and optimization

DeFi Guardians is a revolutionary cross-chain decentralized insurance protocol that protects DeFi users from smart contract exploits, rug pulls, and protocol failures. This comprehensive solution combines robust smart contracts with an intuitive web interface, demonstrating the full power of next-generation blockchain development.

• 🔗 Cross-Chain Architecture: Seamless operation between Sepolia (Sepolia) and Hedera Testnet using Chainlink CCIP
• 💰 Liquidity Provider Rewards: 70% of premiums distributed to LPs, 30% reserved for claims
• 🗳️ Decentralized Governance: LP-based voting system for claim validation
• 🌐 Modern Web Interface: Built with Next.js 15, TypeScript, and Tailwind CSS
• 📱 Mobile-First Design: Responsive interface optimized for all devices
• 🔐 Dynamic Wallet Integration: Embedded wallet infrastructure with seamless user onboarding
• 💼 One-Click Financial Operations: Simplified PYUSD insurance purchases and claim processing
• ⚡ Real-Time Updates: Live dashboard with policy status and claim tracking

┌─────────────────┐    CCIP     ┌─────────────────┐
│   Sepolia       │◄────────────►│     Hedera      │
│                 │              │                 │
│ • PremiumVault  │              │ • PolicyManager │
│ • LPVault       │              │ • ClaimManager  │
│ • PayoutVault   │              │ • VotingMirror  │
└─────────────────┘              └─────────────────┘

┌─────────────────────────────────────────┐
│              Next.js App                │
├─────────────────────────────────────────┤
│ • Hero Section & Navigation             │
│ • Coverage Purchase Widget              │
│ • User Dashboard                        │
│ • Governance Interface                  │
│ • Real-time Analytics                   │
└─────────────────────────────────────────┘

• Node.js 18+
• pnpm (recommended) or npm
• Git
• MetaMask or compatible wallet

# Clone the repository
git clone https://github.com/your-username/defi-guardians.git
cd defi-guardians

# Install dependencies
pnpm install

# Add contracts submodule
git submodule add https://github.com/gokulnpc/Defi-Guardian-Contracts.git contracts-repo
git submodule update --init --recursive

# Set up environment variables
cp .env.example .env.local
# Edit .env.local with your configuration

# Start the development server
pnpm dev

# In another terminal, compile smart contracts
pnpm compile

# Run tests
pnpm test

# Run specific test file
pnpm test:simple

# Deploy to Sepolia Sepolia
pnpm deploy:sepolia

# Deploy to Hedera Testnet
pnpm deploy:hedera

# Verify contracts
pnpm verify:all

sequenceDiagram
    participant User
    participant PremiumVault
    participant CCIP
    participant PolicyManager

    User->>PremiumVault: buyCoverage()
    PremiumVault->>PremiumVault: Split premium 70/30
    PremiumVault->>CCIP: Send policy data
    CCIP->>PolicyManager: Receive policy data
    PolicyManager->>User: Mint Policy NFT

sequenceDiagram
    participant User
    participant ClaimManager
    participant VotingMirror
    participant CCIP
    participant PayoutVault

    User->>ClaimManager: openClaim()
    ClaimManager->>VotingMirror: Get LP voting power
    Note over ClaimManager: 5-minute voting period
    ClaimManager->>CCIP: Send payout instruction
    CCIP->>PayoutVault: Process payout
    PayoutVault->>User: Transfer funds

• 🏠 Hero Section: Animated landing page with protocol overview
• 💳 Coverage Widget: Simplified insurance purchase interface
• 📊 Dashboard: Personal policy management and analytics
• 🗳️ Governance: LP voting interface for claims
• 🔄 Real-time Updates: Live status tracking and notifications

• 🎨 Modern UI: Built with Radix UI components and Tailwind CSS
• 🌙 Dark/Light Mode: Theme switching with next-themes
• 📱 Responsive Design: Mobile-first approach with fluid layouts
• ♿ Accessibility: WCAG compliant with keyboard navigation
• ⚡ Performance: Optimized with Next.js 15 app router

# Run all tests
pnpm test

# Run specific test suites
pnpm test:premium-vault
pnpm test:claim-manager
pnpm test:cross-chain

# Run with coverage
pnpm test:coverage

# Run in watch mode
pnpm test:watch

# Run component tests
pnpm test:frontend

# Run E2E tests
pnpm test:e2e

# Run accessibility tests
pnpm test:a11y

• 💻 Smart Contract Exploits: Code vulnerabilities and hacks
• 🏃 Rug Pulls: Team abandonment and fund theft
• 📈 Oracle Failures: Price manipulation attacks
• 🗳️ Governance Attacks: Malicious proposal execution
• 🌉 Bridge Failures: Cross-chain infrastructure risks

• 🛡️ Access Controls: Multi-signature and role-based permissions
• 🔒 Reentrancy Protection: All state-changing functions protected
• ✅ Input Validation: Comprehensive parameter checking
• 🔍 Audit Ready: Code optimized for security reviews

• 🔐 Wallet Security: Secure wallet connection via Dynamic Labs
• 🛡️ Data Protection: Client-side encryption for sensitive data
• 🌐 HTTPS Only: Secure communication protocols
• 🔒 Content Security: CSP headers and XSS protection

• ✅ Comprehensive test coverage (100%)
• ✅ Gas optimization completed
• ✅ Security review ready
• ✅ Frontend production build tested
• ⏳ External audit pending
• ⏳ Mainnet deployment planned

• 🛡️ Risk Protection: Insure your DeFi positions against smart contract risks
• 📊 Portfolio Safety: Comprehensive coverage across multiple protocols
• 🔄 Easy Claims: Streamlined claim submission and processing

• 💰 Yield Generation: Earn from insurance premiums
• 🗳️ Governance Power: Vote on claims and protocol decisions
• 📈 Diversified Returns: Risk-adjusted yields from insurance activities

• 🔐 User Confidence: Offer insurance to attract more users
• 📊 Risk Analytics: Access detailed risk assessment data
• 🤝 Partnership: Integrate insurance into your protocol

• $200B+ DeFi Market: Massive addressable market for insurance
• $2B+ Losses: Annual losses from exploits and failures
• Low Coverage: <1% of DeFi assets currently insured

• Cross-Chain First: Built for multi-chain DeFi ecosystem
• Hardhat 3 Powered: Leveraging cutting-edge development tools
• Modern Stack: Next.js 15, TypeScript, Tailwind CSS
• Real-time Sync: Instant cross-chain state synchronization

• Lower Costs: No intermediaries, pure smart contract automation
• Faster Claims: 5-minute voting periods vs weeks in traditional insurance
• Transparent: All operations visible on-chain
• Composable: Easily integrated into existing DeFi protocols

DeFi Guardians Core Team:

• Gokuleshwaran Narayanan
• Jash Mehta

• Hardhat Team for building the incredible Hardhat 3 development environment
• Chainlink for providing robust CCIP cross-chain infrastructure
• OpenZeppelin for battle-tested smart contract libraries
• Hedera for high-performance distributed ledger technology
• Dynamic Labs for seamless wallet connectivity
• Vercel for hosting and deployment infrastructure

DeFi Guardians represents the convergence of cutting-edge blockchain development and modern web technologies. We're not just building insurance; we're building the foundation for a safer, more secure DeFi ecosystem.

Ready to revolutionize DeFi insurance? Let's build the future together! 🚀

For questions, feedback, or collaboration opportunities, please open an issue or reach out to our team.