How beefyfinance/beefy-cowllector-v2 works
Main Components
a) Core Services:
• Harvester Service (Main Bot)
• Analytics Service (Grafana)
• API Service
• Database Layer
• Smart Contracts Layer
b) External Integrations:
• Multiple Blockchain Networks
• Discord Integration (for notifications)
• Beefy Vaults & Strategies
• Revenue Bridge
┌─ Infrastructure Layer ─────────────────────┐
• Docker Containers │
• Database │
• Grafana Analytics │
• Application Layer ──────────────────────┐ │
• API Service │ │
• Harvester Core │ │
• Balance Checker │ │
• RPC Client │ │
• Smart Contract Layer ──────────────────┤ │
• Harvest Lens Contract │ │
• Strategy Contracts │ │
• Revenue Bridge │ │
• ┘
Key Relationships to Highlight
a) Data Flow:
• How the harvester interacts with multiple chains
• Harvest report flow to Discord
• Analytics data collection path
• API endpoints interaction
b) Component Interactions:
• RPC communication with blockchain networks
• Database interactions for storing harvest reports
• Analytics dashboard data collection
• Smart contract interactions
Technical Details
• Node.js runtime environment (>=20.5)
• Docker containerization
• Foundry for contract deployment
• TypeScript implementation
• Database migrations system
• RPC client architecture
a) Harvest Flow:
Vault Discovery → Balance Check → Harvest Execution → Report Generation → Discord Notification
b) Monitoring Flow:
Data Collection → Metrics Storage → Dashboard Display → Alert Generation
Component Details
a) API Service (/api):
• REST endpoints
• Database connectivity
• Report management
b) Analytics (/analytics):
• Grafana dashboards
• Alert configurations
• Data source management
c) Core Logic (/src):
• Harvest actions
• Chain interactions
• Report generation
• RPC management