nwaku/CHANGELOG.md

2023-03-15 v0.16.0

What's Changed

Release highlights:

• a fix for an issue that prevented the node from generating high-resolution (up to nanosecond) timestamps
• introduction of an application-defined meta attribute to the Waku Message. This can be quite valuable for network-wide deduplication, deterministic hashing, validity checking and other planned improvements to the protocol
• many optimizations in RLN implementation and its underlying dependencies

Features

• Integrated a new group manager for RLN-protected relay 1496
• Added application-defined meta attribute to Waku Message according to RFC 14/WAKU2-MESSAGE 1581
• Implemented deterministic hashing scheme for Waku Messages according to RFC 14/WAKU2-MESSAGE 1586

Changes

• Upgraded nim-sqlite3-abi to the latest version 1565
• Better validation of protocol buffers 1563
• Improved underlying Zerokit performance and FFI 1571
• Node peer ID now logged with relay trace logging 1574
• Continued refactoring of several protocol implementations to improve maintainability and readability
• Refactored and cleaned up peer manager 1539
• Removed unused and legacy websocket submodule 1580 1582
• Use base64 URL-safe encoding for noise 1569
• Various general improvements to RLN implementation 1585 1587
• Started on implementation for new and improved filter protocol 1584
• Updated pubsub and content topic namespacing to reflect latest changes in RFC 23/WAKU2-TOPICS 1589
• Unified internal peer data models 1597
• Improved internal implementation of Waku ENR encoding and decoding 1598 1599
• Underlying dependency for RLN implementation now loaded as a static library 1578

Fixes

• Fixed internally generated timestamps to allow higher resolution than seconds 1570
• Fixed padded base64 usage for encoding and decoding payloads on the JSON RPC API 1572
• Fixed incorrect relative module imports 1591
• Fixed RLN relay erroneously storing messages from multiple apps 1594

This release supports the following libp2p protocols:

Protocol	Spec status	Protocol id
11/WAKU2-RELAY	stable	/vac/waku/relay/2.0.0
12/WAKU2-FILTER	draft	/vac/waku/filter/2.0.0-beta1
13/WAKU2-STORE	draft	/vac/waku/store/2.0.0-beta4
18/WAKU2-SWAP	draft	/vac/waku/swap/2.0.0-beta1
19/WAKU2-LIGHTPUSH	draft	/vac/waku/lightpush/2.0.0-beta1

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

2023-02-15 v0.15.0

Release highlights:

• Relay connectivity is now maintained by a management loop that selects from the peerstore
• Ability to manually specify multiaddrs for the nwaku node to advertise
• Two important fixes related to historical message queries:
  • fixed archive bug that resulted in duplicate messages in store query response
  • fixed query page size limit not being respected

Features

• New connectivity loop to maintain relay connectivity from peerstore 1482 1462
• Support for manually specifying multiaddrs to advertise 1509 1512
• Added dynamic keystore for membership credential storage and management 1466

Changes

• Abstracted RLN relay group management into its own API 1465
• Prune peers from peerstore when exceeding capacity 1513
• Removed Kilic submodule 1517
• Continued refactoring of several protocol implementations to improve maintainability and readability
• Refactored and improved JSON RPC API
• Added safe default values for peer-store-capacity 1525
• Improvements in regular CI test reliability and repeatability
• Improved archive query performance 1510
• Added better e2e trace logging for relay messages 1526
• Relay RPC API now encodes message payloads in base64 572 1555

Fixes

• Fixed Waku archive queries returning duplicate messages due to incorrect reordering 1511
• Fixed Admin RPC API crashing on returning peer with no multiaddresses 1507
• Fixed page size limit not being respected in store query responses 1520
• Fixed nwaku subscribing to default pubsub topic even if not configured 1548
• Fixed underlying issue causing node to incorrectly report it's unreachable 1518 1546
• Fixed Relay RPC API not adhering to RFC 1139
• Fixed message IDs in nwaku diverging from those in go-waku 1556

This release supports the following libp2p protocols:

