How filecoin-project/go-f3 works
Main Components
a) Core Protocol Layer:
• GossipPBFT Consensus Module (from /gpbft)
• BLS Signature Module (from /blssig)
• Expected Consensus Module (from /ec)
b) Certificate Management Layer:
• Certificate Store (from /certstore)
• Certificate Exchange System (from /certexchange)
• Certificate Chain Management (from /certchain)
c) Network Layer:
• Polling Mechanism (from /certexchange/polling)
• PubSub System (from /chainexchange)
d) Supporting Infrastructure:
• Write-Ahead Log (from /internal/writeaheadlog)
• Power Store (from /internal/powerstore)
• Manifest Management (from /manifest)
┌─────────────────────────────────────────┐
• External Systems │
• (Filecoin Network / Lotus Nodes) │
• ┘
• ↕
┌─────────────────────────────────────────┐
• Network Communication │
• (PubSub, Certificate Exchange) │
• ┘
• ↕
┌─────────────────────────────────────────┐
• Consensus Core (GPBFT) │
• ┘
• ↕
┌─────────────────────────────────────────┐
• Certificate Management │
• ┘
• ↕
┌─────────────────────────────────────────┐
• Persistence Layer │
• ┘
Key Relationships to Highlight
• Bidirectional communication between the GPBFT consensus module and certificate management
• Polling mechanism's interaction with external nodes
• Demonstrate how the power store influences consensus decisions
• Write-ahead log's relationship with critical components
Component Details
For each major component, show:
• Internal subcomponents (e.g., poller, predictor, and subscriber for polling)
• Key interfaces with other components
• Primary data flows
• Critical state storage points
Metrics and Monitoring Points
Indicators for:
• Performance measurement points (from /metrics.go files)
• Health check locations
• Monitoring interfaces
Implementation Notes
• Numbered sequence indicators for critical flows