types

Class LedgerInfoOuterClass.LedgerInfo.Builder

java.lang.Object

com.google.protobuf.AbstractMessageLite.Builder

com.google.protobuf.AbstractMessage.Builder<BuilderType>

com.google.protobuf.GeneratedMessageV3.Builder<LedgerInfoOuterClass.LedgerInfo.Builder>

types.LedgerInfoOuterClass.LedgerInfo.Builder

All Implemented Interfaces:

com.google.protobuf.Message.Builder, com.google.protobuf.MessageLite.Builder, com.google.protobuf.MessageLiteOrBuilder, com.google.protobuf.MessageOrBuilder, Cloneable, LedgerInfoOuterClass.LedgerInfoOrBuilder

Enclosing class:

LedgerInfoOuterClass.LedgerInfo

public static final class LedgerInfoOuterClass.LedgerInfo.Builder
extends com.google.protobuf.GeneratedMessageV3.Builder<LedgerInfoOuterClass.LedgerInfo.Builder>
implements LedgerInfoOuterClass.LedgerInfoOrBuilder

/ Even though we don't always need all hashes, we pass them in and return them
 / always so that we keep them in sync on the client and don't make the client
 / worry about which one(s) to pass in which cases
 /
 / This structure serves a dual purpose.
 /
 / First, if this structure is signed by 2f+1 validators it signifies the state
 / of the ledger at version `version` -- it contains the transaction
 / accumulator at that version which commits to all historical transactions.
 / This structure may be expanded to include other information that is derived
 / from that accumulator (e.g. the current time according to the time contract)
 / to reduce the number of proofs a client must get.
 /
 / Second, the structure contains a `consensus_data_hash` value. This is the
 / hash of an internal data structure that represents a block that is voted on
 / by consensus.
 /
 / Combining these two concepts when the consensus algorithm votes on a block B
 / it votes for a LedgerInfo with the `version` being the latest version that
 / will be committed if B gets 2f+1 votes. It sets `consensus_data_hash` to
 / represent B so that if those 2f+1 votes are gathered, the block is valid to
 / commit
 

Protobuf type types.LedgerInfo

Method Summary

