package remote
Get desktop application:
View/edit binary Protocol Buffers messages
service BridgeBackend
bor.proto:10rpc Version (, )
bor.proto:12Version returns the service version number
rpc BorTxnLookup (, )
bor.proto:14rpc BorEvents (, )
bor.proto:16
service ETHBACKEND
ethbackend.proto:11rpc Etherbase (, )
ethbackend.proto:12message
ethbackend.proto:82(message has no fields)
message
ethbackend.proto:84optional address = 1
rpc NetVersion (, )
ethbackend.proto:14message
ethbackend.proto:86(message has no fields)
message
ethbackend.proto:88uint64 id = 1
rpc NetPeerCount (, )
ethbackend.proto:16message
ethbackend.proto:104(message has no fields)
message
ethbackend.proto:106uint64 count = 1
rpc Version (, )
ethbackend.proto:19Version returns the service version number
rpc Syncing (, )
ethbackend.proto:22Syncing returns a data object detailing the status of the sync process
message
ethbackend.proto:90uint64 last_new_block_seen = 1
uint64 frozen_blocks = 2
uint64 current_block = 3
bool syncing = 4
repeated stages = 5
rpc ProtocolVersion (, )
ethbackend.proto:25ProtocolVersion returns the Ethereum protocol version number (e.g. 66 for ETH66).
message
ethbackend.proto:108(message has no fields)
message
ethbackend.proto:110uint64 id = 1
rpc ClientVersion (, )
ethbackend.proto:28ClientVersion returns the Ethereum client version string using node name convention (e.g. TurboGeth/v2021.03.2-alpha/Linux).
message
ethbackend.proto:112(message has no fields)
message
ethbackend.proto:114string node_name = 1
rpc Subscribe (, stream )
ethbackend.proto:30message
ethbackend.proto:140Event type = 1
message
ethbackend.proto:144Event type = 1
bytes data = 2
serialized data
rpc SubscribeLogs (stream , stream )
ethbackend.proto:33Only one subscription is needed to serve all the users, LogsFilterRequest allows to dynamically modifying the subscription
message
ethbackend.proto:149bool all_addresses = 1
repeated addresses = 2
bool all_topics = 3
repeated topics = 4
message
ethbackend.proto:156optional address = 1
optional block_hash = 2
uint64 block_number = 3
bytes data = 4
uint64 log_index = 5
repeated topics = 6
optional transaction_hash = 7
uint64 transaction_index = 8
bool removed = 9
rpc Block (, )
ethbackend.proto:38High-level method - can read block from db, snapshots or apply any other logic it doesn't provide consistency Request fields are optional - it's ok to request block only by hash or only by number
message
ethbackend.proto:168uint64 block_height = 2
optional block_hash = 3
message
ethbackend.proto:173bytes block_rlp = 1
bytes senders = 2
High-level method - can read block body (only storage metadata) from db, snapshots or apply any other logic
message
ethbackend.proto:132uint64 blockNumber = 1
message
ethbackend.proto:136bytes body = 1
rpc CanonicalHash (, )
ethbackend.proto:44High-level method - can find block hash by block number
message
ethbackend.proto:116uint64 block_number = 1
message
ethbackend.proto:120optional hash = 1
rpc HeaderNumber (, )
ethbackend.proto:47High-level method - can find block number by block hash
message
ethbackend.proto:124optional hash = 1
message
ethbackend.proto:128optional uint64 number = 1
rpc TxnLookup (, )
ethbackend.proto:51High-level method - can find block number by txn hash it doesn't provide consistency
message
ethbackend.proto:178optional txn_hash = 1
message
ethbackend.proto:182uint64 block_number = 1
uint64 tx_number = 2
rpc NodeInfo (, )
ethbackend.proto:54NodeInfo collects and returns NodeInfo from all running sentry instances.
message
ethbackend.proto:187uint32 limit = 1
message
ethbackend.proto:195repeated nodes_info = 1
rpc Peers (, )
ethbackend.proto:57Peers collects and returns peers information from all running sentry instances.
message
ethbackend.proto:199repeated peers = 1
rpc AddPeer (, )
ethbackend.proto:59message
ethbackend.proto:191string url = 1
message
ethbackend.proto:203bool success = 1
rpc PendingBlock (, )
ethbackend.proto:62PendingBlock returns latest built block.
message
ethbackend.proto:207bytes block_rlp = 1
rpc BorTxnLookup (, )
ethbackend.proto:64rpc BorEvents (, )
ethbackend.proto:66rpc AAValidation (, )
ethbackend.proto:68message
ethbackend.proto:220optional tx = 1
message
ethbackend.proto:224bool valid = 1
service HeimdallBackend
bor.proto:19rpc Version (, )
bor.proto:21Version returns the service version number
rpc Producers (, )
bor.proto:23message
bor.proto:45uint64 block_num = 1
message
bor.proto:49optional proposer = 1
repeated validators = 2
service KV
kv.proto:34Provides methods to access key-value data
rpc Version (, )
kv.proto:36Version returns the service version number
rpc Tx (stream , stream )
kv.proto:43Tx exposes read-only transactions for the key-value store When tx open, client must receive 1 message from server with txID When cursor open, client must receive 1 message from server with cursorID Then only client can initiate messages from server
message
kv.proto:91Op op = 1
string bucket_name = 2
uint32 cursor = 3
bytes k = 4
bytes v = 5
message
kv.proto:99bytes k = 1
bytes v = 2
uint32 cursor_id = 3
send once after new cursor open
uint64 view_id = 4
return once after tx open. mdbx's tx.ViewID() - id of write transaction in db
uint64 tx_id = 5
return once after tx open. internal identifier - use it in other methods - to achieve consistent DB view (to read data from same DB tx on server).
rpc StateChanges (, stream )
kv.proto:45message
kv.proto:154bool with_storage = 1
bool with_transactions = 2
message
kv.proto:135StateChangeBatch - list of StateDiff done in one DB transaction
uint64 state_version_id = 1
mdbx's tx.ID() - id of write transaction in db - where this changes happened
repeated change_batch = 2
uint64 pending_block_base_fee = 3
BaseFee of the next block to be produced
uint64 block_gas_limit = 4
GasLimit of the latest block - proxy for the gas limit of the next block to be produced
uint64 finalized_block = 5
uint64 pending_blob_fee_per_gas = 6
Base Blob Fee for the next block to be produced
rpc Snapshots (, )
kv.proto:48Snapshots returns list of current snapshot files. Then client can just open all of them.
message
kv.proto:159(message has no fields)
message
kv.proto:162repeated string blocks_files = 1
repeated string history_files = 2
rpc Range (, )
kv.proto:54Range [from, to) Range(from, nil) means [from, EndOfTable) Range(nil, to) means [StartOfTable, to) If orderAscend=false server expecting `from`<`to`. Example: Range("B", "A")
rpc Stream(RangeReq) returns (stream Pairs);
message
kv.proto:167uint64 tx_id = 1
returned by .Tx()
string table = 2
query params
bytes from_prefix = 3
bytes to_prefix = 4
bool order_ascend = 5
sint64 limit = 6
<= 0 means no limit
int32 page_size = 7
pagination params
<= 0 means server will choose
string page_token = 8
rpc Sequence (, )
kv.proto:57message
kv.proto:187`kv.Sequence` method
uint64 tx_id = 1
returned by .Tx()
string table = 2
query params
message
kv.proto:194uint64 value = 1
rpc GetLatest (, )
kv.proto:60Temporal methods
can return latest value or as of given timestamp
message
kv.proto:200Temporal methods
uint64 tx_id = 1
returned by .Tx()
string table = 2
query params
bytes k = 3
uint64 ts = 4
bytes k2 = 5
bool latest = 6
if true, then `ts` ignored and return latest state (without history lookup)
message
kv.proto:211bytes v = 1
bool ok = 2
rpc HistorySeek (, )
kv.proto:61message
kv.proto:216uint64 tx_id = 1
returned by .Tx()
string table = 2
bytes k = 3
uint64 ts = 4
message
kv.proto:223bytes v = 1
bool ok = 2
rpc IndexRange (, )
kv.proto:63message
kv.proto:227uint64 tx_id = 1
returned by .Tx()
string table = 2
query params
bytes k = 3
sint64 from_ts = 4
-1 means Inf
sint64 to_ts = 5
-1 means Inf
bool order_ascend = 6
sint64 limit = 7
<= 0 means no limit
int32 page_size = 8
pagination params
<= 0 means server will choose
string page_token = 9
message
kv.proto:243repeated uint64 timestamps = 1
TODO: it can be a bitmap
string next_page_token = 2
rpc HistoryRange (, )
kv.proto:64message
kv.proto:249uint64 tx_id = 1
returned by .Tx()
string table = 2
query params
sint64 from_ts = 4
-1 means Inf
sint64 to_ts = 5
-1 means Inf
bool order_ascend = 6
sint64 limit = 7
<= 0 means no limit
int32 page_size = 8
pagination params
<= 0 means server will choose
string page_token = 9
rpc RangeAsOf (, )
kv.proto:65message
kv.proto:264uint64 tx_id = 1
returned by .Tx()
string table = 2
query params
bytes from_key = 3
nil means Inf
bytes to_key = 4
nil means Inf
uint64 ts = 5
bool latest = 6
if true, then `ts` ignored and return latest state (without history lookup)
bool order_ascend = 7
sint64 limit = 8
<= 0 means no limit
int32 page_size = 9
pagination params
<= 0 means server will choose
string page_token = 10
message
kv.proto:120Used in:
optional address = 1
uint64 incarnation = 2
Action action = 3
bytes data = 4
nil if there is no UPSERT in action
bytes code = 5
nil if there is no CODE in action
repeated storage_changes = 6
enum Action
kv.proto:107Used in:
STORAGE = 0
Change only in the storage
UPSERT = 1
Change of balance or nonce (and optionally storage)
CODE = 2
Change of code (and optionally storage)
UPSERT_CODE = 3
Change in (balance or nonce) and code (and optionally storage)
REMOVE = 4
Account is deleted
message
bor.proto:40Used as response type in: BridgeBackend.BorEvents, ETHBACKEND.BorEvents
string state_receiver_contract_address = 1
repeated bytes event_rlps = 2
message
bor.proto:35Used as request type in: BridgeBackend.BorEvents, ETHBACKEND.BorEvents
uint64 block_num = 1
optional block_hash = 2
message
bor.proto:30Used as response type in: BridgeBackend.BorTxnLookup, ETHBACKEND.BorTxnLookup
bool present = 1
uint64 block_number = 2
message
bor.proto:26Used as request type in: BridgeBackend.BorTxnLookup, ETHBACKEND.BorTxnLookup
optional bor_tx_hash = 1
Used in:
FORWARD = 0
UNWIND = 1
message
ethbackend.proto:211repeated hashes = 1
message
ethbackend.proto:215uint64 start = 1
uint64 count = 2
Used in: ,
HEADER = 0
PENDING_LOGS = 1
PENDING_BLOCK = 2
NEW_SNAPSHOT = 3
NEW_SNAPSHOT - one or many new snapshots (of snapshot sync) were created, client need to close old file descriptors and open new (on new segments), then server can remove old files
message
kv.proto:298sint64 next_time_stamp = 1
sint64 limit = 2
enum Op
kv.proto:69Used in:
FIRST = 0
FIRST_DUP = 1
SEEK = 2
SEEK_BOTH = 3
CURRENT = 4
LAST = 6
LAST_DUP = 7
NEXT = 8
NEXT_DUP = 9
NEXT_NO_DUP = 11
PREV = 12
PREV_DUP = 13
PREV_NO_DUP = 14
SEEK_EXACT = 15
SEEK_BOTH_EXACT = 16
OPEN = 30
CLOSE = 31
OPEN_DUP_SORT = 32
message
kv.proto:282Used as response type in: KV.HistoryRange, KV.Range, KV.RangeAsOf
repeated bytes keys = 1
TODO: replace by lengtsh+arena? Anyway on server we need copy (serialization happening outside tx)
repeated bytes values = 2
string next_page_token = 3
uint32 estimateTotal = 3; // send once after stream creation
message
kv.proto:294bytes next_key = 1
sint64 limit = 2
message
kv.proto:145StateChange - changes done by 1 block or by 1 unwind
Used in:
Direction direction = 1
uint64 block_height = 2
optional block_hash = 3
repeated changes = 4
repeated bytes txs = 5
enable by withTransactions=true
uint64 block_time = 6
message
kv.proto:115Used in:
optional location = 1
bytes data = 2
message
ethbackend.proto:96Used in:
string stage_name = 1
uint64 block_number = 2
message
bor.proto:54Used in:
uint64 id = 1
optional address = 2
int64 voting_power = 3
int64 proposer_priority = 4