Protocol	Spec status	Protocol id
11/WAKU2-RELAY	stable	/vac/waku/relay/2.0.0
12/WAKU2-FILTER	draft	/vac/waku/filter/2.0.0-beta1
13/WAKU2-STORE	draft	/vac/waku/store/2.0.0-beta4
18/WAKU2-SWAP	draft	/vac/waku/swap/2.0.0-beta1
19/WAKU2-LIGHTPUSH	draft	/vac/waku/lightpush/2.0.0-beta1

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

2023-01-16 v0.14.0

Release highlights:

• An important fix for the Waku message archive returning inconsistent responses to history queries.
• Support for AutoNAT and libp2p Circuit Relay that allows, among other things, for NAT hole punching.
• Support for structured logging in JSON format.
• A fix for an underlying file descriptor leak that affected websocket connections.

Features

• Support for AutoNAT
• Support for libp2p Circuit Relay (server only)
• New Waku Archive implementation. This allows easy addition of drivers for different technologies to store historical messages.
• Support for structured logging and specifying log format.
• Node now keeps track of its external reachability.

Changes

• Zerokit RLN library now statically linked.
• Use extended key generation in Zerokit API to comply with 32/RLN.
• Re-enable root validation in 17/WAKU-RLN-RELAY implementation.
• Network monitoring tool now supports DNS discovery.
• Added dashboard for network monitoring.
• Continued refactoring of several protocol implementations to improve maintainability and readability.
• Removed swap integration from store protocol.
• Peerstore now consolidated with libp2p peerstore.
• Peerstore now also tracks peer direction.
• SIGSEGV signals are now handled and logged properly.
• Waku v2 no longer imports libraries from Waku v1.
• Improved build and CI processes:
  • Added support for an EXPERIMENTAL compiler flag.
  • Simplified project Makefile.
  • Split Dockerfile into production and experimental stages.
  • Removed obsolete simulation libraries from build.
• Improved parallellisation (and therefore processing time) when dialing several peers simultaneously.
• Waku Archive now responds with error to historical queries containing more than 10 content topics.

Fixes

• Fixed support for optional fields in several protocol rpc codecs. #1393 #1395 #1396
• Fixed clients with --store=false not installing Store Client JSON-RPC API handlers. #1382
• Fixed SQLite driver returning inconsistent responses to store queries. #1415
• Fixed peer exchange discv5 loop starting before discv5 has started. #1407
• Fixed wakubridge test timing. #1429
• Fixed bug in Noise module types equating T_ss incorrectly to "se" and not "ss". #1432
• Fixed Ctrl-C quitting resulting in unreleased resources and exit failures. #1416
• Fixed CI workflows not cloning repo on startup. #1454 #1455
• Fixed Admin API peer connection not returning error response if peer can't be connected. #1476
• Fixed underlying file descriptor leak. #1483

Docs

• Added instructions for running nwaku with docker compose.

This release supports the following libp2p protocols:

Protocol	Spec status	Protocol id
11/WAKU2-RELAY	stable	/vac/waku/relay/2.0.0
12/WAKU2-FILTER	draft	/vac/waku/filter/2.0.0-beta1
13/WAKU2-STORE	draft	/vac/waku/store/2.0.0-beta4
18/WAKU2-SWAP	draft	/vac/waku/swap/2.0.0-beta1
19/WAKU2-LIGHTPUSH	draft	/vac/waku/lightpush/2.0.0-beta1

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

2022-11-15 v0.13.0

Release highlights:

• A Waku canary tool to check if nodes are reachable and what protocols they support.
• Simplified configuration for store protocol. This new guide explains how to configure store from this release forward.
• Support for environment variables to configure a nwaku node. See our configuration guide for more.
• A Waku network monitoring tool to report network metrics, including network size, discoverable peer capabilities and more.

Features

