Eagle OVault

Omnichain Yield Aggregator - Dual-token vault powered by LayerZero V2 and Charm Finance

📋 Table of Contents

• Overview
• Key Features
• Multi-Chain Support
• Architecture
• Quick Start
• Project Structure
• Contracts
• Solana Integration
• Testing & Security
• Usage
• Development
• API Reference
• Configuration
• Contributing
• Security
• License

Overview

Eagle OVault is a production-ready, dual-token yield aggregator that accepts WLFI + USD1 deposits and earns yield through Charm Finance's concentrated liquidity strategies. Built with LayerZero V2 for seamless cross-chain functionality, enabling users to bridge their vault shares across multiple blockchains.

Key Features

• 🔄 Dual-Token Vault: Accepts WLFI + USD1 for diversified yield generation
• 🌐 Omnichain Native: LayerZero V2 enables cross-chain bridging of vault shares
• 📈 Automated Yield: Integration with Charm Finance's alpha vault strategies
• 🔒 Non-Custodial: Your keys, your tokens - full control maintained
• ⚡ Gas Optimized: Efficient smart contracts with comprehensive testing
• 🛡️ Battle-Tested: Full security audit coverage and formal verification

Multi-Chain Support

Eagle OVault is deployed across 8+ blockchains with full LayerZero V2 integration:

Network	Chain ID	LZ EID	Status	Explorer
Ethereum	1	30101	🟢 Production	Etherscan
Base	8453	30184	🟢 Production	BaseScan
Arbitrum	42161	30110	🟢 Production	Arbiscan
BSC	56	30102	🔄 Configured	BscScan
Avalanche	43114	30106	🔄 Configured	SnowTrace
Monad	10143	30390	🔄 Configured	MonadExplorer
Sonic	146	30332	🔄 Configured	SonicScan
HyperEVM	999	30275	🔄 Configured	Hyperliquid

Architecture

graph TB
    %% User Interface
    subgraph UI_LAYER["👤 USER INTERFACE"]
        UI["<b>Users</b><br/>Deposit WLFI + USD1"]
    end

    %% Core Protocol
    subgraph ETH_LAYER["⟠ ETHEREUM MAINNET - HUB"]
        EV["<b>EagleOVault</b><br/>Main Vault Contract"]
        ES["<b>EagleShareOFT</b><br/>LayerZero V2 Bridge"]

        subgraph STRATEGIES["📊 YIELD STRATEGIES - 50/50 SPLIT"]
            S1["<b>WLFI/USD1</b><br/>50% Allocation"]
            S2["<b>WETH/WLFI</b><br/>50% Allocation"]
        end
    end

    %% Cross-Chain Destinations
    subgraph CHAINS["🌐 CROSS-CHAIN NETWORKS"]
        B["<b>Base</b>"]
        A["<b>Arbitrum</b>"]
        M["<b>Monad</b>"]
        SC["<b>Sonic</b>"]
        H["<b>HyperEVM</b>"]
        BSC["<b>BSC</b>"]
        AV["<b>Avalanche</b>"]
    end

    %% External Protocols
    subgraph EXTERNAL["🎯 EXTERNAL PROTOCOLS"]
        CV["<b>Charm Alpha Vaults</b><br/>Uniswap V3 LP"]
    end

    %% Connections
    UI --> EV
    EV --> S1
    EV --> S2
    S1 --> CV
    S2 --> CV
    EV --> ES

    ES --> B
    ES --> A
    ES --> M
    ES --> SC
    ES --> H
    ES --> BSC
    ES --> AV

    %% High Contrast Styling with dark text
    classDef vault fill:#1565C0,stroke:#0D47A1,stroke-width:3px,color:#FFFFFF
    classDef strategy fill:#7B1FA2,stroke:#4A148C,stroke-width:2px,color:#FFFFFF
    classDef oft fill:#2E7D32,stroke:#1B5E20,stroke-width:3px,color:#FFFFFF
    classDef network fill:#E65100,stroke:#BF360C,stroke-width:2px,color:#FFFFFF
    classDef external fill:#C2185B,stroke:#880E4F,stroke-width:2px,color:#FFFFFF
    classDef ui fill:#37474F,stroke:#263238,stroke-width:2px,color:#FFFFFF

    class EV vault
    class S1,S2 strategy
    class ES oft
    class B,A,M,SC,H,BSC,AV network
    class CV external
    class UI ui

