(prev. Upgrade Nim Usage)

Enable easy C-Bindings for Desktop

Estimated date of completion: 19 Dec

Resources Required for 2025H2: TODO

Deliver nim-ffi, a library that facilitates delivering functional c-bindings for nim libraries.

This milestone tracks the work to ensure the resulting bindings are usable on desktop platform: Mac, Linux and Windows.

FURPS

See deliverables.

Risk	(Accept, Own, Mitigation)
Windows and build challenges	This is not a straightforward functionality delivery. Do note that most of the c-bindings works is already done.
Nim macros	Nim messaging team have limited experience with Nim macros, potentially impacting the speed of delivery.

Owner: Nim Messaging Team

Feature: Nim FFI

FURPS:

F1. Provides the core logic needed to expose any synchronous or asynchronous Nim library to a C-FFI library.
U1. Introduce new pragma definitions, such as {.ffi.}, to appropriately annotate types and procedures.
U2. Any Nim project can use it and can be installed using Nimble, similarly to how nim-chronos is imported.
U3. The interaction with the exposed C library can be done using JSON.
R1. Nim-FFI does not leak memory.
R2. The exposed C library never hangs when working asynchronously.
S1. The exposed C library can be used in Logos Core; on Linux, Mac and Windows.
+1. nwaku repository uses nim-ffi to expose the existing libwaku functionality.