package flow.entities

Get desktop application:
View/edit binary Protocol Buffers messages

Used in: access.AccountResponse, access.GetAccountResponse, execution.GetAccountAtBlockIDResponse

• bytes address = 1

• uint64 balance = 2

• bytes code = 3

• repeated AccountKey keys = 4

• map<string, bytes> contracts = 5

Used in: access.AccountKeyResponse, access.AccountKeysResponse, Account

• uint32 index = 1

• bytes public_key = 2

• uint32 sign_algo = 3

• uint32 hash_algo = 4

• uint32 weight = 5

• uint32 sequence_number = 6

• bool revoked = 7

Used in: BlockSeal

• repeated bytes verifier_signatures = 1

• repeated bytes signer_ids = 2

Used in: access.BlockResponse, access.SubscribeBlocksResponse

• bytes id = 1

• bytes parent_id = 2

• uint64 height = 3

• optional google.protobuf.Timestamp timestamp = 4

• repeated CollectionGuarantee collection_guarantees = 5

• repeated BlockSeal block_seals = 6

• repeated bytes signatures = 7

• repeated ExecutionReceiptMeta execution_receipt_metaList = 8

• repeated ExecutionResult execution_result_list = 9

• optional BlockHeader block_header = 10

• bytes protocol_state_id = 11

BlockExecutionData represents the collection of data produced while execiting the block.

Used in: executiondata.GetExecutionDataByBlockIDResponse, executiondata.SubscribeExecutionDataResponse

• bytes block_id = 1

  Block ID of the block that was executed.

• repeated ChunkExecutionData chunk_execution_data = 2

  Ordered list of ChunkExecutionData produced while executing the block. Note: there will be one ChunkExecutionData per collection in the block, plus one for the service chunk. The service chunk is executed last and is always the last chunk in the list.

Used in: access.BlockHeaderResponse, access.SubscribeBlockHeadersResponse, Block, execution.BlockHeaderResponse

• bytes id = 1

• bytes parent_id = 2

• uint64 height = 3

• optional google.protobuf.Timestamp timestamp = 4

• bytes payload_hash = 5

• uint64 view = 6

• repeated bytes parent_voter_ids = 7

  deprecated!! value will be empty. replaced by parent_vote_indices

• bytes parent_voter_sig_data = 8

• bytes proposer_id = 9

• bytes proposer_sig_data = 10

• string chain_id = 11

• bytes parent_voter_indices = 12

• optional TimeoutCertificate last_view_tc = 13

• uint64 parent_view = 14

Used in: Block

• bytes block_id = 1

• bytes execution_receipt_id = 2

• repeated bytes execution_receipt_signatures = 3

• repeated bytes result_approval_signatures = 4

• bytes final_state = 5

• bytes result_id = 6

• repeated AggregatedSignature aggregated_approval_sigs = 7

Used in: access.BlockHeaderResponse, access.BlockResponse, access.SubscribeBlockDigestsFromLatestRequest, access.SubscribeBlockDigestsFromStartBlockIDRequest, access.SubscribeBlockDigestsFromStartHeightRequest, access.SubscribeBlockHeadersFromLatestRequest, access.SubscribeBlockHeadersFromStartBlockIDRequest, access.SubscribeBlockHeadersFromStartHeightRequest, access.SubscribeBlocksFromLatestRequest, access.SubscribeBlocksFromStartBlockIDRequest, access.SubscribeBlocksFromStartHeightRequest

• BLOCK_UNKNOWN = 0

• BLOCK_FINALIZED = 1

• BLOCK_SEALED = 2

Used in: ExecutionResult

• uint32 CollectionIndex = 1

• bytes start_state = 2

  state when starting executing this chunk

• bytes event_collection = 3

  Events generated by executing results

• bytes block_id = 4

  Block id of the execution result this chunk belongs to

• uint64 total_computation_used = 5

  total amount of computation used by running all txs in this chunk

• uint32 number_of_transactions = 6

  number of transactions inside the collection

• uint64 index = 7

  chunk index inside the ER (starts from zero)

• bytes end_state = 8

  EndState inferred from next chunk or from the ER

• bytes execution_data_id = 9

  ExecutionDataID for chunk. Currently unused and reserved for future