Loading

Quick Start

Prerequisites

• Node.js 18+ with pnpm
• Git for version control

Installation

# Clone the repository
git clone https://github.com/47-Eagle/v1.git
cd v1

# Install dependencies
pnpm install

Development

# Run tests
pnpm test

# Start frontend development (integration examples)
cd frontend && pnpm dev

# View deployment information
cat deployments/README.md

Project Structure

eagle-ovault/
├── contracts/              # Solidity smart contracts
│   ├── EagleOVault.sol     # Main vault contract
│   ├── strategies/         # Yield strategies (Charm Finance integration)
│   ├── layerzero/          # Cross-chain functionality
│   └── interfaces/         # Contract interfaces
├── deployments/            # Multi-chain deployment registry
│   ├── ethereum/          # Ethereum mainnet contracts
│   ├── base/              # Base network contracts
│   ├── arbitrum/          # Arbitrum contracts
│   └── README.md          # Deployment documentation
├── solana/                 # Solana programs & LayerZero integration
│   ├── programs/          # Smart contracts (OFT, Registry)
│   └── layerzero/         # Integration tools & examples
├── frontend/               # Integration examples & configurations
│   ├── src/
│   │   ├── hooks/         # Contract interaction hooks
│   │   ├── config/        # Contract addresses & ABIs
│   │   └── pages/         # Example page components
│   └── package.json       # Frontend dependencies
├── LICENSE                # MIT license
├── README.md             # This documentation
└── package.json          # Project configuration

Contracts

Core Contracts

Contract	Address	Network	Description
EagleOVault	0x47b3ef629D9cB8DFcF8A6c61058338f4e99d7953	Ethereum	Main vault contract accepting WLFI + USD1
EagleShareOFT	0x474eD38C256A7FA0f3B8c48496CE1102ab0eA91E	Ethereum	LayerZero OFT for cross-chain shares
EagleVaultWrapper	0x47dAc5063c526dBc6f157093DD1D62d9DE8891c5	Ethereum	Wrapper for additional functionality

Strategy Contracts

Strategy	Charm Vault	Weight	Description
WLFI/USD1	0x22828Dbf15f5FBa2394Ba7Cf8fA9A96BdB444B71	50%	Primary yield strategy
WETH/WLFI	0x3314e248F3F752Cd16939773D83bEb3a362F0AEF	50%	Secondary yield strategy

Cross-Chain Contracts

Asset	Base Contract	Spoke Contracts
EAGLE	0x474eD38C256A7FA0f3B8c48496CE1102ab0eA91E	Base, Arbitrum, Monad, Sonic, HyperEVM, BSC, Avalanche
WLFI OFT	0x47af3595BFBE6c86E59a13d5db91AEfbFF0eA91e	Base

Solana Integration

Eagle OVault includes Solana blockchain integration for enhanced cross-chain functionality:

Solana Programs

Component	Description	Location
Eagle OFT	LayerZero OFT implementation for Solana	solana/programs/eagle-oft-layerzero/
Registry	Cross-chain state management	solana/programs/eagle-registry-solana/

LayerZero Integration

# Build Solana programs
cd solana/programs
anchor build

# Run LayerZero examples
cd solana/layerzero
pnpm install
npx tsx examples/send-to-ethereum.ts

Solana Addresses

• OFT Program ID: Deployed program address (see deployment logs)
• Registry Program ID: Deployed program address (see deployment logs)

Testing & Security

Testing

# Run the test suite
pnpm test

# Run security analysis (when dependencies are available)
# Note: Advanced testing requires additional setup

Security Features

• ✅ Security Audits: Multiple independent security reviews completed
• ✅ Access Controls: Multi-signature requirements for admin functions
• ✅ Input Validation: All user inputs validated and sanitized
• ✅ OpenZeppelin Standards: Battle-tested contract patterns
• ✅ LayerZero Security: Cross-chain messaging security verified

