mirror of
https://github.com/logos-messaging/nim-chat-poc.git
synced 2026-07-03 07:00:16 +00:00
29c64b340d
Chat-side integration of the LEZ-backed RLN mix protocol:
- src/chat/delivery/waku_client.nim: mount waku_mix with onchain
RLN spam protection wired to logos_core_client fetchers; gate
the first publish on (a) gifter status confirmation, (b)
cushion of 2 poll intervals after confirmation, and (c) proof
root stability in the local valid_roots window; wrap mix
lightpush in withTimeout so vanished SURB replies surface as
Err instead of pinning the send coroutine.
- src/chat/client.nim: surface sendBytes errors via asyncSpawn
wrapped try/except instead of discarding the future (was
hiding every mix-publish failure).
- chat-side gifter client invocation (RLN membership service
wire format, EIP-191 ethereum-allowlist auth).
- Background membership status watcher that reconciles the
optimistic leaf returned by the gifter against the chain's
authoritative leaf via the status RPC.
Simulation harness (simulations/mix_lez_chat/):
- Spin up sequencer + run_setup + 4 mix nodes (one of which
runs the gifter service) + chat sender + chat receiver.
- SIM_NETWORK={local,testnet}, SIM_SLIM for testnet (reuses
shipped config_account + cached payment_account), Docker
image + GHCR for cross-platform testing.
- Strict mix-pool readiness gate, kademlia + RLN root activity
checks, gifter EIP-191 auth fixture, slim-mode submodule
minimization.
- TREE_ID_HEX pinned to the canonical testnet deployment.
Submodule bumps:
- vendor/nwaku to 8e6ba04 (LEZ-backed RLN mix + 2-phase gifter).
- vendor/logos-lez-rln to 950f287 (SPEL RLN program + mix sim
infrastructure + canonical testnet deploy).
Docs:
- RUN_SLIM_TESTNET.md: slim sim recipe.
- cleanup/MODE_A_GIFTER_SLOT_BUG.md: per-signer nonce collision
postmortem driving the queue+worker fix.
170 lines
5.4 KiB
Makefile
170 lines
5.4 KiB
Makefile
export BUILD_SYSTEM_DIR := vendor/nimbus-build-system
|
|
export EXCLUDED_NIM_PACKAGES := vendor/nwaku/vendor/nim-dnsdisc/vendor \
|
|
vendor/nwaku/vendor/nimbus-build-system \
|
|
vendor/nwaku/vendor/nim-ffi \
|
|
vendor/nim-sds/vendor \
|
|
vendor/logos-lez-rln
|
|
LINK_PCRE := 0
|
|
FORMAT_MSG := "\\x1B[95mFormatting:\\x1B[39m"
|
|
# we don't want an error here, so we can handle things later, in the ".DEFAULT" target
|
|
-include $(BUILD_SYSTEM_DIR)/makefiles/variables.mk
|
|
|
|
ifeq ($(NIM_PARAMS),)
|
|
# "variables.mk" was not included, so we update the submodules.
|
|
GIT_SUBMODULE_UPDATE := git submodule update --init --recursive
|
|
.DEFAULT:
|
|
+@ echo -e "Git submodules not found. Running '$(GIT_SUBMODULE_UPDATE)'.\n"; \
|
|
$(GIT_SUBMODULE_UPDATE); \
|
|
echo
|
|
# Now that the included *.mk files appeared, and are newer than this file, Make will restart itself:
|
|
# https://www.gnu.org/software/make/manual/make.html#Remaking-Makefiles
|
|
#
|
|
# After restarting, it will execute its original goal, so we don't have to start a child Make here
|
|
# with "$(MAKE) $(MAKECMDGOALS)". Isn't hidden control flow great?
|
|
|
|
else # "variables.mk" was included. Business as usual until the end of this file.
|
|
|
|
# Determine the OS
|
|
detected_OS := $(shell uname -s)
|
|
ifneq (,$(findstring MINGW,$(detected_OS)))
|
|
detected_OS := Windows
|
|
endif
|
|
|
|
|
|
##########
|
|
## Main ##
|
|
##########
|
|
.PHONY: all update clean
|
|
|
|
# default target, because it's the first one that doesn't start with '.'
|
|
all: | bot_echo pingpong liblogoschat
|
|
|
|
test_file := $(word 2,$(MAKECMDGOALS))
|
|
define test_name
|
|
$(shell echo '$(MAKECMDGOALS)' | cut -d' ' -f3-)
|
|
endef
|
|
|
|
logos_chat.nims:
|
|
ln -s logos_chat.nimble $@
|
|
|
|
update: | update-common
|
|
rm -rf logos_chat.nims && \
|
|
$(MAKE) logos_chat.nims $(HANDLE_OUTPUT)
|
|
|
|
clean:
|
|
rm -rf build
|
|
cd vendor/libchat && cargo clean
|
|
|
|
# must be included after the default target
|
|
-include $(BUILD_SYSTEM_DIR)/makefiles/targets.mk
|
|
|
|
### Create nimble links (used when building with Nix)
|
|
.PHONY: nimbus-build-system-nimble-dir
|
|
nimbus-build-system-nimble-dir:
|
|
NIMBLE_DIR="$(CURDIR)/$(NIMBLE_DIR)" \
|
|
PWD_CMD="$(PWD)" \
|
|
$(CURDIR)/vendor/nwaku/scripts/generate_nimble_links.sh
|
|
|
|
## Possible values: prod; debug
|
|
TARGET ?= prod
|
|
|
|
## Git version
|
|
GIT_VERSION ?= $(shell git describe --abbrev=6 --always --tags)
|
|
## Compilation parameters. If defined in the CLI the assignments won't be executed
|
|
NIM_PARAMS := $(NIM_PARAMS) -d:git_version=\"$(GIT_VERSION)\" -d:libp2p_mix_experimental_exit_is_dest
|
|
|
|
##################
|
|
## Dependencies ##
|
|
##################
|
|
|
|
CARGO_TARGET_DIR ?= rust-bundle/target
|
|
RUST_BUNDLE_LIB := $(CARGO_TARGET_DIR)/release/liblogoschat_rust_bundle.a
|
|
|
|
# Mix RLN spam protection library (separate zerokit build for mix-rln-spam-protection-plugin)
|
|
MIX_LIBRLN_VERSION ?= v2.0.0
|
|
MIX_LIBRLN_FILE ?= $(CURDIR)/build/librln_mix_$(MIX_LIBRLN_VERSION).a
|
|
MIX_LIBRLN_NIM_PARAMS := --passL:$(MIX_LIBRLN_FILE) --passL:-lm
|
|
ifneq ($(detected_OS),Darwin)
|
|
MIX_LIBRLN_NIM_PARAMS += --passL:"-Wl,--allow-multiple-definition"
|
|
endif
|
|
|
|
.PHONY: mix-librln
|
|
mix-librln: | $(MIX_LIBRLN_FILE)
|
|
|
|
$(MIX_LIBRLN_FILE):
|
|
echo -e $(BUILD_MSG) "$@" && \
|
|
$(CURDIR)/vendor/nwaku/scripts/build_rln_mix.sh \
|
|
$(CURDIR)/build/zerokit_$(MIX_LIBRLN_VERSION) \
|
|
$(MIX_LIBRLN_VERSION) \
|
|
$(MIX_LIBRLN_FILE) && \
|
|
$(CURDIR)/scripts/fix_mix_librln_dupes.sh $(MIX_LIBRLN_FILE) $(RUST_BUNDLE_LIB)
|
|
|
|
# libchat and rln each embed Rust std when built as staticlibs; linking both
|
|
# causes duplicate-symbol errors. rust-bundle/ links them as rlibs so std
|
|
# is emitted once. [1]
|
|
# [1] https://doc.rust-lang.org/reference/linkage.html#mixed-rust-and-foreign-codebases
|
|
.PHONY: build-rust-bundle
|
|
build-rust-bundle:
|
|
@echo "Building Rust bundle (libchat + rln)"
|
|
$(MAKE) -C vendor/nwaku librln
|
|
CARGO_TARGET_DIR=$(CARGO_TARGET_DIR) cargo build --release --manifest-path rust-bundle/Cargo.toml
|
|
@echo "Bundle library: $(RUST_BUNDLE_LIB)"
|
|
|
|
build-waku-nat:
|
|
@echo "Start building waku nat-libs"
|
|
$(MAKE) -C vendor/nwaku nat-libs
|
|
@echo "Completed building nat-libs"
|
|
|
|
.PHONY: tests
|
|
tests: | build-rust-bundle build-waku-nat logos_chat.nims
|
|
echo -e $(BUILD_MSG) "build/$@" && \
|
|
$(ENV_SCRIPT) nim tests $(NIM_PARAMS) \
|
|
--passL:$(RUST_BUNDLE_LIB) --passL:-lm \
|
|
logos_chat.nims
|
|
|
|
|
|
##########
|
|
## Example ##
|
|
##########
|
|
|
|
# Ensure there is a nimble task with a name that matches the target
|
|
tui bot_echo pingpong: | build-rust-bundle build-waku-nat mix-librln logos_chat.nims
|
|
echo -e $(BUILD_MSG) "build/$@" && \
|
|
$(ENV_SCRIPT) nim $@ $(NIM_PARAMS) $(MIX_LIBRLN_NIM_PARAMS) \
|
|
--passL:$(RUST_BUNDLE_LIB) --passL:-lm \
|
|
--path:src logos_chat.nims
|
|
|
|
###########
|
|
## Library ##
|
|
###########
|
|
|
|
# Determine shared library extension based on OS
|
|
ifeq ($(shell uname -s),Darwin)
|
|
LIBLOGOSCHAT_EXT := dylib
|
|
else ifeq ($(shell uname -s),Linux)
|
|
LIBLOGOSCHAT_EXT := so
|
|
else
|
|
LIBLOGOSCHAT_EXT := dll
|
|
endif
|
|
|
|
LIBLOGOSCHAT := build/liblogoschat.$(LIBLOGOSCHAT_EXT)
|
|
|
|
.PHONY: liblogoschat
|
|
liblogoschat: | build-rust-bundle build-waku-nat mix-librln logos_chat.nims
|
|
echo -e $(BUILD_MSG) "$(LIBLOGOSCHAT)" && \
|
|
$(ENV_SCRIPT) nim liblogoschat $(NIM_PARAMS) $(MIX_LIBRLN_NIM_PARAMS) \
|
|
--passL:$(RUST_BUNDLE_LIB) --passL:-lm \
|
|
--path:src logos_chat.nims && \
|
|
echo -e "\n\x1B[92mLibrary built successfully:\x1B[39m" && \
|
|
echo " $(shell pwd)/$(LIBLOGOSCHAT)"
|
|
|
|
### Nix-only: dependencies are pre-built Nix derivations, not built here
|
|
.PHONY: liblogoschat-nix
|
|
liblogoschat-nix: | logos_chat.nims
|
|
echo -e $(BUILD_MSG) "$(LIBLOGOSCHAT)" && \
|
|
$(ENV_SCRIPT) nim liblogoschat $(NIM_PARAMS) --path:src logos_chat.nims
|
|
|
|
endif
|
|
|
|
|