Modifier and Type	Method and Description
LedgerInfoOuterClass.LedgerInfo.Builder	addRepeatedField(com.google.protobuf.Descriptors.FieldDescriptor field, Object value)
LedgerInfoOuterClass.LedgerInfo	build()
LedgerInfoOuterClass.LedgerInfo	buildPartial()
LedgerInfoOuterClass.LedgerInfo.Builder	clear()
LedgerInfoOuterClass.LedgerInfo.Builder	clearConsensusBlockId() The block id of the last committed block corresponding to this ledger info.
LedgerInfoOuterClass.LedgerInfo.Builder	clearConsensusDataHash() Hash of consensus-specific data that is opaque to all parts of the system other than consensus.
LedgerInfoOuterClass.LedgerInfo.Builder	clearEpochNum() Epoch number corresponds to the set of validators that are active for this ledger info.
LedgerInfoOuterClass.LedgerInfo.Builder	clearField(com.google.protobuf.Descriptors.FieldDescriptor field)
LedgerInfoOuterClass.LedgerInfo.Builder	clearOneof(com.google.protobuf.Descriptors.OneofDescriptor oneof)
LedgerInfoOuterClass.LedgerInfo.Builder	clearTimestampUsecs() Timestamp that represents the microseconds since the epoch (unix time) that is generated by the proposer of the block.
LedgerInfoOuterClass.LedgerInfo.Builder	clearTransactionAccumulatorHash() Root hash of transaction accumulator at this version
LedgerInfoOuterClass.LedgerInfo.Builder	clearVersion() Current latest version of the system
LedgerInfoOuterClass.LedgerInfo.Builder	clone()
com.google.protobuf.ByteString	getConsensusBlockId() The block id of the last committed block corresponding to this ledger info.
com.google.protobuf.ByteString	getConsensusDataHash() Hash of consensus-specific data that is opaque to all parts of the system other than consensus.
LedgerInfoOuterClass.LedgerInfo	getDefaultInstanceForType()
static com.google.protobuf.Descriptors.Descriptor	getDescriptor()
com.google.protobuf.Descriptors.Descriptor	getDescriptorForType()
long	getEpochNum() Epoch number corresponds to the set of validators that are active for this ledger info.
long	getTimestampUsecs() Timestamp that represents the microseconds since the epoch (unix time) that is generated by the proposer of the block.
com.google.protobuf.ByteString	getTransactionAccumulatorHash() Root hash of transaction accumulator at this version
long	getVersion() Current latest version of the system
protected com.google.protobuf.GeneratedMessageV3.FieldAccessorTable	internalGetFieldAccessorTable()
boolean	isInitialized()
LedgerInfoOuterClass.LedgerInfo.Builder	mergeFrom(com.google.protobuf.CodedInputStream input, com.google.protobuf.ExtensionRegistryLite extensionRegistry)
LedgerInfoOuterClass.LedgerInfo.Builder	mergeFrom(LedgerInfoOuterClass.LedgerInfo other)
LedgerInfoOuterClass.LedgerInfo.Builder	mergeFrom(com.google.protobuf.Message other)
LedgerInfoOuterClass.LedgerInfo.Builder	mergeUnknownFields(com.google.protobuf.UnknownFieldSet unknownFields)
LedgerInfoOuterClass.LedgerInfo.Builder	setConsensusBlockId(com.google.protobuf.ByteString value) The block id of the last committed block corresponding to this ledger info.
LedgerInfoOuterClass.LedgerInfo.Builder	setConsensusDataHash(com.google.protobuf.ByteString value) Hash of consensus-specific data that is opaque to all parts of the system other than consensus.
LedgerInfoOuterClass.LedgerInfo.Builder	setEpochNum(long value) Epoch number corresponds to the set of validators that are active for this ledger info.
LedgerInfoOuterClass.LedgerInfo.Builder	setField(com.google.protobuf.Descriptors.FieldDescriptor field, Object value)
LedgerInfoOuterClass.LedgerInfo.Builder	setRepeatedField(com.google.protobuf.Descriptors.FieldDescriptor field, int index, Object value)
LedgerInfoOuterClass.LedgerInfo.Builder	setTimestampUsecs(long value) Timestamp that represents the microseconds since the epoch (unix time) that is generated by the proposer of the block.
LedgerInfoOuterClass.LedgerInfo.Builder	setTransactionAccumulatorHash(com.google.protobuf.ByteString value) Root hash of transaction accumulator at this version
LedgerInfoOuterClass.LedgerInfo.Builder	setUnknownFields(com.google.protobuf.UnknownFieldSet unknownFields)
LedgerInfoOuterClass.LedgerInfo.Builder	setVersion(long value) Current latest version of the system

Methods inherited from class com.google.protobuf.GeneratedMessageV3.Builder

getAllFields, getField, getFieldBuilder, getOneofFieldDescriptor, getParentForChildren, getRepeatedField, getRepeatedFieldBuilder, getRepeatedFieldCount, getUnknownFields, hasField, hasOneof, internalGetMapField, internalGetMutableMapField, isClean, markClean, newBuilderForField, onBuilt, onChanged, setUnknownFieldsProto3

Methods inherited from class com.google.protobuf.AbstractMessage.Builder

findInitializationErrors, getInitializationErrorString, internalMergeFrom, mergeDelimitedFrom, mergeDelimitedFrom, mergeFrom, mergeFrom, mergeFrom, mergeFrom, mergeFrom, mergeFrom, mergeFrom, mergeFrom, mergeFrom, newUninitializedMessageException, toString

Methods inherited from class com.google.protobuf.AbstractMessageLite.Builder

addAll, addAll, mergeFrom, newUninitializedMessageException

Methods inherited from class java.lang.Object

equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface com.google.protobuf.MessageOrBuilder

findInitializationErrors, getAllFields, getField, getInitializationErrorString, getOneofFieldDescriptor, getRepeatedField, getRepeatedFieldCount, getUnknownFields, hasField, hasOneof

Methods inherited from interface com.google.protobuf.MessageLite.Builder

mergeFrom

Method Detail

getDescriptor

public static final com.google.protobuf.Descriptors.Descriptor getDescriptor()

internalGetFieldAccessorTable

protected com.google.protobuf.GeneratedMessageV3.FieldAccessorTable internalGetFieldAccessorTable()

Specified by:

internalGetFieldAccessorTable in class com.google.protobuf.GeneratedMessageV3.Builder<LedgerInfoOuterClass.LedgerInfo.Builder>

