v0.38.0

v0.38.0 (2026-03-16)

Notes

• liblogosdelivery: Major new FFI API with debug API, health status events, message received events, stateful SubscriptionService, and improved resource management.
• Waku Kademlia discovery integrated with Mix protocol.
• Context-aware and event-driven broker architecture introduced.
• REST Store API now defaults to page size 20 with max 100.
• Lightpush no longer mounts without relay enabled.
• Repository renamed from logos-messaging-nim to logos-delivery.

Features

• liblogosdelivery: FFI library of new API (#3714) (3603b838)
• liblogosdelivery: health status event support (#3737) (ba85873f)
• liblogosdelivery: MessageReceivedEvent propagation over FFI (#3747) (0ad55159)
• liblogosdelivery: add debug API (#3742) (09618a26)
• liblogosdelivery: implement stateful SubscriptionService for Core mode (#3732) (51ec09c3)
• Waku Kademlia integration and Mix protocol updates (#3722) (335600eb)
• Waku API: implement Health spec (#3689) (1fb4d1ea)
• Waku API: send (#3669) (1fd25355)
• iOS compilation support (WIP) (#3668) (96196ab8)
• Distribute libwaku binaries (#3612) (9e2b3830)
• Rendezvous: broadcast and discover WakuPeerRecords (#3617) (b0cd75f4)
• New postgres metric to estimate payload stats (#3596) (454b098a)

Bug Fixes

• Fix NodeHealthMonitor logspam (#3743) (7e36e268)
• Fix peer selection by shard and rendezvous/metadata sharding initialization (#3718) (84f79110)
• Correct dynamic library extension on mac and update OS detection (#3754) (1ace0154)
• Force FINALIZE partition detach after detecting shorter error (#3728) (b38b5aae)
• Fix store protocol issue in v0.37.0 (#3657) (91b4c5f5)
• Fix hash inputs for external nullifier, remove length prefix for sha256 (#3660) (2d40cb9d)
• Fix admin API peer shards field from metadata protocol (#3594) (e54851d9)
• Wakucanary exits with error if ping fails (#3595, #3711)
• Force epoll in chronos for Android (#3705) (beb1dde1)
• Fix build_rln.sh script (#3704) (09034837)
• liblogosdelivery: move destroy API to node_api, add security checks and fix possible resource leak (#3736) (db19da92)

Changes

• Context-aware brokers architecture (#3674) (c27405b1)
• Introduce EventBroker, RequestBroker and MultiRequestBroker (#3644) (ae74b901)
• Use chronos' TokenBucket (#3670) (284a0816)
• REST Store API constraints: default page size 20, max 100 (#3602) (8c30a8e1)
• Do not mount lightpush without relay (#3540) (7d1c6aba)
• Mix: use exit==dest approach (#3642) (088e3108)
• Mix: simple refactor to reduce duplicated logs (#3752) (96f1c40a)
• Simplify NodeHealthMonitor creation (#3716) (a8bdbca9)
• Adapt CLI args for delivery API (#3744) (1f9c4cb8)
• Adapt debugapi to WakoNodeConf (#3745) (4a6ad732)
• Bump nim-ffi to v0.1.3 (#3696) (a02aaab5)
• Bump nim-metrics to v0.2.1 (#3734) (c7e0cc0e)
• Add gasprice overflow check (#3636) (a8590a0a)
• Pin RLN dependencies to specific version (#3649) (834eea94)
• Update CI/README references after repository rename to logos-delivery (#3729) (895f3e2d)

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 /vac/waku/filter-subscribe/2.0.0-beta1 /vac/waku/filter-push/2.0.0-beta1
13/WAKU2-STORE	draft	/vac/waku/store/2.0.0-beta4
19/WAKU2-LIGHTPUSH	draft	/vac/waku/lightpush/2.0.0-beta1
WAKU2-LIGHTPUSH v3	draft	/vac/waku/lightpush/3.0.0
66/WAKU2-METADATA	raw	/vac/waku/metadata/1.0.0
WAKU-SYNC	draft	/vac/waku/sync/1.0.0

v0.37.4

Optimize release builds for speed (#3735) (#3777)

v0.37.3

Features

• Allow override user-message-rate-limit (#3778)

v0.37.2

v0.37.2 (2026-03-19)

Features

• Allow union of several retention policies (#3766)

Bug Fixes

• Bump nim-http-utils to v0.4.1 to allow accepting <:><(> as a valid header and tests to validate html rfc7230 (#43)
• Force FINALIZE partition detach after detecting shorter error (#3728)

v0.37.1

Bug Fixes

• Avoid IndexDefect if DB error message is short (#3725)
• Remove ENR cache from peer exchange (#3652) (7920368a)

v0.37.0-beta

Notes

• Deprecated parameters:
  • tree_path and rlnDB (RLN-related storage paths)
  • --dns-discovery (fully removed, including dns-discovery-name-server)
  • keepAlive (deprecated, config updated accordingly)
• Legacy store protocol is no longer supported by default.
• Improved sharding configuration: now explicit and shard-specific metrics added.
• Mix nodes are limited to IPv4 addresses only.
• lightpush legacy is being deprecated. Use lightpush v3 instead.

Features

• Waku API: create node via API (#3580) (bc8acf76)
• Waku Sync: full topic support (#3275) (9327da5a)
• Mix PoC implementation (#3284) (eb7a3d13)
• Rendezvous: add request interval option (#3569) (cc7a6406)
• Shard-specific metrics tracking (#3520) (c3da29fd)
• Libwaku: build Windows DLL for Status-go (#3460) (5c38a53f)
• RLN: add Stateless RLN support (#3621)
• LOG: Reduce log level of messages from debug to info for better visibility (#3622)

Bug Fixes

• Prevent invalid pubsub topic subscription via Relay REST API (#3559) (a36601ab)
• Fixed node crash when RLN is unregistered (#3573) (3d0c6279)
• REST: fixed sync protocol issues (#3503) (393e3cce)
• Regex pattern fix for username:password@ in URLs (#3517) (89a3f735)
• Sharding: applied modulus fix (#3530) (f68d7999)
• Metrics: switched to counter instead of gauge (#3355) (a27eec90)
• Fixed lightpush metrics and diagnostics (#3486) (0ed3fc80)
• Misc sync, dashboard, and CI fixes (#3434, #3508, #3464)
• Raise log level of numerous operational messages from debug to info for better visibility (#3622)

Changes

• Enable peer-exchange by default (#3557) (7df526f8)
• Refactor peer-exchange client and service implementations (#3523) (4379f9ec)
• Updated rendezvous to use callback-based shard/capability updates (#3558) (028bf297)
• Config updates and explicit sharding setup (#3468) (994d485b)
• Bumped libp2p to v1.13.0 (#3574) (b1616e55)
• Removed legacy dependencies (e.g., libpcre in Docker builds) (#3552) (4db4f830)
• Benchmarks for RLN proof generation & verification (#3567) (794c3a85)
• Various CI/CD & infra updates (#3515, #3505)

v0.36.0

Notes

• The rln-relay-eth-client-address parameter, from now on, should be passed as an array of RPC addresses.
• new preset parameter. preset=twn is the RLN-protected Waku Network (cluster 1). Overrides other values.
• Removed dns-addrs parameter as it was duplicated and unused.
• Removed rln-relay-id-key, rln-relay-id-commitment-key, rln-relay-bandwidth-threshold parameters.
• Effectively removed pubsub-topic, which was deprecated in v0.33.0.
• Removed store-sync-max-payload-size parameter.
• Removed dns-discovery-name-server and discv5-only parameters.

Features

• Update implementation for new contract abi (#3390) (ee4058b2d)
• Lighptush v3 for lite-protocol-tester (#3455) (3f3c59488)
• Retrieve metrics from libwaku (#3452) (f016ede60)
• Dynamic logging via REST API (#3451) (9fe8ef8d2)
• Add waku_disconnect_all_peers to libwaku (#3438) (7f51d103b)
• Extend node /health REST endpoint with all protocol's state (#3419) (1632496a2)
• Deprecate sync / local merkle tree (#3312) (50fe7d727)
• Refactor waku sync DOS protection (#3391) (a81f9498c)
• Waku Sync dashboard new panel & update (#3379) (5ed6aae10)
• Enhance Waku Sync logs and metrics (#3370) (f6c680a46)
• Add waku_get_connected_peers_info to libwaku (#3356) (0eb9c6200)
• Add waku_relay_get_peers_in_mesh to libwaku (#3352) (ef9074443)
• Add waku_relay_get_connected_peers to libwaku (#3353) (7250d7392)
• Introduce preset option (#3346) (0eaf90465)
• Add store sync dashboard panel (#3307) (ef8ee233f)

Bug Fixes

• Fix typo from DIRVER to DRIVER (#3442) (b9a4d7702)
• Fix discv5 protocol id in libwaku (#3447) (f7be4c2f0)
• Fix dnsresolver (#3440) (e42e28cc6)
• Misc sync fixes, added debug logging (#3411) (b9efa874d)
• Relay unsubscribe (#3422) (9fc631e10)
• Fix build_rln.sh update version to download v0.7.0 (#3425) (2678303bf)
• Timestamp based validation (#3406) (1512bdaf0)
• Enable WebSocket connection also in case only websocket-secure-support enabled (#3417) (698fe6525)
• Fix addPeer could unintentionally override metadata of previously stored peer with defaults and empty (#3403) (5cccaaac6)
• Fix bad HttpCode conversion, add missing lightpush v3 rest api tests (#3389) (7ff055e42)
• Adjust mistaken comments and broken link (#3381) (237f7abbb)
• Avoid libwaku's redundant allocs (#3380) (ac454a30b)
• Avoid performing nil check for userData (#3365) (b8707b6a5)
• Fix waku sync timing (#3337) (b01b1837d)
• Fix filter out ephemeral msg from waku sync (#3332) (4b963d8f5)
• Apply latest nph formating (#3334) (77105a6c2)
• waku sync 2.0 codecs ENR support (#3326) (bf735e777)
• waku sync mounting (#3321) (380d2e338)
• Fix rest-relay-cache-capacity (#3454) (fed4dc280)

Changes

• Lower waku sync log lvl (#3461) (4277a5349)
• Refactor to unify online and health monitors (#3456) (2e40f2971)
• Refactor rm discv5-only (#3453) (b998430d5)
• Add extra debug REST helper via getting peer statistics (#3443) (f4ad7a332)
• Expose online state in libwaku (#3433) (e7f5c8cb2)
• Add heaptrack support build for Nim v2.0.12 builds (#3424) (91885fb9e)
• Remove debug for js-waku (#3423) (5628dc6ad)
• Bump dependencies for v0.36 (#3410) (005815746)
• Enhance feedback on error CLI (#3405) (3464d81a6)
• Allow multiple rln eth clients (#3402) (861710bc7)
• Separate internal and CLI configurations (#3357) (dd8d66431)
• Avoid double relay subscription (#3396) (7d5eb9374 #3429) (ee5932ebc)
• Improve disconnection handling (#3385) (1ec9b8d96)
• Return all peers from REST admin (#3395) (f6fdd960f)
• Simplify rln_relay code a little (#3392) (7a6c00bd0)
• Extended /admin/v1 RESP API with different option to look at current connected/relay/mesh state of the node (#3382) (3db00f39e)
• Timestamp set to now in publish if not provided (#3373) (f7b424451)
• Update lite-protocol-tester for handling shard argument (#3371) (5ab69edd7)
• Fix unused and deprecated imports (#3368) (6ebb49a14)
• Expect camelCase JSON for libwaku store queries (#3366) (ccb4ed51d)
• Maintenance to c and c++ simple examples (#3367) (25d30d44d)
• Skip two flaky tests (#3364) ([b672617](https://github.co...

v0.35.1

v0.35.1 (2025-03-30)

Bug fixes

• Update RLN references (3287) (ea961fa)

Info: before upgrading to this version, make sure you delete the previous rln_tree folder, i.e.,
the one that is passed through this CLI: --rln-relay-tree-path.

Features

• lightpush v3 (#3279) (e0b563ff)
  Upgrade for Waku Llightpush protocol with enhanced error handling. Read specification here

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 /vac/waku/filter-subscribe/2.0.0-beta1 /vac/waku/filter-push/2.0.0-beta1
13/WAKU2-STORE	draft	/vac/waku/store/2.0.0-beta4
19/WAKU2-LIGHTPUSH	draft	/vac/waku/lightpush/2.0.0-beta1
66/WAKU2-METADATA	raw	/vac/waku/metadata/1.0.0
WAKU-SYNC	draft	/vac/waku/sync/1.0.0

v0.35.0

v0.35.0 (2025-03-03)

Notes

• Deprecated parameter

  • max-relay-peers

• New parameters

  • relay-service-ratio

    String value with peers distribution within max-connections parameter.
    This percentage ratio represents the relay peers to service peers.
    For example, 60:40, tells that 60% of the max-connections will be used for relay protocol
    and the other 40% of max-connections will be reserved for other service protocols (e.g.,
    filter, lightpush, store, metadata, etc.)

  • rendezvous

    boolean attribute that optionally activates waku rendezvous discovery server.
    True by default.

Release highlights

• New filter approach to keep push stream opened within subscription period.
• Waku sync protocol.
• Libwaku async
• Lite-protocol-tester enhancements.
• New panels and metrics in RLN to control outstanding request quota.

Features

• waku sync shard matching check (#3259) (42fd6b827)
• waku store sync 2.0 config & setup (#3217) (7f64dc03a)
• waku store sync 2.0 protocols & tests (#3216) (6ee494d90)
• waku store sync 2.0 storage & tests (#3215) (54a7a6875)
• waku store sync 2.0 common types & codec (#3213) (29fda2dab)
• add txhash-based eligibility checks for incentivization PoC (#3166) (505ec84ce)
• connection change event (#3225) (e81a5517b)
• libwaku add protected topic (#3211) (d932dd10c)
• topic health tracking (#3212) (6020a673b)
• allowing configuration of application level callbacks (#3206) (049fbeabb)
• waku rendezvous wrapper (#2962) (650a9487e)
• making dns discovery async (#3175) (d7d00bfd7)
• remove Waku Sync 1.0 & Negentropy (#3185) (2ab9c3d36)
• add waku_dial_peer and get_connected_peers to libwaku (#3149) (507b1fc4d)
• running periodicaly peer exchange if discv5 is disabled (#3150) (400d7a54f)

Bug Fixes

• avoid double db migration for sqlite (#3244) (2ce245354)
• libwaku waku_relay_unsubscribe (#3207) (ab0c1d4aa)
• libwaku support string and int64 for timestamps (#3205) (2022f54f5)
• lite-protocol-tester receiver exit check (#3187) (beb21c78f)
• linting error (#3156) (99ac68447)

Changes

• more efficient metrics usage (#3298) (6f004d5d4)(c07e278d8)
• filter refactor subscription management and react when the remote peer closes the stream. See the following commits in chronological order:
  • issue: #3281 commit: 5392b8ea4
  • issue: #3198 commit: 287e9b12c
  • issue: #3267 commit: 46747fd49
• send msg hash as string on libwaku message event (#3234) (9c209b4c3)
• separate heaptrack from debug build (#3249) (81f24cc25)
• capping mechanism for relay and service connections (#3184) (2942782f9)
• add extra migration to sqlite and improving error message (#3240) (bfd60ceab)
• optimize libwaku size (#3242) (9c0ad8517)
• golang example end using negentropy dependency plus simple readme.md (#3235) (0e0fcfb1a)
• enhance libwaku store protocol and more (#3223) (22ce9ee87)
• add two RLN metrics and panel (#3181) (1b532e8ab)
• libwaku async (#3180) (47a623541)
• filter protocol in libwaku (#3177) (f856298ca)
• add supervisor for lite-protocol-tester infra (#3176) (a7264d68c)
• libwaku better error handling and better waku thread destroy handling (#3167) (294dd03c4)
• libwaku allow several multiaddresses for a single peer in store queries (#3171) (3cb8ebdd8)
• naming connectPeer procedure (#3157) (b3656d6ee)

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 /vac/waku/filter-subscribe/2.0.0-beta1 /vac/waku/filter-push/2.0.0-beta1
13/WAKU2-STORE	draft	/vac/waku/store/2.0.0-beta4
19/WAKU2-LIGHTPUSH	draft	/vac/waku/lightpush/2.0.0-beta1
66/WAKU2-METADATA	raw	/vac/waku/metadata/1.0.0
WAKU-SYNC	draft	/vac/waku/reconciliation/1.0.0 & /vac/waku/transfer/1.0.0

v0.34.0

v0.34.0 (2024-10-29)

Notes:

• The --protected-topic CLI configuration has been removed. Equivalent flag, --protected-shard, shall be used instead.

Features

• change latency buckets (#3153) (956fde6e)
• libwaku: ping peer (#3144) (de11e576)
• initial windows support (#3107) (ff21c01e)
• circuit relay support (#3112) (cfde7eea)

Bug Fixes

• peer exchange libwaku response handling (#3141) (76606421)
• add more logs, stagger intervals & set prune offset to 10% for waku sync (#3142) (a386880b)
• add log and archive message ingress for sync (#3133) (80c7581a)
• add a limit of max 10 content topics per query (#3117) (c35dc549)
• avoid segfault by setting a default num peers requested in Peer eXchange (#3122) (82fd5dde)
• returning peerIds in base 64 (#3105) (37edaf62)
• changing libwaku's error handling format (#3093) (2e6c299d)
• remove spammy log (#3091) (1d2b910f)
• avoid out connections leak (#3077) (eb2bbae6)
• rejecting excess relay connections (#3065) (8b0884c7)
• static linking negentropy in ARM based mac (#3046) (256b7853)

Changes

• support ping with multiple multiaddresses and close stream (#3154) (3665991a)
• liteprotocoltester: easy setup fleets (#3125) (268e7e66)
• saving peers enr capabilities (#3127) (69d9524f)
• networkmonitor: add missing field on RlnRelay init, set default for num of shard (#3136) (edcb0e15)
• add to libwaku peer id retrieval proc (#3124) (c5a825e2)
• adding to libwaku dial and disconnect by peerIds (#3111) (25da8102)
• dbconn: add requestId info as a comment in the database logs (#3110) (30c072a4)
• improving get_peer_ids_by_protocol by returning the available protocols of connected peers (#3109) (ed0ee5be)
• remove warnings (#3106) (c861fa9f)
• better store logs (#3103) (21b03551)
• Improve binding for waku_sync (#3102) (c3756e3a)
• improving and temporarily skipping flaky rln test (#3094) (a6ed80a5)
• update master after release v0.33.1 (#3089) (54c3083d)
• re-arrange function based on responsibility of peer-manager (#3086) (0f8e8740)
• waku_keystore: give some more context in case of error (#3064) (3ad613ca)
• bump negentropy (#3078) (643ab20f)
• Optimize store (#3061) (5875ed63)
• wrap peer store (#3051) (729e63f5)
• disabling metrics for libwaku (#3058) (b358c90f)
• test peer connection management (#3049) (711e7db1)
• updating upload and download artifact actions to v4 (#3047) (7c4a9717)
• Better database query logs and logarithmic scale in grafana store panels (#3048) (d68b06f1)
• extending store metrics (#3042) (fd83b42f)

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 /vac/waku/filter-subscribe/2.0.0-beta1 /vac/waku/filter-push/2.0.0-beta1
13/WAKU2-STORE	draft	/vac/waku/store/2.0.0-beta4
19/WAKU2-LIGHTPUSH	draft	/vac/waku/lightpush/2.0.0-beta1
66/WAKU2-METADATA	raw	/vac/waku/metadata/1.0.0
WAKU-SYNC	draft	/vac/waku/sync/1.0.0