2021-05-11 v0.3

This release contains the following:

Features

• Start of RLN relay implementation
• Start of swap implementation
• Start of fault-tolerant store implementation
• Initial bridge implementation between Waku v1 and v2 protocols
• Initial lightpush implementation
• A peer manager for relay, filter, store and swap peers
• Persistent storage for peers: A node with this feature enabled will now attempt to reconnect to relay peers after a restart. It will respect the gossipsub PRUNE backoff period before attempting to do so.
• --persist-peers CLI option to persist peers in local storage
• --persist-messages CLI option to store historical messages locally
• --keep-alive CLI option to maintain a stable connection to relay peers on idle topics
• A CLI chat application (chat2) over Waku v2 with bridging to matterbridge

Changes

General refactoring

• Split out waku_types types into the right place; create utils folder.
• Change type of contentTopic in ContentFilter to string.
• Replace sequence of contentTopics in ContentFilter with a single contentTopic.
• Add timestamp field to WakuMessage.
• Ensure CLI config parameters use a consistent naming scheme. Summary of changes here.

Docs

Several clarifications and additions aimed at contributors, including

• information on how to query Status test fleet for node addresses,
• how to view logs, and
• how to update submodules.

Schema

• Add Message table to the persistent message store. This table replaces the old messages table. It has two additional columns, namely
  • pubsubTopic, and
  • version.
• Add Peer table for persistent peer storage.

API

• JSON-RPC Admin API: Added a post method to connect to peers on an ad-hoc basis.
• Nim API: PubSub topic subscribe and unsubscribe no longer returns a future (removed async designation).
• HistoryQuery: Added pubsubTopic field. Message history can now be filtered and queried based on the pubsubTopic.
• HistoryQuery: Added support for querying a time window by specifying start and end times.

Fixes

• Running nodes can now be shut down gracefully
• Content filtering now works on any PubSub topic and not just the waku default.
• Nodes can now mount protocols without supporting relay as a capability

The Waku v2 suite of protocols are still in a raw/draft state.
This release supports the following libp2p protocols:

Protocol	Spec status	Protocol id
17/WAKU-RLN	raw	/vac/waku/waku-rln-relay/2.0.0-alpha1
18/WAKU2-SWAP	raw	/vac/waku/swap/2.0.0-alpha1
19/WAKU2-LIGHTPUSH	raw	/vac/waku/lightpush/2.0.0-alpha1
11/WAKU2-RELAY	draft	/vac/waku/relay/2.0.0-beta2
12/WAKU2-FILTER	draft	/vac/waku/filter/2.0.0-beta1
13/WAKU2-STORE	draft	/vac/waku/store/2.0.0-beta3

The Waku v1 implementation is stable but not under active development.