mirror of
https://github.com/logos-messaging/logos-messaging-go-bindings.git
synced 2026-07-04 09:49:27 +00:00
43ed60b641
Implement the high-level, idiomatic Go Messaging API mirroring the Nim MessagingClient, on top of the internal/ffi/liblogosdelivery bridge. - MessagingClient: New/Start/Stop/Close, Subscribe/Unsubscribe, Send -> RequestID. (Named to match the Nim MessagingClient.) - Unified Events() <-chan Event with a sealed Event interface (MessageReceived/Sent/Propagated/Error, ConnectionStatus). Events are dropped (never block) if a consumer falls behind. - Event decoding handles liblogosdelivery's std/json wire format: received payload/meta arrive as JSON byte-int arrays (not base64), with base64 + null fallbacks; connectionStatus as an enum-name string. Unit-tested. - Config aliases the kernel WakuNodeConf. - examples/messaging: runnable demo. Part of #106 (Store + kernel accessors follow after logos-delivery#3851). Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
logos-delivery Go Bindings
Go bindings for the Waku library.
Install
go get -u github.com/logos-messaging/logos-delivery-go-bindings
Building & Dependencies
libwaku (from logos-delivery) is required at compile-time.
Building with Makefile
If you have logos-delivery checked out, point the build to it:
# path to your existing logos-delivery clone
export LOGOS_DELIVERY_DIR=/absolute/path/to/logos-delivery
export CGO_CFLAGS="-I${LOGOS_DELIVERY_DIR}/library"
export CGO_LDFLAGS="-L${LOGOS_DELIVERY_DIR}/build -lwaku -Wl,-rpath,${LOGOS_DELIVERY_DIR}/build"
# compile all packages
make -C pkg/kernel build
# run all tests
make -C pkg/kernel test
# run a specific test
make -C pkg/kernel test TEST=TestConnectedPeersInfo
Development
When working on this repository itself, logos-delivery is included as a git submodule for convenience.
- Initialize and update the submodule, then build
libwakugit submodule update --init --recursive make -C pkg/kernel build-libwaku - Build the project. Submodule paths are used by default to find
libwaku.make -C pkg/kernel build