package com.hedera.hapi.node.state.history

Get desktop application:
View/edit binary Protocol Buffers messages

* A construction-scoped node id.

• uint64 construction_id = 1

  * The unique id of a history proof construction.

• uint64 node_id = 2

  * The unique id of a node.

* A piece of new history in the form of an address book hash and associated metadata.

Used in: HistoryProof, HistorySignature

• bytes address_book_hash = 1

  * The address book hash of the new history.

• bytes metadata = 2

  * The metadata associated to the address book.

* A proof that some address book history belongs to the ledger id's chain of trust.

Used in: HistoryProofConstruction, HistoryProofVote

• bytes source_address_book_hash = 1

  * The hash of the source address book.

• repeated ProofKey target_proof_keys = 2

  * The proof keys for the target address book, needed to keep constructing proofs after adopting the target address book's roster at a handoff.

• optional History target_history = 3

  * The target history of the proof.

• bytes proof = 4

  * The proof of chain of trust from the ledger id.

* Summary of the status of constructing a metadata proof, necessary to ensure deterministic construction ending in a roster with sufficient weight to enact its own constructions.

• uint64 construction_id = 1

  * The construction id.

• bytes source_roster_hash = 2

  * The hash of the roster whose weights are used to determine when certain thresholds are during construction.

• optional HistoryProof source_proof = 3

  * If set, the proof that the address book of the source roster belongs to the the ledger id's chain of trust; if not set, the source roster's address book must *be* the ledger id.

• bytes target_roster_hash = 4

  * The hash of the roster whose weights are used to assess progress toward obtaining proof keys for parties that hold at least a strong minority of the stake in that roster.

• oneof proof_state

  • proto.Timestamp grace_period_end_time = 5

    * If the network is still gathering proof keys for this construction, the next time at which nodes should stop waiting for tardy proof keys and assembly the history to be proven as soon as it has the associated metadata and proof keys for nodes with >2/3 weight in the target roster.

  • proto.Timestamp assembly_start_time = 6

    * If the network has gathered enough proof keys to assemble the history for this construction, the cutoff time at which those keys must have been adopted to be included in the final history.

  • HistoryProof target_proof = 7

    * When this construction is complete, the recursive proof that the target roster's address book and associated metadata belong to the ledger id's chain of trust.

  • string failure_reason = 8

    * If set, the reason the construction failed.

* A node's vote for a particular history proof; either by explicitly giving the proof, or by identifying a node that already voted for it.

Used in: services.auxiliary.history.HistoryProofVoteTransactionBody

• oneof vote

  • HistoryProof proof = 1

    * The history proof the submitting node is voting for.

  • uint64 congruent_node_id = 2

    * The id of another node that already voted for the exact proof the submitting node is voting for.

* A node's signature blessing some new history.

Used in: RecordedHistorySignature, services.auxiliary.history.HistoryProofSignatureTransactionBody

• optional History history = 1

  * The new history the node is signing.

• bytes signature = 2

  * The node's signature on the canonical serialization of the new history.

* A record of the proof key a node had in a particular address book. Necessary to keep at each point history so that nodes can verify the correct key was used to sign in transitions starting from the current address book; no matter how keys have been rotated from the time the address book was created.

Used in: HistoryProof

• uint64 node_id = 1

  * The node id.

• bytes key = 2

  * The key.

* A set of proof keys for a node; that is, the key the node is currently using and the key it wants to use in assembling the next address book in the ledger id's chain of trust.

• optional proto.Timestamp adoption_time = 2

  * The consensus time when the network adopted the active proof key in this set. An adoption time that is sufficiently tardy relative to the latest assembly start time may result in the node's key being omitted from the address book.

• bytes key = 3

  * The proof key the node is using.

• bytes next_key = 4

  * If set, the proof key the node wants to start using in the address book.

* A signature on some new history recorded at a certain time.

• optional proto.Timestamp signing_time = 1

  * The time at which the signature was recorded.

• optional HistorySignature history_signature = 2

  * The signature on some new history.