Sketch devp2p and gossip dependencies (#64)

* Sketch devp2p and gossip dependencies

* Update waku.md

Co-Authored-By: Dean Eigenmann <dean.eigenmann@icloud.com>

* Update waku.md

Co-Authored-By: Dean Eigenmann <dean.eigenmann@icloud.com>

* Update waku.md

Co-Authored-By: Adam Babik <a.babik@designfortress.com>

* add section on nodes discovery

* tweak float ttl

* clarify flooding
This commit is contained in:
Oskar Thorén 2019-12-10 23:58:16 +08:00 committed by GitHub
parent f0f607678b
commit 35e53aa9da
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 21 additions and 1 deletions

22
waku.md
View File

@ -64,7 +64,17 @@ Waku was created to incrementally improve in areas that Whisper is lacking in, w
| **Mail Server** | A node responsible for archiving messages. | | **Mail Server** | A node responsible for archiving messages. |
| **Mail Client** | A node that requests messages from mail servers. | | **Mail Client** | A node that requests messages from mail servers. |
## Specification ## Underlying Transports and Prerequisites
### Use of DevP2P
For nodes to communicate, they MUST implement devp2p and run RLPx. They MUST have some way of connecting to other nodes. Node discovery is largely out of scope for this spec, but see the appendix for some suggestions on how to do this.
### Gossip based routing
In Whisper, messages are gossiped between peers. Whisper is a form of rumor-mongering protocol that works by flooding to its connected peers based on some factors. Messages are elgible for retransmission until their TTL expires. A node SHOULD relay messages to all connected nodes if an envelope matches their PoW and bloom filter settings. If a node works in light mode, it MAY choose not to forward envelopes. A node MUST NOT send expired envelopes, unless the envelopes are sent as a mailserver response. A node SHOULD NOT send a message to a peer that it has already sent before.
## Wire Specification
### Use of RLPx transport protocol ### Use of RLPx transport protocol
@ -500,6 +510,16 @@ Notes useful for implementing Waku mode.
Consider partition topics based on some usage, to avoid too much traffic on a single topic. Consider partition topics based on some usage, to avoid too much traffic on a single topic.
### Node discovery
[Discovery v4](https://github.com/ethereum/devp2p/wiki/Discovery-Overview) SHOULD NOT be used, because it doesn't distinguish between capabilities. It will thus have a hard time finding Waku/Whisper nodes.
[Discovery v5](https://github.com/ethereum/devp2p/blob/master/discv5/discv5.md) MAY be used. However, it is quite bandwidth heavy for resource restricted devices. Thus, some lighter discovery mechanism is used. For some ad hoc ideas, see the current ad hoc implementation used in the [Status spec](https://github.com/status-im/specs/blob/master/status-client-spec.md#discovery).
This is an ongoing area of research and will likely change in future versions.
Known static nodes MAY also be used.
## Footnotes ## Footnotes
1. <https://github.com/ethereum/devp2p/blob/master/rlpx.md> 1. <https://github.com/ethereum/devp2p/blob/master/rlpx.md>