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.