lib

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

README.md (2010B)


      1 # Native binding qualification host
      2 
      3 This standalone test library composes the real shared client, protected native
      4 outbox, file-secret provider and signer with an isolated loopback relay. It
      5 reexports the production `radroots_ffi` component and exports test setup and
      6 measurement controls in its own component. It contains no product commands,
      7 validators, outbox or recovery implementation.
      8 
      9 Generated Swift and generic Kotlin callers must invoke the production objects.
     10 Rust host setup, measured effects and language execution remain separate proof
     11 scopes. Synthetic keys, test grants, pause controls and the deliberate panic
     12 probe belong only to this fixture. They are not product API or custody,
     13 hardware, app-migration, signing or release qualification.
     14 
     15 Build and test this independent manifest with the `native_binding_fixture`
     16 Cargo profile, after the root producer/generator build. Keep every command
     17 inside `cargo extbuild run --`. The named profile prevents fixed-name FFI
     18 rlib collisions without overriding extbuild's target-directory routing.
     19 
     20 After building the fixture and `radroots_ffi_bindgen`, execute the actual
     21 language lane from the Lib root:
     22 
     23 ```sh
     24 cargo extbuild run -- cargo build -p xtask --bin radroots_ffi_bindgen --locked
     25 cargo extbuild run -- node crates/radroots_ffi/tests/native/qualify.mjs \
     26   --out /absolute/new/external/evidence-directory \
     27   --kotlinc /absolute/kotlin/bin/kotlinc \
     28   --jna /absolute/jna.jar \
     29   --java /absolute/java
     30 ```
     31 
     32 The lane records actual tool versions, source and binary hashes, deterministic
     33 generation, compiler output and real workflow results. Kotlin's coroutines
     34 runtime is resolved from the specified Kotlin installation. This lane requires
     35 native macOS with Swift6, Kotlin2.2 and Java21. Plain nonthrowing Swift panic
     36 conversion is a deliberately isolated process-failure probe; Result-shaped
     37 panics must be caught as unexpected errors. No panic probe belongs to product
     38 API. Original failures remain in their original evidence directories.