Generated: 2026-09-04
- v2/legacy libp2p symbol collision —
libp2p_peerstore_newet al. fromc-libp2p/v2/libp2p_v2.ashadowed legacy implementations, causing segfaults in bitswap engine. Fixed by linking only required v2 objects (noise.o,multistream.o) after-lp2p. - c-libnostr shared-library
-fPIClinker error — c-libnostr CMake builds bothlibnostr.soandlibnostr.a. Linkinglibsecp256k1.a(built without-fPIC) into the shared library failed on Linux CI. Fixed by building only thenostr_statictarget. - c-libp2p/v2
yamux_stub.onot built —main/Makefileandtest/Makefilereference../c-libp2p/v2/src/stub/yamux_stub.o, but the v2 Makefile only built objects inSRCS. Fixed by addingsrc/stub/yamux_stub.oto the v2allandcleantargets. - Cross-platform
preparetarget deleting archives — Thepreparetarget searched for non-ELF files and deleted.aarchives, causing full c-libnostr and secp256k1 rebuilds on everymake all. Fixed by removing.a/.la/.lofrom the find patterns. - nostril secp256k1 host-triplet detection broken on Linux — The
nostrilMakefile target grepped for^host_triplet=which does not exist in secp256k1config.log(it useshost='...'). This caused Linux CI to purge a valid secp256k1 build. Fixed by grepping^host='and checking OS name in addition to architecture.
- [~] QUIC transport —
transport/quic_transport.ccompiles and links. lsquic engine stub is present; needs end-to-end handshake verification. - [~] WebSocket transport —
transport/ws_transport.ccompiles and links. libwebsockets integration is stubbed; needs event loop wiring. - [~] Transport registry dial dispatch —
transport/registry.c,transport/dnsaddr_resolver.c, andtransport/swarm_dialer_v2_bridge.ccompile and link. The registry iterates transports, but bitswap engine still uses the legacy TCP-only path for the actual block exchange. - [~] Swarm dialer protocol upgrade — Outbound dialer runs TCP →
multistream →
/noise→ Noise handshake → multistream over noise → yamux. Full end-to-endswarm connectverify against Kubo blocked bylibp2p_stream_get_latest_streambridge stream bug.
- [~] Noise handshake completion — Outbound v2 Noise XX handshake with
libp2p identity payload works against Kubo v0.43.0. Inbound listener still
uses legacy SECIO.
swarm connectis blocked by a bridge stream bug inlibp2p_stream_get_latest_stream(see PROTOCOL_GAPS.md P0 #2). - SECIO deprecation —
security/secio_noise_fallback.cimplements Noise-first with SECIO fallback. Legacy SECIO code remains for old peers. - [~] Yamux integration —
transport/v2_stream_wrapper.candtransport/swarm_dialer_v2_bridge.cwrap v2 yamux into the legacy stream lifecycle. Basic DATA frames work; WINDOW_UPDATE, PING, GO_AWAY ignored. - [~] Identify protocol v2 —
c-libp2p/v2/src/identify/identify_v2.cencodes all six Identify fields. Linked into main binary. Not yet wired into the live daemon inbound path.
- c-libnostr symbol collision resolution — All internal
nostr/*.osymbols renamed toipfs_nostr_*prefix.c-libnostr/build/libnostr.anow links cleanly into the main binary. - [~] NIP-34 git integration — CLI flags and internal event builders are
implemented in
cmd/ipfs/nostr.candnostr/git.c. Relay push/pull still needs c-libnostr relay client wiring. - [~] Nostr relay send/receive — c-libnostr is linked.
NOSTR_FEATURE_RELAYis OFF in the top-level Makefile to keep build times low; enabling it requires libwebsockets + cJSON linked into c-libnostr. - [~] Hybrid content routing —
routing/nostr_hybrid_routing.cimplements CID announce/resolve over Nostr kind-30023 events. Needs live relay test.
- [~] Repo version mismatch —
repo/fsrepo/fs_repo_version.ctargets version 18 and implements a migration stub. Need to verify against Kubo. - Repo lock portability —
fs_repo_lock()usesflock(LOCK_EX | LOCK_NB)which works on POSIX but may not interact correctly with Kubo repo locks (Kubo uses go-fslock with different semantics).
- [~] DHT provide/get offline errors —
routing/dht_server_api.cadds a stub DHT RPC server thread. Provide/get still return mock data; needs live Kademlia table integration. - [~] Bootstrap peer resolution —
transport/dnsaddr_resolver.cresolves/dnsaddr/domains to IPv4 multiaddrs. Needs integration into the bootstrap dial sequence. - Kubo interoperability HTTP RPC —
core/api_kubo_rpc.cserves/api/v0/versionand/api/v0/idon port 5011. Wired into daemon lifecycle (starts in pthread, stops gracefully via poll loop).
- Silent smoke test failures — All shell test blocks use
set -euo pipefail; failures now propagate correctly. - macOS CI matrix —
macos-latestis available via workflow_dispatch in.github/workflows/ci.yml. Periodic runner added in.github/workflows/ci-periodic.yml. - Test binary segfault / exit 1 — v2 collision fixed;
test_ipfsno longer segfaults at startup. However, the suite crashes in CI with heap corruption (see below). - Test binary heap corruption in CI —
test_ipfscrashes non-deterministically in GitHub Actions Ubuntu runners with either:Fatal glibc error: malloc.c:4376 assertion failed(exit 134, SIGABRT)Segmentation fault(exit 139, SIGSEGV) Crashes occur during tests that create repos and exercise the HTTP API (test_core_api_*andtest_daemon_startup_shutdown). The crashes do not reproduce locally (macOS arm64). All affected tests are disabled from the default suite as a temporary measure. Root cause is likely a heap-corruption bug in repo initialization, RSA key generation, or HTTP request processing that only manifests under Ubuntu glibc's stricter malloc checking.
- act local CI —
make act-buildworks but the Kubo interop job inside act still fails. Need to debug act container networking or port forwarding for the interop harness.
- CMake migration — c-libnostr and several submodules use CMake; c-ipfs still uses hand-rolled Makefiles. A top-level CMakeLists.txt would unify dependency discovery, feature flags, and cross-compilation.
- BoringSSL alignment — lsquic requires BoringSSL, but the rest of the project links OpenSSL. Symbol conflicts possible. Need isolated linking or full migration to BoringSSL.
- nostril secp256k1 CFLAGS — act containers use older GCC that rejects
-std=gnu23. The Makefile already forces-std=c99for secp256k1 configure, but this needs verification in CI.
- c-libp2p v2 yamux symbol collision —
src/conn/yamux.candsrc/stub/yamux_stub.cdefine functions with the same names (libp2p_yamux_session_new,libp2p_yamux_stream_open, etc.) but incompatible signatures.main/Makefilelinksyamux_stub.oexplicitly and does not linklibp2p_v2.a, so the collision is avoided for now. Long-term: reconcile the two yamux APIs or remove one. - c-libnostr relay feature disabled —
NOSTR_FEATURE_RELAY=OFFis hard-coded in the top-level Makefile to minimize build time. Enabling it requires linking libwebsockets and cJSON into c-libnostr, then ensuring the resultinglibnostr.adoes not collide with internalnostr/*.osymbols. - BoringSSL vs OpenSSL coexistence — lsquic links BoringSSL; c-ipfs
links OpenSSL (via
-lcurl -lssl -lcrypto). Both libraries define the same public symbols (libssl, libcrypto). On macOS this works because BoringSSL is linked as static archives placed explicitly on the link line. On Linux CI the same approach seems to work, but symbol shadowing risks remain if lsquic calls BoringSSL functions that behave differently from OpenSSL equivalents. - CMake vs Makefile hybrid build — c-libnostr, lsquic, BoringSSL, and libwebsockets use CMake; c-ipfs and c-libp2p use hand-rolled Makefiles. The top-level Makefile orchestrates CMake sub-builds with ad-hoc rules. A unified build system (e.g., top-level CMake or Meson) would eliminate ordering bugs like the yamux_stub omission.
- libp2p spec: QUIC-v1 — RFC 9000 + libp2p-TLS 1.3
- libp2p spec: WebSocket — RFC 6455 with multistream security
- libp2p spec: Noise XX — Noise Framework with static key extension
- NIP-34 — Git stuff over Nostr (partial: CLI flags done, relay integration pending)
- NIP-65 — Relay list metadata (c-libnostr supports it, not wired)
- IPNS over PubSub —
pubsub/ipns_pubsub.oexists but needs DHT fallback and Kubo interop verification.