• bytes state_delta_commitment = 10

  use. This representation has less surface for byzantine nodes to create data inconsistencies compared to the `execution_data_id` being included at the ExecutionResult's root level.

  a commitment over sorted list of register changes

• uint32 service_event_count = 11

  number of service events emitted in this

ChunkExecutionData represents the collection of data produced while executing a chunk.

Used in: BlockExecutionData

• optional ExecutionDataCollection collection = 1

  Ordered list of transactions included in the collection that was executed in the chunk.

• repeated Event events = 2

  Events emitted by transactions in the collection. Note: events listed in the last ChunkExecutionData in the BlockExecutionData were emitted by the service transaction. Some, but not all, of these events are service events.

• optional TrieUpdate trieUpdate = 3

  TrieUpdate produced by executing the collection. TrieUpdates contain a list of registers that were modified during chunk execution. The value included is the new value of the register.

• repeated ExecutionDataTransactionResult transaction_results = 4

  Transaction results produced by executing the collection. Note: these are not the same type of results returned by other RPCs. These results are sepcific to execution data. The most notable difference is they only include a boolean value to indicate whether or not an error was encountered during execution, not the error itself.

Used in: access.CollectionResponse

• bytes id = 1

• repeated bytes transaction_ids = 2

Used in: Block

• bytes collection_id = 1

• repeated bytes signatures = 2

• bytes reference_block_id = 3

• bytes signature = 4

• repeated bytes signer_ids = 5

  deprecated!! value will be empty. replaced by signer_indices

• bytes signer_indices = 6

• bytes cluster_chain_id = 7

Used in: NodeVersionInfo

• uint64 start_height = 1

  The first block that the version supports.

• uint64 end_height = 2

  The last block that the version supports.

Used in: access.EventsResponse.Result, access.TransactionResultResponse, ChunkExecutionData, execution.GetEventsForBlockIDsResponse.Result, execution.GetTransactionResultResponse, executiondata.SubscribeAccountStatusesResponse.Result, executiondata.SubscribeEventsResponse

• string type = 1

• bytes transaction_id = 2

• uint32 transaction_index = 3

• uint32 event_index = 4

• bytes payload = 5

Used in: access.GetEventsForBlockIDsRequest, access.GetEventsForHeightRangeRequest, access.GetScheduledTransactionResultRequest, access.GetSystemTransactionResultRequest, access.GetTransactionByIndexRequest, access.GetTransactionRequest, access.GetTransactionsByBlockIDRequest, access.SendAndSubscribeTransactionStatusesRequest, execution.GetEventsForBlockIDsResponse, execution.GetTransactionResultResponse, execution.GetTransactionResultsResponse, executiondata.GetExecutionDataByBlockIDRequest, executiondata.SubscribeAccountStatusesFromLatestBlockRequest, executiondata.SubscribeAccountStatusesFromStartBlockIDRequest, executiondata.SubscribeAccountStatusesFromStartHeightRequest, executiondata.SubscribeEventsFromLatestRequest, executiondata.SubscribeEventsFromStartBlockIDRequest, executiondata.SubscribeEventsFromStartHeightRequest, executiondata.SubscribeEventsRequest, executiondata.SubscribeExecutionDataFromLatestRequest, executiondata.SubscribeExecutionDataFromStartBlockHeightRequest, executiondata.SubscribeExecutionDataFromStartBlockIDRequest, executiondata.SubscribeExecutionDataRequest

• JSON_CDC_V0 = 0

• CCF_V0 = 1

ExecutionDataCollection represents the collection of transactions that were executed within a chunk. Note: this is not the same type as the entities.Collection.

Used in: ChunkExecutionData

• repeated Transaction transactions = 1

  List of transactions included in the collection.

ExecutionDataTransactionResult represents the result of executing a transaction.

Used in: ChunkExecutionData

• bytes transaction_id = 1

  Transaction ID of the transaction that was executed.

• bool failed = 2

  Boolean indicating whether or not the transaction's execution failed with an error.

• uint64 computation_used = 3

  Amount of computation used during execution.

Used in: access.ExecutionReceiptsResponse

• optional ExecutionReceiptMeta meta = 1

