lib

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

commit fca43a1eff6bf655289eb77e3dde994b425bd51d
parent 0cf069a40956afffeef3aa1e168efb8a9c796785
Author: triesap <tyson@radroots.org>
Date:   Sun, 12 Apr 2026 21:07:10 +0000

docs: refresh crate-facing metadata

Diffstat:
Mcrates/identity/Cargo.toml | 2+-
Mcrates/identity/README | 7+++++--
Mcrates/nostr_accounts/Cargo.toml | 2+-
Mcrates/nostr_accounts/README | 2++
Mcrates/nostr_signer/Cargo.toml | 2+-
Mcrates/nostr_signer/README | 7+++++--
Mcrates/protected_store/Cargo.toml | 2+-
Mcrates/protected_store/README | 4+++-
Mcrates/replica_db/Cargo.toml | 2+-
Mcrates/replica_db/README | 5+++--
Mcrates/runtime_manager/Cargo.toml | 2+-
Mcrates/runtime_manager/README | 8+++++---
Mcrates/runtime_paths/Cargo.toml | 2+-
Mcrates/runtime_paths/README | 11+++++++----
Mcrates/trade/Cargo.toml | 2+-
Mcrates/trade/README | 9+++++----
16 files changed, 43 insertions(+), 26 deletions(-)

