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