Fabric 系统链码
什么是系统链码
fabric 自 1.0 版本开始,将链码分为系统链码和普通链码两种。普通链码(智能合约)用于实现业务逻辑,而系统链码则是用于系统管理,例如 lscc、qscc等。
与普通链码需要独立沙盒环境运行不同,系统链码在 peer 服务启动时随 peer 节点注册,同 peer 节点一起运行。
在 fabric 1.0 版本时,系统链码为固定的 5 个:lscc、qscc、cscc、vscc、escc,这 5 个链码功能固定,分别用于链码生命周期管理、区块/交易查询、通道配置管理、交易背书和交易验证。
什么是系统链码插件
系统链码使用方便,但是由于其功能、逻辑固定,不利于扩展。在 1.1 版本开始,fabric 允许定制自己的 vscc 和 escc,这样智能合约所能实现的交易模式会更加丰富。
实现这个功能就是 fabric 开始支持系统链码插件,通过插件的形式达到动态注册系统链码的目的。
有哪些系统链码
Hyperledger Fabric v1.1提供了几个特殊的链码来执行某些特殊的任务,这些链码被称为系统链码 (System Chaincode)。本文的目的是简述这些链码的实现、功能和用法。与用户链码类似,系统链码也实现了 Init() 和 Invoke() 方法。Fabric中一共有五种合约:
- Configuration System Chaincode (CSCC) – core/scc/cscc/configure.go
- Life Cycle System Chaincode (LSCC) – core/scc/lscc/lscc.go Query
- System Chaincode (QSCC) – core/scc/qscc/query.go Endorser System
- Chaincode (ESCC) – core/scc/escc/endorser_onevalidsignature.go
- Validator System Chaincode (VSCC) –
- core/scc/vscc/validator_onevalidsignature.go
下面,将对每个系统链码的功能以及使用进行阐述。值得注意的是,因为我们可能需要传输golang结构体的序列化的protobuf bytes,用命令行(CLI)进行简单的invoke/query可能不能使用系统链码的提供的全部功能。因此,推荐使用SDK进行执行这些功能。在本文中,仅通过CLI执行invoke/query操作演示系统链码的部分功能。
Configuration System Chaincode (CSCC)
CSCC 管理peer上通道相关的信息以及执行通道配置交易。它提供五个方法:(i) JoinChain, (ii) GetConfigBlock, (iii) GetConfigTree, (iv) SimulateConfigTreeUpdate, (v) GetChannels。
下面将介绍这些功能的使用。所有的命令都是在sample network (参考setup)中的指向peer0的客户端中执行的。为了运行CSCC相关的命令,我们需要在CLI命令中使用peer channel和peer chaincode。
JoinChain 方法用来使一个peer加入通道。它需要一个参数,即通道配置区块的序列化的protobuf bytes,其中通道配置区块作为peer channel create命令的返回从orderer获取。下面的CLI命令使peer加入名为ch1的通道。在调用CSCC时,peer channel join命令负责读取ch1.block并把它以bytes的形式传入。但是,如果我们直接使用peer chaincode invoke来调用JoinChain方法,将ch1.block的内容放入CLI请求是比较困难的。
$ peer channel join -b ch1.block
GetConfigBlock 方法用于获取给定通道的当前的配置区块。它需要一个参数,即通道名字的byte形式。如下的两条CLI命令都可以用于获取通道mychannel的配置区块。
$ peer chaincode query -C "mychannel" -n cscc -c '{"Args":["GetConfigBlock", "mychannel"]}'
或
peer channel fetch -o orderer0:7050 config -c mychannel
GetChannels方法用于获取peer目前所加入的通道。如下的两条CLI命令都可以用于获取所有的通道。
$ peer chaincode query -C "" -n cscc -c '{"Args":["GetChannels"]}'
或
$ peer channel list
GetConfigTree和SimulateConfigTreeUpdate用于获取config结构和模拟执行config结构更新。如果要从一个通道添加或移除组织,必须获取config tree来进行修改,并在调用SimulateConfigTree方法时,必须获取CSCC的背书。
Life Cycle System Chaincode (LSCC)
LSCC 用于管理链码的生命周期——在peer上安装、在通道上部署和升级、用户从运行中的链码获取信息。它提供了八个方法:(i) install, (ii) deploy, (iii) upgrade, (iv) getid, (v) getdepspec, (vi) getccdata, (vii) getchaincodes, (viii) getinstalledchaincodes。
install方法用于存储chaincode程序到peer的文件系统(/var/hyperledger/production/chaincodes)。它需要一个参数,即chaincode deployment spec (core/common/ccprovider/cdspackage.go)的序列化protobuf bytes。尽管我们可以通过传入整个chaincode的内容来直接调用LSCC,但更好的做法是使用peer chaincode install命令,这个命令在其将通过读取chaincode的内容对LSCC进行调用。
$ peer chaincode install -n mycc -v 1.0 -p
github.com/hyperledger/fabric/examples/chaincode/go/chaincode_example02
deploy方法用于在给定的通道上实例化合约。它可以接受五个参数,前两个参数——通道的名字和chaincode deployment spec是必须的,其他是那个参数——背书策略、背书系统合约的名字和验证系统合约的名字是可选的。
$ peer chaincode instantiate -o orderer0:7050 -C mychannel -n mycc -v 1.0 -c '{"Args":["init","a","100","b","200"]}' -P "OR ('Org1MSP', 'Org2MSP')"
getdepspec方法用于获取安装在peer上的合约的chaincode deployment spec。下面的CLI命令将从通道mychannel中获取mycc合约的deployment spec。
$ peer chaincode query -C mychannel -n lscc -c '{"Args":["getdepspec", "mychannel", "mychannel"]}'
getchaincodes方法用于获取在部署在通道上的合约的列表。如下CLI命令从通道mychannel上获取实例化的合约列表。
$ peer chaincode query -C mychannel -n lscc -c '{"Args":["getchaincodes"]}'
getinstalledchaincodes方法用于获取在peer上安装的合约的列表。
$ peer chaincode query -C "" -n lscc -c '{"Args":["getinstalledchaincodes"]}'
upgrade方法用于升级合约。
$ peer chaincode upgrade -o orderer0:7050 -C mychannel -n mycc -v 2.0 -c '{"Args":["reinit"]}' -P "OR ('Org1MSP', 'Org2MSP')"
getid用于获取合约的id
$ peer chaincode query -C mychannel -n lscc -c '{"Args":["getid","mychannel","mycc"]}'
getccdata用于获取合约的数据。
$ peer chaincode query -C mychannel -n lscc -c '{"Args":["getccdata","mychannel","mycc"]}'
Query System Chaincode (QSCC)
QSCC 将特定的方法暴露给用户,使得用户可以查询在block storage中存储的区块和交易。它提供五个方法:(i) GetChainInfo, (ii) GetBlockByNumber, (iii) GetBlockByHash, (iv) GetTransactionByID, (v) GetBlockByTxID。
GetBlockByNumber方法用于获取序列化的区块。下面的CLI命令从通道mychannel中获取序号为3的区块。
$ peer chaincode query -C mychannel -n qscc -c '{"Args":["GetBlockByNumber", "mychannel", "3"]}'
其他方法类似。
Endorser System Chaincode (ESCC)
ESCC 被背书节点(core/endorser/endorser.go)调用。背书节点在执行交易之后,将它的前面放在transaction response message中。其中,transaction response message也包括交集执行的结果,如交易状态、合约事件和read/write set等。一个调用功能可以包含5-7个参数,即Header、ChaincodeProposalPayload、ChaincodeID、Response、simulation result、events、payload visibility。
Validator System Chaincode (VSCC)
VSCC 被记账节点(core/committer/txvalidator/validator.go)调用,来根据合约的背书策略验证每个交易的签名集合。
Fabric 系统链码相关推荐
- Fabric 1.0源代码分析(42)scc(系统链码) #cscc(通道相关)
# Fabric 1.0源代码笔记 之 scc(系统链码) #cscc(通道相关) ## 1.cscc概述 cscc代码在core/scc/cscc/configure.go. ## 2.PeerCo ...
- 区块链教程Fabric1.0源代码分析scc(系统链码)
区块链教程Fabric1.0源代码分析scc(系统链码),2018年下半年,区块链行业正逐渐褪去发展之初的浮躁.回归理性,表面上看相关人才需求与身价似乎正在回落.但事实上,正是初期泡沫的渐退,让人们更 ...
- fabric系统逻辑结构图,VMware下载安装,VMware安装ubuntu
fabric系统逻辑结构图 org: fabric系统是通过组织来划分的 ,每个组织内都有承担不同功能的peer节点,同时每个组织都有自己对应的fabric-ca服务器,fabric系统中所有的组织共 ...
- fabric contract链码案例
fabric提供了合约的操作接口,这些接口从原来的源代码里独立出来了,变成fabric-contract-api-go,这里以fabric v1.4.8 + fabric-contract-a ...
- Fabric系列 - 链码 ChainCode
链码(chaincode)是 Hyperledger Fabric 提供的智能合约,是上层应用与底层区块链平台交互的媒介.现阶段,Fabric 提供 Go.Java.Node.js 等语言编写的链码 ...
- Fabric安装链码出现的问题01
在安装链码中出现了: Error: chaincode install failed with status: 500 - failed to invoke backing implementatio ...
- fabric 一个链码如何调用另一个链码
https://blog.csdn.net/xjyr/article/details/83267788 https://blog.csdn.net/xiaohuanglv/article/detail ...
- 华为云区块链BCS笔记
P:Peer节点,背书功能(Endorser),执行交提案并背书,提交功能(commiteer):交易最终检查和落盘. O:Orderer节点,排序功能,为全网收到的所有交易进行全局排序,并在Orde ...
- fabric 启动peer_编写 Fabric 链码的一般准则
我相信智能合约(链码)是 Hyperledger Fabric 区块链网络的核心.正确开发链码可以真正发挥一个安全区块链的优势,反之则会带来灾难性的后果.在这篇文章里我不打算探讨 Hyperledge ...
最新文章
- 2021年大数据Flink(一):乘风破浪的Flink-Flink概述
- 用Leangoo Scrum看板工具管理OKR-目标管理
- 软件测试推荐专业,软件测试专业老师推荐信
- 把十六进制字符转换成十进制数
- java se 9.0.4_jre 9下载(Java SE Runtime Environment)下载
- Spring 学习 3- AOP
- 总结一下SubSonic使用技巧
- 解决方法:未能加载文件或程序集“Microsoft.Office.Interop.Excel。。
- AHU算法课-DP动态规划
- 葫芦娃登录后显示服务器维护,葫芦娃手游新手常见问题解答
- 正则只保留括号里的内容
- 关于卫星伪距残差的理解
- linux conforming code segment nonconforming code segment
- 华为鸿蒙亮利剑,华为亮利剑,超级主镜头+鸿蒙OS,所有期许或将如愿以偿
- freemarker遍历list处理第一个、最后一个元素
- 程序员分界线:30岁,30岁转行、35岁转行、35岁被迫裁员
- 魔兽中的dx写屏(原版为英文)
- 安装SQl Server Polybase 报错解决方法
- PTA 求最大、次大和第3大的值 (25 分)
- 选矿的元宇宙,工艺的3D场景再现
热门文章
- 产品思维考察之对象思维
- SWUSTOJ #617 班级课程成绩计算
- C#练习题答案: TO DE-RY-PO-陆琪暗号【难度:1级】--景越C#经典编程题库,1000道C#基础练习题等你来挑战
- 2022研究生学术与职业素养讲座(MOOC)期末答案
- DM backup database 报错[-7169](bakres与dmap消息通信失败)
- scal实现工厂方法模式
- 推荐几款个人灰常喜欢的vscode 主题
- springboot 集成redis key乱码\xac\xed\x00\x05t\x00\x0eHAOKE_HOT_WORD
- MT4安卓版下载安装
- 计算机考试网络应用题一定要做到ie浏览器,2016年计算机二级《MSOffice》考前考试卷及答案...