import "github.com/hyperledger/fabric-protos-go/ledger/rwset/kvrwset"
type HashedRWSet struct {
HashedReads []*KVReadHash `protobuf:"bytes,1,rep,name=hashed_reads,json=hashedReads,proto3" json:"hashed_reads,omitempty"`
HashedWrites []*KVWriteHash `protobuf:"bytes,2,rep,name=hashed_writes,json=hashedWrites,proto3" json:"hashed_writes,omitempty"`
MetadataWrites []*KVMetadataWriteHash `protobuf:"bytes,3,rep,name=metadata_writes,json=metadataWrites,proto3" json:"metadata_writes,omitempty"`
XXX_NoUnkeyedLiteral struct{} `json:"-"`
XXX_unrecognized []byte `json:"-"`
XXX_sizecache int32 `json:"-"`
}HashedRWSet encapsulates hashed representation of a private read-write set for KV or Document data model
func (*HashedRWSet) Descriptor() ([]byte, []int)
func (m *HashedRWSet) GetHashedReads() []*KVReadHash
func (m *HashedRWSet) GetHashedWrites() []*KVWriteHash
func (m *HashedRWSet) GetMetadataWrites() []*KVMetadataWriteHash
func (*HashedRWSet) ProtoMessage()
func (m *HashedRWSet) Reset()
func (m *HashedRWSet) String() string
func (m *HashedRWSet) XXX_DiscardUnknown()
func (m *HashedRWSet) XXX_Merge(src proto.Message)
func (m *HashedRWSet) XXX_Size() int
func (m *HashedRWSet) XXX_Unmarshal(b []byte) error
type KVMetadataEntry struct {
Name string `protobuf:"bytes,1,opt,name=name,proto3" json:"name,omitempty"`
Value []byte `protobuf:"bytes,2,opt,name=value,proto3" json:"value,omitempty"`
XXX_NoUnkeyedLiteral struct{} `json:"-"`
XXX_unrecognized []byte `json:"-"`
XXX_sizecache int32 `json:"-"`
}KVMetadataEntry captures a 'name'ed entry in the metadata of a key/key-hash.
func (*KVMetadataEntry) Descriptor() ([]byte, []int)
func (m *KVMetadataEntry) GetName() string
func (m *KVMetadataEntry) GetValue() []byte
func (*KVMetadataEntry) ProtoMessage()
func (m *KVMetadataEntry) Reset()
func (m *KVMetadataEntry) String() string
func (m *KVMetadataEntry) XXX_DiscardUnknown()
func (m *KVMetadataEntry) XXX_Merge(src proto.Message)
func (m *KVMetadataEntry) XXX_Size() int
func (m *KVMetadataEntry) XXX_Unmarshal(b []byte) error
type KVMetadataWrite struct {
Key string `protobuf:"bytes,1,opt,name=key,proto3" json:"key,omitempty"`
Entries []*KVMetadataEntry `protobuf:"bytes,2,rep,name=entries,proto3" json:"entries,omitempty"`
XXX_NoUnkeyedLiteral struct{} `json:"-"`
XXX_unrecognized []byte `json:"-"`
XXX_sizecache int32 `json:"-"`
}KVMetadataWrite captures all the entries in the metadata associated with a key
func (*KVMetadataWrite) Descriptor() ([]byte, []int)
func (m *KVMetadataWrite) GetEntries() []*KVMetadataEntry
func (m *KVMetadataWrite) GetKey() string
func (*KVMetadataWrite) ProtoMessage()
func (m *KVMetadataWrite) Reset()
func (m *KVMetadataWrite) String() string
func (m *KVMetadataWrite) XXX_DiscardUnknown()
func (m *KVMetadataWrite) XXX_Merge(src proto.Message)
func (m *KVMetadataWrite) XXX_Size() int
func (m *KVMetadataWrite) XXX_Unmarshal(b []byte) error
type KVMetadataWriteHash struct {
KeyHash []byte `protobuf:"bytes,1,opt,name=key_hash,json=keyHash,proto3" json:"key_hash,omitempty"`
Entries []*KVMetadataEntry `protobuf:"bytes,2,rep,name=entries,proto3" json:"entries,omitempty"`
XXX_NoUnkeyedLiteral struct{} `json:"-"`
XXX_unrecognized []byte `json:"-"`
XXX_sizecache int32 `json:"-"`
}KVMetadataWriteHash captures all the upserts to the metadata associated with a key hash
func (*KVMetadataWriteHash) Descriptor() ([]byte, []int)
func (m *KVMetadataWriteHash) GetEntries() []*KVMetadataEntry
func (m *KVMetadataWriteHash) GetKeyHash() []byte
func (*KVMetadataWriteHash) ProtoMessage()
func (m *KVMetadataWriteHash) Reset()
func (m *KVMetadataWriteHash) String() string
func (m *KVMetadataWriteHash) XXX_DiscardUnknown()
func (m *KVMetadataWriteHash) XXX_Merge(src proto.Message)
func (m *KVMetadataWriteHash) XXX_Size() int
func (m *KVMetadataWriteHash) XXX_Unmarshal(b []byte) error
type KVRWSet struct {
Reads []*KVRead `protobuf:"bytes,1,rep,name=reads,proto3" json:"reads,omitempty"`
RangeQueriesInfo []*RangeQueryInfo `protobuf:"bytes,2,rep,name=range_queries_info,json=rangeQueriesInfo,proto3" json:"range_queries_info,omitempty"`
Writes []*KVWrite `protobuf:"bytes,3,rep,name=writes,proto3" json:"writes,omitempty"`
MetadataWrites []*KVMetadataWrite `protobuf:"bytes,4,rep,name=metadata_writes,json=metadataWrites,proto3" json:"metadata_writes,omitempty"`
XXX_NoUnkeyedLiteral struct{} `json:"-"`
XXX_unrecognized []byte `json:"-"`
XXX_sizecache int32 `json:"-"`
}KVRWSet encapsulates the read-write set for a chaincode that operates upon a KV or Document data model This structure is used for both the public data and the private data
func (m *KVRWSet) GetMetadataWrites() []*KVMetadataWrite
func (m *KVRWSet) GetRangeQueriesInfo() []*RangeQueryInfo
type KVRead struct {
Key string `protobuf:"bytes,1,opt,name=key,proto3" json:"key,omitempty"`
Version *Version `protobuf:"bytes,2,opt,name=version,proto3" json:"version,omitempty"`
XXX_NoUnkeyedLiteral struct{} `json:"-"`
XXX_unrecognized []byte `json:"-"`
XXX_sizecache int32 `json:"-"`
}KVRead captures a read operation performed during transaction simulation A 'nil' version indicates a non-existing key read by the transaction
type KVReadHash struct {
KeyHash []byte `protobuf:"bytes,1,opt,name=key_hash,json=keyHash,proto3" json:"key_hash,omitempty"`
Version *Version `protobuf:"bytes,2,opt,name=version,proto3" json:"version,omitempty"`
XXX_NoUnkeyedLiteral struct{} `json:"-"`
XXX_unrecognized []byte `json:"-"`
XXX_sizecache int32 `json:"-"`
}KVReadHash is similar to the KVRead in spirit. However, it captures the hash of the key instead of the key itself version is kept as is for now. However, if the version also needs to be privacy-protected, it would need to be the hash of the version and hence of 'bytes' type
func (*KVReadHash) Descriptor() ([]byte, []int)
func (m *KVReadHash) GetKeyHash() []byte
func (m *KVReadHash) GetVersion() *Version
func (*KVReadHash) ProtoMessage()
func (m *KVReadHash) Reset()
func (m *KVReadHash) String() string
func (m *KVReadHash) XXX_DiscardUnknown()
func (m *KVReadHash) XXX_Merge(src proto.Message)
func (m *KVReadHash) XXX_Size() int
func (m *KVReadHash) XXX_Unmarshal(b []byte) error
type KVWrite struct {
Key string `protobuf:"bytes,1,opt,name=key,proto3" json:"key,omitempty"`
IsDelete bool `protobuf:"varint,2,opt,name=is_delete,json=isDelete,proto3" json:"is_delete,omitempty"`
Value []byte `protobuf:"bytes,3,opt,name=value,proto3" json:"value,omitempty"`
XXX_NoUnkeyedLiteral struct{} `json:"-"`
XXX_unrecognized []byte `json:"-"`
XXX_sizecache int32 `json:"-"`
}KVWrite captures a write (update/delete) operation performed during transaction simulation
type KVWriteHash struct {
KeyHash []byte `protobuf:"bytes,1,opt,name=key_hash,json=keyHash,proto3" json:"key_hash,omitempty"`
IsDelete bool `protobuf:"varint,2,opt,name=is_delete,json=isDelete,proto3" json:"is_delete,omitempty"`
ValueHash []byte `protobuf:"bytes,3,opt,name=value_hash,json=valueHash,proto3" json:"value_hash,omitempty"`
XXX_NoUnkeyedLiteral struct{} `json:"-"`
XXX_unrecognized []byte `json:"-"`
XXX_sizecache int32 `json:"-"`
}KVWriteHash is similar to the KVWrite. It captures a write (update/delete) operation performed during transaction simulation
func (*KVWriteHash) Descriptor() ([]byte, []int)
func (m *KVWriteHash) GetIsDelete() bool
func (m *KVWriteHash) GetKeyHash() []byte
func (m *KVWriteHash) GetValueHash() []byte
func (*KVWriteHash) ProtoMessage()
func (m *KVWriteHash) Reset()
func (m *KVWriteHash) String() string
func (m *KVWriteHash) XXX_DiscardUnknown()
func (m *KVWriteHash) XXX_Merge(src proto.Message)
func (m *KVWriteHash) XXX_Size() int
func (m *KVWriteHash) XXX_Unmarshal(b []byte) error
type QueryReads struct {
KvReads []*KVRead `protobuf:"bytes,1,rep,name=kv_reads,json=kvReads,proto3" json:"kv_reads,omitempty"`
XXX_NoUnkeyedLiteral struct{} `json:"-"`
XXX_unrecognized []byte `json:"-"`
XXX_sizecache int32 `json:"-"`
}QueryReads encapsulates the KVReads for the items read by a transaction as a result of a query execution
func (*QueryReads) Descriptor() ([]byte, []int)
func (m *QueryReads) GetKvReads() []*KVRead
func (*QueryReads) ProtoMessage()
func (m *QueryReads) Reset()
func (m *QueryReads) String() string
func (m *QueryReads) XXX_DiscardUnknown()
func (m *QueryReads) XXX_Merge(src proto.Message)
func (m *QueryReads) XXX_Size() int
func (m *QueryReads) XXX_Unmarshal(b []byte) error
type QueryReadsMerkleSummary struct {
MaxDegree uint32 `protobuf:"varint,1,opt,name=max_degree,json=maxDegree,proto3" json:"max_degree,omitempty"`
MaxLevel uint32 `protobuf:"varint,2,opt,name=max_level,json=maxLevel,proto3" json:"max_level,omitempty"`
MaxLevelHashes [][]byte `protobuf:"bytes,3,rep,name=max_level_hashes,json=maxLevelHashes,proto3" json:"max_level_hashes,omitempty"`
XXX_NoUnkeyedLiteral struct{} `json:"-"`
XXX_unrecognized []byte `json:"-"`
XXX_sizecache int32 `json:"-"`
}QueryReadsMerkleSummary encapsulates the Merkle-tree hashes for the QueryReads This allows to reduce the size of RWSet in the presence of query results by storing certain hashes instead of actual results. maxDegree field refers to the maximum number of children in the tree at any level maxLevel field contains the lowest level which has lesser nodes than maxDegree (starting from leaf level)
func (*QueryReadsMerkleSummary) Descriptor() ([]byte, []int)
func (m *QueryReadsMerkleSummary) GetMaxDegree() uint32
func (m *QueryReadsMerkleSummary) GetMaxLevel() uint32
func (m *QueryReadsMerkleSummary) GetMaxLevelHashes() [][]byte
func (*QueryReadsMerkleSummary) ProtoMessage()
func (m *QueryReadsMerkleSummary) Reset()
func (m *QueryReadsMerkleSummary) String() string
func (m *QueryReadsMerkleSummary) XXX_DiscardUnknown()
func (m *QueryReadsMerkleSummary) XXX_Merge(src proto.Message)
func (m *QueryReadsMerkleSummary) XXX_Size() int
func (m *QueryReadsMerkleSummary) XXX_Unmarshal(b []byte) error
type RangeQueryInfo struct {
StartKey string `protobuf:"bytes,1,opt,name=start_key,json=startKey,proto3" json:"start_key,omitempty"`
EndKey string `protobuf:"bytes,2,opt,name=end_key,json=endKey,proto3" json:"end_key,omitempty"`
ItrExhausted bool `protobuf:"varint,3,opt,name=itr_exhausted,json=itrExhausted,proto3" json:"itr_exhausted,omitempty"`
// Types that are valid to be assigned to ReadsInfo:
// *RangeQueryInfo_RawReads
// *RangeQueryInfo_ReadsMerkleHashes
ReadsInfo isRangeQueryInfo_ReadsInfo `protobuf_oneof:"reads_info"`
XXX_NoUnkeyedLiteral struct{} `json:"-"`
XXX_unrecognized []byte `json:"-"`
XXX_sizecache int32 `json:"-"`
}RangeQueryInfo encapsulates the details of a range query performed by a transaction during simulation. This helps protect transactions from phantom reads by varifying during validation whether any new items got committed within the given range between transaction simuation and validation (in addition to regular checks for updates/deletes of the existing items). readInfo field contains either the KVReads (for the items read by the range query) or a merkle-tree hash if the KVReads exceeds a pre-configured numbers
func (*RangeQueryInfo) Descriptor() ([]byte, []int)
func (m *RangeQueryInfo) GetEndKey() string
func (m *RangeQueryInfo) GetItrExhausted() bool
func (m *RangeQueryInfo) GetRawReads() *QueryReads
func (m *RangeQueryInfo) GetReadsInfo() isRangeQueryInfo_ReadsInfo
func (m *RangeQueryInfo) GetReadsMerkleHashes() *QueryReadsMerkleSummary
func (m *RangeQueryInfo) GetStartKey() string
func (*RangeQueryInfo) ProtoMessage()
func (m *RangeQueryInfo) Reset()
func (m *RangeQueryInfo) String() string
func (m *RangeQueryInfo) XXX_DiscardUnknown()
func (m *RangeQueryInfo) XXX_Merge(src proto.Message)
func (*RangeQueryInfo) XXX_OneofWrappers() []interface{}
XXX_OneofWrappers is for the internal use of the proto package.
func (m *RangeQueryInfo) XXX_Size() int
func (m *RangeQueryInfo) XXX_Unmarshal(b []byte) error
type RangeQueryInfo_RawReads struct {
RawReads *QueryReads `protobuf:"bytes,4,opt,name=raw_reads,json=rawReads,proto3,oneof"`
}type RangeQueryInfo_ReadsMerkleHashes struct {
ReadsMerkleHashes *QueryReadsMerkleSummary `protobuf:"bytes,5,opt,name=reads_merkle_hashes,json=readsMerkleHashes,proto3,oneof"`
}type Version struct {
BlockNum uint64 `protobuf:"varint,1,opt,name=block_num,json=blockNum,proto3" json:"block_num,omitempty"`
TxNum uint64 `protobuf:"varint,2,opt,name=tx_num,json=txNum,proto3" json:"tx_num,omitempty"`
XXX_NoUnkeyedLiteral struct{} `json:"-"`
XXX_unrecognized []byte `json:"-"`
XXX_sizecache int32 `json:"-"`
}Version encapsulates the version of a Key A version of a committed key is maintained as the height of the transaction that committed the key. The height is represenetd as a tuple <blockNum, txNum> where the txNum is the position of the transaction (starting with 0) within block
Package kvrwset imports 3 packages (graph) and is imported by 23 packages. Updated 2019-08-23. Refresh now. Tools for package owners.