clear

public LedgerInfoOuterClass.LedgerInfo.Builder clear()

Specified by:

clear in interface com.google.protobuf.Message.Builder

Specified by:

clear in interface com.google.protobuf.MessageLite.Builder

Overrides:

clear in class com.google.protobuf.GeneratedMessageV3.Builder<LedgerInfoOuterClass.LedgerInfo.Builder>

getDescriptorForType

public com.google.protobuf.Descriptors.Descriptor getDescriptorForType()

Specified by:

getDescriptorForType in interface com.google.protobuf.Message.Builder

Specified by:

getDescriptorForType in interface com.google.protobuf.MessageOrBuilder

Overrides:

getDescriptorForType in class com.google.protobuf.GeneratedMessageV3.Builder<LedgerInfoOuterClass.LedgerInfo.Builder>

getDefaultInstanceForType

public LedgerInfoOuterClass.LedgerInfo getDefaultInstanceForType()

Specified by:

getDefaultInstanceForType in interface com.google.protobuf.MessageLiteOrBuilder

Specified by:

getDefaultInstanceForType in interface com.google.protobuf.MessageOrBuilder

build

public LedgerInfoOuterClass.LedgerInfo build()

Specified by:

build in interface com.google.protobuf.Message.Builder

Specified by:

build in interface com.google.protobuf.MessageLite.Builder

buildPartial

public LedgerInfoOuterClass.LedgerInfo buildPartial()

Specified by:

buildPartial in interface com.google.protobuf.Message.Builder

Specified by:

buildPartial in interface com.google.protobuf.MessageLite.Builder

clone

public LedgerInfoOuterClass.LedgerInfo.Builder clone()

Specified by:

clone in interface com.google.protobuf.Message.Builder

Specified by:

clone in interface com.google.protobuf.MessageLite.Builder

Overrides:

clone in class com.google.protobuf.GeneratedMessageV3.Builder<LedgerInfoOuterClass.LedgerInfo.Builder>

setField

public LedgerInfoOuterClass.LedgerInfo.Builder setField(com.google.protobuf.Descriptors.FieldDescriptor field,
                                                        Object value)

Specified by:

setField in interface com.google.protobuf.Message.Builder

Overrides:

setField in class com.google.protobuf.GeneratedMessageV3.Builder<LedgerInfoOuterClass.LedgerInfo.Builder>

clearField

public LedgerInfoOuterClass.LedgerInfo.Builder clearField(com.google.protobuf.Descriptors.FieldDescriptor field)

Specified by:

clearField in interface com.google.protobuf.Message.Builder

Overrides:

clearField in class com.google.protobuf.GeneratedMessageV3.Builder<LedgerInfoOuterClass.LedgerInfo.Builder>

clearOneof

public LedgerInfoOuterClass.LedgerInfo.Builder clearOneof(com.google.protobuf.Descriptors.OneofDescriptor oneof)

Specified by:

clearOneof in interface com.google.protobuf.Message.Builder

Overrides:

clearOneof in class com.google.protobuf.GeneratedMessageV3.Builder<LedgerInfoOuterClass.LedgerInfo.Builder>

setRepeatedField

public LedgerInfoOuterClass.LedgerInfo.Builder setRepeatedField(com.google.protobuf.Descriptors.FieldDescriptor field,
                                                                int index,
                                                                Object value)

Specified by:

setRepeatedField in interface com.google.protobuf.Message.Builder

Overrides:

setRepeatedField in class com.google.protobuf.GeneratedMessageV3.Builder<LedgerInfoOuterClass.LedgerInfo.Builder>

addRepeatedField

public LedgerInfoOuterClass.LedgerInfo.Builder addRepeatedField(com.google.protobuf.Descriptors.FieldDescriptor field,
                                                                Object value)

Specified by:

addRepeatedField in interface com.google.protobuf.Message.Builder

Overrides:

addRepeatedField in class com.google.protobuf.GeneratedMessageV3.Builder<LedgerInfoOuterClass.LedgerInfo.Builder>

mergeFrom

public LedgerInfoOuterClass.LedgerInfo.Builder mergeFrom(com.google.protobuf.Message other)

Specified by:

mergeFrom in interface com.google.protobuf.Message.Builder

Overrides:

mergeFrom in class com.google.protobuf.AbstractMessage.Builder<LedgerInfoOuterClass.LedgerInfo.Builder>

mergeFrom

public LedgerInfoOuterClass.LedgerInfo.Builder mergeFrom(LedgerInfoOuterClass.LedgerInfo other)

isInitialized

public final boolean isInitialized()

Specified by:

isInitialized in interface com.google.protobuf.MessageLiteOrBuilder

Overrides:

isInitialized in class com.google.protobuf.GeneratedMessageV3.Builder<LedgerInfoOuterClass.LedgerInfo.Builder>

mergeFrom

public LedgerInfoOuterClass.LedgerInfo.Builder mergeFrom(com.google.protobuf.CodedInputStream input,
                                                         com.google.protobuf.ExtensionRegistryLite extensionRegistry)
                                                  throws IOException

Specified by:

mergeFrom in interface com.google.protobuf.Message.Builder

Specified by:

mergeFrom in interface com.google.protobuf.MessageLite.Builder

Overrides:

mergeFrom in class com.google.protobuf.AbstractMessage.Builder<LedgerInfoOuterClass.LedgerInfo.Builder>

Throws:

IOException

getVersion

public long getVersion()

 Current latest version of the system
 

uint64 version = 1;

Specified by:

getVersion in interface LedgerInfoOuterClass.LedgerInfoOrBuilder

setVersion

public LedgerInfoOuterClass.LedgerInfo.Builder setVersion(long value)

 Current latest version of the system
 

uint64 version = 1;

clearVersion

public LedgerInfoOuterClass.LedgerInfo.Builder clearVersion()

 Current latest version of the system
 

uint64 version = 1;

getTransactionAccumulatorHash

public com.google.protobuf.ByteString getTransactionAccumulatorHash()

 Root hash of transaction accumulator at this version
 

bytes transaction_accumulator_hash = 2;

Specified by:

getTransactionAccumulatorHash in interface LedgerInfoOuterClass.LedgerInfoOrBuilder

setTransactionAccumulatorHash

public LedgerInfoOuterClass.LedgerInfo.Builder setTransactionAccumulatorHash(com.google.protobuf.ByteString value)

 Root hash of transaction accumulator at this version
 

bytes transaction_accumulator_hash = 2;

clearTransactionAccumulatorHash

public LedgerInfoOuterClass.LedgerInfo.Builder clearTransactionAccumulatorHash()

 Root hash of transaction accumulator at this version
 

bytes transaction_accumulator_hash = 2;

getConsensusDataHash

public com.google.protobuf.ByteString getConsensusDataHash()

 Hash of consensus-specific data that is opaque to all parts of the system
 other than consensus.  This is needed to verify signatures because
 consensus signing includes this hash
 

bytes consensus_data_hash = 3;

Specified by:

getConsensusDataHash in interface LedgerInfoOuterClass.LedgerInfoOrBuilder

setConsensusDataHash

public LedgerInfoOuterClass.LedgerInfo.Builder setConsensusDataHash(com.google.protobuf.ByteString value)

 Hash of consensus-specific data that is opaque to all parts of the system
 other than consensus.  This is needed to verify signatures because
 consensus signing includes this hash
 

bytes consensus_data_hash = 3;

clearConsensusDataHash

public LedgerInfoOuterClass.LedgerInfo.Builder clearConsensusDataHash()

 Hash of consensus-specific data that is opaque to all parts of the system
 other than consensus.  This is needed to verify signatures because
 consensus signing includes this hash
 

bytes consensus_data_hash = 3;

getConsensusBlockId

public com.google.protobuf.ByteString getConsensusBlockId()

 The block id of the last committed block corresponding to this ledger info.
 This field is not particularly interesting to the clients, but can be used
 by the validators for synchronization.
 

bytes consensus_block_id = 4;

Specified by:

getConsensusBlockId in interface LedgerInfoOuterClass.LedgerInfoOrBuilder

setConsensusBlockId

public LedgerInfoOuterClass.LedgerInfo.Builder setConsensusBlockId(com.google.protobuf.ByteString value)

 The block id of the last committed block corresponding to this ledger info.
 This field is not particularly interesting to the clients, but can be used
 by the validators for synchronization.
 

bytes consensus_block_id = 4;

clearConsensusBlockId

