Fabric 1.0原始碼分析(42)scc(系統鏈碼)
# Fabric 1.0原始碼筆記 之 scc(系統鏈碼)
## 1、scc概述
scc,system chain codes,即系統鏈碼。包括:
* cscc,configuration system chaincode,處理在peer通道配置。
* escc,endorser system chaincode,對交易申請的應答資訊進行簽名,來提供背書功能。
* lscc,lifecycle system chaincode,處理生命週期請求,如chaincode的安裝,例項化,升級,解除安裝。
* qscc,querier system chaincode,提供賬本查詢,如獲取塊和交易資訊。
* vscc,validator system chaincode,處理交易校驗,包括檢查背書策略和版本在併發時的控制。
[Fabric 1.0原始碼筆記 之 scc(系統鏈碼) #cscc(通道相關)](
[Fabric 1.0原始碼筆記 之 scc(系統鏈碼) #escc(背書相關)]
[Fabric 1.0原始碼筆記 之 scc(系統鏈碼) #lscc(鏈碼相關)]
[Fabric 1.0原始碼筆記 之 scc(系統鏈碼) #qscc(賬本查詢相關)]
[Fabric 1.0原始碼筆記 之 scc(系統鏈碼) #vscc(策略校驗相關)]
scc程式碼分佈在core/common/sysccprovider和core/scc目錄下,目錄結構如下:
* core/common/sysccprovider目錄:
* sysccprovider.go,SystemChaincodeProvider和SystemChaincodeProviderFactory介面定義。
* core/scc目錄:
* sysccapi.go,SystemChaincode結構體及方法。
* sccproviderimpl.go,SystemChaincodeProvider和SystemChaincodeProviderFactory介面實現,即sccProviderFactory和sccProviderImpl結構體及方法。
* importsysccs.go,scc工具函式。
## 2、介面定義
### 2.1、SystemChaincodeProviderFactory介面定義
介面定義如下:
```go
type SystemChaincodeProviderFactory interface {
//建立SystemChaincodeProvider
NewSystemChaincodeProvider() SystemChaincodeProvider
}
//程式碼在core/common/sysccprovider/sysccprovider.go
```
全域性變數及相關函式:
```go
var sccFactory SystemChaincodeProviderFactory
//為sccFactory賦值
func RegisterSystemChaincodeProviderFactory(sccfact SystemChaincodeProviderFactory)
//獲取sccFactory.NewSystemChaincodeProvider()
func GetSystemChaincodeProvider() SystemChaincodeProvider {
//程式碼在core/common/sysccprovider/sysccprovider.go
```
補充ChaincodeInstance結構體定義:
```go
type ChaincodeInstance struct {
ChainID string //ID
ChaincodeName string //名稱
ChaincodeVersion string //版本
}
//程式碼在core/common/sysccprovider/sysccprovider.go
```
### 2.2、SystemChaincodeProvider介面定義
介面定義如下:
```go
type SystemChaincodeProvider interface {
IsSysCC(name string) bool //是否系統鏈碼
IsSysCCAndNotInvokableCC2CC(name string) bool //確認是系統鏈碼且不可通過CC2CC呼叫
IsSysCCAndNotInvokableExternal(name string) bool //確認是系統鏈碼且不可通過提案呼叫
GetQueryExecutorForLedger(cid string) (ledger.QueryExecutor, error) //獲取賬本的查詢執行器
}
//程式碼在core/common/sysccprovider/sysccprovider.go
```
## 3、SystemChaincodeProvider和SystemChaincodeProviderFactory介面實現
SystemChaincodeProviderFactory介面實現,即sccProviderFactory結構體及方法:
```go
type sccProviderFactory struct {
}
//構造sccProviderImpl{}
func (c *sccProviderFactory) NewSystemChaincodeProvider() sysccprovider.SystemChaincodeProvider
//程式碼在core/scc/sccproviderimpl.go
```
SystemChaincodeProvider介面實現,即sccProviderImpl結構體及方法:
```go
type sccProviderImpl struct {
}
func (c *sccProviderImpl) IsSysCC(name string) bool //IsSysCC(name)
func (c *sccProviderImpl) IsSysCCAndNotInvokableCC2CC(name string) bool //IsSysCCAndNotInvokableCC2CC(name)
//l := peer.GetLedger(cid)
//l.NewQueryExecutor()
func (c *sccProviderImpl) GetQueryExecutorForLedger(cid string) (ledger.QueryExecutor, error)
//IsSysCCAndNotInvokableExternal(name)
func (c *sccProviderImpl) IsSysCCAndNotInvokableExternal(name string) bool
//程式碼在core/scc/sccproviderimpl.go
```
## 4、scc工具函式
systemChaincodes定義:
```go
var systemChaincodes = []*SystemChaincode{
{
Enabled: true,
Name: "cscc",
Path: "github.com/hyperledger/fabric/core/scc/cscc",
InitArgs: [][]byte{[]byte("")},
Chaincode: &cscc.PeerConfiger{},
InvokableExternal: true, // cscc is invoked to join a channel
},
{
Enabled: true,
Name: "lscc",
Path: "github.com/hyperledger/fabric/core/scc/lscc",
InitArgs: [][]byte{[]byte("")},
Chaincode: &lscc.LifeCycleSysCC{},
InvokableExternal: true, // lscc is invoked to deploy new chaincodes
InvokableCC2CC: true, // lscc can be invoked by other chaincodes
},
{
Enabled: true,
Name: "escc",
Path: "github.com/hyperledger/fabric/core/scc/escc",
InitArgs: [][]byte{[]byte("")},
Chaincode: &escc.EndorserOneValidSignature{},
},
{
Enabled: true,
Name: "vscc",
Path: "github.com/hyperledger/fabric/core/scc/vscc",
InitArgs: [][]byte{[]byte("")},
Chaincode: &vscc.ValidatorOneValidSignature{},
},
{
Enabled: true,
Name: "qscc",
Path: "github.com/hyperledger/fabric/core/chaincode/qscc",
InitArgs: [][]byte{[]byte("")},
Chaincode: &qscc.LedgerQuerier{},
InvokableExternal: true, // qscc can be invoked to retrieve blocks
InvokableCC2CC: true, // qscc can be invoked to retrieve blocks also by a cc
},
}
//程式碼在core/scc/importsysccs.go
```
涉及scc工具函式如下:
```go
func RegisterSysCCs() //遍歷systemChaincodes,呼叫RegisterSysCC(sysCC)
func DeploySysCCs(chainID string)//遍歷systemChaincodes,呼叫deploySysCC(chainID, sysCC)
func DeDeploySysCCs(chainID string)//遍歷systemChaincodes,呼叫DeDeploySysCC(chainID, sysCC)
func IsSysCC(name string) bool //是否系統鏈碼
func IsSysCCAndNotInvokableExternal(name string) bool //確認是系統鏈碼且不可被髮送到此節點的提案呼叫
func IsSysCCAndNotInvokableCC2CC(name string) bool //確認是系統鏈碼且不可通過chaincode-to-chaincode方式呼叫
//程式碼在core/scc/importsysccs.go
```
## 5、SystemChaincode結構體及方法
```go
type SystemChaincode struct {
Name string //系統鏈碼唯一名稱
Path string //系統鏈碼路徑,當前未使用
InitArgs [][]byte //啟動系統鏈碼的初始化引數
Chaincode shim.Chaincode //實際的shim.Chaincode物件
InvokableExternal bool //跟蹤是否可以被髮送到此節點的提案呼叫
InvokableCC2CC bool //跟蹤是否可以通過chaincode-to-chaincode方式呼叫
Enabled bool //啟用或禁用
}
//註冊系統鏈碼,呼叫inproccontroller.Register(syscc.Path, syscc.Chaincode)
func RegisterSysCC(syscc *SystemChaincode) error
func deploySysCC(chainID string, syscc *SystemChaincode) error //部署鏈碼
func DeDeploySysCC(chainID string, syscc *SystemChaincode) error //停止鏈碼
func buildSysCC(context context.Context, spec *pb.ChaincodeSpec) (*pb.ChaincodeDeploymentSpec, error) //編譯鏈碼
func isWhitelisted(syscc *SystemChaincode) bool //是否在白名單,基於chaincode.system配置
//程式碼在core/scc/sysccapi.go
```
網址:http://www.qukuailianxueyuan.io/
欲領取造幣技術與全套虛擬機器資料
區塊鏈技術交流QQ群:756146052 備註:CSDN
尹成學院微信:備註:CSDN
網址:http://www.qukuailianxueyuan.io/
欲領取造幣技術與全套虛擬機器資料
區塊鏈技術交流QQ群:756146052 備註:CSDN
尹成學院微信:備註:CSDN
相關文章
- Fabric 1.0原始碼分析(42)scc(系統鏈碼) #cscc(通道相關)原始碼
- Fabric 1.0原始碼分析(3)Chaincode(鏈碼)原始碼AI
- Fabric 1.0原始碼分析(5)Chaincode(鏈碼)體系總結原始碼AI
- Fabric 1.0原始碼分析(47)Fabric 1.0.4 go程式碼量統計原始碼Go
- Fabric 1.0原始碼分析(14) flogging(Fabric日誌系統)原始碼
- Fabric 1.0原始碼分析(25) Orderer原始碼
- Fabric 1.0原始碼分析(31) Peer原始碼
- Fabric 1.0原始碼分析(4)Chaincode(鏈碼)#platforms(鏈碼語言平臺)原始碼AIPlatform
- Fabric 1.0原始碼分析(29) Orderer #multichain(多鏈支援包)原始碼AI
- Fabric 1.0原始碼分析(40) Proposal(提案)原始碼
- Fabric 1.0原始碼分析(18) Ledger(賬本)原始碼
- Fabric 1.0原始碼分析(43) Tx(Transaction 交易)原始碼
- Fabric 1.0原始碼分析(13)events(事件服務)原始碼事件
- Fabric 1.0原始碼分析(26)Orderer #ledger(Orderer Ledger)原始碼
- Fabric 1.0原始碼分析(39) policy(背書策略)原始碼
- Fabric 1.0原始碼分析(1)BCCSP(區塊鏈加密服務提供者)原始碼區塊鏈加密
- Fabric 1.0原始碼分析(15)gossip(流言演算法)原始碼Go演算法
- Fabric 1.0原始碼分析(23)LevelDB(KV資料庫)原始碼資料庫
- Fabric 1.0原始碼分析(44)Tx #RWSet(讀寫集)原始碼
- 區塊鏈教程Fabric1.0原始碼分析policy(背書策略)-兄弟連區塊鏈區塊鏈原始碼
- Fabric 1.0原始碼分析(10)consenter(共識外掛)原始碼
- Fabric 1.0原始碼分析(35)Peer #EndorserServer(Endorser服務端)原始碼Server服務端
- Fabric 1.0原始碼分析(36) Peer #EndorserClient(Endorser客戶端)原始碼client客戶端
- Fabric 1.0原始碼分析(41)putils(protos/utils工具包)原始碼
- Fabric 1.0原始碼分析(45)gRPC(Fabric中註冊的gRPC Service)原始碼RPC
- Hyperledger Fabric系統鏈碼介紹
- Fabric 1.0原始碼分析(9)configtx(配置交易)體系介紹原始碼
- Fabric 1.0原始碼分析(2) blockfile(區塊檔案儲存)原始碼BloC
- Fabric 1.0原始碼分析(19) Ledger #statedb(狀態資料庫)原始碼資料庫
- Fabric 1.0原始碼分析(21)Ledger #historydb(歷史資料庫)原始碼資料庫
- Fabric 1.0原始碼分析(22)Ledger #blkstorage(block檔案儲存)原始碼BloC
- Fabric 1.0原始碼分析(32) Peer #peer node start命令實現原始碼
- Fabric 1.0原始碼分析(8)configtx(配置交易) #genesis(系統通道創世區塊)原始碼
- Fabric 1.0原始碼分析(20) Ledger #idStore(ledgerID資料庫)原始碼資料庫
- Fabric 1.0原始碼分析(30) Orderer #BroadcastServer(Broadcast服務端)原始碼ASTServer服務端
- Fabric 1.0原始碼分析(37) Peer #DeliverClient(Deliver客戶端)原始碼client客戶端
- Fabric 1.0原始碼分析(38) Peer #BroadcastClient(Broadcast客戶端)原始碼ASTclient客戶端
- Fabric 1.0原始碼分析(27) Orderer #configupdate(處理通道配置更新)原始碼