• Added Waku canary tool to check if i) a given node is reachable and ii) it supports a set of protocols.
• Simplified Waku store configuration.
• Decoupled Waku peer persistence configuration from message store configuration.
• Added keyfile support for secure storage of RLN credentials.
• Added configurable libp2p agent string to nwaku switch.
• Support for configuration with environment variables.
• Added example module to showcase basic nwaku relay usage.
• Added a nwaku network monitoring tool to provide metrics on peers, network size and more.

Changes

• Removed support for Kilic's RLN library (obsolete).
• Improved logging for 17/WAKU-RLN-RELAY implementation.
• Connection to eth node for RLN now more stable, maintains state and logs failures.
• Waku apps and tools now moved to their own subdirectory.
• Continued refactoring of several protocol implementations to improve maintainability and readability.
• Periodically log metrics when running RLN spam protection.
• Added metrics dashboard for RLN spam protection.
• Github CI test workflows are now run selectively, based on the content of a PR.
• Improved reliability of CI runs and added email notifications.
• Discv5 discovery loop now triggered to fill a 34/WAKU2-PEER-EXCHANGE peer list cache asynchronously.
• Upgraded to Nim v1.6.6.
• Cleaned up compiler warnings on unused imports.
• Improved exception handling and annotation.
• 13/WAKU2-STORE no longer enabled by default on nwaku nodes.
• Merkle tree roots for RLN membership changes now on a per-block basis to allow poorly connected peers to operate within a window of acceptable roots.

Fixes

• Fixed encoding of ID commitments for RLN from Big-Endian to Little-Endian. #1256
• Fixed maxEpochGap to be the maximum allowed epoch gap (RLN). #1257
• Fixed store cursors being retrieved incorrectly (truncated) from DB. #1263
• Fixed message indexed by store cursor being excluded from history query results. #1263
• Fixed log-level configuration being ignored by the nwaku node. #1272
• Fixed incorrect error message when failing to set 34/WAKU2-PEER-EXCHANGE peer. #1298
• Fixed and replaced deprecated TaintedString type. #1326
• Fixed and replaced unreliable regex library and usage. #1327 #1328
• Fixed and replaced deprecated ganache-cli node package with ganache for RLN onchain tests. Added graceful daemon termination. #1347

Docs

• Added cross client RLN testnet tutorial.
• Fixed broken link to Kibana in cluster documentation.
• Added an improved quickstart guide for operators.
• Added a Docker usage guide for operators.
• Added operator guide on running RLN spam prevention on nwaku nodes.
• Extended guidelines on nwaku configuration methods for operators.
• Added new store configuration guide to reflect simplified options.

This release supports the following libp2p protocols:

Protocol	Spec status	Protocol id
11/WAKU2-RELAY	stable	/vac/waku/relay/2.0.0
12/WAKU2-FILTER	draft	/vac/waku/filter/2.0.0-beta1
13/WAKU2-STORE	draft	/vac/waku/store/2.0.0-beta4
18/WAKU2-SWAP	draft	/vac/waku/swap/2.0.0-beta1
19/WAKU2-LIGHTPUSH	draft	/vac/waku/lightpush/2.0.0-beta1

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

2022-10-06 v0.12.0

Release highlights:

• The performance and stability of the message store has improved dramatically. Query durations, even for long-term stores, have improved by more than a factor of 10.
• Support for Waku Peer Exchange - a discovery method for resource-restricted nodes.
• Messages can now be marked as "ephemeral" to prevent them from being stored.
• Zerokit is now the default implementation for spam-protected relay with RLN.

The full list of changes is below.

Features

• Default support for Zerokit version of 17/WAKU-RLN-RELAY implementation.
• Added Filter REST API OpenAPI specification.
• Added POC implementation for 43/WAKU2-DEVICE-PAIRING.
• 14/WAKU2-MESSAGE can now be marked as ephemeral to prevent them from being stored.
• Support for 34/WAKU2-PEER-EXCHANGE.

Changes

