mirror of
https://github.com/logos-messaging/logos-messaging-go-bindings.git
synced 2026-06-11 03:09:27 +00:00
1dc549d1d7
* refactor: extract libwaku cgo bridge into internal/ffi Move the C preamble, cgo shims, and callback plumbing from pkg/kernel/nwaku.go into internal/ffi/libwaku.go, where #111 scaffolded them to live. The bridge exposes Go-typed Waku* primitives (handle in, strings out) and owns the handle->event-handler registry, so pkg/kernel is now pure Go: WakuNode keeps its full API, logging, and error texts, and just calls ffi. Behavior is unchanged. Dropped four C shims that had no Go callers (cGoWakuContentTopic, cGoWakuPubsubTopic, cGoWakuDefaultPubsubTopic, cGoWakuLightpushPublish). CGO flags still come from the environment (Makefile/CI untouched). Part of #106. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> * refactor: move libwaku bridge into internal/ffi/libwaku subpackage One subpackage per C library so a binary links exactly the libraries it imports: libwaku and liblogosdelivery carry overlapping symbols and must never link together (until logos-delivery#3851). With the package named libwaku the Waku* prefixes became stutter, so the exported primitives drop them (libwaku.New/Start/RelayPublish/...). internal/ffi keeps an umbrella doc.go stating the rule. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> --------- Co-authored-by: Claude Fable 5 <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