How epiccash/epic works
Epic is a MimbleWimble blockchain node: an operator starts the server, which participates in peer networking, synchronizes and validates chain state, and can expose APIs or produce blocks. The graph separates protocol/core validation, chain state, networking, server operations, and client-facing APIs. Several subsystem links are documented at the product level; where sampled files do not show the runtime wiring, those links are omitted rather than inferred.
Main entry points: chain.rs Chain Validation · epic/server.rs Epic Server · serv.rs Peer Service · cmd/server.rs Command Line
Components 20
Node Operations
- Command Line
src/bin/cmd/server.rs - Epic Server
servers/src/epic/server.rs - Chain Sync
servers/src/epic/sync - Mining Services
servers/src/mining
Peer Networking
- Peer Service
p2p/src/serv.rs - Peer Management
p2p/src/peers.rs - Peer Protocol
p2p/src/protocol.rs
Chain Processing
- Chain Validation
chain/src/chain.rs - Block Processing
chain/src/pipe.rs - UTXO State
chain/src/txhashset/txhashset.rs - Chain Store
chain/src/store.rs
Blockchain Protocol
- Consensus Rules
core/src/consensus.rs - Transaction Model
core/src/core/transaction.rs - Core Serialization
core/src/ser.rs
Node Interfaces
- HTTP API Server
api/src/rest.rs - Request Router
api/src/router.rs - API Handlers
api/src/handlers.rs - Foreign RPC
api/src/foreign_rpc.rs - Foreign API
api/src/foreign.rs
Other components
- Node Operator
Connections 20
- Node Operator → Command Line: starts node
README.md - Command Line → Epic Server: runs server
- Epic Server → Chain Sync: starts synchronization
servers/src/epic/server.rs - Epic Server → Mining Services: starts mining
servers/src/epic/server.rs - Epic Server → Peer Service: participates in network
README.md - Epic Server → Chain Validation: validates blocks
README.md - Peer Service → Peer Management: manages peers
- Peer Service → Peer Protocol: exchanges messages
- Chain Validation → Block Processing: processes blocks
- Chain Validation → UTXO State: maintains state
- Chain Validation → Chain Store: persists chain data
- Consensus Rules → Chain Validation: defines validation rules
- Transaction Model → Chain Validation: provides transaction model
- Node Operator → HTTP API Server: uses node API
README.md - HTTP API Server → Request Router: serves routed requests
api/src/rest.rs - Request Router → API Handlers: dispatches routes
api/src/handlers.rs - API Handlers → Foreign RPC: handles RPC requests
api/src/handlers.rs - Foreign RPC → Foreign API: delegates API calls
api/src/foreign_rpc.rs - Foreign API → Transaction Model: accepts transactions
- Peer Protocol → Core Serialization: encodes protocol data