Waku Specifications

Waku builds a family of privacy-preserving, censorship-resistant communication protocols for web3 applications. This repository contains specifications for the Waku suite of protocols.

List of Specifications:

• Standards
  • Core: Standards and protocols for the core Waku p2p communications offering.
  • Application: Standards and protocols that describe various applications or encryption use cases built on top of a Waku network.
• Informational: Waku design issues, general guidelines or background information that does not constitute a new feature.

Core standards

Waku Specifications	Description
10/WAKU2	Waku Overview
11/WAKU2-RELAY	Waku Relay
12/WAKU2-FILTER	Waku Filter
13/WAKU2-STORE	Waku Store
14/WAKU2-MESSAGE	Waku Message
17/WAKU2-RLN-RELAY	Waku RLN Relay
19/WAKU2-LIGHTPUSH	Waku Lightpush
33/WAKU2-DISCV5	Waku Discovery v5 Ambient Peer Discovery
36/WAKU2-BINDINGS-API	Waku C Bindings API
WAKU2-PEER-EXCHANGE	Waku Peer Exchange
WAKU2-ENR	Waku Usage of ENR
WAKU2-INCENTIVIZATION	Waku Incentivization
WAKU2-METADATA	Waku Metadata
WAKU2-NETWORK	Waku Network
RELAY-SHARDING	Waku Relay Sharding
WAKU2-STORE	Waku Store Query

Application standards

Waku Specifications	Description
20/TOY-ETH-PM	Toy Ethereum Private Message
21/WAKU2-FAULT-TOLERANT-STORE	Waku Fault-Tolerant Store
22/TOY-CHAT	Waku Toy Chat
26/WAKU2-PAYLOAD	Waku Message Payload Encryption
53/WAKU2-X3DH	X3DH Usage for Waku Payload Encryption
54/WAKU2-X3DH-SESSIONS	Session Management for Waku X3DH
DANDELION	Waku Dandelion
WAKU2-DEVICE-PAIRING	Device Pairing and Secure Transfers with Noise
WAKU2-NOISE	Noise Protocols for Waku Payload Encryption
TOR-PUSH	Waku Tor Push

Informational

Waku Specifications	Description
23/WAKU2-TOPICS	Waku Topic Usage Recommendations
27/WAKU2-PEERS	Waku Peer Management Recommendations
29/WAKU2-CONFIG	Waku Parameter Configuration Recommendations
30/ADAPTIVE-NODES	Adaptive Nodes
ADVERSARIAL-MODELS	Waku Adversarial Models and Attack-based Threat List
RELAY-STATIC-SHARD-ALLOC	Waku Relay Static Shard Allocation

Resources

Relevant Waku resources related to the specifications located in this repository:

• Waku.org
• nwaku: Waku Node

Contributions

Contributions are welcome from any party. Contributors can create specifications relating to the Waku domain and create a pull request to begin discussion. The recommended template may be used for new proposed specifications.

New specifications are considered a proof of concept. Once a rough consensus is reached towards stabilization, the specification may be considered to receive the draft status and further discussion will continue on the Vac RFC-Index repository.

NOTE: Specifications located in this repository should be considered not production ready. Discussion should be conducted with the intention of maturing each specification.

Head over to the Vac RFC-Index repository where other Waku specifications live.