• 17/WAKU-RLN-RELAY implementation now handles on-chain transaction errors.
• 17/WAKU-RLN-RELAY implementation now validates the Merkle tree root against a window of acceptable roots.
• Added metrics for 17/WAKU-RLN-RELAY implementation.
• Continued refactoring of several protocol implementations to improve maintainability and readability.
• Cleaned up nwaku imports and dependencies.
• Refactored and organised nwaku unit tests.
• Nwaku now periodically logs node metrics by default.
• Further improvements to the store implementation:
  • Better logging and query traceability.
  • More useful metrics to measure query and insertion time.
  • Reworked indexing for faster inserts and queries.
  • Reworked data model to use a simple, single timestamp for indexing, ordering and querying.
  • Improved retention policy management with periodic execution.
  • Run sqlite database vacuum at node start.
  • Improved logging when migrating the database to a newer version.
• relay no longer auto-mounted on all nwaku nodes.
• The most complete node ENR now included in response to API requests for node info().
• Updated Grafana dashboards included with nwaku.
• Github CI test execution now skipped for doc-only changes.

Fixes

• Fixed nwaku unnecessary sleep when no dynamic bootstrap nodes retrieved.
• Fixed 12/WAKU2-FILTER not working from browser-based clients due to nwaku peer manager failing to reuse existing connection.
• Waku Message payload now correctly encoded as base64 in the Relay REST API.
• Fixed handling of bindParam(uint32) in sqlite.
• chat2 application now correctly selects a random store node on startup.
• Fixed macos builds failing due to an unsupported dependency.
• Fixed nwaku not reconnecting to previously discovered nodes after losing connection.
• Fixed nwaku failing to start switch transports with external IP configuration.
• Fixed SIGSEGV crash when attempting to start nwaku store without db-path configuration.

Docs

• Improved RLN testnet tutorial
• Added tutorial on running nwaku from a DigitalOcean droplet.
• Added guide on how to monitor nwaku using Prometheus and Grafana.

This release supports the following libp2p protocols:

Protocol	Spec status	Protocol id
11/WAKU2-RELAY	stable	/vac/waku/relay/2.0.0
12/WAKU2-FILTER	draft	/vac/waku/filter/2.0.0-beta1
13/WAKU2-STORE	draft	/vac/waku/store/2.0.0-beta4
18/WAKU2-SWAP	draft	/vac/waku/swap/2.0.0-beta1
19/WAKU2-LIGHTPUSH	draft	/vac/waku/lightpush/2.0.0-beta1

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

2022-08-15 v0.11

Release highlights:

• Major improvements in the performance of historical message queries to longer-term, sqlite-only message stores.
• Introduction of an HTTP REST API with basic functionality
• On-chain RLN group management. This was also integrated into an example spam-protected chat application.

The full list of changes is below.

Features

• Support for on-chain group membership management in the 17/WAKU-RLN-RELAY implementation.
• Integrated HTTP REST API for external access to some wakunode2 functionality:
  • Debug REST API exposes debug information about a wakunode2.
  • Relay REST API allows basic pub/sub functionality according to 11/WAKU2-RELAY.
• 35/WAKU2-NOISE implementation now adds padding to ChaChaPoly encryptions to increase security and reduce metadata leakage.

Changes

• Significantly improved the SQLite-only historical message store query performance.
• Refactored several protocol implementations to improve maintainability and readability.
• Major code reorganization for the 13/WAKU2-STORE implementation to improve maintainability. This will also make the store extensible to support multiple implementations.
• Disabled compiler log colors when running in a CI environment.
• Refactored 35/WAKU2-NOISE implementation into smaller submodules.
• 11/WAKU2-RELAY implementation can now optionally be compiled with Zerokit RLN. Previously only Kilic's RLN was supported.

Fixes

• Fixed wire encoding of protocol buffers to use proto3.
• Fixed Waku v1 <> Waku v2 bridge losing connection to statically configured v1 nodes.
• Fixed underlying issue causing DNS discovery to fail for records containing multiple strings.

Docs

• Updated release process documentation.
• Added tutorial on how to run a spam-protected chat2 application with on-chain group management.

This release supports the following libp2p protocols:

