19: Lightpush as draft and tweak spec (#379)

This commit is contained in:
Oskar Thorén 2021-05-24 16:54:24 +08:00 committed by GitHub
parent 81720bd7f4
commit 9de75c34d5
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23

View File

@ -2,7 +2,7 @@
slug: 19 slug: 19
title: 19/WAKU2-LIGHTPUSH title: 19/WAKU2-LIGHTPUSH
name: Waku v2 Light Push name: Waku v2 Light Push
status: raw status: draft
editor: Oskar Thorén <oskar@status.im> editor: Oskar Thorén <oskar@status.im>
contributors: contributors:
--- ---
@ -11,10 +11,12 @@ contributors:
# Motivation and goals # Motivation and goals
Light nodes with short connection windows and limited bandwidth wish to publish messages into the Waku network. Light nodes with short connection windows and limited bandwidth wish to publish
Additionally, there sometimes is a need for confirmation that a message has been received "by the network". 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/LIGHTPUSH` is a request/reply protocol for this. `19/WAKU2-LIGHTPUSH` is a request/response protocol for this.
# Payloads # Payloads
@ -41,16 +43,15 @@ message PushRPC {
## Message relaying ## Message relaying
Nodes that respond to `PushRequests` MUST relay this via `RELAY` protocol on the specified `pubsub_topic`. Nodes that respond to `PushRequests` MUST relay this via [11/WAKU2-RELAY](/spec/11) protocol on the specified `pubsub_topic`.
If they are unable to do so for some reason, they SHOULD return an error code in `PushResponse`. If they are unable to do so for some reason, they SHOULD return an error code in `PushResponse`.
## Notes ## 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.
TODO: Check current message confirmation setup
--> Note that the above is currently not fully implemented.
# Copyright # Copyright
Copyright and related rights waived via [CC0](https://creativecommons.org/publicdomain/zero/1.0/). Copyright and related rights waived via [CC0](https://creativecommons.org/publicdomain/zero/1.0/).