diff --git a/crates/identity/Cargo.toml b/crates/identity/Cargo.toml @@ -6,7 +6,7 @@ edition.workspace = true authors = ["Tyson Lupul <tyson@radroots.org>"] rust-version.workspace = true license.workspace = true -description = "Identity models, username helpers, and profile utilities" +description = "Identity models, encrypted file storage, and profile utilities" repository.workspace = true homepage.workspace = true documentation = "https://docs.rs/radroots_identity" diff --git a/crates/identity/README b/crates/identity/README @@ -1,13 +1,16 @@ # radroots_identity -This is the README for `radroots_identity`, which provides identity models and -profile utilities for the `radroots` core libraries. +This is the README for `radroots_identity`, which provides identity models, +encrypted file storage, and profile utilities for the `radroots` core +libraries. ## Overview * public and private identity, profile, file, and identifier types; * username validation, normalization, and parser helpers; * default identity path constants and JSON file support behind feature flags; + * encrypted identity-file and public-profile storage helpers for local runtime + consumers; * optional NIP-49, `secrecy`, `zeroize`, and `ts-rs` support for protected key material and shared model export. diff --git a/crates/nostr_accounts/Cargo.toml b/crates/nostr_accounts/Cargo.toml @@ -6,7 +6,7 @@ edition.workspace = true authors = ["Tyson Lupul <tyson@radroots.org>"] rust-version.workspace = true license.workspace = true -description = "Account models and vault-backed Nostr stores" +description = "Vault-backed Nostr account stores and bootstrap helpers" repository.workspace = true homepage.workspace = true documentation = "https://docs.rs/radroots_nostr_accounts" diff --git a/crates/nostr_accounts/README b/crates/nostr_accounts/README @@ -8,6 +8,8 @@ and vault-backed stores for the `radroots` core libraries. * account, selection, and store-state models for working Nostr identities; * manager and store layers for file-backed and in-memory account persistence under `std`; + * shared bootstrap helpers for local account stores backed by protected files + and runtime-selected secret vaults; * vault integrations through `radroots_secret_vault`, including memory and OS keyring backends; * optional nostrdb bridge helpers for account registration and lookup. diff --git a/crates/nostr_signer/Cargo.toml b/crates/nostr_signer/Cargo.toml @@ -6,7 +6,7 @@ edition.workspace = true authors = ["Tyson Lupul <tyson@radroots.org>"] rust-version.workspace = true license.workspace = true -description = "Transport-neutral signer models, policies, and stores" +description = "Transport-neutral signer stores and NIP-46 handler primitives" repository.workspace = true homepage.workspace = true documentation = "https://docs.rs/radroots_nostr_signer" diff --git a/crates/nostr_signer/README b/crates/nostr_signer/README @@ -1,7 +1,8 @@ # radroots_nostr_signer This is the README for `radroots_nostr_signer`, which provides transport- -neutral signer models and stores for the `radroots` core libraries. +neutral signer stores and NIP-46 handler primitives for the `radroots` core +libraries. ## Overview @@ -9,8 +10,10 @@ neutral signer models and stores for the `radroots` core libraries. workflows; * manager and evaluation helpers for request review and signer policy decisions; + * shared NIP-46 codec, response, and request-session handler helpers for + reusable signer services; * file, memory, and native SQLite stores for persisted signer state; - * optional shared-model export through `serde` and `ts-rs` feature gates. + * optional native SQLite support for persistent signer services. ## Copyright diff --git a/crates/protected_store/Cargo.toml b/crates/protected_store/Cargo.toml @@ -6,7 +6,7 @@ edition.workspace = true authors = ["Tyson Lupul <tyson@radroots.org>"] rust-version.workspace = true license.workspace = true -description = "Authenticated store envelopes for protected local records" +description = "Protected local-record envelopes and file-backed key sources" repository.workspace = true homepage.workspace = true documentation = "https://docs.rs/radroots_protected_store" diff --git a/crates/protected_store/README b/crates/protected_store/README @@ -9,7 +9,9 @@ local store envelopes for the `radroots` core libraries. * seal and open helpers built around XChaCha20Poly1305 and wrapped data keys; * JSON encode and decode helpers for serialized protected payloads; * portable core logic with optional `std` support through - `radroots_secret_vault`. + `radroots_secret_vault`; + * file-backed wrapped-key helpers for protected local identity and account + storage flows. ## Copyright diff --git a/crates/replica_db/Cargo.toml b/crates/replica_db/Cargo.toml @@ -6,7 +6,7 @@ edition.workspace = true authors = ["Tyson Lupul <tyson@radroots.org>"] rust-version.workspace = true license.workspace = true -description = "Replica SQL runtime interfaces and typed database helpers" +description = "Replica SQL facades, typed models, and shaped query helpers" repository.workspace = true homepage.workspace = true documentation = "https://docs.rs/radroots_replica_db" diff --git a/crates/replica_db/README b/crates/replica_db/README @@ -1,13 +1,14 @@ # radroots_replica_db This is the README for `radroots_replica_db`, which provides replica SQL -runtime interfaces for the `radroots` core libraries. +facades and shaped query helpers for the `radroots` core libraries. ## Overview * a generic `ReplicaSql<E>` facade over any `SqlExecutor` implementation; * migration, backup, restore, and export helpers for replica database state; - * typed CRUD and query helpers over the shared replica schema models; + * typed CRUD helpers over the shared replica schema models; + * shaped query helpers for common trade, farm, and event freshness lookups; * feature-gated web, native, and embedded backend support through `radroots_sql_core`. diff --git a/crates/runtime_manager/Cargo.toml b/crates/runtime_manager/Cargo.toml @@ -6,7 +6,7 @@ edition.workspace = true authors = ["Tyson Lupul <tyson@radroots.org>"] rust-version.workspace = true license.workspace = true -description = "Managed runtime registry and path helpers" +description = "Managed runtime lifecycle, registry, and inspection helpers" repository.workspace = true homepage.workspace = true documentation = "https://docs.rs/radroots_runtime_manager" diff --git a/crates/runtime_manager/README b/crates/runtime_manager/README @@ -1,7 +1,7 @@ # radroots_runtime_manager This is the README for `radroots_runtime_manager`, which provides managed -runtime registry helpers for the `radroots` core libraries. +runtime lifecycle and inspection helpers for the `radroots` core libraries. ## Overview @@ -9,8 +9,10 @@ runtime registry helpers for the `radroots` core libraries. * shared and per-instance path resolution layered on `radroots_runtime_paths`; * registry load, save, lookup, and upsert helpers for managed runtime instances; - * model types for lifecycle, install state, health state, defaults, and - runtime grouping. + * lifecycle helpers for archive install, process start and stop, managed-file + writes, and secret-file handling; + * managed runtime inspection and target-resolution helpers for status, logs, + config, and action availability. ## Copyright diff --git a/crates/runtime_paths/Cargo.toml b/crates/runtime_paths/Cargo.toml @@ -6,7 +6,7 @@ edition.workspace = true authors = ["Tyson Lupul <tyson@radroots.org>"] rust-version.workspace = true license.workspace = true -description = "Canonical local path resolution for runtime layouts" +description = "Canonical runtime path selection and contract helpers" repository.workspace = true homepage.workspace = true documentation = "https://docs.rs/radroots_runtime_paths" diff --git a/crates/runtime_paths/README b/crates/runtime_paths/README @@ -1,15 +1,18 @@ # radroots_runtime_paths -This is the README for `radroots_runtime_paths`, which provides canonical local -path resolution for the `radroots` core libraries. +This is the README for `radroots_runtime_paths`, which provides canonical +runtime path selection and contract helpers for the `radroots` core libraries. ## Overview * default file-name and bootstrap-path helpers for local runtime layouts; * platform, host-environment, namespace, and path-profile types for path decisions; - * resolver and override types that produce structured `RadrootsPaths` outputs; - * legacy-path inspection and migration constants for compatibility handling. + * resolver, override, and runtime-selection helpers that produce structured + `RadrootsPaths` outputs; + * service and app contract helpers for active profile, override, and root + selection reporting; + * migration and legacy-path inspection helpers for runtime relocation audits. ## Copyright diff --git a/crates/trade/Cargo.toml b/crates/trade/Cargo.toml @@ -6,7 +6,7 @@ edition.workspace = true authors = ["Tyson Lupul <tyson@radroots.org>"] rust-version.workspace = true license.workspace = true -description = "Trade listing projections and validation models" +description = "Trade listing, order, and public-trade workflow helpers" repository.workspace = true homepage.workspace = true documentation = "https://docs.rs/radroots_trade" diff --git a/crates/trade/README b/crates/trade/README @@ -1,14 +1,15 @@ # radroots_trade -This is the README for `radroots_trade`, which provides trade listing -projections and validation models for the `radroots` core libraries. +This is the README for `radroots_trade`, which provides shared trade workflow +helpers for the `radroots` core libraries. ## Overview * listing model types such as subtotals and totals built on `radroots_core` money, quantity, currency, and unit values; - * listing overlay, projection, and validation modules for trade-facing - workflows; + * listing publish helpers for canonical address normalization, author checks, + and event-shaping workflows; + * order and public-trade helpers for shared request validation and projection; * optional `serde`, `serde_json`, and `ts-rs` support for shared model serialization and export; * portable shared-model support for both `std` and `no_std` builds.