【翻译】Hyperledger Fabric v1.1 中的系统链码

Hyperledger Fabric 交易流

Hyperledger Fabric v1.1提供了几个特殊的链码来执行某些特殊的任务,这些链码被称为系统链码 (System Chaincode)。本文的目的是简述这些链码的实现、功能和用法。与用户链码类似,系统链码也实现了 Init()Invoke() 方法。Fabric中一共有五种合约:

  1. Configuration System Chaincode (CSCC) -- core/scc/cscc/configure.go
  2. Life Cycle System Chaincode (LSCC) -- core/scc/lscc/lscc.go
  3. Query System Chaincode (QSCC) -- core/scc/qscc/query.go
  4. Endorser System Chaincode (ESCC) -- core/scc/escc/endorser_onevalidsignature.go
  5. Validator System Chaincode (VSCC) -- core/scc/vscc/validator_onevalidsignature.go

下面,将对每个系统链码的功能以及使用进行阐述。值得注意的是,因为我们可能需要传输golang结构体的序列化的protobuf bytes,用命令行(CLI)进行简单的invoke/query可能不能使用系统链码的提供的全部功能。因此,推荐使用SDK进行执行这些功能。在本文中,仅通过CLI执行invoke/query操作演示系统链码的部分功能。

1. Configuration System Chaincode (CSCC)

CSCC 管理peer上通道相关的信息以及执行通道配置交易。它提供五个方法:(i) JoinChain, (ii) GetConfigBlock, (iii) GetConfigTree, (iv) SimulateConfigTreeUpdate, (v) GetChannels

下面将介绍这些功能的使用。所有的命令都是在sample network (参考setup)中的指向peer0的客户端中执行的。为了运行CSCC相关的命令,我们需要在CLI命令中使用peer channelpeer 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

GetConfigTreeSimulateConfigTreeUpdate用于获取config结构和模拟执行config结构更新。如果要从一个通道添加或移除组织,必须获取config tree来进行修改,并在调用SimulateConfigTree方法时,必须获取CSCC的背书。

2. 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"]}'

3. 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"]}'

其他方法类似。

4. 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。

5. Validator System Chaincode (VSCC)

VSCC 被记账节点(core/committer/txvalidator/validator.go)调用,来根据合约的背书策略验证每个交易的签名集合。

译自:System Chaincodes in Hyperledger Fabric v1.1

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 217,657评论 6 505
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 92,889评论 3 394
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 164,057评论 0 354
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 58,509评论 1 293
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 67,562评论 6 392
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 51,443评论 1 302
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 40,251评论 3 418
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 39,129评论 0 276
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 45,561评论 1 314
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 37,779评论 3 335
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,902评论 1 348
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 35,621评论 5 345
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 41,220评论 3 328
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,838评论 0 22
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,971评论 1 269
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 48,025评论 2 370
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 44,843评论 2 354

推荐阅读更多精彩内容