status-im
/
EIPs
mirror of https://github.com/status-im/EIPs.git
2
0
Fork 0
Code Issues Projects Releases Wiki Activity

Merge branch 'master' into eip665

This commit is contained in:
Greg Colvin 2018-03-28 16:13:55 -06:00 committed by GitHub
parent b2e0f8c575 76d83cb59e
commit f98cdae372
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 46 additions and 15 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

61
EIPS/eip-868.md
View File

@ -18,35 +18,66 @@ resolution of Ethereum Node Records (ENR).
To bridge current and future discovery networks and to aid the implementation of other To bridge current and future discovery networks and to aid the implementation of other
relay mechanisms for ENR such as DNS, we need a way to request the most up-to-date version relay mechanisms for ENR such as DNS, we need a way to request the most up-to-date version
of a node record. of a node record. This EIP provides a way to request it using the existing discovery
protocol.
# Specification # Specification
Implementations of Node Discovery Protocol v4 should support two new packet types, a request Implementations of Node Discovery Protocol v4 should support two new packet types, a
and reply of the node record. The new packets are: request and reply of the node record. The existing ping and pong packets are extended with
a new field containing the sequence number of the ENR.
### enrRequest (0x05) ### Ping Packet (0x01)
RLP: `[ expiration ]` ```text
packet-data = [version, from, to, expiration, enr-seq]
```
When a packet of this type is received, the node should reply with an enrResponse packet `enr-seq` is the current sequence number of the sending node's record. All other fields
retain their existing meaning.
### Pong Packet (0x02)
```text
packet-data = [to, ping-hash, expiration, enr-seq]
```
`enr-seq` is the current sequence number of the sending node's record. All other fields
retain their existing meaning.
### ENRRequest Packet (0x05)
```text
packet-data = [ expiration ]
```
When a packet of this type is received, the node should reply with an ENRResponse packet
containing the current version of its record. containing the current version of its record.
To guard against amplification attacks, the sender of enrRequest should have replied to a To guard against amplification attacks, the sender of ENRRequest should have replied to a
ping packet recently. The expiration field, a UNIX timestamp, should be handled as for all ping packet recently (just like for FindNode). The `expiration` field, a UNIX timestamp,
other existing packets, i.e. no reply should be sent if it refers to a time in the past. should be handled as for all other existing packets i.e. no reply should be sent if it
refers to a time in the past.
### enrResponse (0x06) ### ENRResponse Packet (0x06)
RLP: `[ requestHash, ENR ]` ```text
packet-data = [ request-hash, ENR ]
```
This packet is the response to enrRequest. This packet is the response to ENRRequest.
- `requestHash` is the hash of the entire enrRequest packet being replied to. - `request-hash` is the hash of the entire ENRRequest packet being replied to.
- `ENR` is the node record. - `ENR` is the node record.
The recipient of the packet should verify that the node record is signed by node who The recipient of the packet should verify that the node record is signed by node who sent
sent enrResponse. ENRResponse.
## Resolving Records
To resolve the current record of a node public key, perform a recursive Kademlia lookup
using the FindNode, Neighbors packets. When the node is found, send ENRRequest to it and
return the record from the response.
# Copyright # Copyright