lib

Core libraries for Radroots
git clone https://radroots.dev/git/lib.git
Log | Files | Refs | README

README.md (1230B)


      1 # radroots_sdk_ffi
      2 
      3 Private UniFFI bindings over the host-neutral `radroots_sdk` engine. The V1
      4 surface exposes deterministic memory-client construction, versioned capability
      5 DTOs, secret-safe errors, and explicit asynchronous close. It does not own
      6 keychain prompts, background execution, application scheduling, or presentation
      7 DTOs; those remain mobile-host responsibilities.
      8 
      9 This Rust build crate is never published. Generated Swift and Kotlin artifacts
     10 are qualified independently from the public 19-crate Rust inventory.
     11 
     12 The SDK artifact producer uses the source-owned `radroots_ffi_bindgen` binary
     13 in `xtask`. It preserves the actual async close method, keeps native string
     14 error messages as Kotlin's exception message, and gives Swift observer
     15 cancellation an explicit safe lifetime. Generated files must never be patched
     16 by consumers. Source-lock identity includes the generator implementation.
     17 
     18 `tests/native/qualify.mjs` accepts explicit library, generator, output, Kotlin,
     19 JNA and Java paths. It checks repeated generation, strict Swift6/Kotlin
     20 compilation, real native error-field round trips and actual memory-client
     21 closure. That retained bridge test does not qualify participant custody or
     22 application behavior.