作者:你送的指环_526 | 来源:互联网 | 2023-08-11 10:43
区块链教程Fabric1.0源代码分析Tx(Transaction 交易)一,2018年下半年,区块链行业正逐渐褪去发展之初的浮躁、回归理性,表面上看相关人才需求与身价似乎正在回落。但事实上,正是初期泡沫的渐退,让人们更多的关注点放在了区块链真正的技术之上。
Fabric 1.0源代码笔记 之 Tx(Transaction 交易)
1、Tx概述
Tx,即Transaction,交易或事务。
Tx代码分布目录结构如下:
- protos/common/common.pb.go,交易的封装即Envelope结构体。也包括Payload、Header、ChannelHeader和SignatureHeader。
- protos/utils目录,交易相关部分工具函数,包括txutils.go、proputils.go和commonutils.go。
- core/ledger/kvledger/txmgmt目录
* rwsetutil目录,读写集相关结构体及方法。
* version目录,version.Height结构体及方法。
* validator目录,Validator接口及实现。
* txmgr目录,TxMgr接口及实现。
2、交易的封装Envelope结构体
有个图4
2.1、Envelope结构体
Envelope直译为信封,封装Payload和Signature。
type Envelope struct { //用签名包装Payload,以便对信息做身份验证 Payload []byte //Payload序列化 Signature []byte //Payload header中指定的创建者签名 } //代码在protos/common/common.pb.go
2.2、Payload相关结构体
Payload直译为有效载荷。Payload结构体:
type Payload struct { Header *Header //Header Data []byte //Transaction序列化 } //代码在protos/common/common.pb.go
Header结构体:
type Header struct { ChannelHeader []byte SignatureHeader []byte } //代码在protos/common/common.pb.go
ChannelHeader结构体:
type ChannelHeader struct { Type int32 Version int32 //消息协议版本 Timestamp *google_protobuf.Timestamp //创建消息时的本地时间 ChannelId string //消息绑定的ChannelId TxId string //TxId Epoch uint64 //纪元 Extension []byte //可附加的扩展 } //代码在protos/common/common.pb.go
补充HeaderType:
type HeaderType int32 const ( HeaderType_MESSAGE HeaderType = 0 HeaderType_CONFIG HeaderType = 1 HeaderType_CONFIG_UPDATE HeaderType = 2 HeaderType_ENDORSER_TRANSACTION HeaderType = 3 HeaderType_ORDERER_TRANSACTION HeaderType = 4 HeaderType_DELIVER_SEEK_INFO HeaderType = 5 HeaderType_CHAINCODE_PACKAGE HeaderType = 6 ) //代码在protos/common/common.pb.go
SignatureHeader结构体:
type SignatureHeader struct { Creator []byte //消息的创建者, 指定为证书链 Nonce []byte //可能只使用一次的任意数字,可用于检测重播攻击 } //代码在protos/common/common.pb.go
2.3、Transaction相关结构体
Transaction结构体:
type Transaction struct { Actions []*TransactionAction //Payload.Data是个TransactionAction数组,容纳每个交易 } //代码在protos/peer/transaction.pb.go
TransactionAction结构体:
type TransactionAction struct { Header []byte Payload []byte } //代码在protos/peer/transaction.pb.go
2.4、ChaincodeActionPayload相关结构体
ChaincodeActionPayload结构体:
type ChaincodeActionPayload struct { ChaincodeProposalPayload []byte Action *ChaincodeEndorsedAction } //代码在protos/peer/transaction.pb.go
ChaincodeEndorsedAction结构体:
type ChaincodeEndorsedAction struct { ProposalResponsePayload []byte //ProposalResponsePayload序列化 Endorsements []*Endorsement } //代码在protos/peer/transaction.pb.go
ProposalResponsePayload结构体:
type ProposalResponsePayload struct { ProposalHash []byte Extension []byte //ChaincodeAction序列化 } //代码在protos/peer/proposal_response.pb.go
ChaincodeAction结构体:
type ChaincodeAction struct { Results []byte //TxRwSet序列化 Events []byte Response *Response ChaincodeId *ChaincodeID } //代码在protos/peer/proposal.pb.go
3、交易验证代码TxValidationFlags
TxValidationFlags是交易验证代码的数组,在commiter验证块时使用。
type TxValidationFlags []uint8 //创建TxValidationFlags数组 func NewTxValidationFlags(size int) TxValidationFlags //为指定的交易设置交易验证代码 func (obj TxValidationFlags) SetFlag(txIndex int, flag peer.TxValidationCode) //获取指定交易的交易验证代码 func (obj TxValidationFlags) Flag(txIndex int) peer.TxValidationCode //检查指定的交易是否有效 func (obj TxValidationFlags) IsValid(txIndex int) bool //检查指定的交易是否无效 func (obj TxValidationFlags) IsInvalid(txIndex int) bool //指定交易的交易验证代码与flag比较,相同为true func (obj TxValidationFlags) IsSetTo(txIndex int, flag peer.TxValidationCode) bool //代码在core/ledger/util/txvalidationflags.go
补充peer.TxValidationCode:
type TxValidationCode int32 const ( TxValidationCode_VALID TxValidatiOnCode= 0 TxValidationCode_NIL_ENVELOPE TxValidatiOnCode= 1 TxValidationCode_BAD_PAYLOAD TxValidatiOnCode= 2 TxValidationCode_BAD_COMMON_HEADER TxValidatiOnCode= 3 TxValidationCode_BAD_CREATOR_SIGNATURE TxValidatiOnCode= 4 TxValidationCode_INVALID_ENDORSER_TRANSACTION TxValidatiOnCode= 5 TxValidationCode_INVALID_CONFIG_TRANSACTION TxValidatiOnCode= 6 TxValidationCode_UNSUPPORTED_TX_PAYLOAD TxValidatiOnCode= 7 TxValidationCode_BAD_PROPOSAL_TXID TxValidatiOnCode= 8 TxValidationCode_DUPLICATE_TXID TxValidatiOnCode= 9 TxValidationCode_ENDORSEMENT_POLICY_FAILURE TxValidatiOnCode= 10 TxValidationCode_MVCC_READ_CONFLICT TxValidatiOnCode= 11 TxValidationCode_PHANTOM_READ_CONFLICT TxValidatiOnCode= 12 TxValidationCode_UNKNOWN_TX_TYPE TxValidatiOnCode= 13 TxValidationCode_TARGET_CHAIN_NOT_FOUND TxValidatiOnCode= 14 TxValidationCode_MARSHAL_TX_ERROR TxValidatiOnCode= 15 TxValidationCode_NIL_TXACTION TxValidatiOnCode= 16 TxValidationCode_EXPIRED_CHAINCODE TxValidatiOnCode= 17 TxValidationCode_CHAINCODE_VERSION_CONFLICT TxValidatiOnCode= 18 TxValidationCode_BAD_HEADER_EXTENSION TxValidatiOnCode= 19 TxValidationCode_BAD_CHANNEL_HEADER TxValidatiOnCode= 20 TxValidationCode_BAD_RESPONSE_PAYLOAD TxValidatiOnCode= 21 TxValidationCode_BAD_RWSET TxValidatiOnCode= 22 TxValidationCode_ILLEGAL_WRITESET TxValidatiOnCode= 23 TxValidationCode_INVALID_OTHER_REASON TxValidatiOnCode= 255 ) //代码在protos/peer/transaction.pb.go 未完待续感谢关注兄弟连区块链教程分享!