Protocol	Spec status	Protocol id
11/WAKU2-RELAY	stable	/vac/waku/relay/2.0.0
12/WAKU2-FILTER	draft	/vac/waku/filter/2.0.0-beta1
13/WAKU2-STORE	draft	/vac/waku/store/2.0.0-beta4
18/WAKU2-SWAP	draft	/vac/waku/swap/2.0.0-beta1
19/WAKU2-LIGHTPUSH	draft	/vac/waku/lightpush/2.0.0-beta1

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

2022-06-15 v0.10

Release highlights:

• Support for key exchange using Noise handshakes.
• Support for a SQLite-only historical message store. This allows for cheaper, longer-term historical message storage on disk rather than in memory.
• Several fixes for native WebSockets, including slow or hanging connections and connections dropping unexpectedly due to timeouts.
• A fix for a memory leak in nodes running a local SQLite database.

Features

• Support for 35/WAKU2-NOISE handshakes as key exchange protocols.
• Support for TOML config files via --config-file=<path/to/config.toml>.
• Support for --version command. This prints the current tagged version (or compiled commit hash, if not on a version).
• Support for running store protocol from a filter client, storing only the filtered messages.
• Start of an HTTP REST API implementation.
• Support for a memory-efficient SQLite-only store configuration.

Changes

• Added index on receiverTimestamp in the SQLite store to improve query performance.
• GossipSub Peer Exchange is now disabled by default. This is a more secure option.
• Progress towards dynamic group management for the 17/WAKU-RLN-RELAY implementation.
• Nodes with --keep-alive enabled now sends more regular pings to keep connections more reliably alive.
• Disabled swap protocol by default.
• Reduced unnecessary and confusing logging, especially during startup.
• Added discv5 UDP port to the node's main discoverable ENR.

Fixes

• The in-memory store now checks the validity of message timestamps before storing.
• Fixed underlying bug that caused connection leaks in the HTTP client.
• Fixed Docker image compilation to use the correct external variable for compile-time flags (NIMFLAGS instead of NIM_PARAMS).
• Fixed issue where --dns4-domain-name caused an unhandled exception if no external port was available.
• Avoids unnecessarily calling DB migration if a --db-path is set but nothing is persisted in the DB. This led to a misleading warning log.
• Fixed underlying issues that caused WebSocket connections to hang.
• Fixed underlying issue that caused WebSocket connections to time out after 10 mins.
• Fixed memory leak in nodes that implements a SQLite database.

Docs

• Added tutorial on how to generate and configure a node key.
• Added first guide for nwaku operators.

This release supports the following libp2p protocols:

Protocol	Spec status	Protocol id
11/WAKU2-RELAY	stable	/vac/waku/relay/2.0.0
12/WAKU2-FILTER	draft	/vac/waku/filter/2.0.0-beta1
13/WAKU2-STORE	draft	/vac/waku/store/2.0.0-beta4
18/WAKU2-SWAP	draft	/vac/waku/swap/2.0.0-beta1
19/WAKU2-LIGHTPUSH	draft	/vac/waku/lightpush/2.0.0-beta1

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

2022-03-31 v0.9

Release highlights:

• Support for Peer Exchange (PX) when a peer prunes a 11/WAKU2-RELAY mesh due to oversubscription. This can significantly increase mesh stability.
• Improved start-up times through managing the size of the underlying persistent message storage.
• New websocket connections are no longer blocked due to parsing failures in other connections.

The full list of changes is below.

Features

• Support for bootstrapping 33/WAKU-DISCV5 via DNS discovery
• Support for GossipSub Peer Exchange

Changes

• Waku v1 <> v2 bridge now supports DNS multiaddrs
• Waku v1 <> v2 bridge now validates content topics before attempting to bridge a message from Waku v2 to Waku v1
• Persistent message storage now auto deletes messages once over specified --store-capacity. This can significantly improve node start-up times.
• Renamed Waku v1 <> v2 bridge make target and binary to wakubridge
• Increased store logging to assist with debugging
• Increased rln-relay logging to assist with debugging
• Message metrics no longer include the content topic as a dimension to keep Prometheus metric cardinality under control
• Waku v2 toy-chat application now sets the sender timestamp when creating messages
• The type of the proof field of the WakuMessage is changed to RateLimitProof
• Added method to the JSON-RPC API that returns the git tag and commit hash of the binary
• The node's ENR is now included in the JSON-RPC API response when requesting node info

