FISCO-BCOS源码各模块的简单理解

原创内容,未经允许不得转载

本文对源码的解读为个人理解,欢迎指正
关联github仓库:FISCO-BCOS
内容太多了,慢慢深入阅读,持续更新中...(2020-04-30)

各模块的功能:

可以简单分EVM模块、账本模块、共识同步模块、网络模块

EVM模块:执行交易

  • libethcore
    • block区块定义
    • transaction定义
    • abi定义
    • 并行交易定义
  • libevm
    • EVMC 提供exec接口
    • ExtVmFace 提供evm的call get接口
    • VMFactory
  • libinterpreter EVM的实现
    • VM 虚拟机汇编操作的定义
    • VMCall call操作对应汇编的定义
    • VMOpt copyCode, exp256 操作工具类
  • libexecutive 执行交易
    • Executive: call, create,execute
    • ExtVM: 生成调用结果或部署结果
  • libtxpool 交易池,待确认的交易
    • TransactionNonceCheck commonTxCheck
    • TxPool insert, clear, pending, verify等对交易池的操作

账本模块:

  • libstorage 用不同db存储的数据层
    • RocksDBStorage, BasicRocksDB: 基本put commit等操作
    • LevelDBStorage: commit, select, setDb..基本put commit等操作
    • SQLStorage: 是否与AMDB相关
    • ZdbStorage: 在mysql上,创建预编译、系统表等数据表
    • CachedStorage: 缓存存储,具体未知
    • ScalableStorage: 可扩展存储,与AMDB proxy相关?
    • MemoryTable 系统表,如权限控制,crud等
    • BinLog: binlog handler(decode, encode, ), binlog storage
    • SQLBasicAccess: buildSQL, buildConditions
    • SQLConnectionPool: 连接池
    • Table: table的基本操作setEntries
  • libstoragestate MPT存储
    • StorageState MPT操作 定义对state的操作如,createAccount,createContract,rollback, addBalance
    • StorageStateFactory 工厂类
  • libledger 数据层上的账本层
    • DBInitializer: 初始化storage相关,create实例
    • Ledger, LedgerParam:
      • 创建consensusEngine, createRaftSealer, createPBFTSealer, initPBFTEngine
      • 初始化blockVerifier, eventLogFilter, initBlockChain, initSync, initTxPool, initSync
    • LedgerManager: getGroupListForRpc (.h中获取BlockChainInterface等face接口)
  • libmptstate ethereum原生代码
    • Account 账户的定义,nonce, code, balance等, setCode账户代码
    • State, MPTState MPTStateFactory
      • MPTStateFactory: getState
      • State: addAddress, addBalance/subBalance, createAccount, codeHash, addresHash
      • MPTState: commit操作,维持MPT State状态树,State为数据层的话,MPTState为接口层

共识同步模块 共识时verifier用到到账本模块,用到evm执行

  • libconsensus
    • Sealer 定义sealer操作(打包区块), loadTxs, reportNewBlock, isBlockSyncing
    • ConsensusEngineBase: 区块校验、
    • pbft待详读 PBFT分组共识算法、HotStuff共识算法
    • raft待详读
    • rotating_pbft(RPBFT) 待详读 基于pbft的DPOS
  • libblockverifier
    • BlockVerifier
      • executeBlock
      • executeTransaction
      • parallelExecuteBlock
    • DAG, TxDAG 用于并行交易
    • ExecutiveContext 执行交易的上下文
  • libblockchain
    • BlockChainImp 区块链逻辑的实现,检查构建创世块、获取区块和交易等face接口的实现
  • libsync
    • DownloadingBlockQueue, DownloadingTxsQueue 与RLP结合
    • GossipBlockStatus 传递区块状态包
    • DownloadRequest, RspBlockReq 下载区块请求
    • SyncMaster 同步操作定义,send,broadcast
    • SyncTransaction 广播交易
    • SyncMsgEngine msg监听、收发
      • SyncMsgPacket 广播的消息包
    • SyncTreeTopology 网络拓扑图 nodeList, nodeInfo

与网络模块

  • libnetwork
    • ASIOInterface boost的网络模块,用于socket连接, ssl的websocket连接
    • Host: 节点间握手(Server/Client) 与P2P关联
      • handshakeServer ssl
      • asyncConnect..
    • Session session会话,监听信息
    • PeerWhitelist 白名单
  • libp2p
    • Service
      • heartBeat 与updateStaticNodes保持连接
      • asyncSendMessageByNodeID, 或broadcast, multicast
      • onMessage, onConnect等
    • P2PSession
      • heartBeat心跳包
      • onTopicMessage等监听topic信息
    • message: P2PMessage P2PMessageRC2
    • StatisticHandler block/tx sync的设置,如updateDownloadedTxsCount
  • librpc
    • SafeHttpServer 接收/回复rpc API的请求
    • Rpc 定义rpc的接口
    • JsonHelper HttpMessage等解析工具类
  • libchannelserver 基于channel的sdk长连接协议定义,与web3sdk中定义类似,此处为server, sdk为client,可参考另一篇sdk的文章

加密、鉴权模块

  • libdevcrypto:AES(CBC模式), Hash(md, keccak.sha256, secp256k1)
    • gm 国密sm2, sm3, sm4, 国密hash, aes等
  • libsecurity 落盘加密
    • EncryptedLevelDB leveldb文件加密
    • EncryptedFile: decryptContents解密文件
    • KeyCenter: KeyCenterHttpClient keyServer密钥管理中心

特性模块:

  • libprecompiled 预编译合约的实现,包含接口solidity文件。与table直接交互
  • libeventfilter event日志的过滤器
    • EventLogFilterManager
    • EventLogFilterParams
    • EventLogFilter: matches
  • libdevcore 地址, base64, log, rlp, trie等定义
  • libconfig 全局配置 Global configure of the node
  • tools shell脚本,build_chain, get_node_certs等
  • test 测试类

libinitializer

读取配置文件,进行初始化,包含:

  • Initializer,总的初始化,将P2P, RPC, Secure, Ledger, Log等模块的初始化集中处理。