nim-eth/eth/p2p/discoveryv5/messages.nim

137 lines
3.3 KiB
Nim
Raw Normal View History

## Discovery v5 Protocol Messages as specified at
## https://github.com/ethereum/devp2p/blob/master/discv5/discv5-wire.md#protocol-messages
## These messages get RLP encoded.
##
import
2021-01-25 16:26:18 +00:00
std/[hashes, net],
stew/arrayops,
eth/rlp, enr
{.push raises: [Defect].}
2019-12-16 19:38:45 +00:00
type
MessageKind* = enum
2020-11-13 11:33:07 +00:00
# TODO This is needed only to make Nim 1.2.6 happy
# Without it, the `MessageKind` type cannot be used as
# a discriminator in case objects.
unused = 0x00
2019-12-16 19:38:45 +00:00
ping = 0x01
pong = 0x02
findnode = 0x03
nodes = 0x04
2020-11-13 11:33:07 +00:00
talkreq = 0x05
talkresp = 0x06
regtopic = 0x07
ticket = 0x08
regconfirmation = 0x09
topicquery = 0x0A
2019-12-16 19:38:45 +00:00
2020-11-13 11:33:07 +00:00
RequestId* = object
id*: seq[byte]
2019-12-16 19:38:45 +00:00
PingMessage* = object
2019-12-16 19:38:45 +00:00
enrSeq*: uint64
PongMessage* = object
2019-12-16 19:38:45 +00:00
enrSeq*: uint64
2021-01-25 16:26:18 +00:00
ip*: IpAddress
2019-12-16 19:38:45 +00:00
port*: uint16
FindNodeMessage* = object
2020-11-13 11:33:07 +00:00
distances*: seq[uint32]
2019-12-16 19:38:45 +00:00
NodesMessage* = object
2019-12-16 19:38:45 +00:00
total*: uint32
enrs*: seq[Record]
2020-11-13 11:33:07 +00:00
TalkReqMessage* = object
protocol*: seq[byte]
request*: seq[byte]
TalkRespMessage* = object
response*: seq[byte]
# Not implemented, specification is not final here.
RegTopicMessage* = object
TicketMessage* = object
RegConfirmationMessage* = object
TopicQueryMessage* = object
SomeMessage* = PingMessage or PongMessage or FindNodeMessage or NodesMessage or
TalkReqMessage or TalkRespMessage
2019-12-16 19:38:45 +00:00
Message* = object
2019-12-16 19:38:45 +00:00
reqId*: RequestId
case kind*: MessageKind
2019-12-16 19:38:45 +00:00
of ping:
ping*: PingMessage
2019-12-16 19:38:45 +00:00
of pong:
pong*: PongMessage
2019-12-16 19:38:45 +00:00
of findnode:
findNode*: FindNodeMessage
2019-12-16 19:38:45 +00:00
of nodes:
nodes*: NodesMessage
2020-11-13 11:33:07 +00:00
of talkreq:
talkreq*: TalkReqMessage
of talkresp:
talkresp*: TalkRespMessage
of regtopic:
regtopic*: RegTopicMessage
of ticket:
ticket*: TicketMessage
of regconfirmation:
regconfirmation*: RegConfirmationMessage
of topicquery:
topicquery*: TopicQueryMessage
2019-12-16 19:38:45 +00:00
else:
discard
template messageKind*(T: typedesc[SomeMessage]): MessageKind =
when T is PingMessage: ping
elif T is PongMessage: pong
elif T is FindNodeMessage: findNode
elif T is NodesMessage: nodes
2020-11-13 11:33:07 +00:00
elif T is TalkReqMessage: talkreq
elif T is TalkRespMessage: talkresp
proc read*(rlp: var Rlp, T: type RequestId): T
{.raises: [ValueError, RlpError, Defect].} =
mixin read
var reqId: RequestId
reqId.id = rlp.toBytes()
if reqId.id.len > 8:
raise newException(ValueError, "RequestId is > 8 bytes")
rlp.skipElem()
reqId
proc append*(writer: var RlpWriter, value: RequestId) =
writer.append(value.id)
2021-01-25 16:26:18 +00:00
proc read*(rlp: var Rlp, T: type IpAddress): T
{.raises: [RlpError, Defect].} =
let ipBytes = rlp.toBytes()
rlp.skipElem()
if ipBytes.len == 4:
var ip: array[4, byte]
discard copyFrom(ip, ipBytes)
IpAddress(family: IPv4, address_v4: ip)
elif ipBytes.len == 16:
var ip: array[16, byte]
discard copyFrom(ip, ipBytes)
IpAddress(family: IPv6, address_v6: ip)
else:
raise newException(RlpTypeMismatch,
"Amount of bytes for IP address is different from 4 or 16")
proc append*(writer: var RlpWriter, ip: IpAddress) =
case ip.family:
of IpAddressFamily.IPv4:
writer.append(ip.address_v4)
of IpAddressFamily.IPv6: writer.append(ip.address_v6)
2020-11-13 11:33:07 +00:00
proc hash*(reqId: RequestId): Hash =
hash(reqId.id)