package sentry

Get desktop application:
View/edit binary Protocol Buffers messages

• rpc SetStatus (StatusData, SetStatusReply)

  sentry.proto:176

  SetStatus - force new ETH client state of sentry - network_id, max_block, etc...

  message StatusData

  sentry.proto:112

  • uint64 network_id = 1

  • optional types.H256 total_difficulty = 2

  • optional types.H256 best_hash = 3

  • optional Forks fork_data = 4

  • uint64 max_block_height = 5

  • uint64 max_block_time = 6

  message SetStatusReply

  sentry.proto:128

  (message has no fields)

• rpc PenalizePeer (PenalizePeerRequest, google.protobuf.Empty)

  sentry.proto:178

  message PenalizePeerRequest

  sentry.proto:86

  • optional types.H512 peer_id = 1

  • PenaltyKind penalty = 2

• rpc PeerMinBlock (PeerMinBlockRequest, google.protobuf.Empty)

  sentry.proto:179

  message PeerMinBlockRequest

  sentry.proto:91

  • optional types.H512 peer_id = 1

  • uint64 min_block = 2

• rpc HandShake (google.protobuf.Empty, HandShakeReply)

  sentry.proto:183

  HandShake - pre-requirement for all Send* methods - returns list of ETH protocol versions, without knowledge of protocol - impossible encode correct P2P message

  message HandShakeReply

  sentry.proto:130

  • Protocol protocol = 1

• rpc SendMessageByMinBlock (SendMessageByMinBlockRequest, SentPeers)

  sentry.proto:184

  message SendMessageByMinBlockRequest

  sentry.proto:66

  • optional OutboundMessageData data = 1

  • uint64 min_block = 2

  • uint64 max_peers = 3

• rpc SendMessageById (SendMessageByIdRequest, SentPeers)

  sentry.proto:185

  message SendMessageByIdRequest

  sentry.proto:72

  • optional OutboundMessageData data = 1

  • optional types.H512 peer_id = 2

• rpc SendMessageToRandomPeers (SendMessageToRandomPeersRequest, SentPeers)

  sentry.proto:186

  message SendMessageToRandomPeersRequest

  sentry.proto:77

  • optional OutboundMessageData data = 1

  • uint64 max_peers = 2

• rpc SendMessageToAll (OutboundMessageData, SentPeers)

  sentry.proto:188

• rpc Messages (MessagesRequest, stream InboundMessage)

  sentry.proto:193

  Subscribe to receive messages. Calling multiple times with a different set of ids starts separate streams. It is possible to subscribe to the same set if ids more than once.

  message MessagesRequest

  sentry.proto:134

  • repeated MessageId ids = 1

  message InboundMessage

  sentry.proto:100

  • MessageId id = 1

  • bytes data = 2

  • optional types.H512 peer_id = 3

• rpc Peers (google.protobuf.Empty, PeersReply)

  sentry.proto:195

  message PeersReply

  sentry.proto:138

  • repeated types.PeerInfo peers = 1

• rpc PeerCount (PeerCountRequest, PeerCountReply)

  sentry.proto:196

  message PeerCountRequest

  sentry.proto:142

  (message has no fields)

  message PeerCountReply

  sentry.proto:149

  • uint64 count = 1

  • repeated PeerCountPerProtocol counts_per_protocol = 2

• rpc PeerById (PeerByIdRequest, PeerByIdReply)

  sentry.proto:197

  message PeerByIdRequest

  sentry.proto:154

  • optional types.H512 peer_id = 1

  message PeerByIdReply

  sentry.proto:156

  • optional types.PeerInfo peer = 1

• rpc PeerEvents (PeerEventsRequest, stream PeerEvent)

  sentry.proto:199

  Subscribe to notifications about connected or lost peers.

  message PeerEventsRequest

  sentry.proto:158

  (message has no fields)

  message PeerEvent

  sentry.proto:160

  • optional types.H512 peer_id = 1

  • PeerEvent.PeerEventId event_id = 2

• rpc AddPeer (AddPeerRequest, AddPeerReply)

  sentry.proto:201

  message AddPeerRequest

  sentry.proto:96

  • string url = 1

  message AddPeerReply

  sentry.proto:170

  • bool success = 1

• rpc NodeInfo (google.protobuf.Empty, types.NodeInfoReply)

  sentry.proto:204

  NodeInfo returns a collection of metadata known about the host.

Used in: StatusData

• optional types.H256 genesis = 1

• repeated uint64 height_forks = 2

• repeated uint64 time_forks = 3

======= eth 65 protocol ===========

Used in: InboundMessage, MessagesRequest, OutboundMessageData

• STATUS_65 = 0

• GET_BLOCK_HEADERS_65 = 1

• BLOCK_HEADERS_65 = 2

• BLOCK_HASHES_65 = 3

• GET_BLOCK_BODIES_65 = 4

• BLOCK_BODIES_65 = 5

• GET_NODE_DATA_65 = 6

• NODE_DATA_65 = 7

• GET_RECEIPTS_65 = 8

• RECEIPTS_65 = 9

• NEW_BLOCK_HASHES_65 = 10

• NEW_BLOCK_65 = 11

• TRANSACTIONS_65 = 12

• NEW_POOLED_TRANSACTION_HASHES_65 = 13

• GET_POOLED_TRANSACTIONS_65 = 14

• POOLED_TRANSACTIONS_65 = 15

• STATUS_66 = 17

  eth64 announcement messages (no id)

• NEW_BLOCK_HASHES_66 = 18

• NEW_BLOCK_66 = 19

• TRANSACTIONS_66 = 20

• NEW_POOLED_TRANSACTION_HASHES_66 = 21

  eth65 announcement messages (no id)

• GET_BLOCK_HEADERS_66 = 22

  eth66 messages with request-id

• GET_BLOCK_BODIES_66 = 23

• GET_NODE_DATA_66 = 24

• GET_RECEIPTS_66 = 25

• GET_POOLED_TRANSACTIONS_66 = 26

• BLOCK_HEADERS_66 = 27

• BLOCK_BODIES_66 = 28

• NODE_DATA_66 = 29

• RECEIPTS_66 = 30

• POOLED_TRANSACTIONS_66 = 31

• NEW_POOLED_TRANSACTION_HASHES_68 = 32

  ======= eth 68 protocol ===========

Used as request type in: Sentry.SendMessageToAll

Used as field type in: SendMessageByIdRequest, SendMessageByMinBlockRequest, SendMessageToRandomPeersRequest

• MessageId id = 1

• bytes data = 2

Used in: PeerCountReply

• Protocol protocol = 1

• uint64 count = 2

Used in: PeerEvent

• Connect = 0

  Happens after after a successful sub-protocol handshake.

• Disconnect = 1

Used in: PenalizePeerRequest

• Kick = 0

Used in: HandShakeReply, PeerCountPerProtocol

• ETH65 = 0

• ETH66 = 1

• ETH67 = 2

• ETH68 = 3

Used as response type in: Sentry.SendMessageById, Sentry.SendMessageByMinBlock, Sentry.SendMessageToAll, Sentry.SendMessageToRandomPeers

• repeated types.H512 peers = 1