Fixes

• Fixed incorrect conversion of seconds to nanosecond timestamps
• Fixed store queries blocking due to failure in resource clean up
• Fixed underlying issue where new websocket connections are blocked due to parsing failures in other connections
• Fixed failure to log the ENR necessary for a discv5 connection to the node

Docs

• Added RAM requirements to wakunode2 build instructions
• Added tutorial on communicating with waku2 test fleets via the chat2 toy-chat application in spam-protected mode using 17/WAKU-RLN-RELAY.
• Added a section on bug reporting to wakunode2 README
• Fixed broken links in the JSON-RPC API Tutorial

This release supports the following libp2p protocols:

Protocol	Spec status	Protocol id
11/WAKU2-RELAY	stable	/vac/waku/relay/2.0.0
12/WAKU2-FILTER	draft	/vac/waku/filter/2.0.0-beta1
13/WAKU2-STORE	draft	/vac/waku/store/2.0.0-beta4
18/WAKU2-SWAP	draft	/vac/waku/swap/2.0.0-beta1
19/WAKU2-LIGHTPUSH	draft	/vac/waku/lightpush/2.0.0-beta1

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

2022-03-03 v0.8

Release highlights:

• Working demonstration and integration of 17/WAKU-RLN-RELAY in the Waku v2 toy-chat application
• Beta support for ambient peer discovery using a version of Discovery v5
• A fix for the issue that caused a store node to run out of memory after serving a number of historical queries
• Ability to configure a dns4 domain name for a node and resolve other dns-based multiaddrs

The full list of changes is below.

Features

• 17/WAKU-RLN-RELAY implementation now supports spam-protection for a specific combination of pubsubTopic and contentTopic (available under the rln compiler flag).
• 17/WAKU-RLN-RELAY integrated into chat2 toy-chat (available under the rln compiler flag)
• Added support for resolving dns-based multiaddrs
• A Waku v2 node can now be configured with a domain name and dns4 multiaddr
• Support for ambient peer discovery using 33/WAKU-DISCV5

Changes

• Metrics: now monitoring content topics and the sources of new connections
• Metrics: improved default fleet monitoring dashboard
• Introduced a Timestamp type (currently an alias for int64).
• All timestamps changed to nanosecond resolution.
• timestamp field number in WakuMessage object changed from 4 to 10
• 13/WAKU2-STORE identifier updated to /vac/waku/store/2.0.0-beta4
• toy-chat application now uses DNS discovery to connect to existing fleets

Fixes

• Fixed underlying bug that caused occasional failures when reading the certificate for secure websockets
• Fixed store memory usage issues when responding to history queries

Docs

• Documented use of domain certificates for secure websockets
• Documented how to configure a dns4 domain name for a node
• Clarified use of DNS discovery and provided current URLs for discoverable fleet nodes
• Added tutorial on using 17/WAKU-RLN-RELAY with the chat2 toy-chat application
• Added tutorial on how to configure and a use a 15/WAKU-BRIDGE

This release supports the following libp2p protocols:

Protocol	Spec status	Protocol id
11/WAKU2-RELAY	stable	/vac/waku/relay/2.0.0
12/WAKU2-FILTER	draft	/vac/waku/filter/2.0.0-beta1
13/WAKU2-STORE	draft	/vac/waku/store/2.0.0-beta4
18/WAKU2-SWAP	draft	/vac/waku/swap/2.0.0-beta1
19/WAKU2-LIGHTPUSH	draft	/vac/waku/lightpush/2.0.0-beta1

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

2022-01-19 v0.7

Release highlights:

• Support for secure websockets.
• Ability to remove unreachable clients in a filter node.
• Several fixes to improve store performance and decrease query times. Query time for large stores decreased from longer than 8 min to under 100 ms.
• Fix for a long-standing bug that prevented proper database migration in some deployed Docker containers.

