How aboutcircles/circles-nethermind-plugin works
Core Infrastructure Layer
• Nethermind Client (Host System)
• Lighthouse Consensus Engine
• PostgreSQL Database
Plugin Core Components
• BlockIndexer
• StateMachine
• Plugin Manager
Components directly above the infrastructure layer.
Protocol Implementation Modules
• CirclesV1 Implementation
• CirclesV2 Implementation
• CirclesV2.NameRegistry
• CirclesV2.StandardTreasury
• CirclesV2.Erc20Lift
Common Services Layer
• Query Engine
• RPC Module
• Event Subscription System
• Pathfinder Service
Data Flow Components
• Log Parser System
• Event Processing Pipeline
• Database Schema Management
• Insert Buffer
Design Guidelines:
Layer Organization
Top to bottom:
1. External Interface Layer (RPC/WebSocket)
2. Service Layer (Query, Pathfinder)
3. Protocol Implementation Layer
4. Core Plugin Layer
5. Infrastructure Layer
Key Interactions to Highlight:
Event Flow
• How blockchain events flow from Nethermind through the LogParser
• Event processing pipeline
• Database write operations
Query Flow
• Demonstrate RPC request handling
• Query processing through the Query Engine
• Database read operations
Subscription System
• WebSocket connection handling
• Real-time event notification flow
Protocol Processing
• How different protocol implementations process events
• Schema management and data storage
Additional Elements:
Notes
• Configuration requirements
• Critical dependencies
• Performance considerations
Version Information
• Protocol version differences
• Compatibility requirements
Scale Indicators
• Which components can be scaled
• Performance bottlenecks