• optional ExecutionResult execution_result = 2

  optional; only set if requested

Used in: Block, ExecutionReceipt

• bytes executor_id = 1

  Node ID of the execution node who produced the receipt.

• bytes result_id = 2

  ID of the execution result.

• repeated bytes spocks = 3

  Spocks of the execution result.

• bytes executor_signature = 4

  Signature from the execution node who produced the receipt.

Used in: access.ExecutionResultByIDResponse, access.ExecutionResultForBlockIDResponse, Block, ExecutionReceipt

• bytes previous_result_id = 1

• bytes block_id = 2

• repeated Chunk chunks = 3

• repeated ServiceEvent service_events = 4

• bytes execution_data_id = 5

  hash of execution data (internally partitioned chunk by chunk);

ExecutionStateQuery defines the criteria to use when selecting the ExecutionResult to use for the requested data.

Used in: access.ExecuteScriptAtBlockHeightRequest, access.ExecuteScriptAtBlockIDRequest, access.ExecuteScriptAtLatestBlockRequest, access.GetAccountAtBlockHeightRequest, access.GetAccountAtLatestBlockRequest, access.GetAccountBalanceAtBlockHeightRequest, access.GetAccountBalanceAtLatestBlockRequest, access.GetAccountKeyAtBlockHeightRequest, access.GetAccountKeyAtLatestBlockRequest, access.GetAccountKeysAtBlockHeightRequest, access.GetAccountKeysAtLatestBlockRequest, access.GetAccountRequest, access.GetCollectionByIDRequest, access.GetEventsForBlockIDsRequest, access.GetEventsForHeightRangeRequest, access.GetExecutionResultByIDRequest, access.GetExecutionResultForBlockIDRequest, access.GetFullCollectionByIDRequest, access.GetScheduledTransactionRequest, access.GetScheduledTransactionResultRequest, access.GetSystemTransactionRequest, access.GetSystemTransactionResultRequest, access.GetTransactionByIndexRequest, access.GetTransactionRequest, access.GetTransactionsByBlockIDRequest, access.SendAndSubscribeTransactionStatusesRequest, access.SendTransactionRequest, executiondata.GetExecutionDataByBlockIDRequest, executiondata.GetRegisterValuesRequest, executiondata.SubscribeAccountStatusesFromLatestBlockRequest, executiondata.SubscribeAccountStatusesFromStartBlockIDRequest, executiondata.SubscribeAccountStatusesFromStartHeightRequest, executiondata.SubscribeEventsFromLatestRequest, executiondata.SubscribeEventsFromStartBlockIDRequest, executiondata.SubscribeEventsFromStartHeightRequest, executiondata.SubscribeEventsRequest, executiondata.SubscribeExecutionDataFromLatestRequest, executiondata.SubscribeExecutionDataFromStartBlockHeightRequest, executiondata.SubscribeExecutionDataFromStartBlockIDRequest, executiondata.SubscribeExecutionDataRequest

• uint64 agreeing_executors_count = 1

  Minimum number of execution receipts for the execution result.

• repeated bytes required_executor_ids = 2

  Set of execution node IDs, one of which must have produced the execution result.

• bool include_executor_metadata = 3

  Whether or not to include ExecutorMetadata in the response.

ExecutorMetadata contains data about the execution result used to serve the request.

Used in: Metadata, executiondata.GetExecutionDataByBlockIDResponse, executiondata.GetRegisterValuesResponse, executiondata.SubscribeAccountStatusesResponse, executiondata.SubscribeEventsResponse, executiondata.SubscribeExecutionDataResponse

• bytes execution_result_id = 1

  ID of the ExecutionResult used to serve the request

• repeated bytes executor_ids = 2

  Node IDs of Execution nodes that produced the result

KeyPart represents a part of a register key.

Used in: Payload

• uint32 type = 1

  Type of the key part.

• bytes value = 2

  Value of the key part.

Metadata contains data about the node's state at the time of the request.