The full list of changes is below.

Features

• Support for secure websocket transport

Changes

• Filter nodes can now remove unreachable clients
• The WakuInfo listenStr is deprecated and replaced with a sequence of listenAddresses to accommodate multiple transports
• Removed cached peerInfo on local node. Rely on underlying libp2p switch instead
• Metrics: added counters for protocol messages
• Waku v2 node discovery now supports 31/WAKU2-ENR
• resuming the history via resume now takes the answers of all peers in peerList into consideration and consolidates them into one deduplicated list

Fixes

• Fixed database migration failure in the Docker image
• All HistoryResponse messages are now auto-paginated to a maximum of 100 messages per response
• Increased maximum length for reading from a libp2p input stream to allow largest possible protocol messages, including HistoryResponse messages at max size
• Significantly improved store node query performance
• Implemented a GossipSub MessageIdProvider for 11/WAKU2-RELAY messages instead of relying on the unstable default
• Receiver timestamps for message indexing in the store now have consistent millisecond resolution

This release supports the following libp2p protocols:

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

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

2021-11-05 v0.6

Some useful features and fixes in this release, include:

• two methods for Waku v2 node discovery
• support for unsecure websockets, which paves the way for native browser usage
• a fix for nim-waku store nodes running out of memory due to store size: the number of stored messages can now easily be configured
• a fix for densely connected nodes refusing new connections: the maximum number of allowed connections can now easily be configured
• support for larger message sizes (up from 64kb to 1Mb per message)

The full list of changes is below.

Features

• Waku v2 node discovery via DNS following EIP-1459
• Waku v2 node discovery via Node Discovery v5

Changes

• Pagination of historical queries are now simplified
• GossipSub prune backoff period is now the recommended 1 minute
• Bridge now uses content topic format according to 23/WAKU2-TOPICS
• Better internal differentiation between local and remote peer info
• Maximum number of libp2p connections is now configurable
• udp-port CLI option has been removed for binaries where it's not used
• Waku v2 now supports unsecure WebSockets
• Waku v2 now supports larger message sizes of up to 1 Mb by default
• Further experimental development of RLN for spam protection. These changes are disabled by default under a compiler flag. Changes include:
  • Per-message rate limit proof defined
  • RLN proof generation and verification integrated into Waku v2
  • RLN tree depth changed from 32 to 20
  • Support added for static membership group formation

Docs

• Added contributor guidelines on Waku v2 fleet monitoring and management
• Added basic tutorial on using Waku v2 DNS-based discovery

Fixes

• Bridge between toy-chat and matterbridge now shows correct announced addresses
• Bridge no longer re-encodes already encoded payloads when publishing to V1
• Bridge now populates WakuMessage timestamps when publishing to V2
• Store now has a configurable maximum number of stored messages
• Network simulations for Waku v1 and Waku v2 are runnable again

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
11/WAKU2-RELAY	stable	/vac/waku/relay/2.0.0
12/WAKU2-FILTER	draft	/vac/waku/filter/2.0.0-beta1
13/WAKU2-STORE	draft	/vac/waku/store/2.0.0-beta3
18/WAKU2-SWAP	draft	/vac/waku/swap/2.0.0-beta1
19/WAKU2-LIGHTPUSH	draft	/vac/waku/lightpush/2.0.0-beta1

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

2021-07-26 v0.5.1

This patch release contains the following fix:

• Support for multiple protocol IDs when reconnecting to previously connected peers: A bug in v0.5 caused clients using persistent peer storage to only support the mounted protocol ID.

This is a patch release that is fully backwards-compatible with release v0.5. It supports the same libp2p protocols:

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

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

2021-07-23 v0.5

This release contains the following:

Features

• Support for keep-alives using libp2p ping protocol.
• DB migration for the message and peer stores.
• Support for multiple protocol IDs. Mounted protocols now match versions of the same protocol that adds a postfix to the stable protocol ID.

Changes

