Hyperledger 소스코드 구조 분석

1. Hyperledger Code AnalysisHyperledger Code AnalysisHyperledger Code AnalysisHyperledger Code AnalysisHyperledger Code AnalysisHyperledger Code AnalysisHyperledger Code AnalysisHyperledger Code AnalysisHyperledger Code AnalysisHyperledger Code AnalysisHyperledger Code AnalysisHyperledger Code AnalysisHyperledger Code AnalysisHyperledger Code AnalysisHyperledger Code AnalysisHyperledger Code AnalysisHyperledger Code Analysis
Jongseok Choi
SmartM2M
January 9, 2018

2. Outline
1 Hyperledger Introduction
Preliminaries
Basic Concepts
Architecture
2 Code Hierarchy
Source Line Analysis
3 Command Composition
Fabric Architecture
Peer
Orderer
4 Peer Details
Node
5 Block
Implementation
6 Conclusion
Summary
Future Works
2/37

3. Preliminaries
1. Programming
• Go
2. Database
• LevelDB
• CouchDB
3. RPC
• gRPC or thrift
• Protobuf
4. Cryptography
• X.509
• ECDSA
• TLS
5. Infra
• Kafka
Hyperledger IntroductionIPreliminaries
3/37

4. A Distributed Ledger
An append-only system of record or log of transactions.
• ]¥x@ ƒ}(promises),pò(trades), ∏ú≠XÒX
lpt0| 0]X0 ⌅t⌧ ¨© ⇠ àL.
• π $∏Ãl¡–⌧ ¯Ï¡⇠‡, ⌅lò t˘ $∏Ãl–
8Ï` ⇠ àƒ] h.
• Ñ∞–•@ ⌘Y ‡∞ xùê ∆î ‰ê⌅ pt0†t§
• ]¥xX ⌧⌧Ù•D µt⌧ ∏ú≠Xt ò¨î Ét Ñ∞
–•D X¯h.
Hyperledger IntroductionIBasic Concepts
4/37

5. Blockchain 2.0
Encompasses both distributed ledgers and smart contracts.
Hyperledger IntroductionIBasic Concepts
5/37

6. Distributed Ledgers in Action
1. π )– àî ®‡ ¨åt ¥§ ‘∏¨ 8ú⇠»D L,
tât|Xî ©]t àî ED ¿‡ à‰.
2. ⌅p XòX Dt à8| Ätt, ‰x ¨å‰@ ®‹
D î‰.
3. ¯¨‡ò⌧, PÖ@ Ÿ‹– ⌧ ‰x Dt à8| Äx‰.
4. Ï0⌧ Ω¡D t⌧ t4 ¨å É@ D ‡, ƒ¨å@ ‰‹
‹ƒXÏ à8| Äx‰.
5. ®‡ ¨å‰t t˘ ‘∏¨– ŸXXt, ‰L ledger| ¯ ⇠
à‰.
6. t |(X ë≈‰t ¥ê ƒ ‹®X $∏Ãl–⌧
|¥òê– Ñ∞–• Ÿë –¨| ∞ ‰.
Hyperledger IntroductionIBasic Concepts
6/37

7. Blockchain Technologies
Smart contract
• The code or any complex program stored and executed on a
blockchain.
I Smart contractî Ñ∞ –• 0 ⌅X XòX ƒ5< l1(.
I Ñ∞–•@ ‰ê⌅ ı ⌧ pt0†t§| –à D»|, ‰ê⌅
D¿»§ ¡Ñ.
Blockchain 6= Cryptocurrency
• Cryptocurrency is an application that sits on top of blockchain.
Not the other way around.
I Blockchain and cryptocurrencies are often discussed in similar
contexts, but they are not one in the same.
I Distributed ledgers do not require a cryptocurrency to work.
Hyperledger IntroductionIBasic Concepts
7/37

8. Business Aspects
All over the global market there are ledgers that organizations
and individuals alike must trust.
• Permissioned blockchains di↵er from what you’ll find in Bitcoin
or Ethereum.
I ÄÑX ‘0⌅|tà ]¥x Q©–⌧î ‰⌧ ‡∞ ƒ–
0⇠XÏ, ]¥x ‹§–⌧ƒ å 0⇠X 8Ïê|
l1Xî ÉD © h.
I t˘ $∏Ãl–⌧ p x%D ‰t¿ J‡ƒ T í@ ÙHD
0⇠< pt0| ı h.
Hyperledger IntroductionIBasic Concepts
8/37

9. Modular Approach
Hyperledger
• Hyperledgerî ¡ Ñ|/‹®ò iXL‡¨ò– 0|⌧
ÑX(.
Hyperledger IntroductionIArchitecture
9/37

10. Architecture
Hyperledger IntroductionIArchitecture

11. Components
Platform-agnostic
• Language : Go
• gRPC over HTTP/2
Peers
• xù⌧ <¥ : Consensus L‡¨ò ⇠â
• xù⇠¿ J@ <¥ : Consensus L‡¨ò ⇠âX¿ JL
Transactions
• Deploy new chaincode
• Invoke an operation
• Read states
State
• a key-value store
Hyperledger IntroductionIArchitecture
11/37

12. Components
Membership service
• Peer–å xù⌧| ⌧
xù⌧ ÖX
1. Enrollment certificates
I E-CAÄ0 ⌧ ⇠p E-Cert|‡ ÄÑ
I x‹–å ›ƒê| ÄÏX‡, ∏ú≠XD ›1X0 ⌅ åD
ÄÏh
2. Transaction certificates
I T-CAÄ0 ⌧ ⇠p T-Cert|‡ ÄÑ
I Xòt¡X ∏ú≠XD ⌧ X0 ⌅t ¨©
I T-CA| ⌧x x‹î E-Cert@ ¡l| t⌧` ⇠ àL.
Pseudonumous transaction authorization
• Peer º»ò Œ@ ∏ú≠XD Ÿ| T-Cert ⌧tXî
| ⌧¥
Hyperledger IntroductionIArchitecture
12/37