public LedgerInfoOuterClass.LedgerInfo.Builder clearConsensusBlockId()

 The block id of the last committed block corresponding to this ledger info.
 This field is not particularly interesting to the clients, but can be used
 by the validators for synchronization.
 

bytes consensus_block_id = 4;

getEpochNum

public long getEpochNum()

 Epoch number corresponds to the set of validators that are active for this
 ledger info. The main motivation for keeping the epoch number in the
 LedgerInfo is to ensure that the client has enough information to verify
 that the signatures for this info are coming from the validators that
 indeed form a quorum. Without epoch number a potential attack could reuse
 the signatures from the validators in one epoch in order to sign the wrong
 info belonging to another epoch, in which these validators do not form a
 quorum. The very first epoch number is 0.
 

uint64 epoch_num = 5;

Specified by:

getEpochNum in interface LedgerInfoOuterClass.LedgerInfoOrBuilder

setEpochNum

public LedgerInfoOuterClass.LedgerInfo.Builder setEpochNum(long value)

 Epoch number corresponds to the set of validators that are active for this
 ledger info. The main motivation for keeping the epoch number in the
 LedgerInfo is to ensure that the client has enough information to verify
 that the signatures for this info are coming from the validators that
 indeed form a quorum. Without epoch number a potential attack could reuse
 the signatures from the validators in one epoch in order to sign the wrong
 info belonging to another epoch, in which these validators do not form a
 quorum. The very first epoch number is 0.
 

uint64 epoch_num = 5;

clearEpochNum

public LedgerInfoOuterClass.LedgerInfo.Builder clearEpochNum()

 Epoch number corresponds to the set of validators that are active for this
 ledger info. The main motivation for keeping the epoch number in the
 LedgerInfo is to ensure that the client has enough information to verify
 that the signatures for this info are coming from the validators that
 indeed form a quorum. Without epoch number a potential attack could reuse
 the signatures from the validators in one epoch in order to sign the wrong
 info belonging to another epoch, in which these validators do not form a
 quorum. The very first epoch number is 0.
 

uint64 epoch_num = 5;

getTimestampUsecs

public long getTimestampUsecs()

 Timestamp that represents the microseconds since the epoch (unix time) that is
 generated by the proposer of the block.  This is strictly increasing with every block.
 If a client reads a timestamp > the one they specified for transaction expiration time,
 they can be certain that their transaction will never be included in a block in the future
 (assuming that their transaction has not yet been included)
 

uint64 timestamp_usecs = 6;

Specified by:

getTimestampUsecs in interface LedgerInfoOuterClass.LedgerInfoOrBuilder

setTimestampUsecs

public LedgerInfoOuterClass.LedgerInfo.Builder setTimestampUsecs(long value)

 Timestamp that represents the microseconds since the epoch (unix time) that is
 generated by the proposer of the block.  This is strictly increasing with every block.
 If a client reads a timestamp > the one they specified for transaction expiration time,
 they can be certain that their transaction will never be included in a block in the future
 (assuming that their transaction has not yet been included)
 

uint64 timestamp_usecs = 6;

clearTimestampUsecs

public LedgerInfoOuterClass.LedgerInfo.Builder clearTimestampUsecs()

 Timestamp that represents the microseconds since the epoch (unix time) that is
 generated by the proposer of the block.  This is strictly increasing with every block.
 If a client reads a timestamp > the one they specified for transaction expiration time,
 they can be certain that their transaction will never be included in a block in the future
 (assuming that their transaction has not yet been included)
 

uint64 timestamp_usecs = 6;

setUnknownFields

public final LedgerInfoOuterClass.LedgerInfo.Builder setUnknownFields(com.google.protobuf.UnknownFieldSet unknownFields)

Specified by:

setUnknownFields in interface com.google.protobuf.Message.Builder

Overrides:

setUnknownFields in class com.google.protobuf.GeneratedMessageV3.Builder<LedgerInfoOuterClass.LedgerInfo.Builder>

mergeUnknownFields

public final LedgerInfoOuterClass.LedgerInfo.Builder mergeUnknownFields(com.google.protobuf.UnknownFieldSet unknownFields)

Specified by:

mergeUnknownFields in interface com.google.protobuf.Message.Builder

Overrides:

mergeUnknownFields in class com.google.protobuf.GeneratedMessageV3.Builder<LedgerInfoOuterClass.LedgerInfo.Builder>