radrootsd

JSON-RPC bridge for Radroots event publishing
git clone https://radroots.dev/git/radrootsd.git
Log | Files | Refs | README | LICENSE

README (2722B)


      1 # radrootsd
      2 
      3 This is the README for `radrootsd` which is a long-running daemon for
      4 authenticated publishing and optional NIP-46 control on Rad Roots networks.
      5 
      6 NIP-46 kind-24133 request and response events are locally completed through a
      7 dedicated protocol helper and then relayed as already-signed transport
      8 messages. Remote `sign_event` results are accepted only when the author and
      9 canonical event ID match the exact unsigned request and the complete NIP-01
     10 event verifies.
     11 
     12 ## Verification
     13 
     14 `radrootsd --help`, `--version` and subcommand help exit successfully before
     15 loading configuration or creating logging, identity, database or network state.
     16 Malformed arguments retain the redacted nonzero failure boundary.
     17 
     18 Run the native standalone checks with the declared Rust toolchain and committed
     19 lockfile. In an extbuild-enabled checkout, first run `cargo extbuild doctor`
     20 and route each command through `cargo extbuild run --`:
     21 
     22 ```text
     23 cargo fmt --all --check
     24 cargo check --workspace --all-targets --locked
     25 cargo test --workspace --all-targets --locked
     26 cargo clippy --workspace --all-targets --locked -- -D warnings
     27 RUSTDOCFLAGS="-D warnings" cargo doc --workspace --no-deps --locked
     28 scripts/verify-boundaries.sh
     29 scripts/verify-supply-chain.sh
     30 ```
     31 
     32 The boundary command verifies the source-lock digest against the actual
     33 Cargo.lock and the exact public foundation dependencies resolved offline. It
     34 also byte-compares the root-only public API against its reviewed baseline and
     35 rejects forbidden repository roots or credential material. The supply-chain
     36 command checks the locked dependency, license,
     37 advisory, and immutable public-source policy.
     38 
     39 After an intentional dependency-lock update, refresh its digest through the
     40 private owning tool, then check freshness (route these commands through
     41 extbuild in an enabled checkout):
     42 
     43 ```text
     44 cargo run --locked --offline -p radrootsd_xtask -- source-lock refresh
     45 cargo run --locked --offline -p radrootsd_xtask -- source-lock check
     46 ```
     47 
     48 The producer verifies the existing typed source-lock schema and actual offline
     49 public dependency graph before atomically replacing only the lockfile digest.
     50 It preserves the selected Lib revision, archive, catalog and version identity;
     51 it does not qualify a new Lib source archive or a release artifact.
     52 
     53 The standalone flake exposes exactly one real `radrootsd` package, check, and
     54 application for `aarch64-darwin` and `x86_64-linux`. It exposes no checkout
     55 wrapper, development shell, NixOS module, OCI artifact, or other system.
     56 
     57 ## Copyright
     58 
     59 Except as otherwise noted, all files in the `radrootsd` distribution are
     60 
     61     Copyright (c) 2025 Tyson Lupul
     62 
     63 ## License
     64 
     65 This repository is licensed under AGPL-3.0-or-later. See LICENSE.