libsoliton/C-API.md

libsoliton_capi

C ABI FFI layer for libsoliton — a pure-Rust post-quantum cryptographic library.

API

The complete API is defined in soliton.h (48 exported functions, cbindgen-generated). All functions return int32_t error codes; opaque handles are created/freed via matched _new/_free pairs.

Build

cargo build --release -p libsoliton_capi

Produces:

• target/release/libsoliton_capi.so (Linux) / .dylib (macOS) / .dll (Windows)
• target/release/libsoliton_capi.a (static)

Link

pkg-config:

gcc main.c $(pkg-config --cflags --libs libsoliton) -o main

CMake:

find_package(Soliton REQUIRED)
target_link_libraries(myapp Soliton::Soliton)

Direct:

gcc main.c -I path/to/soliton_capi -L path/to/target/release -lsoliton_capi -o main