lib

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

README.md (3658B)


      1 # radroots_browser
      2 
      3 Origin-thread client composition over the shared Radroots execution owner,
      4 authenticated protected IndexedDB workspace and shared Nostr session. Participant
      5 signing and workspace attachment remain explicit. Opening existing state never
      6 creates missing keys, grants or records. Startup performs no automatic query,
      7 publication or outbox replay. Preview memory does not qualify protected work.
      8 
      9 `listings().publish` delegates initial public listings to the same retained
     10 command owner as private inquiry. It requires an authenticated seller outbox
     11 and uses configured public write targets. Public results remain typed Listings;
     12 they acquire no private recipient, wrapping or stock authority. Scoped operation
     13 reads and explicit retry retain original signing and publication evidence.
     14 
     15 Effectful methods return the shared `ExecutionResult`; queries/resources retain
     16 compact errors. Generated `Failure` values preserve actual code/retry and
     17 original operation/admission with optional fixed signer rejection and exact
     18 SHA-256 prefix coverage. Byte counts are canonical decimal strings. No raw
     19 signer payload crosses the boundary. Unknown projection retains diagnostics,
     20 and drain/close preserve the original pending operation. Native and browser
     21 boundary errors keep a128-byte stack limit by boxing optional diagnostics;
     22 generated callers still receive typed values. Caller diagnostics grant no
     23 business, original nonissuance or stock-release authority.
     24 
     25 Accepted commands belong to a bounded local Rust task owner independently of
     26 their observation futures. Close permanently stops admission, drains original
     27 obtained evidence, disconnects the shared session, disposes original socket and
     28 signer callbacks and closes protected storage last. Cancelled close must resume.
     29 Tab termination cannot guarantee asynchronous completion. Browser WebSocket
     30 limitations remain those documented by the concrete transport adapter.
     31 
     32 The final WASM artifact must select one real clock provider for the pinned Nostr
     33 session. Enable `artifact_clock` at that artifact root to use `performance.now`
     34 and `Date.now`; do not combine it with another provider selection. Importing the
     35 module and constructing configuration perform no I/O. Native targets compile
     36 only host-independent task mechanics, not a browser client or fallback store.
     37 
     38 The `bindings` module generates local JavaScript handles and TypeScript
     39 declarations for listing, inquiry, operation observation/resume and explicit
     40 lifecycle calls. Its Rust constructors accept actual configured client and
     41 authenticated workspace handles. Foreign descriptors cannot create workspace
     42 authority. Inputs use the shared bounded parsers; IDs and times remain exact
     43 strings. Owned typed results retain independent admission, installation,
     44 issuance, delivery, wait, recovery and per-target provenance. String
     45 admission bounds UTF-16 before a Rust copy, rejects unpaired surrogates and
     46 checks the exact UTF-8 budget. Listing bytes are bounded before copying into
     47 WASM memory. Shared parsers remain the semantic authority. Presentation text
     48 copies have the foreign caller's lifetime; Rust retains zeroizing private data.
     49 Close the client explicitly before releasing its handles. Dropping or freeing
     50 one foreign wrapper does not complete asynchronous resource closure or undo
     51 accepted commands.
     52 
     53 The browser test package packs generated exports with a clearly synthetic
     54 Rust-authenticated host fixture for neutral TypeScript page/worker calls. That
     55 fixture is not a general host/custody factory or the complete SDK distribution.
     56 Scoped worker signer bridges and complete distribution remain separately
     57 qualified work.