Used in: access.AccountBalanceResponse, access.AccountKeyResponse, access.AccountKeysResponse, access.AccountResponse, access.BlockHeaderResponse, access.BlockResponse, access.CollectionResponse, access.EventsResponse, access.ExecuteScriptResponse, access.ExecutionReceiptsResponse, access.ExecutionResultByIDResponse, access.ExecutionResultForBlockIDResponse, access.FullCollectionResponse, access.GetAccountResponse, access.ProtocolStateSnapshotResponse, access.SendTransactionResponse, access.TransactionResponse, access.TransactionResultResponse, access.TransactionResultsResponse, access.TransactionsResponse

• bytes latest_finalized_block_id = 1

  Block ID of the latest finalized block

• uint64 latest_finalized_height = 2

  Height of the latest finalized block

• bytes node_id = 3

  Node's unique ID

• uint64 highest_indexed_height = 4

  Height of the latest block who's execution state data is fully indexed

• optional ExecutorMetadata executor_metadata = 5

  Metadata about the execution result used to serve the request.

Used in: access.GetNodeVersionInfoResponse

• string semver = 1

  The currently running node software version.

• string commit = 2

  The git commit hash of the currently running node software.

• bytes spork_id = 3

  The unique identifier for the node's network within the current spork.

• uint64 protocol_version = 4

  The deprecated protocol version number. Previously this referred to the major software version as of the most recent spork. Replaced by protocol_state_version.

• uint64 spork_root_block_height = 5

  The spork root block height. This is the height of the first sealed block in the spork network.

• uint64 node_root_block_height = 6

  The node's root block height. This is the first sealed block in the node's protocol database. If the node started at the beginning of the spork, it is the same as the spork root block height. If the node started after the beginning of the spork, it is the height of the first sealed block indexed.

• optional CompatibleRange compatible_range = 7

  The compatible version range.

• uint64 protocol_state_version = 8

  The Protocol State version as of the latest finalized block. This tracks the schema version of the Protocol State and is used to coordinate breaking changes in the Protocol. Version numbers are monotonically increasing.

Payload represents the key-value pair of a register.

Used in: TrieUpdate

• repeated KeyPart keyPart = 1

  List of key parts that make up the register key. Can be converted into register id.

• bytes value = 2

  Value of the register.

Used in: TimeoutCertificate

• uint64 view = 1

• bytes block_id = 2

• bytes signer_indices = 3

• bytes sig_data = 4

Used in: executiondata.GetRegisterValuesRequest

• bytes owner = 1

• bytes key = 2

Used in: ExecutionResult

• string type = 1

• bytes payload = 2

Used in: BlockHeader

• uint64 view = 1

• repeated uint64 high_qc_views = 2

• optional QuorumCertificate highest_qc = 3

• bytes signer_indices = 4

• bytes sig_data = 5

Used in: access.FullCollectionResponse, access.SendAndSubscribeTransactionStatusesRequest, access.SendTransactionRequest, access.TransactionResponse, access.TransactionsResponse, ExecutionDataCollection

• bytes script = 1

• repeated bytes arguments = 2

• bytes reference_block_id = 3

• uint64 gas_limit = 4

• optional Transaction.ProposalKey proposal_key = 5

• bytes payer = 6

• repeated bytes authorizers = 7

• repeated Transaction.Signature payload_signatures = 8

• repeated Transaction.Signature envelope_signatures = 9

Used in: Transaction

• bytes address = 1

• uint32 key_id = 2

• uint64 sequence_number = 3

Used in: Transaction

• bytes address = 1

• uint32 key_id = 2

• bytes signature = 3

• bytes extension_data = 4

Used in: access.TransactionResultResponse

• UNKNOWN = 0

• PENDING = 1

• FINALIZED = 2

• EXECUTED = 3

• SEALED = 4

• EXPIRED = 5

TrieUpdate produced by executing the collection. TrieUpdates contain a list of registers that were modified during chunk execution. The value included is the new value of the register.

Used in: ChunkExecutionData

• bytes root_hash = 1

  RootHash is the root hash of the trie before the update is applied.

• repeated bytes paths = 2

  List of register paths updated. Note: paths and payloads map 1:1 with eachother. i.e. for each element in path, the value in payloads at the same index is the value of the register at that path.

• repeated Payload payloads = 3

  List of register values updated. Note: paths and payloads map 1:1 with eachother. i.e. for each element in path, the value in payloads at the same index is the value of the register at that path.