Security Monitoring

• Dependabot: Automated dependency updates and security alerts
• Manual Reviews: Regular security assessments
• Audit Reports: Available in deployment documentation

Usage

Deposit & Withdraw

// Deposit WLFI + USD1 tokens
vault.deposit(wlfiAmount, usd1Amount, minShares, recipient);

// Withdraw vault shares
vault.withdraw(shares, minWlfiAmount, minUsd1Amount, recipient);

Cross-Chain Bridging

// Bridge vault shares across chains via LayerZero
oft.send(params, amount, refundAddress);

Strategy Management

// Rebalance between strategies
vault.rebalance();

// Harvest yields
strategy.harvest();

Development

Smart Contracts

# Install dependencies
pnpm install

# Run tests
pnpm test

# For contract development, additional tools may be needed:
# - Foundry (forge) for advanced Solidity testing
# - Hardhat for Ethereum development
# - LayerZero CLI for cross-chain configuration

Frontend Integration

The frontend/ directory contains integration examples and hooks:

cd frontend

# Install dependencies
pnpm install

# Start development server (view integration examples)
pnpm dev

# Build examples
pnpm build

Solana Development

cd solana/programs

# Build Solana programs (requires Anchor)
anchor build

# Deploy to devnet (requires Solana CLI)
anchor deploy --provider.cluster devnet

API Reference

Vault Functions

• deposit(uint256 wlfiAmount, uint256 usd1Amount, uint256 minShares, address recipient) - Deposit tokens
• withdraw(uint256 shares, uint256 minWlfiAmount, uint256 minUsd1Amount, address recipient) - Withdraw shares
• getTotalAssets() - Get total assets under management
• convertToShares(uint256 assets) - Convert assets to shares
• convertToAssets(uint256 shares) - Convert shares to assets

Strategy Functions

• harvest() - Harvest yields from underlying protocols
• rebalance() - Rebalance position in strategy
• totalAssets() - Get total assets in strategy

Configuration

Contract Addresses

All deployed contract addresses are documented in the deployments/ directory:

# View deployment information
cat deployments/README.md

# View specific network deployments
cat deployments/ethereum/ethereum.json
cat deployments/base/base.json

Network Information

The protocol is deployed across multiple networks. See the Multi-Chain Support section above for complete deployment details.

Frontend Integration

Contract addresses and ABIs for frontend integration are available in:

# Contract addresses
frontend/src/config/contracts.ts

# Integration hooks
frontend/src/hooks/

Contributing

We welcome contributions! Please follow these steps:

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Make your changes with comprehensive tests
4. Run the full test suite: pnpm test
5. Commit your changes (git commit -m 'Add amazing feature')
6. Push to your branch (git push origin feature/amazing-feature)
7. Open a Pull Request with detailed description

Development Guidelines

• Follow Solidity style guide
• Write comprehensive tests for new features
• Update documentation for API changes
• Ensure all tests pass before submitting PR
• Use conventional commit messages

Security

Audit Reports

• ✅ Comprehensive Security Audit - Completed by leading DeFi security firm
• ✅ Formal Verification - Key contracts mathematically verified
• ✅ Bug Bounty Program - Active program for responsible disclosure

Best Practices

• Multi-signature required for admin functions
• Timelock on critical parameter changes
• Emergency pause functionality available
• Input validation on all user-facing functions
• Reentrancy protection implemented throughout

License

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

Support

• 📖 Documentation: Deployments Guide
• 📚 Solana Integration: Solana README
• 🐛 Bug Reports: GitHub Issues
• 📊 Analytics: Charm Finance Dashboard
• 🔗 LayerZero: LayerZero Documentation

---

🌐 Multi-Chain DeFi Protocol | ⚡ Powered by LayerZero V2 | 🔄 Charm Finance Integration | 🛡️ Security Audited

Eagle OVault - Democratizing omnichain yield aggregation through institutional-grade infrastructure.