diff --git a/content/docs/rfcs/19/README.md b/content/docs/rfcs/19/README.md new file mode 100644 index 00000000..ceba4d01 --- /dev/null +++ b/content/docs/rfcs/19/README.md @@ -0,0 +1,54 @@ +--- +slug: 19 +title: 19/WAKU2-LIGHTPUSH +name: Waku v2 Light Push +status: raw +editor: Oskar Thorén +contributors: +--- + +**Protocol identifier**: `/vac/waku/lightpush/2.0.0-alpha1` + +# Motivation and goals + +Light nodes with short connection windows and limited bandwidth wish to publish messages into the Waku network. +Additionally, there sometimes is a need for confirmation that a message has been received "by the network". + +`19/LIGHTPUSH` is a request/reply protocol for this. + +# Payloads + +```protobuf +message PushRequest { + string pubsub_topic = 1; + WakuMessage message = 2; +} + +message PushResponse { + boolean is_success = 1; + // Error messages, etc + string info = 2; +} + +message PushRPC { + string request_id = 1; + PushRequest query = 2; + PushResponse response = 3; +} +``` + +## Message relaying + +Nodes that respond to `PushRequests` MUST relay this via `RELAY` protocol on the specified `pubsub_topic`. +If they are unable to do so for some reason, they SHOULD return an error code in `PushResponse`. + +## Notes + + + +# Copyright + +Copyright and related rights waived via [CC0](https://creativecommons.org/publicdomain/zero/1.0/). +