13. Consensus Algorithms
Hyperledgerî PBFT| ¨©
• Hyperledger Fabric V1.0–⌧ Ä0î Endorser@ Consensus
x‹ Ѩ(
• X chaincodeî ‰x endorsers| –.
• Consensus x‹î ∏ú≠XD ⌧⌧| Ù•t¸î Ì`à ⇠â
Hyperledger IntroductionIArchitecture
13/37

14. Consensus Algorithms
Hyperledger IntroductionIArchitecture
14/37

15. Consensus Algorithms
Hyperledger IntroductionIArchitecture
15/37

16. Directories
Name Description
bccsp Blockchain Cryptographic Service Provider
common core@ ÏÏ ¿ 4–⌧ ¨© ⇠ àî 0¯ 0•
core Blockchain uÏ |t Ϩ
events t§∏ Pub/Sub 0•
gossip Gossip ⌅†
gotools Go build ƒl
idemix Identity Mixer l⌅
msp Membership Service Provider
orderer Ordering ans consensus
peer Peer
protos GRPC© Protobuf ®L
Code HierarchyISource Line Analysis
16/37

17. Source Lines
Code HierarchyISource Line Analysis
17/37

18. Fabric Architecture
Command CompositionIFabric Architecture
18/37

19. Peer Commands
Peerî 5⌧X î Ö9¥| ¿‡ àL
• version : peer build ✏ base image Ñ⌅
• node : peer x‹ ⇠â
• chaincode : chaincode x‹ ⇠â
• logging : CLIX Log level $ ✏ ¨
• channel : Channel ¨
Peerî Cobra (§¿| t©XÏ Ö9¥
✏ ò¯ X
Command CompositionIPeer
19/37

20. Peer Commands
1 var mainCmd = &cobra.Command{
2 Use: "peer",
3 PersistentPreRunE: func(cmd *cobra.Command, args []string) error {
4 loggingSpec := viper.GetString("logging.level")
5 flogging.InitFromSpec(loggingSpec)
6
7 return nil
8 },
9 Run: func(cmd *cobra.Command, args []string) {
10 if versionFlag {
11 fmt.Print(version.GetInfo())
12 } else {
13 cmd.HelpFunc()(cmd, args)
14 }
15 },
16 }
Code 1: peer/main.go
1 mainCmd.AddCommand(version.Cmd())
2 mainCmd.AddCommand(node.Cmd())
3 mainCmd.AddCommand(chaincode.Cmd(nil))
4 mainCmd.AddCommand(clilogging.Cmd(nil))
5 mainCmd.AddCommand(channel.Cmd(nil))
Code 2: peer/main.go
Command CompositionIPeer
20/37

21. Peer-Node Commands
1 func Cmd() *cobra.Command {
2 nodeCmd.AddCommand(startCmd())
3 nodeCmd.AddCommand(statusCmd())
4
5 return nodeCmd
6 }
Code 3: peer/node/node.go
1 var nodeStartCmd = &cobra.Command{
2 Use: "start",
3 Short: "Starts the node.",
4 Long: ‘Starts a node that interacts with the network.‘,
5 RunE: func(cmd *cobra.Command, args []string) error {
6 return serve(args)
7 },
8 }
Code 4: peer/node/start.go
Command CompositionIPeer
21/37

22. Peer-Chaincode Commands
1 func Cmd(cf *ChaincodeCmdFactory) *cobra.Command {
2 addFlags(chaincodeCmd)
3
4 chaincodeCmd.AddCommand(installCmd(cf))
5 chaincodeCmd.AddCommand(instantiateCmd(cf))
6 chaincodeCmd.AddCommand(invokeCmd(cf))
7 chaincodeCmd.AddCommand(packageCmd(cf, nil))
8 chaincodeCmd.AddCommand(queryCmd(cf))
9 chaincodeCmd.AddCommand(signpackageCmd(cf))
10 chaincodeCmd.AddCommand(upgradeCmd(cf))
11 chaincodeCmd.AddCommand(listCmd(cf))
12
13 return chaincodeCmd
14 }
Code 5: peer/chaincode/chaincode.go
Command CompositionIPeer
22/37

23. Peer-Channel Commands
1 func Cmd(cf *ChannelCmdFactory) *cobra.Command {
2 AddFlags(channelCmd)
3
4 channelCmd.AddCommand(createCmd(cf))
5 channelCmd.AddCommand(fetchCmd(cf))
6 channelCmd.AddCommand(joinCmd(cf))
7 channelCmd.AddCommand(listCmd(cf))
8 channelCmd.AddCommand(updateCmd(cf))
9 channelCmd.AddCommand(signconfigtxCmd(cf))
10 channelCmd.AddCommand(getinfoCmd(cf))
11
12 return channelCmd
13 }
Code 6: peer/channel/channel.go
Command CompositionIPeer
23/37

24. Orderer Commands
Ordererî kingpin (§¿| t©XÏ Ö9¥@ ò¯ X
• kingpin (§¿î cobra (§¿@ Ϩ ¡¡ Condition<
Ñ0| h.
1 var (
2 app = kingpin.New("orderer", "Hyperledger Fabric orderer
node")
3
4 start = app.Command("start", "Start the orderer node").
Default()
5 version = app.Command("version", "Show version information
")
6 )
Code 7: orderer/common/server/main.go
Command CompositionIOrderer
24/37

25. Orderer-start Commands
1 case start.FullCommand():
2 logger.Infof("Starting %s", metadata.GetVersionInfo())
3 conf := config.Load()
4 initializeLoggingLevel(conf)
5 initializeProfilingService(conf)
6 grpcServer := initializeGrpcServer(conf)
7 initializeLocalMsp(conf)
8 signer := localmsp.NewSigner()
9 manager := initializeMultiChainManager(conf, signer)
10 server := NewServer(manager, signer)
11 ab.RegisterAtomicBroadcastServer(grpcServer.Server(),
server)
12 logger.Info("Beginning to serve requests")
13 grpcServer.Start()
Code 8: orderer/common/server/main.go
Command CompositionIOrderer
25/37

26. Node
ledgermgmt.Initialize
peer.CacheConfiguration
peer.GetPeerEndpoint
peer.GetSecureConfig
peer.CreatePeerServer
createEventHubServer
ccprovider
.EnableCCInfoCache
createChaincodeServerregisterChaincodeSupport pb.RegisterAdminServer
endorser
.NewEndorserServer
pb
.RegisterEndorserServer
mgmt
.GetLocalSigningIdentity()
.Serialize()
peergossip.NewMCS
peergossip
.NewSecurityAdvisor
service
.InitGossipService
initSysCCs peer.Initialize go peerServer.Start
go
ehubGrpcServer.Start
profiling is enabled?
go
http.ListenAndServe
Yes
End
No
Start
Peer DetailsINode
26/37

27. Basic Server Settings
3⌧X GRPC ⌧Ñ| lŸ
• Peer server
I XΩ$ |¯0 : peer.listenAddress
I 0¯ Ï∏ : 7051
• Chaincode server
I XΩ$ |¯0 : peer.chaincodeListenAddress
I 0¯ Ï∏ : 7052
• Event hub server
I XΩ$ |¯0 : peer.events.address
I 0¯ Ï∏ : 7053
Peer DetailsINode
27/37

28. Ledger Initialization
Ledger 0T–⌧î Ledger| •` pt0†t§| 0T
Xî ¸
• LevelDB : Chain/Ledger ID •D ⌅ KV pt0†t§
• CouchDB : Binary| •X0 ⌅ §†¨¿ DB ¨©
1 func NewProvider() (ledger.PeerLedgerProvider, error) {
2 idStore := openIDStore(ledgerconfig.GetLedgerProviderPath())
3
4 ledgerStoreProvider := ledgerstorage.NewProvider()
5
6 vdbProvider, err := privacyenabledstate.NewCommonStorageDBProvider()
7 if err != nil {
8 return nil, err
9 }
10
11 var historydbProvider historydb.HistoryDBProvider
12 historydbProvider = historyleveldb.NewHistoryDBProvider()
13
14 provider := &Provider{idStore, ledgerStoreProvider, vdbProvider,
historydbProvider}
15 provider.recoverUnderConstructionLedger()
16 return provider, nil
17 }
Code 9: core/ledger/kbledger/kv ledger provider.go
Peer DetailsINode
28/37

29. GRPC Server
GRPCServer x0òt§|
†t§ ¨©
• Interface– Ïh h⇠Ã
0
• TLS µ‡ ( ✏ CA
xù⌧ ( $ D Ïh
grpcServerImpl lp¥î
Private< ¨©X‡,
xÄ–î x0òt§|
µt⌧ ¨©
• ⌧ÑX XΩ$ ✏
|¯0| Ïh
1 type GRPCServer interface {
2 Address() string
3 Start() error
4 Stop()
5 Server() *grpc.Server
6 Listener() net.Listener
7 ServerCertificate() tls.Certificate
8 TLSEnabled() bool
9 MutualTLSRequired() bool
10 AppendClientRootCAs(clientRoots [][]byte) error
11 RemoveClientRootCAs(clientRoots [][]byte) error
12 SetClientRootCAs(clientRoots [][]byte) error
13 SetServerCertificate(tls.Certificate)
14 }
Code 10: core/comm/server.go
1 type grpcServerImpl struct {
2 address string
3 listener net.Listener
4 server *grpc.Server
5 serverCertificate atomic.Value
6 serverKeyPEM []byte
7 serverRootCAs []tls.Certificate
8 lock *sync.Mutex
9 clientRootCAs map[string]*x509.Certificate
10 tlsConfig *tls.Config
11 tlsEnabled bool
12 mutualTLSRequired bool
13 }
Code 11: core/comm/server.go
Peer DetailsINode
29/37

30. Chaincode Server
Chaincodeî GRPC ⌧Ñ| lŸ
• GRPC| ⌅t⌧ ¨©⇠î chaincodesî 6⌧ l1(.
I core/scc/importsysccs.go T‹ 8p
Name Chaincode Package
cscc &cscc.PeerConfiger{} core/scc/cscc
lscc lscc.NewLifeCycleSysCC core/scc/lscc
escc &escc.EndorserOneValidSignature{} core/scc/escc
vscc &vscc.ValidatorOneValidSignature{} core/scc/vscc
qscc &qscc.LedgerQuerier{} core/chaincode/qscc
rscc rscc.NewRscc core/chaincode/rscc
Peer DetailsINode
30/37

31. Peer Server
Peer ⌧Ñî GRPC ⌧Ñ| lŸ
• AtomicBroadcast, Admin, Endorser 3⌧X RPC| ⌧ı
• Transaction ò¨î core/endorser/endorser lp¥ 8‡
I ‰» x EndorserServer Ì`D ⇠âh.
1 func CreatePeerServer(listenAddress string,
2 serverConfig comm.ServerConfig) (comm.GRPCServer, error) {
3
4 var err error
5 peerServer, err = comm.NewGRPCServer(listenAddress, serverConfig)
6 abServer := peer.NewAtomicBroadcastServer(timeWindow, mutualTLS)
7 ab.RegisterAtomicBroadcastServer(peerServer.Server(), abServer)
8 pb.RegisterAdminServer(peerServer.Server(), core.NewAdminServer())
9 serverEndorser := endorser.NewEndorserServer(privDataDist, &endorser.SupportImpl{})
10 auth := authHandler.ChainFilters(serverEndorser, authFilters...)
11 pb.RegisterEndorserServer(peerServer.Server(), auth)
12 go peerServer.Start()
13
14 return peerServer, nil
15 }
Code 12: peer/node/start.go
Peer DetailsINode
31/37

32. Event Hub Server
Event » î 1⌧X GRPC Protobuf| Ïh
• Events
1 grpcServer, err := comm.NewGRPCServerFromListener(lis, serverConfig)
2 if err != nil {
3 logger.Errorf("Failed to return new GRPC server: %s", err)
4 return nil, err
5 }
6
7 ehConfig := &producer.EventsServerConfig{BufferSize: uint(viper.GetInt("peer.events.
buffersize")), Timeout: viper.GetDuration("peer.events.timeout"), TimeWindow: viper
.GetDuration("peer.events.timewindow")}
8 ehServer := producer.NewEventsServer(ehConfig)
9 pb.RegisterEventsServer(grpcServer.Server(), ehServer)
10
11 go grpcServer.Start()
Code 13: peer/node/start.go
Peer DetailsINode
32/37

33. Block Structure
¥x›1
• core/peer T‹ 8‡
1 type Block struct {
2 Header *BlockHeader ‘protobuf:"bytes,1,opt,name=header"
json:"header,omitempty"‘
3 Data *BlockData ‘protobuf:"bytes,2,opt,name=data" json:"
data,omitempty"‘
4 Metadata *BlockMetadata ‘protobuf:"bytes,3,opt,name=
metadata" json:"metadata,omitempty"‘
5 }
BlockIImplementation
33/37

34. Block Data
1 type BlockHeader struct {
2 Number uint64 ‘protobuf:"varint,1,opt,name=number" json:"
number,omitempty"‘
3 PreviousHash []byte ‘protobuf:"bytes,2,opt,name=
previous_hash,json=previousHash,proto3" json:"
previous_hash,omitempty"‘
4 DataHash []byte ‘protobuf:"bytes,3,opt,name=data_hash,json
=dataHash,proto3" json:"data_hash,omitempty"‘
5 }
1 type BlockData struct {
2 Data [][]byte ‘protobuf:"bytes,1,rep,name=data,proto3"
json:"data,omitempty"‘
3 }
4
5 type BlockMetadata struct {
6 Metadata [][]byte ‘protobuf:"bytes,1,rep,name=metadata,
proto3" json:"metadata,omitempty"‘
7 }
BlockIImplementation
34/37

35. Summary
⌅¥ x ⌅†@ GRPC| 0⇠< h.
• Hyperledger Ñ ✏ tt| ⌅t⌧î RPC– tt ‰∞
⌘îh
• ⌅¥ x Ñ D `tå X0 ⌅t⌧î Protobuf Ñ ¸ GRPC
lp| Ñ
Hyperledger| L§∏ ⇣î Ÿ
• GRPC| ¨©XÏ Peer– ∏ú≠XD ›1
• GRPCî ⌅¨ Œ@ ∏¥| ¿–X‡ à0 L8–, ®| ✏
Web 8X1t D¸ íL
ConclusionISummary
35/37