package flow.executiondata
Get desktop application:
View/edit binary Protocol Buffers messages
Execution Data API provides access to execution data from the Flow network
GetExecutionDataByBlockID returns execution data for a specific block ID. Errors: - InvalidArgument is returned if the request contains an invalid block ID. - NotFound is returned if the start block or execution data are not currently available on the node. This may happen if the block was from a previous spork, or if the block has yet not been received.
message
executiondata.proto:72The request for GetExecutionDataByBlockID
bytes block_id = 1
Block ID of the block to get execution data for.
entities.EventEncodingVersion event_encoding_version = 2
Preferred event encoding version of the block events payload. Possible variants: 1. CCF 2. JSON-CDC
message
executiondata.proto:83The response for GetExecutionDataByBlockID
optional block_execution_data = 1
BlockExecutionData for the block.
rpc SubscribeExecutionData (, stream )
executiondata.proto:38SubscribeExecutionData streams execution data for all blocks starting at the requested start block, up until the latest available block. Once the latest is reached, the stream will remain open and responses are sent for each new execution data as it becomes available. Errors: - InvalidArgument is returned if the request contains an invalid start block. - NotFound is returned if the start block is not currently available on the node. This may happen if the block was from a previous spork, or if the block has yet not been received.
message
executiondata.proto:89The request for SubscribeExecutionData
bytes start_block_id = 1
Block ID of the first block to get execution data for. Only one of start_block_id and start_block_height may be provided, otherwise an InvalidArgument error is returned. If neither are provided, the latest sealed block is used.
uint64 start_block_height = 2
Block height of the first block to get execution data for. Only one of start_block_id and start_block_height may be provided, otherwise an InvalidArgument error is returned. If neither are provided, the latest sealed block is used.
entities.EventEncodingVersion event_encoding_version = 3
Preferred event encoding version of the block events payload. Possible variants: 1. CCF 2. JSON-CDC
message
executiondata.proto:110The response for SubscribeExecutionData
uint64 block_height = 1
Block height of the block containing the execution data.
optional block_execution_data = 2
BlockExecutionData for the block. Note: The block's ID is included within the BlockExecutionData.
optional block_timestamp = 3
Timestamp from the block containing the execution data.
rpc SubscribeEvents (, stream )
executiondata.proto:63SubscribeEvents streams events for all blocks starting at the requested start block, up until the latest available block. Once the latest is reached, the stream will remain open and responses are sent for each new block as it becomes available. Events within each block are filtered by the provided EventFilter, and only those events that match the filter are returned. If no filter is provided, all events are returned. Responses are returned for each block containing at least one event that matches the filter. Additionally, heatbeat responses (SubscribeEventsResponse with no events) are returned periodically to allow clients to track which blocks were searched. Clients can use this information to determine which block to start from when reconnecting. Errors: - InvalidArgument is returned if the request contains an invalid EventFilter or start block. - NotFound is returned if the start block is not currently available on the node. This may happen if the block was from a previous spork, or if the block has yet not been received.
message
executiondata.proto:123The request for SubscribeEvents
bytes start_block_id = 1
Block ID of the first block to search for events. Only one of start_block_id and start_block_height may be provided, otherwise an InvalidArgument error is returned. If neither are provided, the latest sealed block is used.
uint64 start_block_height = 2
Block height of the first block to search for events. Only one of start_block_id and start_block_height may be provided, otherwise an InvalidArgument error is returned. If neither are provided, the latest sealed block is used.
optional filter = 3
Filter to apply to events for each block searched. If no filter is provided, all events are returned.
uint64 heartbeat_interval = 4
Interval in block heights at which the server should return a heartbeat message to the client. The heartbeat is a normal SubscribeEventsResponse with no events, and allows clients to track which blocks were searched. Clients can use this information to determine which block to start from when reconnecting. The interval is calculated from the last response returned, which could be either another heartbeat or a response containing events.
entities.EventEncodingVersion event_encoding_version = 5
Preferred event encoding version of the block events payload. Possible variants: 1. CCF 2. JSON-CDC
message
executiondata.proto:159The response for SubscribeEvents
bytes block_id = 1
Block ID of the block containing the events.
uint64 block_height = 2
Block height of the block containing the events.
repeated events = 3
Events matching the EventFilter in the request. The API may return no events which signals a periodic heartbeat. This allows clients to track which blocks were searched. Client can use this information to determine which block to start from when reconnecting.
optional block_timestamp = 4
Timestamp from the block containing the events.
GetRegisterValues gets the values for the given register IDs as of the given block height
message
executiondata.proto:219request for GetRegisterValues
uint64 block_height = 1
Block height of the execution state being queried.
repeated register_ids = 2
Register IDs of the Ledger.RegisterID format with an owner and key.
message
executiondata.proto:229response for GetRegisterValues
repeated bytes values = 1
raw register values at the given height.
message
executiondata.proto:180EventFilter defines the filter to apply to block events. Filters are applied as an OR operation, i.e. any event matching any of the filters is returned. If no filters are provided, all events are returned. If there are any invalid filters, the API will return an InvalidArgument error.
Used in:
repeated string event_type = 1
A list of full event types to include. All events exactly matching any of the provided event types will be returned. Event types have 2 formats: - Protocol events: flow.[event name] - Smart contract events: A.[contract address].[contract name].[event name]
repeated string contract = 2
A list of contracts who's events should be included. All events emitted by any of the provided contracts will be returned. Contracts have the following name formats: - Protocol events: flow - Smart contract events: A.[contract address].[contract name] This filter matches on the full contract including its address, not just the contract's name.
repeated string address = 3
A list of addresses who's events should be included. All events emitted by any contract held by any of the provided addresses will be returned. Addresses must be Flow account addresses in hex format and valid for the network the node is connected to. i.e. only a mainnet address is valid for a mainnet node. Addresses may optionally include the 0x prefix.