区块链教程Fabric1.0源代码分析scc(系统链码)
2018-11-07 15:50
836 查看
区块链教程Fabric1.0源代码分析scc(系统链码),2018年下半年,区块链行业正逐渐褪去发展之初的浮躁、回归理性,表面上看相关人才需求与身价似乎正在回落。但事实上,正是初期泡沫的渐退,让人们更多的关注点放在了区块链真正的技术之上。
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,处理交易校验,包括检查背书策略和版本在并发时的控制。
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接口定义
接口定义如下:
type SystemChaincodeProviderFactory interface { //创建SystemChaincodeProvider NewSystemChaincodeProvider() SystemChaincodeProvider } //代码在core/common/sysccprovider/sysccprovider.go
全局变量及相关函数:
var sccFactory SystemChaincodeProviderFactory //为sccFactory赋值 func RegisterSystemChaincodeProviderFactory(sccfact SystemChaincodeProviderFactory) //获取sccFactory.NewSystemChaincodeProvider() func GetSystemChaincodeProvider() SystemChaincodeProvider { //代码在core/com 5b4 mon/sysccprovider/sysccprovider.go
补充ChaincodeInstance结构体定义:
type ChaincodeInstance struct { ChainID string //ID ChaincodeName string //名称 ChaincodeVersion string //版本 } //代码在core/common/sysccprovider/sysccprovider.go
2.2、SystemChaincodeProvider接口定义
接口定义如下:
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结构体及方法:
type sccProviderFactory struct { } //构造sccProviderImpl{} func (c *sccProviderFactory) NewSystemChaincodeProvider() sysccprovider.SystemChaincodeProvider //代码在core/scc/sccproviderimpl.go
SystemChaincodeProvider接口实现,即sccProviderImpl结构体及方法:
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定义:
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工具函数如下:
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结构体及方法
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
相关文章推荐
- 区块链教程Fabric1.0源代码分析flogging(Fabric日志系统)
- 区块链教程Fabric1.0源代码分析链码 链码语言平台
- 区块链教程Fabric1.0源代码分析Chaincode(链码)体系总结
- 区块链教程Fabric1.0源代码分析Ledger blkstorage block文件存储
- 区块链教程Fabric1.0源代码分析Orderer Ledge
- 区块链教程Fabric1.0源代码分析configupdate处理通道配置更新
- 区块链教程Fabric1.0源代码分析Ledger historydb历史数据库
- 区块链教程Fabric1.0源代码分析Orderer BroadcastServer
- 区块链教程Fabric1.0源代码分析Orderer multichain
- 兄弟连区块链教程Fabric1.0源代码分析ledgerID数据
- 区块链教程Fabric1.0源代码分析Orderer multichain多链支持包
- 区块链教程Fabric1.0源代码分析configtx#genesis
- 区块链教程Fabric1.0源代码分析Peer
- 区块链教程Fabric1.0源代码分析Ledger(账本)二
- 区块链教程Fabric1.0源代码分析流言算法Gossip服务端二
- 区块链教程Fabric1.0源代码分析Fabric1.0.4go代码量统计
- 区块链教程Fabric1.0源代码分析consenter#filter
- 区块链教程Fabric1.0源代码分析流言算法Gossip服务端二