A native module defines C callbacks with the shared function signature and exports solan_module_init(SolanModule *m). Register functions with solan_module_add_function and values with solan_module_add_value.

#include "solan.h"
static int add(int argc, const SolanValue *argv, SolanValue *res, void *user) {
  (void)user; (void)argc;
  if (!solan_is_number(argv[0]) || !solan_is_number(argv[1]))
    return solan_throw("جمع: يتطلب رقمين");
  *res = solan_number(solan_to_number(argv[0]) + solan_to_number(argv[1]));
  return 0;
}
int solan_module_init(SolanModule *m) {
  solan_module_add_function(m, "جمع", add, 2, 2, NULL);
  solan_module_add_value(m, "الاصدار", solan_number(1));
  return 0;
}

• Build a shared object with -fPIC -shared and -I include; the README example outputs hello.so.
• Import the module from Solan using a relative path; the module name is derived from the filename without extension.
• The executable exports solan_* symbols with the appropriate dynamic-linker flag; README says not to link the extension against libsolan or the executable.

Build as a shared library with -DSOLAN_LIBRARY, then call solan_init() from C, optionally register a native function, pass source to solan_eval, or invoke a Solan function with solan_call. README examples use solan_last_error() to read failures.

cc -O2 -fPIC -shared -DSOLAN_LIBRARY -Wno-format-truncation -o libsolan.so solan.c -lm -ldl
cc -I include -o demo demo.c -L. -lsolan -Wl,-rpath,.

• Direct ffi binding associates a C symbol with a signature such as d(d); README lists type codes i, l, p, d, s, b, and v.
• FFI supports x86-64 and AArch64, up to 6 integer and 8 floating-point arguments; no float, varargs, or callbacks.
• Direct FFI and native-module loading require the اصلي permission, which is inherently unsafe. Apply runtime permission policy before executing third-party native code.