• Bridge topics are now configurable.
• The resume Nim API now eliminates duplicates messages before storing them.
• The resume Nim API now fetches historical messages in page sequence.
• Added support for stable version of relay protocol, with protocol ID /vac/waku/relay/2.0.0.
• Added optional timestamp to WakuRelayMessage.
• Removed PCRE as a prerequisite for building Waku v1 and Waku v2.
• Improved swap metrics.

General refactoring

• Refactored modules according to Nim best practices.
• Simplified the way protocols get notified of new messages.
• Refactored wakunode2 setup into 6 distinct phases with improved logging and error handling.
• Moved Whisper types and protocol from the nim-eth module to nim-waku.

Docs

• Added database migration tutorial.
• Added tutorial to setup websockify.

Schema

• Updated the Message table of the persistent message store:
  • Added senderTimestamp column.
  • Renamed the timestamp column to receiverTimestamp and changes its type to REAL.

API

• Added optional timestamp to WakuRelayMessage on JSON-RPC API.

Fixes

• Conversion between topics for the Waku v1 <-> v2 bridge now follows the RFC recommendation.
• Fixed field order of HistoryResponse protobuf message: the field numbers of the HistoryResponse are shifted up by one to match up the 13/WAKU2-STORE specs.

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
11/WAKU2-RELAY	stable	/vac/waku/relay/2.0.0
12/WAKU2-FILTER	draft	/vac/waku/filter/2.0.0-beta1
13/WAKU2-STORE	draft	/vac/waku/store/2.0.0-beta3
18/WAKU2-SWAP	draft	/vac/waku/swap/2.0.0-beta1
19/WAKU2-LIGHTPUSH	draft	/vac/waku/lightpush/2.0.0-beta1

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

2021-06-03 v0.4

This release contains the following:

Features

• Initial toy-chat implementation

Changes

• The toy-chat application can now perform lightpush and request content-filtered messages from remote peers.
• The toy-chat application now uses default content topic /toy-chat/2/huilong/proto
• Improve toy-chat briding to matterbridge
• Improve swap logging and enable soft mode by default
• Content topics are no longer in a redundant nested structure
• Improve error handling

API

• JSON-RPC Store API: Added an optional time-based query to filter historical messages.
• Nim API: Added resume method.

Fixes

• Connections between nodes no longer become unstable due to keep-alive errors if mesh grows large
• Re-enable lightpush tests and fix Windows CI failure

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
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
18/WAKU2-SWAP	draft	/vac/waku/swap/2.0.0-beta1
19/WAKU2-LIGHTPUSH	draft	/vac/waku/lightpush/2.0.0-beta1

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

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

• Enable swap protocol by default and improve logging

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.

2021-01-05 v0.2

This release contains the following changes:

• Calls to publish a message on wakunode2 now await instead of discard dispatched WakuRelay procedures.
• StrictNoSign enabled.
• Add JSON-RPC API for external access to wakunode2 functionality:
  • Admin API retrieves information about peers registered on the wakunode2.
  • Debug API exposes debug information about a wakunode2.
  • Filter API saves bandwidth by allowing light nodes to filter for specific content.
  • Private API enables symmetric or asymmetric cryptography to encrypt/decrypt message payloads.
  • Relay API allows basic pub/sub functionality.
  • Store API retrieves historical messages.
• Add tutorial on how to use JSON-RPC API.
• Refactor: Move waku_filter protocol into its own module.

The Waku v2 implementation, and most protocols it consist of, are still in a draft/beta state. The Waku v1 implementation is stable but not under active development.

2020-11-30 v0.1

Initial beta release.

This release contains:

• A Nim implementation of the Waku v1 protocol.
• A Nim implementation of the Waku v2 protocol.
• CLI applications wakunode and wakunode2 that allows you to run a Waku v1 or v2 node.
• Examples of Waku v1 and v2 usage.
• Various tests of above.

Currenty the Waku v2 implementation, and most protocols it consist of, are in a draft/beta state. The Waku v1 implementation is stable but not under active development.

Feedback welcome!