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

Get desktop application:
View/edit binary Protocol Buffers messages

* An aggregation of node signatures on some data. <p> Can be used to prove the genesis hinTS verification key in a block proof; but not succinct and not recursive; hence in normal operations with TSS, used only until the first recursive proof is available.

Used in: ChainOfTrustProof

• bytes aggregated_signature = 1

  * The aggregated signature.

• repeated uint64 signing_node_ids = 2

  * In ascending order, the ids of the nodes that contributed signatures.

• bytes verification_key = 3

  * The hinTS key that this signature witnesses.

Used in: HistoryProof

• oneof proof

  • AggregatedNodeSignatures aggregated_node_signatures = 1

    * If there is not yet a SNARK proving the chain of trust from ledger id to the hinTS verification key, an aggregation of Schnorr signatures on the concatenation of the ledger id and genesis hinTS verification key that serve as witnesses for the SNARK prover algorithm.

  • bytes wraps_proof = 2

    * If known, a ZK-compressed SNARK proof proving the chain of trust from the ledger id to this hinTS verification key.

* 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

• repeated ProofKey target_proof_keys = 1

  * 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 = 2

  * The target history of the proof.

• optional ChainOfTrustProof chain_of_trust_proof = 3

  * The proof of chain of trust from the ledger id to the target history's metadata. May be switched from AggregatedNodeSignatures to a recursive proof when one becomes available.

• bytes uncompressed_wraps_proof = 4

  * If set, the uncompressed proof of chain of trust from the ledger id to the target address book; the uncompressed version of the WRAPS proof is required to keep extending the chain of trust.

* 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.

• 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 assemble 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 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.

  • WrapsSigningState wraps_signing_state = 9

    * If set, the state of the WRAPS signing protocol for this construction.

• uint32 wraps_retry_count = 10

  * The number of times the network has had to restart this construction.

* 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.

* A message published by a node during a WRAPS proof construction.

Used in: WrapsMessageHistory

• optional proto.Timestamp publication_time = 1

  * The time at which the message was published.

• WrapsPhase phase = 2

  * The phase of the construction the message applies to.

• bytes message = 3

  * The message itself.

* A history of messages published during a WRAPS proof construction.

• repeated WrapsMessageDetails messages = 1

  The published messages.

* The phase of a WRAPS proof construction.

Used in: WrapsMessageDetails, WrapsSigningState, services.auxiliary.history.HistoryProofKeyPublicationTransactionBody

• R1 = 0

  * Nodes are publishing their proof keys and R1 messages.

• R2 = 1

  * Nodes are publishing their R2 messages.

• R3 = 2

  * Nodes are publishing their R3 messages.

• AGGREGATE = 3

  * Nodes are aggregating all messages to produce a final signature.

• POST_AGGREGATION = 4

  * Nodes are doing work that must occur in a different event loop than the one used for the above phases.

* The state of an ongoing WRAPS signature protocol.

Used in: HistoryProofConstruction

• WrapsPhase phase = 1

  * The phase of the WRAPS protocol.

• optional proto.Timestamp grace_period_end_time = 2

  * If the network is still gathering WRAPS messages for the R2 or R3 protocol phase, the next time at which nodes should stop waiting for tardy messages from R1 participants and start over.