docs.waku.org/docs/overview/concepts/protocols.md

3.6 KiB

title
Protocols

Waku takes a modular approach, providing a range of protocols that enable applications to control the trade-offs involved in the Anonymity Trilemma. This flexibility empowers applications to make informed choices regarding the desired balance between anonymity, scalability, and latency. Here are the main protocols provided by Waku:

Waku Relay

Waku Relay is a privacy-focused peer-to-peer messaging protocol that extends the libp2p GossipSub protocol. It utilizes a Pub/Sub architecture to enable secure communication channels, encryption, and protection against censorship. With a strong emphasis on privacy, Waku Relay ensures scalability, allowing many peers and messages to coexist within the network.

Waku Filter

Waku Filter is a protocol enabling peers to subscribe to specific messages from other peers. It is designed for devices with limited bandwidth, serving as a lighter alternative to Waku Relay. Unlike relay nodes, Waku Filter allows light nodes to subscribe to service nodes and receive only the messages they are interested in. This optimizes bandwidth consumption but may involve privacy compromises. Nonetheless, Waku Filter efficiently delivers desired messages within bandwidth constraints.

Waku Store

Waku Store is a protocol that allows the querying of messages received through the relay protocol and stored by nodes. It supports retrieving historical messages with pagination. Unlike Waku Relay, which doesn't save messages for offline users, Waku Store peers retain relayed messages for later retrieval.

:::info Data availability is not guaranteed with Waku Store. Waku Relay or Waku Filter are preferred for online usage, while Waku Store is suitable for retrieving messages after reconnecting to the network, like when a dApp starts. :::

Waku Light Push

Waku Light Push is a Request/Reply protocol for Waku's light nodes with limited bandwidth and short connection windows. It enables clients to receive a confirmation when sending messages, indicating that at least one node has received them. However, using Waku Light Push compromises privacy as the remote peer becomes aware of the message originator.

:::info Please note that Waku Light Push confirms receipt by the remote peer but doesn't guarantee network-wide propagation. :::

Waku Message

Waku Message specifies the message structure used in the Waku network. It defines metadata fields, such as content topics and timestamps, that other Waku protocols can use.

Waku Payload

Waku Payload provides guidelines for implementing secure and private communication in the Waku network. It covers encryption, decryption, and signing methods for message payloads, focusing on confidentiality, authenticity, integrity, and unlinkability.

Waku RLN Relay

The Waku RLN Relay protocol extends the Waku Relay protocol by adding spam protection using Rate Limiting Nullifiers (RLN). It enforces a global messaging rate for all peers to prevent spam in the Waku network. Spammers face financial penalties and removal from the system. This protocol provides efficient and economic spam prevention suitable for resource-constrained environments.