From 127f5bd2c7e9b9cd0bff195453e84c15f4b143d5 Mon Sep 17 00:00:00 2001 From: kaiserd <1684595+kaiserd@users.noreply.github.com> Date: Tue, 13 Dec 2022 11:45:58 +0100 Subject: [PATCH] update(lightpush): dandelion (#549) --- content/docs/rfcs/19/README.md | 28 ++++++++++++++++++---------- 1 file changed, 18 insertions(+), 10 deletions(-) diff --git a/content/docs/rfcs/19/README.md b/content/docs/rfcs/19/README.md index 08ec31e0..e48a6250 100644 --- a/content/docs/rfcs/19/README.md +++ b/content/docs/rfcs/19/README.md @@ -4,17 +4,16 @@ title: 19/WAKU2-LIGHTPUSH name: Waku v2 Light Push status: draft editor: Oskar Thorén -contributors: +contributors: Daniel Kaiser --- **Protocol identifier**: `/vac/waku/lightpush/2.0.0-beta1` -# Motivation and goals +# Motivation and Goals -Light nodes with short connection windows and limited bandwidth wish to publish -messages into the Waku network. Additionally, there is sometimes a need for -confirmation that a message has been received "by the network" (here, at least -one node). +Light nodes with short connection windows and limited bandwidth wish to publish messages into the Waku network. +Additionally, there is sometimes a need for confirmation that a message has been received "by the network" +(here, at least one node). `19/WAKU2-LIGHTPUSH` is a request/response protocol for this. @@ -41,17 +40,26 @@ message PushRPC { } ``` -## Message relaying +## Message Relaying -Nodes that respond to `PushRequests` MUST relay this via [11/WAKU2-RELAY](/spec/11) protocol on the specified `pubsub_topic`. +Nodes that respond to `PushRequests` MUST either +relay the encapsulated message via [11/WAKU2-RELAY](/spec/11) protocol on the specified `pubsub_topic`, +or forward the `PushRequest` via 19/LIGHTPUSH on a [44/WAKU2-DANDELION](https://rfc.vac.dev/spec/44/) stem. If they are unable to do so for some reason, they SHOULD return an error code in `PushResponse`. -## Security considerations +## Security Considerations -Since this can introduce amplification factor, it is RECOMMENDED for the node relaying to the rest of the network to extra precaution. This can be done by various forms of rate limiting, or by using [18/WAKU2-SWAP](/spec/18) to account for the service provided. +Since this can introduce an amplification factor, it is RECOMMENDED for the node relaying to the rest of the network to take extra precautions. +This can be done by rate limiting via [17/WAKU2-RLN-RELAY](https://rfc.vac.dev/spec/17/). Note that the above is currently not fully implemented. # Copyright Copyright and related rights waived via [CC0](https://creativecommons.org/publicdomain/zero/1.0/). + +# References + +* [11/WAKU2-RELAY](/spec/11) +* [44/WAKU2-DANDELION](https://rfc.vac.dev/spec/44/) +