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.