Skip to main content
Waku is now Logos Messaging - this site will redirect to https://logos.co by the end of 2025. Join us there to take part in our testnet node programme.

Specs

Technical deep dives into the inner workings of the Waku.

Waku Overview

Start here for a general introduction to Waku protocols. 10/WAKU2 describes Waku v2, a suite of secure peer-to-peer communication protocols with a focus on resource-restricted devices, privacy preservation and censorship resistance.

The Waku Network

Start here if you care most about the application of Waku protocols. 64/WAKU2-NETWORK describes an opinionated deployment of Waku protocols to form a coherent and shared decentralised messaging network that is open-access, useful for generalised messaging, privacy preserving, scalable and accessible even to resource-restricted devices.

Message Format

14/WAKU2-MESSAGE describes how message data is encoded for transmission over a Waku network.

Message Relay

Waku's strategy for p2p message routing is presented in 11/WAKU2-RELAY. It is an extension of the GossipSub publish/subscribe model, with a focus on privacy and security through message unlinkability to publishers or subscribers.

Spam protection

We extend the Relay protocol with spam protecting measures in 17/WAKU2-RLN-RELAY. This describes a way to achieve DoS protected message routing using Rate Limiting Nullifiers (RLN), while maintaining privacy preservation.

Content Filtering

12/WAKU2-FILTER is a protocol that allows resource-restricted nodes to receive only selected messages from a Waku network based on content filters.

Lightpush Publishing

19/WAKU2-LIGHTPUSH is a protocol that allows resource-restricted nodes to publish to a Waku network without participating in message routing.

Message Caching

13/WAKU2-STORE describes how historical messages can be cached and retrieved by nodes on a Waku network.