https://njump.meNostr notes by https://njump.me/npub12347pztk7yvn0pflq2nl4vugs5ck3x24pgqnwmcg0sr4cz6zsk5shef0f2https://njump.me/nevent1qqsrlsfazqlpccd9qplp86sghavhya43uftt8p5yhnm2chv0x2d2htczyp2xhcyfwmc3jdu98up2074n3zznz6ye259qzdm0pp7qwhqtg2z6jq97gefBuild manifest for get_file_hash v0.5.3
In reply to <a href='/nevent1qqs2y3rewsme5s09gm85eshhg3zhu9kyzjxmmrq6jrw2ene0ce70qvqqxag0u'>nevent1q…ag0u</a><br/>_________________________<br/><br/>Build manifest for get_file_hash v0.5.3
2026-10-09T01:55:15Zhttps://njump.me/nevent1qqs2y3rewsme5s09gm85eshhg3zhu9kyzjxmmrq6jrw2ene0ce70qvqzyp2xhcyfwmc3jdu98up2074n3zznz6ye259qzdm0pp7qwhqtg2z6jdua4hn<?xml version='1.0' ...
<?xml version='1.0' encoding='windows-1252'?>
<br/><!--
<br/> Copyright (C) 2017 Christopher R. Field.
<br/>
<br/> Licensed under the Apache License, Version 2.0 (the "License");
<br/> you may not use this file except in compliance with the License.
<br/> You may obtain a copy of the License at
<br/>
<br/> <a href="http://www.apache.org/licenses/LICENSE-2.0">http://www.apache.org/licenses/LICENSE-2.0</a>
<br/>
<br/> Unless required by applicable law or agreed to in writing, software
<br/> distributed under the License is distributed on an "AS IS" BASIS,
<br/> WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
<br/> See the License for the specific language governing permissions and
<br/> limitations under the License.
<br/>-->
<br/>
<br/><!--
<br/> The "cargo wix" subcommand provides a variety of predefined variables available
<br/> for customization of this template. The values for each variable are set at
<br/> installer creation time. The following variables are available:
<br/>
<br/> TargetTriple = The rustc target triple name.
<br/> TargetEnv = The rustc target environment. This is typically either
<br/> "msvc" or "gnu" depending on the toolchain downloaded and
<br/> installed.
<br/> TargetVendor = The rustc target vendor. This is typically "pc", but Rust
<br/> does support other vendors, like "uwp".
<br/> CargoTargetBinDir = The complete path to the directory containing the
<br/> binaries (exes) to include. The default would be
<br/> "target\release\". If an explicit rustc target triple is
<br/> used, i.e. cross-compiling, then the default path would
<br/> be "target\<CARGO_TARGET>\<CARGO_PROFILE>",
<br/> where "<CARGO_TARGET>" is replaced with the "CargoTarget"
<br/> variable value and "<CARGO_PROFILE>" is replaced with the
<br/> value from the "CargoProfile" variable. This can also
<br/> be overridden manually with the "target-bin-dir" flag.
<br/> CargoTargetDir = The path to the directory for the build artifacts, i.e.
<br/> "target".
<br/> CargoProfile = The cargo profile used to build the binaries
<br/> (usually "debug" or "release").
<br/> Version = The version for the installer. The default is the
<br/> "Major.Minor.Fix" semantic versioning number of the Rust
<br/> package.
<br/>-->
<br/>
<br/><!--
<br/> Please do not remove these pre-processor If-Else blocks. These are used with
<br/> the `cargo wix` subcommand to automatically determine the installation
<br/> destination for 32-bit versus 64-bit installers. Removal of these lines will
<br/> cause installation errors.
<br/>-->
<br/><?if $(sys.BUILDARCH) = x64 or $(sys.BUILDARCH) = arm64 ?>
<br/> <?define PlatformProgramFilesFolder = "ProgramFiles64Folder" ?>
<br/><?else ?>
<br/> <?define PlatformProgramFilesFolder = "ProgramFilesFolder" ?>
<br/><?endif ?>
<br/>
<br/><Wix xmlns='<a href="http://schemas.microsoft.com/wix/2006/wi'>">http://schemas.microsoft.com/wix/2006/wi'></a>;
<br/>
<br/> <Product
<br/> Id='*'
<br/> Name='get_file_hash'
<br/> UpgradeCode='DED69220-26E3-4406-B564-7F2B58C56F57'
<br/> Manufacturer='gnostr admin@gnostr.org'
<br/> Language='1033'
<br/> Codepage='1252'
<br/> Version='$(var.Version)'>
<br/>
<br/> <Package Id='*'
<br/> Keywords='Installer'
<br/> Description='A utility crate providing a procedural macro to compute and embed file hashes at compile time.'
<br/> Manufacturer='gnostr admin@gnostr.org'
<br/> InstallerVersion='450'
<br/> Languages='1033'
<br/> Compressed='yes'
<br/> InstallScope='perMachine'
<br/> SummaryCodepage='1252'
<br/> />
<br/>
<br/> <MajorUpgrade
<br/> Schedule='afterInstallInitialize'
<br/> DowngradeErrorMessage='A newer version of [ProductName] is already installed. Setup will now exit.'/>
<br/>
<br/> <Media Id='1' Cabinet='media1.cab' EmbedCab='yes' DiskPrompt='CD-ROM #1'/>
<br/> <Property Id='DiskPrompt' Value='get_file_hash Installation'/>
<br/>
<br/> <Directory Id='TARGETDIR' Name='SourceDir'>
<br/> <Directory Id='$(var.PlatformProgramFilesFolder)' Name='PFiles'>
<br/> <Directory Id='APPLICATIONFOLDER' Name='get_file_hash'>
<br/>
<br/> <!--
<br/> Enabling the license sidecar file in the installer is a four step process:
<br/>
<br/> 1. Uncomment the `Component` tag and its contents.
<br/> 2. Change the value for the `Source` attribute in the `File` tag to a path
<br/> to the file that should be included as the license sidecar file. The path
<br/> can, and probably should be, relative to this file.
<br/> 3. Change the value for the `Name` attribute in the `File` tag to the
<br/> desired name for the file when it is installed alongside the `bin` folder
<br/> in the installation directory. This can be omitted if the desired name is
<br/> the same as the file name.
<br/> 4. Uncomment the `ComponentRef` tag with the Id attribute value of "License"
<br/> further down in this file.
<br/> -->
<br/> <!--
<br/> <Component Id='License' Guid='*'>
<br/> <File Id='LicenseFile' Name='ChangeMe' DiskId='1' Source='C:\Path\To\File' KeyPath='yes'/>
<br/> </Component>
<br/> -->
<br/>
<br/> <Directory Id='Bin' Name='bin'>
<br/> <Component Id='Path' Guid='8DB39A25-8B99-4C25-8CF5-4704353C7C6E' KeyPath='yes'>
<br/> <Environment
<br/> Id='PATH'
<br/> Name='PATH'
<br/> Value='[Bin]'
<br/> Permanent='no'
<br/> Part='last'
<br/> Action='set'
<br/> System='yes'/>
<br/> </Component>
<br/> <Component Id='binary0' Guid='*'>
<br/> <File
<br/> Id='exe0'
<br/> Name='get_file_hash.exe'
<br/> DiskId='1'
<br/> Source='$(var.CargoTargetBinDir)\get_file_hash.exe'
<br/> KeyPath='yes'/>
<br/> </Component>
<br/> <Component Id='binary1' Guid='*'>
<br/> <File
<br/> Id='exe1'
<br/> Name='n34.exe'
<br/> DiskId='1'
<br/> Source='$(var.CargoTargetBinDir)\n34.exe'
<br/> KeyPath='yes'/>
<br/> </Component>
<br/> <Component Id='binary2' Guid='*'>
<br/> <File
<br/> Id='exe2'
<br/> Name='n34-relay.exe'
<br/> DiskId='1'
<br/> Source='$(var.CargoTargetBinDir)\n34-relay.exe'
<br/> KeyPath='yes'/>
<br/> </Component>
<br/> <Component Id='binary3' Guid='*'>
<br/> <File
<br/> Id='exe3'
<br/> Name='readme.exe'
<br/> DiskId='1'
<br/> Source='$(var.CargoTargetBinDir)\readme.exe'
<br/> KeyPath='yes'/>
<br/> </Component>
<br/> </Directory>
<br/> </Directory>
<br/> </Directory>
<br/> </Directory>
<br/>
<br/> <Feature
<br/> Id='Binaries'
<br/> Title='Application'
<br/> Description='Installs all binaries and the license.'
<br/> Level='1'
<br/> ConfigurableDirectory='APPLICATIONFOLDER'
<br/> AllowAdvertise='no'
<br/> Display='expand'
<br/> Absent='disallow'>
<br/>
<br/> <!--
<br/> Uncomment the following `ComponentRef` tag to add the license
<br/> sidecar file to the installer.
<br/> -->
<br/> <!--<ComponentRef Id='License'/>-->
<br/>
<br/> <ComponentRef Id='binary0'/>
<br/> <ComponentRef Id='binary1'/>
<br/> <ComponentRef Id='binary2'/>
<br/> <ComponentRef Id='binary3'/>
<br/>
<br/> <Feature
<br/> Id='Environment'
<br/> Title='PATH Environment Variable'
<br/> Description='Add the install location of the [ProductName] executable to the PATH system environment variable. This allows the [ProductName] executable to be called from any location.'
<br/> Level='1'
<br/> Absent='allow'>
<br/> <ComponentRef Id='Path'/>
<br/> </Feature>
<br/> </Feature>
<br/>
<br/> <SetProperty Id='ARPINSTALLLOCATION' Value='[APPLICATIONFOLDER]' After='CostFinalize'/>
<br/>
<br/>
<br/> <!--
<br/> Uncomment the following `Icon` and `Property` tags to change the product icon.
<br/>
<br/> The product icon is the graphic that appears in the Add/Remove
<br/> Programs control panel for the application.
<br/> -->
<br/> <!--<Icon Id='ProductICO' SourceFile='wix\Product.ico'/>-->
<br/> <!--<Property Id='ARPPRODUCTICON' Value='ProductICO' />-->
<br/>
<br/> <Property Id='ARPHELPLINK' Value='<a href="https://github.com/gnostr-org/get_file_hash'/>">https://github.com/gnostr-org/get_file_hash'/></a>;
<br/>
<br/> <UI>
<br/> <UIRef Id='WixUI_FeatureTree'/>
<br/>
<br/> <!--
<br/> Enabling the EULA dialog in the installer is a three step process:
<br/>
<br/> 1. Comment out or remove the two `Publish` tags that follow the
<br/> `WixVariable` tag.
<br/> 2. Uncomment the `<WixVariable Id='WixUILicenseRtf' Value='Path\to\Eula.rft'>` tag further down
<br/> 3. Replace the `Value` attribute of the `WixVariable` tag with
<br/> the path to a RTF file that will be used as the EULA and
<br/> displayed in the license agreement dialog.
<br/> -->
<br/> <Publish Dialog='WelcomeDlg' Control='Next' Event='NewDialog' Value='CustomizeDlg' Order='99'>1</Publish>
<br/> <Publish Dialog='CustomizeDlg' Control='Back' Event='NewDialog' Value='WelcomeDlg' Order='99'>1</Publish>
<br/>
<br/> </UI>
<br/>
<br/>
<br/> <!--
<br/> Enabling the EULA dialog in the installer requires uncommenting
<br/> the following `WixUILicenseRTF` tag and changing the `Value`
<br/> attribute.
<br/> -->
<br/> <!-- <WixVariable Id='WixUILicenseRtf' Value='Relative\Path\to\Eula.rtf'/> -->
<br/>
<br/>
<br/> <!--
<br/> Uncomment the next `WixVariable` tag to customize the installer's
<br/> Graphical User Interface (GUI) and add a custom banner image across
<br/> the top of each screen. See the WiX Toolset documentation for details
<br/> about customization.
<br/>
<br/> The banner BMP dimensions are 493 x 58 pixels.
<br/> -->
<br/> <!--<WixVariable Id='WixUIBannerBmp' Value='wix\Banner.bmp'/>-->
<br/>
<br/>
<br/> <!--
<br/> Uncomment the next `WixVariable` tag to customize the installer's
<br/> Graphical User Interface (GUI) and add a custom image to the first
<br/> dialog, or screen. See the WiX Toolset documentation for details about
<br/> customization.
<br/>
<br/> The dialog BMP dimensions are 493 x 312 pixels.
<br/> -->
<br/> <!--<WixVariable Id='WixUIDialogBmp' Value='wix\Dialog.bmp'/>-->
<br/>
<br/> </Product>
<br/>
<br/></Wix>
<br/>
2026-10-09T01:55:01Zhttps://njump.me/nevent1qqsyymtd2s7x4xl8f5l7ty7y3xvm3f0pzx2zy9d5v67zwg9zly8crpszyp2xhcyfwmc3jdu98up2074n3zznz6ye259qzdm0pp7qwhqtg2z6ju3r6fguse std::process::Command; use std::fs; use sha2::{Digest, ...
use std::process::Command;<br/>use std::fs;<br/>use sha2::{Digest, Sha256};<br/><br/>fn calculate_sha256(file_path: &str) -> String {<br/> let content = fs::read(file_path).expect("Unable to read file");<br/> let mut hasher = Sha256::new();<br/> hasher.update(&content);<br/> hasher.finalize()<br/> .iter()<br/> .map(|b| format!("{:02x}", b))<br/> .collect()<br/>}<br/><br/>#[test]<br/>fn test_get_file_hash_binary_no_features() {<br/> let output = Command::new("cargo")<br/> .arg("run")<br/> .arg("--bin")<br/> .arg("get_file_hash")<br/> .output()<br/> .expect("Failed to execute command");<br/><br/> let stdout = String::from_utf8_lossy(&output.stdout);<br/> let stderr = String::from_utf8_lossy(&output.stderr);<br/><br/> // Assert that the command ran successfully<br/> assert!(output.status.success(), "Command failed with stderr: {}", stderr);<br/><br/> // Manually calculate the hash of the binary's source file<br/> let expected_hash = calculate_sha256("src/bin/get_file_hash.rs");<br/><br/> // Assert that the output contains the correct hash<br/> // Check for the raw hash first<br/> assert!(stdout.contains(&expected_hash), "Output did not contain raw expected hash. Expected: {}, Actual: {}", expected_hash, stdout);<br/><br/> // Then check for the formatted string, including backticks<br/> // Use a regex-like check for more flexibility with newlines if needed, or refine to exact match<br/> let expected_hash_line = format!("* **SHA-256 Hash:** `{}`", expected_hash);<br/> assert!(stdout.contains(&expected_hash_line), "Output did not contain expected hash line. Expected line: {}, Actual: {}", expected_hash_line, stdout);<br/><br/> // Assert that the output contains "Integrity Verified."<br/> assert!(stdout.contains("Integrity Verified."), "Output did not contain 'Integrity Verified.'. stdout: {}", stdout);<br/><br/> println!("Output from get_file_hash binary (no features):<br/>{}", stdout);<br/>}<br/><br/>#[test]<br/>fn test_get_file_hash_binary_with_nostr_feature() {<br/> let output = Command::new("cargo")<br/> .arg("run")<br/> .arg("--bin")<br/> .arg("get_file_hash")<br/> .arg("--features")<br/> .arg("nostr")<br/> .output()<br/> .expect("Failed to execute command");<br/><br/> let stdout = String::from_utf8_lossy(&output.stdout);<br/> let stderr = String::from_utf8_lossy(&output.stderr);<br/><br/> // Assert that the command ran successfully<br/> assert!(output.status.success(), "Command failed with stderr: {}", stderr);<br/><br/> // Manually calculate the hash of the binary's source file<br/> let expected_hash = calculate_sha256("src/bin/get_file_hash.rs");<br/><br/> // Assert that the output contains the correct hash<br/> assert!(stdout.contains(&expected_hash), "Output did not contain raw expected hash. Expected: {}, Actual: {}", expected_hash, stdout);<br/><br/> // Then check for the formatted string, including backticks<br/> let expected_hash_line = format!("* **SHA-256 Hash:** `{}`", expected_hash);<br/> assert!(stdout.contains(&expected_hash_line), "Output did not contain expected hash line. Expected line: {}, Actual: {}", expected_hash_line, stdout);<br/><br/> // Assert that the output contains "Integrity Verified."<br/> assert!(stdout.contains("Integrity Verified."), "Output did not contain 'Integrity Verified.'. stdout: {}", stdout);<br/><br/> println!("Output from get_file_hash binary (with nostr feature):<br/>{}", stdout);<br/>}<br/>
2026-10-09T01:54:55Zhttps://njump.me/nevent1qqstc7f4sxcnz9t4t2ctu4gnzvney6jprafp03qv6p75gpa9vx3vxmszyp2xhcyfwmc3jdu98up2074n3zznz6ye259qzdm0pp7qwhqtg2z6jx8rmlp//! Recursive packet framing and parity helpers for the ...
//! Recursive packet framing and parity helpers for the `perfect_ip` protocol.<br/>//!<br/>//! `perfect_ip` is a repair-oriented tree protocol. It does not try to be a<br/>//! general transport; instead it turns a byte buffer into a deterministic tree<br/>//! of MTU-safe data slices and parity slices that can be reconstructed when a<br/>//! sibling packet is missing.<br/>//!<br/>//! ## Packet model<br/>//!<br/>//! - [`process_slice`] recursively splits payloads until each emitted leaf fits<br/>//! within the packet budget.<br/>//! - Internal nodes emit a left child, right child, and parity frame.<br/>//! - Packet ids form a stable recursive path such as `ROOT.1.0.P`.<br/>//! - [`packetize`] finalizes the batch by filling `total_packets` into every<br/>//! packet header.<br/>//!<br/>//! ## Wire model<br/>//!<br/>//! On the wire, packet slices are exchanged as Nostr events. Each slice is<br/>//! encoded as JSON content under a dedicated custom event kind, which keeps the<br/>//! protocol relay-native and removes the old transport dependency.<br/>//!<br/>//! ## Repair model<br/>//!<br/>//! The parity scheme is XOR-based. Given one sibling payload and the matching<br/>//! parity frame, [`recover_missing_data`] and [`recover_missing_slice`] can<br/>//! rebuild the missing sibling payload. [`IntegrityManager`] tracks the<br/>//! manifest, records received slices, persists the partial state to disk, and<br/>//! verifies that parity frames still match their children.<br/>//!<br/>//! The layout intentionally mirrors the packet-tree sketch in the<br/>//! `perfect_ip.rs` gist.<br/>extern crate alloc;<br/>use alloc::collections::{BTreeMap, BTreeSet};<br/>use alloc::string::{String, ToString};<br/>use alloc::vec::Vec;<br/>use std::io;<br/>use std::path::Path;<br/><br/>use serde::{Deserialize, Serialize};<br/>use nostr_sdk::prelude::*;<br/><br/>/// Packet header metadata shared by all packet types in the tree.<br/>///<br/>/// `seq_num` is assigned in the order packets are emitted by the recursive<br/>/// packetizer. `total_packets` is populated only after packetization has<br/>/// finished, so callers can treat the batch as self-describing once finalized.<br/>#[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize)]<br/>pub struct Header {<br/> /// Monotonic sequence number assigned during packetization.<br/> pub seq_num: u32,<br/> /// Total number of packets in the finalized batch.<br/> pub total_packets: u32,<br/>}<br/><br/>/// A single packet produced by the recursive packetizer.<br/>///<br/>/// `id` carries the recursive path for the packet, such as `ROOT.0.1.P`.<br/>/// `is_parity` marks frames that store XOR parity rather than original user<br/>/// data. `data` always contains the raw bytes that would be transmitted on the<br/>/// wire inside the JSON-encoded repair message.<br/>#[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize)]<br/>pub struct ProtocolSlice {<br/> /// Stable recursive packet identifier.<br/> pub id: String,<br/> /// Packet sequencing metadata.<br/> pub header: Header,<br/> /// Raw payload bytes for the packet or parity frame.<br/> pub data: Vec<u8>,<br/> /// `true` when this slice is a parity frame.<br/> pub is_parity: bool,<br/>}<br/><br/>/// Finalized packet tree output.<br/>///<br/>/// `total_packets` is duplicated here so callers can inspect batch metadata<br/>/// without walking the packet list. The packet list is stable and already has<br/>/// each packet header patched to reflect the finalized count.<br/>#[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize)]<br/>pub struct PacketBatch {<br/> /// Number of packets in the batch.<br/> pub total_packets: u32,<br/> /// Finalized packets with matching `total_packets` headers.<br/> pub packets: Vec<ProtocolSlice>,<br/>}<br/><br/>/// Tracks the expected manifest and the packets that have arrived so far.<br/>///<br/>/// The manager is deliberately simple: it stores the expected ids, the received<br/>/// slices, and exposes helpers for missing-node inspection, parity validation,<br/>/// and persistence.<br/>#[derive(Debug, Clone, Default)]<br/>pub struct IntegrityManager {<br/> manifest: BTreeSet<String>,<br/> /// Received packet slices keyed by packet id.<br/> pub received_slices: BTreeMap<String, ProtocolSlice>,<br/>}<br/><br/>impl IntegrityManager {<br/> /// Create a manager from the set of expected packet ids.<br/> ///<br/> /// The manifest is stored as a set so lookups stay cheap even for larger<br/> /// packet trees.<br/> pub fn new(expected_ids: Vec<String>) -> Self {<br/> Self {<br/> manifest: expected_ids.into_iter().collect(),<br/> received_slices: BTreeMap::new(),<br/> }<br/> }<br/><br/> /// Record a received packet by id, replacing any prior packet with the same id.<br/> ///<br/> /// Re-recording a slice is allowed and simply overwrites the previous<br/> /// entry. That makes repair retries and late arrivals idempotent.<br/> pub fn record_slice(&mut self, slice: ProtocolSlice) {<br/> self.received_slices.insert(slice.id.clone(), slice);<br/> }<br/><br/> /// Persist the received packet map to disk using JSON.<br/> ///<br/> /// This writes only the received slice map. The caller supplies the<br/> /// manifest again on load so persisted state stays lightweight and portable.<br/> pub fn persist(&self, path: impl AsRef<Path>) -> io::Result<()> {<br/> let encoded = serde_json::to_vec(&self.received_slices).map_err(io::Error::other)?;<br/> std::fs::write(path, encoded)<br/> }<br/><br/> /// Load a persisted packet map from disk and attach it to the given manifest.<br/> ///<br/> /// The manifest is not persisted with the slice data; callers are expected<br/> /// to regenerate or reload it independently.<br/> pub fn load_from_disk(path: impl AsRef<Path>, manifest: BTreeSet<String>) -> io::Result<Self> {<br/> let bytes = std::fs::read(path)?;<br/> let received_slices: BTreeMap<String, ProtocolSlice> =<br/> serde_json::from_slice(&bytes).map_err(io::Error::other)?;<br/> Ok(Self {<br/> manifest,<br/> received_slices,<br/> })<br/> }<br/><br/> /// Return the packet ids from the manifest that are still missing.<br/> ///<br/> /// The returned ids preserve the manifest set's iteration order only in the<br/> /// sense that they are collected into a vector; callers should sort if they<br/> /// need deterministic display order.<br/> pub fn get_missing_nodes(&self) -> Vec<String> {<br/> self.manifest<br/> .iter()<br/> .filter(|id| !self.received_slices.contains_key(*id))<br/> .cloned()<br/> .collect()<br/> }<br/><br/> /// Verify that every parity slice matches the XOR of its sibling data slices.<br/> ///<br/> /// If a parity node's siblings are both present, the check recomputes the<br/> /// XOR and compares it with the stored parity bytes. Missing siblings are<br/> /// ignored so partial downloads can still pass for the fragments they have.<br/> pub fn verify_integrity(&self) -> bool {<br/> for (id, slice) in &self.received_slices {<br/> if !slice.is_parity {<br/> continue;<br/> }<br/><br/> let Some(base_id) = id.strip_suffix(".P") else {<br/> return false;<br/> };<br/> let left = self.received_slices.get(&format!("{}.0", base_id));<br/> let right = self.received_slices.get(&format!("{}.1", base_id));<br/><br/> if let (Some(left), Some(right)) = (left, right) {<br/> if calculate_parity(&left.data, &right.data) != slice.data {<br/> return false;<br/> }<br/> }<br/> }<br/><br/> true<br/> }<br/>}<br/><br/>/// Nostr event kind used for packet slices.<br/>pub const PERFECT_IP_KIND: Kind = Kind::Custom(31_337);<br/><br/>/// Hashtag used to query perfect_ip events on relays.<br/>pub const PERFECT_IP_HASHTAG: &str = "perfect_ip";<br/><br/>/// PIP manifest event kind.<br/>pub const PIP_MANIFEST_KIND: Kind = Kind::Custom(39_078);<br/><br/>/// PIP slice event kind.<br/>pub const PIP_SLICE_KIND: Kind = Kind::Custom(39_079);<br/><br/>/// PIP repair request event kind.<br/>pub const PIP_REPAIR_REQUEST_KIND: Kind = Kind::Custom(39_080);<br/><br/>/// Hashtag used to query PIP events on relays.<br/>pub const PIP_HASHTAG: &str = "pip";<br/><br/>/// Packet manifest describing one tree upload.<br/>#[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize)]<br/>pub struct PacketManifest {<br/> /// Stable root id for the packet tree.<br/> pub root: String,<br/> /// Hex-encoded SHA-256 of the original payload.<br/> pub sha256: String,<br/> /// Original payload size in bytes.<br/> pub size: u64,<br/> /// Total packet count for the tree.<br/> pub packets: u64,<br/> /// Maximum packet tree depth.<br/> pub depth: u32,<br/> /// Target MTU used by the packetizer.<br/> pub mtu: u64,<br/> /// Encoding name used on the wire.<br/> pub encoding: String,<br/> /// Relative path for directory uploads.<br/> pub path: String,<br/>}<br/><br/>/// Repair request for missing packet ids.<br/>#[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize)]<br/>pub struct RepairRequest {<br/> /// Stable root id for the packet tree.<br/> pub root: String,<br/> /// Packet ids still needed for reconstruction.<br/> pub want: Vec<String>,<br/> /// Encoding name used on the wire.<br/> pub encoding: String,<br/>}<br/><br/>/// Build a filter for PIP events.<br/>pub fn pip_filter(kind: Kind, id: Option<&str>, hashtag: &str) -> Filter {<br/> let filter = Filter::new().kind(kind).hashtag(hashtag);<br/><br/> match id {<br/> Some(id) => filter.identifier(id),<br/> None => filter,<br/> }<br/>}<br/><br/>/// Build a filter for PIP manifest events.<br/>pub fn pip_manifest_filter(id: Option<&str>) -> Filter {<br/> pip_filter(PIP_MANIFEST_KIND, id, PIP_HASHTAG)<br/>}<br/><br/>/// Build a filter for PIP slice events.<br/>pub fn pip_slice_filter(id: Option<&str>) -> Filter {<br/> pip_filter(PIP_SLICE_KIND, id, PIP_HASHTAG)<br/>}<br/><br/>/// Build a filter for PIP repair requests.<br/>pub fn pip_repair_request_filter(id: Option<&str>) -> Filter {<br/> pip_filter(PIP_REPAIR_REQUEST_KIND, id, PIP_HASHTAG)<br/>}<br/><br/>/// Convert a manifest into a Nostr event builder.<br/>pub fn packet_manifest_to_event(<br/> manifest: &PacketManifest,<br/> packet_event_ids: &[EventId],<br/>) -> Result<EventBuilder, serde_json::Error> {<br/> Ok(<br/> EventBuilder::new(PIP_MANIFEST_KIND, serde_json::to_string(manifest)?)<br/> .tag(Tag::identifier(manifest.root.clone()))<br/> .tag(Tag::custom("sha256".into(), [manifest.sha256.clone()]))<br/> .tag(Tag::custom("size".into(), [manifest.size.to_string()]))<br/> .tag(Tag::custom("packets".into(), [manifest.packets.to_string()]))<br/> .tag(Tag::custom("depth".into(), [manifest.depth.to_string()]))<br/> .tag(Tag::custom("mtu".into(), [manifest.mtu.to_string()]))<br/> .tag(Tag::custom("encoding".into(), [manifest.encoding.clone()]))<br/> .tag(Tag::custom("path".into(), [manifest.path.clone()]))<br/> .tag(Tag::hashtag(PIP_HASHTAG))<br/> .tag(Tag::hashtag("manifest"))<br/> .tags(packet_event_ids.iter().map(|event_id| {<br/> Tag::custom(<br/> "e".into(),<br/> [event_id.to_string(), String::new(), "slice".to_string()],<br/> )<br/> })),<br/> )<br/>}<br/><br/>/// Extract packet event ids referenced by a PIP manifest event.<br/>pub fn manifest_packet_event_ids(event: &Event) -> Vec<EventId> {<br/> event<br/> .tags<br/> .iter()<br/> .filter(|tag| tag.kind().as_str() == "e" && tag.len() >= 4 && tag.as_slice()[3].as_str() == "slice")<br/> .filter_map(|tag| tag.content().and_then(|value| EventId::parse(value).ok()))<br/> .collect()<br/>}<br/><br/>/// Convert a repair request into a Nostr event builder.<br/>pub fn repair_request_to_event(<br/> request: &RepairRequest,<br/> manifest_event_id: EventId,<br/>) -> Result<EventBuilder, serde_json::Error> {<br/> let builder = request.want.iter().fold(<br/> EventBuilder::new(PIP_REPAIR_REQUEST_KIND, serde_json::to_string(request)?)<br/> .tag(Tag::identifier(request.root.clone()))<br/> .tag(Tag::custom(<br/> "e".into(),<br/> [<br/> manifest_event_id.to_string(),<br/> String::new(),<br/> "request".to_string(),<br/> ],<br/> ))<br/> .tag(Tag::custom("encoding".into(), [request.encoding.clone()]))<br/> .tag(Tag::hashtag(PIP_HASHTAG))<br/> .tag(Tag::hashtag("repair")),<br/> |builder, want| builder.tag(Tag::custom("want".into(), [want.clone()])),<br/> );<br/><br/> Ok(builder)<br/>}<br/><br/>/// Convert a packet slice into a PIP slice event builder.<br/>pub fn packet_slice_to_event(slice: &ProtocolSlice) -> Result<EventBuilder, serde_json::Error> {<br/> let type_tag = if slice.is_parity { "parity" } else { "data" };<br/><br/> Ok(<br/> EventBuilder::new(PIP_SLICE_KIND, serde_json::to_string(slice)?)<br/> .tag(Tag::identifier(slice.id.clone()))<br/> .tag(Tag::custom("seq".into(), [slice.header.seq_num.to_string()]))<br/> .tag(Tag::custom("path".into(), [slice.id.clone()]))<br/> .tag(Tag::custom("type".into(), [type_tag.to_string()]))<br/> .tag(Tag::custom("encoding".into(), ["json"]))<br/> .tag(Tag::hashtag(PIP_HASHTAG))<br/> .tag(Tag::hashtag("slice")),<br/> )<br/>}<br/><br/>fn proposal_record_to_slice(<br/> kind: Kind,<br/> tags: &Tags,<br/> content: &str,<br/>) -> Result<Option<ProtocolSlice>, serde_json::Error> {<br/> if kind != PIP_SLICE_KIND {<br/> return Ok(None);<br/> }<br/><br/> let Some(root_id) = tags<br/> .iter()<br/> .find(|tag| tag.kind().as_str() == "d")<br/> .and_then(|tag| tag.content())<br/> else {<br/> return Ok(None);<br/> };<br/><br/> if !tags<br/> .iter()<br/> .any(|tag| tag.kind().as_str() == "t" && tag.content() == Some(PIP_HASHTAG))<br/> {<br/> return Ok(None);<br/> }<br/><br/> if !tags<br/> .iter()<br/> .any(|tag| tag.kind().as_str() == "t" && tag.content() == Some("slice"))<br/> {<br/> return Ok(None);<br/> }<br/><br/> let Some(path) = tags<br/> .iter()<br/> .find(|tag| tag.kind().as_str() == "path")<br/> .and_then(|tag| tag.content())<br/> else {<br/> return Ok(None);<br/> };<br/><br/> if !path.starts_with(root_id) {<br/> return Ok(None);<br/> }<br/><br/> let slice: ProtocolSlice = serde_json::from_str(content)?;<br/> if slice.id != path {<br/> return Ok(None);<br/> }<br/><br/> Ok(Some(slice))<br/>}<br/><br/>/// Try to decode a PIP event back into a packet slice.<br/>pub fn packet_slice_from_event(event: &Event) -> Result<Option<ProtocolSlice>, serde_json::Error> {<br/> proposal_record_to_slice(event.kind, &event.tags, &event.content)<br/>}<br/><br/>/// Try to decode an unsigned PIP event back into a packet slice.<br/>pub fn packet_slice_from_unsigned_event(<br/> event: &UnsignedEvent,<br/>) -> Result<Option<ProtocolSlice>, serde_json::Error> {<br/> proposal_record_to_slice(event.kind, &event.tags, &event.content)<br/>}<br/><br/>/// Build a Nostr filter that matches perfect_ip packet events.<br/>pub fn perfect_ip_filter(id: Option<&str>) -> Filter {<br/> let filter = Filter::new()<br/> .kind(PERFECT_IP_KIND)<br/> .hashtag(PERFECT_IP_HASHTAG);<br/><br/> match id {<br/> Some(id) => filter.identifier(id),<br/> None => filter,<br/> }<br/>}<br/><br/>/// Convert a packet slice into a Nostr event builder.<br/>///<br/>/// The slice is serialized into JSON content so relays can store and replay the<br/>/// event without any custom transport logic.<br/>pub fn slice_to_event(slice: &ProtocolSlice) -> Result<EventBuilder, serde_json::Error> {<br/> Ok(<br/> EventBuilder::new(PERFECT_IP_KIND, serde_json::to_string(slice)?)<br/> .tag(Tag::identifier(slice.id.clone()))<br/> .tag(Tag::hashtag(PERFECT_IP_HASHTAG)),<br/> )<br/>}<br/><br/>/// Convert a packet batch into Nostr event builders.<br/>pub fn batch_to_events(batch: &PacketBatch) -> Result<Vec<EventBuilder>, serde_json::Error> {<br/> batch.packets.iter().map(slice_to_event).collect()<br/>}<br/><br/>fn record_to_slice(<br/> kind: Kind,<br/> tags: &Tags,<br/> content: &str,<br/>) -> Result<Option<ProtocolSlice>, serde_json::Error> {<br/> if kind != PERFECT_IP_KIND {<br/> return Ok(None);<br/> }<br/><br/> let Some(identifier) = tags<br/> .iter()<br/> .find(|tag| tag.kind().as_str() == "d")<br/> .and_then(|tag| tag.content())<br/> else {<br/> return Ok(None);<br/> };<br/><br/> if !tags<br/> .iter()<br/> .any(|tag| tag.kind().as_str() == "t" && tag.content() == Some(PERFECT_IP_HASHTAG))<br/> {<br/> return Ok(None);<br/> }<br/><br/> let slice: ProtocolSlice = serde_json::from_str(content)?;<br/> if slice.id != identifier {<br/> return Ok(None);<br/> }<br/><br/> Ok(Some(slice))<br/>}<br/><br/>/// Try to decode a Nostr event back into a packet slice.<br/>pub fn event_to_slice(event: &Event) -> Result<Option<ProtocolSlice>, serde_json::Error> {<br/> record_to_slice(event.kind, &event.tags, &event.content)<br/>}<br/><br/>/// Try to decode an unsigned Nostr event back into a packet slice.<br/>pub fn unsigned_event_to_slice(<br/> event: &UnsignedEvent,<br/>) -> Result<Option<ProtocolSlice>, serde_json::Error> {<br/> record_to_slice(event.kind, &event.tags, &event.content)<br/>}<br/><br/>/// Maximum payload size this packet protocol is allowed to emit.<br/>///<br/>/// The tree uses half-sized leaves so that parity slices for sibling pairs stay<br/>/// under the same transport ceiling as the data leaves.<br/>pub const MTU_PAYLOAD: usize = 1460;<br/>const MAX_LEAF_PAYLOAD: usize = MTU_PAYLOAD / 2;<br/><br/>/// XOR two payloads into a parity buffer.<br/>///<br/>/// Missing bytes are treated as zero so the returned buffer is as long as the<br/>/// larger input. This is the core repair primitive used at every branch in the<br/>/// recursive packet tree.<br/>pub fn calculate_parity(left: &[u8], right: &[u8]) -> Vec<u8> {<br/> let max_len = left.len().max(right.len());<br/> let mut parity = vec![0; max_len];<br/> for i in 0..max_len {<br/> let l = if i < left.len() { left[i] } else { 0 };<br/> let r = if i < right.len() { right[i] } else { 0 };<br/> parity[i] = l ^ r;<br/> }<br/> parity<br/>}<br/><br/>/// Generate the expected packet ids for a recursive packet tree.<br/>///<br/>/// The returned manifest mirrors [`process_slice`] exactly: leaf nodes are<br/>/// emitted when the payload fits within the leaf payload limit, and internal<br/>/// nodes append `.0`, `.1`, and `.P` entries in tree order. This is what lets<br/>/// [`IntegrityManager`] tell which packets are still missing.<br/>pub fn generate_manifest(id: String, len: usize) -> Vec<String> {<br/> if len <= MAX_LEAF_PAYLOAD {<br/> return vec![id];<br/> }<br/><br/> let half = len / 2;<br/> let mut ids = generate_manifest(format!("{}.0", id), half);<br/> ids.append(&mut generate_manifest(format!("{}.1", id), len - half));<br/> ids.push(format!("{}.P", id));<br/> ids<br/>}<br/><br/>/// Recover the missing payload by XORing the sibling payload and parity frame.<br/>///<br/>/// `expected_len` trims the recovered buffer back to the original payload<br/>/// length. If the sibling and parity bytes are from the same branch, the XOR<br/>/// yields the missing sibling exactly.<br/>pub fn recover_missing_data(expected_len: usize, sibling: &[u8], parity: &[u8]) -> Vec<u8> {<br/> let recovered = calculate_parity(sibling, parity);<br/> recovered.into_iter().take(expected_len).collect()<br/>}<br/><br/>/// Rebuild a missing packet using a sibling packet and parity packet.<br/>///<br/>/// The returned slice is marked as data and receives the next sequence number.<br/>/// This is a convenience wrapper for repair handlers that need to synthesize a<br/>/// complete [`ProtocolSlice`] from branch-local evidence.<br/>pub fn recover_missing_slice(<br/> id: String,<br/> expected_len: usize,<br/> sibling: &ProtocolSlice,<br/> parity: &ProtocolSlice,<br/> seq: &mut u32,<br/>) -> ProtocolSlice {<br/> let header = Header {<br/> seq_num: *seq,<br/> total_packets: sibling<br/> .header<br/> .total_packets<br/> .max(parity.header.total_packets),<br/> };<br/> *seq += 1;<br/><br/> ProtocolSlice {<br/> id,<br/> header,<br/> data: recover_missing_data(expected_len, &sibling.data, &parity.data),<br/> is_parity: false,<br/> }<br/>}<br/><br/>/// Recursively split a payload into MTU-safe slices and parity frames.<br/>///<br/>/// Leaf packets are emitted when the payload is at or below the leaf payload<br/>/// limit. Internal nodes emit left, right, and parity frames in<br/>/// a deterministic order so the manifest and sequence numbers line up exactly.<br/>pub fn process_slice(id: String, data: Vec<u8>, seq: &mut u32) -> Vec<ProtocolSlice> {<br/> if data.len() <= MAX_LEAF_PAYLOAD {<br/> let slice = ProtocolSlice {<br/> id,<br/> header: Header {<br/> seq_num: *seq,<br/> total_packets: 0,<br/> },<br/> data,<br/> is_parity: false,<br/> };<br/> *seq += 1;<br/> return vec![slice];<br/> }<br/><br/> let half = data.len() / 2;<br/> let left_data = data[..half].to_vec();<br/> let right_data = data[half..].to_vec();<br/><br/> let parity = calculate_parity(&left_data, &right_data);<br/> let mut slices = process_slice(format!("{}.0", id), left_data, seq);<br/> slices.append(&mut process_slice(format!("{}.1", id), right_data, seq));<br/><br/> slices.push(ProtocolSlice {<br/> id: format!("{}.P", id),<br/> header: Header {<br/> seq_num: *seq,<br/> total_packets: 0,<br/> },<br/> data: parity,<br/> is_parity: true,<br/> });<br/> *seq += 1;<br/><br/> slices<br/>}<br/><br/>/// Packetize a payload and finalize the batch metadata.<br/>///<br/>/// This is the preferred entrypoint for callers that want a ready-to-send<br/>/// packet tree with `total_packets` filled in. The returned batch is ready for<br/>/// logging, persistence, or network repair.<br/>pub fn packetize(id: String, data: Vec<u8>) -> PacketBatch {<br/> let mut seq = 0;<br/> let mut packets = process_slice(id, data, &mut seq);<br/> let total_packets = packets.len() as u32;<br/> for packet in &mut packets {<br/> packet.header.total_packets = total_packets;<br/> }<br/> PacketBatch {<br/> total_packets,<br/> packets,<br/> }<br/>}<br/><br/>/// Render packet summaries for logs or diagnostics.<br/>///<br/>/// This is intentionally human-facing output for terminal demos and debugging.<br/>/// It keeps the packet ids, sequence numbers, types, and sizes aligned in a<br/>/// single line per packet.<br/>pub fn summarize_packets(packets: &[ProtocolSlice]) -> Vec<String> {<br/> packets<br/> .iter()<br/> .map(|packet| {<br/> format!(<br/> "ID: {:<8} | Seq: {:>2}/{} | Type: {:<6} | Size: {}B",<br/> packet.id,<br/> packet.header.seq_num,<br/> packet.header.total_packets,<br/> if packet.is_parity { "PARITY" } else { "DATA" },<br/> packet.data.len()<br/> )<br/> })<br/> .collect()<br/>}<br/><br/>#[cfg(test)]<br/>mod tests {<br/> use std::time::{Duration, SystemTime, UNIX_EPOCH};<br/><br/> use hashes::Hash;<br/> use nostr_sdk::prelude::{<br/> Client, Event as SdkEvent, Filter as SdkFilter, RelayUrl as SdkRelayUrl,<br/> };<br/><br/> use super::*;<br/><br/> #[test]<br/> fn process_slice_emits_parity_and_data() {<br/> let raw_data = vec![0xAB; 2000];<br/> let batch = packetize("ROOT".to_string(), raw_data);<br/> let packets = batch.packets;<br/><br/> assert!(!packets.is_empty());<br/> assert!(packets.iter().any(|packet| packet.is_parity));<br/> assert!(packets.iter().any(|packet| packet.id == "ROOT.P"));<br/> assert!(<br/> packets<br/> .iter()<br/> .any(|packet| packet.id.starts_with("ROOT.0."))<br/> );<br/> assert!(<br/> packets<br/> .iter()<br/> .any(|packet| packet.id.starts_with("ROOT.1."))<br/> );<br/> assert!(<br/> packets<br/> .iter()<br/> .all(|packet| packet.data.len() <= MTU_PAYLOAD)<br/> );<br/> assert!(<br/> packets<br/> .iter()<br/> .all(|packet| packet.header.total_packets == batch.total_packets)<br/> );<br/> }<br/><br/> #[test]<br/> fn calculate_parity_xors_equal_length_blocks() {<br/> let left = [0xDE, 0xAD, 0xBE];<br/> let right = [0x01, 0x02, 0x03];<br/> assert_eq!(calculate_parity(&left, &right), vec![0xDF, 0xAF, 0xBD]);<br/> }<br/><br/> #[test]<br/> fn generate_manifest_matches_recursive_packet_tree() {<br/> let manifest = generate_manifest("ROOT".to_string(), 2000);<br/><br/> assert!(manifest.contains(&"ROOT.P".to_string()));<br/> assert!(manifest.iter().any(|id| id.starts_with("ROOT.0.")));<br/> assert!(manifest.iter().any(|id| id.starts_with("ROOT.1.")));<br/> assert_eq!(<br/> manifest.len(),<br/> packetize("ROOT".to_string(), vec![0xAB; 2000]).total_packets as usize<br/> );<br/> }<br/><br/> #[test]<br/> fn recover_missing_data_restores_xor_partner() {<br/> let left = vec![0xDE, 0xAD, 0xBE];<br/> let right = vec![0x01, 0x02, 0x03];<br/> let parity = calculate_parity(&left, &right);<br/><br/> assert_eq!(recover_missing_data(left.len(), &right, &parity), left);<br/> assert_eq!(recover_missing_data(right.len(), &left, &parity), right);<br/> }<br/><br/> #[test]<br/> fn recover_missing_slice_rebuilds_header_and_payload() {<br/> let sibling = ProtocolSlice {<br/> id: "ROOT.1".to_string(),<br/> header: Header {<br/> seq_num: 1,<br/> total_packets: 3,<br/> },<br/> data: vec![0x01, 0x02, 0x03],<br/> is_parity: false,<br/> };<br/> let parity = ProtocolSlice {<br/> id: "ROOT.P".to_string(),<br/> header: Header {<br/> seq_num: 2,<br/> total_packets: 3,<br/> },<br/> data: vec![0xDF, 0xAF, 0xBD],<br/> is_parity: true,<br/> };<br/> let mut seq = 3;<br/><br/> let recovered = recover_missing_slice("ROOT.0".to_string(), 3, &sibling, &parity, &mut seq);<br/><br/> assert_eq!(recovered.id, "ROOT.0");<br/> assert_eq!(recovered.data, vec![0xDE, 0xAD, 0xBE]);<br/> assert_eq!(recovered.header.seq_num, 3);<br/> assert_eq!(recovered.header.total_packets, 3);<br/> assert!(!recovered.is_parity);<br/> }<br/><br/> #[test]<br/> fn get_missing_nodes_returns_unseen_manifest_entries() {<br/> let mut manager = IntegrityManager::new(vec![<br/> "ROOT.0".to_string(),<br/> "ROOT.1".to_string(),<br/> "ROOT.P".to_string(),<br/> ]);<br/> manager.record_slice(ProtocolSlice {<br/> id: "ROOT.0".to_string(),<br/> header: Header {<br/> seq_num: 0,<br/> total_packets: 3,<br/> },<br/> data: vec![0xDE],<br/> is_parity: false,<br/> });<br/><br/> let missing = manager.get_missing_nodes();<br/> assert_eq!(missing.len(), 2);<br/> assert!(missing.contains(&"ROOT.1".to_string()));<br/> assert!(missing.contains(&"ROOT.P".to_string()));<br/> }<br/><br/> #[test]<br/> fn verify_integrity_checks_parity_frames() {<br/> let mut manager = IntegrityManager::new(vec![<br/> "ROOT.0".to_string(),<br/> "ROOT.1".to_string(),<br/> "ROOT.P".to_string(),<br/> ]);<br/> let left = ProtocolSlice {<br/> id: "ROOT.0".to_string(),<br/> header: Header {<br/> seq_num: 0,<br/> total_packets: 3,<br/> },<br/> data: vec![0xDE, 0xAD, 0xBE],<br/> is_parity: false,<br/> };<br/> let right = ProtocolSlice {<br/> id: "ROOT.1".to_string(),<br/> header: Header {<br/> seq_num: 1,<br/> total_packets: 3,<br/> },<br/> data: vec![0x01, 0x02, 0x03],<br/> is_parity: false,<br/> };<br/> let parity = ProtocolSlice {<br/> id: "ROOT.P".to_string(),<br/> header: Header {<br/> seq_num: 2,<br/> total_packets: 3,<br/> },<br/> data: calculate_parity(&left.data, &right.data),<br/> is_parity: true,<br/> };<br/><br/> manager.record_slice(left);<br/> manager.record_slice(right);<br/> manager.record_slice(parity);<br/> assert!(manager.verify_integrity());<br/><br/> let mut corrupted = manager.clone();<br/> corrupted<br/> .received_slices<br/> .get_mut("ROOT.P")<br/> .expect("parity slice")<br/> .data[0] ^= 0xFF;<br/> assert!(!corrupted.verify_integrity());<br/> }<br/><br/> #[test]<br/> fn persist_and_load_from_disk_round_trips_received_slices() {<br/> let temp_path = std::env::temp_dir().join(format!(<br/> "nostr-pip-{}-{}.json",<br/> std::process::id(),<br/> Timestamp::now().as_secs()<br/> ));<br/> let mut manager = IntegrityManager::new(vec![<br/> "ROOT.0".to_string(),<br/> "ROOT.1".to_string(),<br/> "ROOT.P".to_string(),<br/> ]);<br/> manager.record_slice(ProtocolSlice {<br/> id: "ROOT.0".to_string(),<br/> header: Header {<br/> seq_num: 0,<br/> total_packets: 3,<br/> },<br/> data: vec![0xDE, 0xAD, 0xBE],<br/> is_parity: false,<br/> });<br/> manager.record_slice(ProtocolSlice {<br/> id: "ROOT.P".to_string(),<br/> header: Header {<br/> seq_num: 1,<br/> total_packets: 3,<br/> },<br/> data: vec![0xAA],<br/> is_parity: true,<br/> });<br/><br/> manager.persist(&temp_path).expect("persist");<br/> let loaded = IntegrityManager::load_from_disk(<br/> &temp_path,<br/> vec![<br/> "ROOT.0".to_string(),<br/> "ROOT.1".to_string(),<br/> "ROOT.P".to_string(),<br/> ]<br/> .into_iter()<br/> .collect(),<br/> )<br/> .expect("load");<br/><br/> assert_eq!(loaded.received_slices.len(), 2);<br/> assert!(loaded.received_slices.contains_key("ROOT.0"));<br/> assert!(loaded.received_slices.contains_key("ROOT.P"));<br/> assert!(loaded.get_missing_nodes().contains(&"ROOT.1".to_string()));<br/> let _ = std::fs::remove_file(temp_path);<br/> }<br/><br/> #[test]<br/> fn protocol_slice_json_round_trips_bytes_and_flags() {<br/> let slice = ProtocolSlice {<br/> id: "ROOT.0.P".to_string(),<br/> header: Header {<br/> seq_num: 7,<br/> total_packets: 63,<br/> },<br/> data: vec![0x00, 0xFF, 0x10, 0x20],<br/> is_parity: true,<br/> };<br/><br/> let encoded = serde_json::to_string(&slice).expect("encode slice");<br/> assert!(encoded.contains("\"id\":\"ROOT.0.P\""));<br/> assert!(encoded.contains("\"is_parity\":true"));<br/> assert!(encoded.contains("\"data\":[0,255,16,32]"));<br/><br/> let decoded: ProtocolSlice = serde_json::from_str(&encoded).expect("decode slice");<br/> assert_eq!(decoded, slice);<br/> }<br/><br/> #[test]<br/> fn summarize_packets_shows_packet_inventory_details() {<br/> let batch = packetize("ROOT".to_string(), vec![0xAB; 2000]);<br/> let lines = summarize_packets(&batch.packets);<br/><br/> assert_eq!(lines.len(), batch.total_packets as usize);<br/> assert!(lines.iter().any(|line| line.contains("ID: ROOT.P")));<br/> assert!(<br/> lines<br/> .iter()<br/> .any(|line| line.contains(&format!("Seq: {:>2}/{}", 0, batch.total_packets)))<br/> );<br/> assert!(lines.iter().any(|line| line.contains("Type: DATA")));<br/> assert!(lines.iter().any(|line| line.contains("Type: PARITY")));<br/> }<br/><br/> #[test]<br/> fn manifest_packet_ids_point_to_slice_events_only() {<br/> let payload = vec![0xAB; 64];<br/> let batch = packetize("ROOT".to_string(), payload.clone());<br/> let keys = Keys::new(<br/> SecretKey::from_hex("0000000000000000000000000000000000000000000000000000000000000001")<br/> .expect("secret key"),<br/> );<br/> let packet_event_ids: Vec<EventId> = batch<br/> .packets<br/> .iter()<br/> .map(|slice| {<br/> let event = packet_slice_to_event(slice)<br/> .expect("build packet slice event")<br/> .finalize(&keys)<br/> .expect("finalize slice event");<br/> event.id<br/> })<br/> .collect();<br/> let manifest = PacketManifest {<br/> root: "ROOT".to_string(),<br/> sha256: "deadbeef".to_string(),<br/> size: payload.len() as u64,<br/> packets: batch.total_packets as u64,<br/> depth: 0,<br/> mtu: MTU_PAYLOAD as u64,<br/> encoding: "json".to_string(),<br/> path: "pip.rs".to_string(),<br/> };<br/> let manifest_event = packet_manifest_to_event(&manifest, &packet_event_ids)<br/> .expect("build manifest event")<br/> .finalize(&keys)<br/> .expect("finalize manifest event");<br/><br/> let refs = manifest_packet_event_ids(&manifest_event);<br/> assert_eq!(refs.len(), batch.total_packets as usize);<br/> assert_eq!(refs, packet_event_ids);<br/> assert!(<br/> packet_slice_from_event(&manifest_event)<br/> .expect("decode manifest")<br/> .is_none()<br/> );<br/> }<br/><br/> #[tokio::test]<br/> #[ignore = "live relay test"]<br/> async fn live_nos_lol_round_trip_reconstructs_and_writes_file() {<br/> fn reconstruct_payload_from_events(events: &[Event]) -> Vec<u8> {<br/> let mut slices: Vec<_> = events<br/> .iter()<br/> .filter_map(|event| packet_slice_from_event(event).expect("decode packet event"))<br/> .collect();<br/> slices.sort_by_key(|slice| slice.header.seq_num);<br/> slices<br/> .into_iter()<br/> .filter(|slice| !slice.is_parity)<br/> .flat_map(|slice| slice.data)<br/> .collect()<br/> }<br/><br/> let relay_urls = [<br/> SdkRelayUrl::parse("wss://nos.lol").expect("nos.lol relay url"),<br/> SdkRelayUrl::parse("wss://relay.damus.io").expect("damus relay url"),<br/> ];<br/> let relay = relay_urls[SystemTime::now()<br/> .duration_since(UNIX_EPOCH)<br/> .expect("clock")<br/> .subsec_nanos() as usize<br/> % relay_urls.len()]<br/> .clone();<br/> let client = Client::default();<br/> client<br/> .add_relay(&relay)<br/> .and_connect()<br/> .await<br/> .expect("add relay");<br/> eprintln!("perfect_ip live relay test connected: {}", relay);<br/><br/> let keys = Keys::new(<br/> SecretKey::from_hex("0000000000000000000000000000000000000000000000000000000000000001")<br/> .expect("secret key"),<br/> );<br/> let payload = vec![0xAB; 3000];<br/> let batch = packetize("ROOT.live".to_string(), payload.clone());<br/> let manifest = PacketManifest {<br/> root: "ROOT.live".to_string(),<br/> sha256: hashes::sha256::Hash::hash(&payload).to_string(),<br/> size: payload.len() as u64,<br/> packets: batch.total_packets as u64,<br/> depth: 0,<br/> mtu: MTU_PAYLOAD as u64,<br/> encoding: "json".to_string(),<br/> path: "pip.rs".to_string(),<br/> };<br/> eprintln!(<br/> "perfect_ip live relay test prepared payload: bytes={}, packets={}",<br/> payload.len(),<br/> batch.total_packets<br/> );<br/><br/> let mut packet_event_ids = Vec::with_capacity(batch.total_packets as usize);<br/> let mut sdk_packet_event_ids = Vec::with_capacity(batch.total_packets as usize);<br/> let mut packet_events = Vec::with_capacity(batch.total_packets as usize);<br/> for slice in &batch.packets {<br/> let event = packet_slice_to_event(slice)<br/> .expect("build slice event")<br/> .finalize(&keys)<br/> .expect("finalize slice event");<br/> packet_event_ids.push(event.id);<br/> let sdk_event: SdkEvent =<br/> serde_json::from_str(&event.as_json()).expect("sdk slice event");<br/> sdk_packet_event_ids.push(sdk_event.id);<br/> eprintln!("perfect_ip live relay test publishing slice: {}", event.id);<br/> let send_result = client<br/> .send_event(&sdk_event)<br/> .to([&relay])<br/> .await<br/> .expect("send slice event");<br/> eprintln!(<br/> "perfect_ip live relay test slice send result: id={}, success={}, failed={}",<br/> send_result.id(),<br/> send_result.success.len(),<br/> send_result.failed.len()<br/> );<br/> if !send_result.failed.is_empty() {<br/> eprintln!(<br/> "perfect_ip live relay test slice send failures: {:?}",<br/> send_result.failed<br/> );<br/> }<br/> packet_events.push(event);<br/> }<br/><br/> let manifest_event = packet_manifest_to_event(&manifest, &packet_event_ids)<br/> .expect("build manifest event")<br/> .finalize(&keys)<br/> .expect("finalize manifest event");<br/> let sdk_manifest_event: SdkEvent =<br/> serde_json::from_str(&manifest_event.as_json()).expect("sdk manifest event");<br/> eprintln!(<br/> "perfect_ip live relay test publishing manifest: {}",<br/> manifest_event.id<br/> );<br/> let manifest_send_result = client<br/> .send_event(&sdk_manifest_event)<br/> .to([&relay])<br/> .await<br/> .expect("send manifest event");<br/> eprintln!(<br/> "perfect_ip live relay test manifest send result: id={}, success={}, failed={}",<br/> manifest_send_result.id(),<br/> manifest_send_result.success.len(),<br/> manifest_send_result.failed.len()<br/> );<br/> if !manifest_send_result.failed.is_empty() {<br/> eprintln!(<br/> "perfect_ip live relay test manifest send failures: {:?}",<br/> manifest_send_result.failed<br/> );<br/> }<br/><br/> tokio::time::sleep(Duration::from_secs(2)).await;<br/><br/> let fetched_manifest = tokio::time::timeout(Duration::from_secs(20), async {<br/> let mut attempts = 0usize;<br/> loop {<br/> attempts += 1;<br/> eprintln!(<br/> "perfect_ip live relay test fetching manifest attempt {}",<br/> attempts<br/> );<br/> let fetched = client<br/> .fetch_events(SdkFilter::new().ids([sdk_manifest_event.id]))<br/> .await<br/> .expect("fetch manifest");<br/> if let Some(event) = fetched.first().cloned() {<br/> eprintln!(<br/> "perfect_ip live relay test fetched manifest after {} attempts",<br/> attempts<br/> );<br/> break event;<br/> }<br/> tokio::time::sleep(Duration::from_secs(1)).await;<br/> }<br/> })<br/> .await<br/> .expect("manifest fetch timeout");<br/> let fetched_manifest: Event =<br/> serde_json::from_str(&fetched_manifest.as_json()).expect("nostr manifest event");<br/> let packet_ids = manifest_packet_event_ids(&fetched_manifest);<br/> assert_eq!(packet_ids, packet_event_ids);<br/><br/> let relay_handle = client.relays().await.remove(&relay).expect("relay handle");<br/> let fetched_packets = tokio::time::timeout(Duration::from_secs(20), async {<br/> let mut attempts = 0usize;<br/> loop {<br/> attempts += 1;<br/> eprintln!(<br/> "perfect_ip live relay test fetching packets attempt {}",<br/> attempts<br/> );<br/> let fetched = relay_handle<br/> .fetch_events(SdkFilter::new().ids(sdk_packet_event_ids.clone()))<br/> .await<br/> .expect("fetch packets");<br/> if fetched.len() >= packet_event_ids.len() {<br/> eprintln!(<br/> "perfect_ip live relay test fetched packets after {} attempts: {} / {}",<br/> attempts,<br/> fetched.len(),<br/> packet_event_ids.len()<br/> );<br/> break fetched;<br/> }<br/> tokio::time::sleep(Duration::from_secs(1)).await;<br/> }<br/> })<br/> .await<br/> .expect("packet fetch timeout");<br/> let fetched_packets: Vec<Event> = fetched_packets<br/> .into_iter()<br/> .map(|event| serde_json::from_str(&event.as_json()).expect("nostr packet event"))<br/> .collect();<br/> let reconstructed = reconstruct_payload_from_events(&fetched_packets);<br/> assert_eq!(reconstructed, payload);<br/><br/> let out_dir = std::env::temp_dir().join("nostr-pip-live-out");<br/> let output_path = out_dir.join(<br/> Path::new(&manifest.path)<br/> .file_name()<br/> .expect("manifest file"),<br/> );<br/> if let Some(parent) = output_path.parent() {<br/> std::fs::create_dir_all(parent).expect("create output dir");<br/> }<br/> std::fs::write(&output_path, &reconstructed).expect("write output");<br/> let written = std::fs::read(&output_path).expect("read output");<br/> assert_eq!(written, payload);<br/><br/> eprintln!(<br/> "{}",<br/> serde_json::json!({<br/> "event": "perfect_ip live relay round trip",<br/> "relay": relay.as_str(),<br/> "manifest_event": manifest_event.id.to_string(),<br/> "packets": packet_ids.len(),<br/> "bytes": written.len(),<br/> "out": output_path.display().to_string(),<br/> "matches": written == payload,<br/> })<br/> );<br/><br/> client.shutdown().await;<br/> }<br/><br/> #[test]<br/> fn dump_full_protocol_for_nocapture() {<br/> use hashes::Hash;<br/> use hashes::sha1::Hash as Sha1Hash;<br/><br/> fn reconstruct_payload_for_test(packets: &[ProtocolSlice]) -> Vec<u8> {<br/> let mut leaves: Vec<_> = packets.iter().filter(|packet| !packet.is_parity).collect();<br/> leaves.sort_by_key(|packet| packet.header.seq_num);<br/> leaves<br/> .into_iter()<br/> .flat_map(|packet| packet.data.clone())<br/> .collect()<br/> }<br/><br/> #[derive(Default)]<br/> struct MockRelay {<br/> online: bool,<br/> dropped: usize,<br/> events: Vec<UnsignedEvent>,<br/> }<br/><br/> impl MockRelay {<br/> fn set_online(&mut self, online: bool) {<br/> self.online = online;<br/> }<br/><br/> fn publish_if_online(&mut self, event: UnsignedEvent) -> bool {<br/> if self.online {<br/> self.events.push(event);<br/> true<br/> } else {<br/> self.dropped += 1;<br/> false<br/> }<br/> }<br/><br/> fn packet_slices(&self) -> Vec<ProtocolSlice> {<br/> self.events<br/> .iter()<br/> .filter(|event| event.kind == PERFECT_IP_KIND)<br/> .map(|event| {<br/> unsigned_event_to_slice(event)<br/> .expect("decode packet event")<br/> .expect("packet event")<br/> })<br/> .filter(|slice| !slice.is_parity)<br/> .collect()<br/> }<br/><br/> fn packet_records(&self) -> Vec<ProtocolSlice> {<br/> self.events<br/> .iter()<br/> .filter(|event| event.kind == PERFECT_IP_KIND)<br/> .map(|event| {<br/> unsigned_event_to_slice(event)<br/> .expect("decode packet event")<br/> .expect("packet event")<br/> })<br/> .collect()<br/> }<br/><br/> fn publish(&mut self, event: UnsignedEvent) {<br/> self.events.push(event);<br/> }<br/><br/> fn clone_snapshot(&self) -> Vec<ProtocolSlice> {<br/> let mut slices: Vec<ProtocolSlice> = self.packet_slices();<br/> slices.sort_by_key(|slice| slice.header.seq_num);<br/> slices<br/> }<br/><br/> fn clone_snapshot_from_template(<br/> &self,<br/> template: &[ProtocolSlice],<br/> ) -> Vec<ProtocolSlice> {<br/> let slices = self.packet_slices();<br/> let map: std::collections::HashMap<String, ProtocolSlice> = slices<br/> .into_iter()<br/> .map(|slice| (slice.id.clone(), slice))<br/> .collect();<br/><br/> template<br/> .iter()<br/> .filter(|packet| !packet.is_parity)<br/> .filter_map(|packet| map.get(&packet.id).cloned())<br/> .collect()<br/> }<br/> }<br/><br/> let payload = vec![0xAB; 3000];<br/> let batch = packetize("ROOT".to_string(), payload.clone());<br/> let manifest = generate_manifest("ROOT".to_string(), payload.len());<br/> let mut manager = IntegrityManager::new(manifest.clone());<br/> let demo_keys = Keys::new(<br/> SecretKey::from_hex("0000000000000000000000000000000000000000000000000000000000000001")<br/> .expect("secret key"),<br/> );<br/><br/> println!("perfect_ip manifest ({} ids):", manifest.len());<br/> for id in &manifest {<br/> println!(" {id}");<br/> }<br/><br/> println!(<br/> "perfect_ip packet inventory ({} packets):",<br/> batch.total_packets<br/> );<br/> for line in summarize_packets(&batch.packets) {<br/> println!("{line}");<br/> }<br/><br/> println!("perfect_ip packet batch json:");<br/> println!(<br/> "{}",<br/> serde_json::to_string(&batch).expect("serialize packet batch")<br/> );<br/><br/> let event_builders = batch_to_events(&batch).expect("build nostr events");<br/> println!("perfect_ip nostr event count: {}", event_builders.len());<br/> let preview_event = event_builders<br/> .first()<br/> .expect("first nostr event")<br/> .clone()<br/> .finalize_unsigned(demo_keys.public_key());<br/> println!("perfect_ip nostr preview kind: {:?}", preview_event.kind);<br/> println!(<br/> "perfect_ip nostr preview content: {}",<br/> preview_event.content<br/> );<br/> println!(<br/> "perfect_ip nostr preview tags: {:?}",<br/> preview_event<br/> .tags<br/> .iter()<br/> .map(|tag| tag.as_slice().to_vec())<br/> .collect::<Vec<_>>()<br/> );<br/> println!(<br/> "perfect_ip nostr preview decoded: {:?}",<br/> unsigned_event_to_slice(&preview_event).expect("decode preview event")<br/> );<br/><br/> println!("perfect_ip first packet json:");<br/> println!(<br/> "{}",<br/> serde_json::to_string(&batch.packets.first().expect("first packet"))<br/> .expect("serialize first packet")<br/> );<br/><br/> println!("perfect_ip last packet json:");<br/> println!(<br/> "{}",<br/> serde_json::to_string(&batch.packets.last().expect("last packet"))<br/> .expect("serialize last packet")<br/> );<br/><br/> for slice in batch.packets.clone() {<br/> manager.record_slice(slice);<br/> }<br/> println!(<br/> "perfect_ip missing nodes: {:?}",<br/> manager.get_missing_nodes()<br/> );<br/> println!(<br/> "perfect_ip integrity verified: {}",<br/> manager.verify_integrity()<br/> );<br/><br/> let reconstructed = reconstruct_payload_for_test(&batch.packets);<br/> println!("perfect_ip reconstructed bytes: {}", reconstructed.len());<br/> println!("perfect_ip payload matches: {}", reconstructed == payload);<br/> assert_eq!(reconstructed, payload);<br/><br/> let mut relay = MockRelay::default();<br/> let repo_id = "perfect-ip-demo";<br/> let owner_public_key = demo_keys.public_key();<br/> let repo_announcement = GitRepositoryAnnouncement {<br/> id: repo_id.to_string(),<br/> name: Some("perfect_ip demo repo".to_string()),<br/> description: Some("Mock NIP-34 repo push carried over perfect_ip".to_string()),<br/> web: vec![Url::parse("<a href="https://example.com/perfect-ip-demo"">https://example.com/perfect-ip-demo"</a>;).expect("demo web url")],<br/> clone: vec![<br/> Url::parse("<a href="https://example.com/perfect-ip-demo.git"">https://example.com/perfect-ip-demo.git"</a>;).expect("demo clone url"),<br/> ],<br/> relays: vec![RelayUrl::parse("wss://relay.damus.io").expect("demo relay url")],<br/> euc: Some(Sha1Hash::hash(payload.as_slice())),<br/> maintainers: vec![owner_public_key],<br/> };<br/><br/> let repo_event = EventBuilder::git_repository_announcement(repo_announcement.clone())<br/> .finalize_unsigned(owner_public_key);<br/> relay.publish(repo_event.clone());<br/> println!(<br/> "perfect_ip git repo announcement kind: {:?}",<br/> repo_event.kind<br/> );<br/> println!(<br/> "perfect_ip git repo announcement tags: {:?}",<br/> repo_event<br/> .tags<br/> .iter()<br/> .map(|tag| tag.as_slice().to_vec())<br/> .collect::<Vec<_>>()<br/> );<br/><br/> let repository =<br/> Coordinate::new(Kind::GitRepoAnnouncement, owner_public_key).identifier(repo_id);<br/> let snapshot_hash = Sha1Hash::hash(payload.as_slice());<br/> let patch = GitPatch {<br/> repository,<br/> content: GitPatchContent::CoverLetter {<br/> title: "perfect_ip repo snapshot".to_string(),<br/> description: format!(<br/> "Mock relay upload: {} bytes split into {} perfect_ip packets",<br/> payload.len(),<br/> batch.total_packets<br/> ),<br/> last_commit: snapshot_hash,<br/> commits_len: batch.total_packets as usize,<br/> },<br/> euc: snapshot_hash,<br/> labels: vec!["perfect_ip".to_string(), "mock-relay".to_string()],<br/> };<br/> let patch_event = EventBuilder::git_patch(patch)<br/> .expect("build git patch")<br/> .finalize_unsigned(owner_public_key);<br/> relay.publish(patch_event.clone());<br/> println!("perfect_ip git patch kind: {:?}", patch_event.kind);<br/> println!("perfect_ip git patch content: {}", patch_event.content);<br/> println!(<br/> "perfect_ip git patch tags: {:?}",<br/> patch_event<br/> .tags<br/> .iter()<br/> .map(|tag| tag.as_slice().to_vec())<br/> .collect::<Vec<_>>()<br/> );<br/> println!(<br/> "perfect_ip git clone source: {}",<br/> repo_announcement.clone.first().expect("clone url")<br/> );<br/><br/> let packet_events: Vec<UnsignedEvent> = batch_to_events(&batch)<br/> .expect("build packet events")<br/> .into_iter()<br/> .map(|builder| builder.finalize_unsigned(owner_public_key))<br/> .collect();<br/> relay.events.extend(packet_events.clone());<br/> println!("perfect_ip git relay event count: {}", relay.events.len());<br/><br/> let cloned_snapshot: Vec<u8> = relay<br/> .clone_snapshot()<br/> .into_iter()<br/> .flat_map(|slice| slice.data)<br/> .collect();<br/> println!("perfect_ip git clone bytes: {}", cloned_snapshot.len());<br/> println!(<br/> "perfect_ip git clone matches: {}",<br/> cloned_snapshot == payload<br/> );<br/> assert_eq!(cloned_snapshot, payload);<br/><br/> let mut repair_relay = MockRelay::default();<br/> repair_relay.set_online(true);<br/> let repair_target_id = "ROOT.0.1.1";<br/> let repair_target = batch<br/> .packets<br/> .iter()<br/> .find(|packet| packet.id == repair_target_id)<br/> .expect("repair target");<br/> let repair_sibling = batch<br/> .packets<br/> .iter()<br/> .find(|packet| packet.id == "ROOT.0.1.0")<br/> .expect("repair sibling");<br/> let repair_parity = batch<br/> .packets<br/> .iter()<br/> .find(|packet| packet.id == "ROOT.0.1.P")<br/> .expect("repair parity");<br/><br/> println!("perfect_ip repair target: {}", repair_target_id);<br/> println!(<br/> "{}",<br/> serde_json::json!({<br/> "event": "perfect_ip repair target",<br/> "target": repair_target_id,<br/> })<br/> );<br/> for (packet, builder) in batch<br/> .packets<br/> .iter()<br/> .zip(batch_to_events(&batch).expect("event builders"))<br/> {<br/> let event = builder.finalize_unsigned(owner_public_key);<br/> if packet.id == repair_target_id {<br/> repair_relay.set_online(false);<br/> let accepted = repair_relay.publish_if_online(event);<br/> println!(<br/> "perfect_ip relay outage dropped {}: {}",<br/> repair_target_id, !accepted<br/> );<br/> println!(<br/> "{}",<br/> serde_json::json!({<br/> "event": "perfect_ip relay outage dropped",<br/> "target": repair_target_id,<br/> "dropped": !accepted,<br/> })<br/> );<br/> repair_relay.set_online(true);<br/> continue;<br/> }<br/><br/> let _ = repair_relay.publish_if_online(event);<br/> }<br/><br/> let partial_manager = {<br/> let mut manager = IntegrityManager::new(manifest.clone());<br/> for slice in repair_relay.packet_records() {<br/> manager.record_slice(slice);<br/> }<br/> manager<br/> };<br/> println!(<br/> "perfect_ip partial missing nodes: {:?}",<br/> partial_manager.get_missing_nodes()<br/> );<br/> println!(<br/> "{}",<br/> serde_json::json!({<br/> "event": "perfect_ip partial missing nodes",<br/> "nodes": partial_manager.get_missing_nodes(),<br/> })<br/> );<br/><br/> let mut repair_seq = repair_target.header.seq_num;<br/> let repaired_slice = recover_missing_slice(<br/> repair_target.id.clone(),<br/> repair_target.data.len(),<br/> repair_sibling,<br/> repair_parity,<br/> &mut repair_seq,<br/> );<br/> let repair_event = slice_to_event(&repaired_slice)<br/> .expect("serialize repair slice")<br/> .finalize_unsigned(owner_public_key);<br/> repair_relay.publish(repair_event);<br/> println!("perfect_ip repair event published: {}", repaired_slice.id);<br/> println!(<br/> "{}",<br/> serde_json::json!({<br/> "event": "perfect_ip repair event published",<br/> "target": repaired_slice.id,<br/> "seq_num": repaired_slice.header.seq_num,<br/> "total_packets": repaired_slice.header.total_packets,<br/> "is_parity": repaired_slice.is_parity,<br/> "bytes": repaired_slice.data.len(),<br/> })<br/> );<br/><br/> let repaired_snapshot = repair_relay.clone_snapshot_from_template(&batch.packets);<br/> let repaired_payload: Vec<u8> = repaired_snapshot<br/> .iter()<br/> .flat_map(|slice| slice.data.clone())<br/> .collect();<br/> let repaired_matches = repaired_payload == payload;<br/> println!(<br/> "perfect_ip repaired relay dropped events: {}",<br/> repair_relay.dropped<br/> );<br/> println!(<br/> "{}",<br/> serde_json::json!({<br/> "event": "perfect_ip repaired relay dropped events",<br/> "dropped_events": repair_relay.dropped,<br/> })<br/> );<br/> println!(<br/> "perfect_ip repaired relay bytes: {}",<br/> repaired_payload.len()<br/> );<br/> println!(<br/> "{}",<br/> serde_json::json!({<br/> "event": "perfect_ip repaired relay bytes",<br/> "bytes": repaired_payload.len(),<br/> })<br/> );<br/> println!("perfect_ip repaired relay matches: {}", repaired_matches);<br/> println!(<br/> "{}",<br/> serde_json::json!({<br/> "event": "perfect_ip repaired relay matches",<br/> "matches": repaired_matches,<br/> })<br/> );<br/> println!(<br/> "{}",<br/> serde_json::json!({<br/> "event": "perfect_ip repaired relay summary",<br/> "dropped_events": repair_relay.dropped,<br/> "bytes": repaired_payload.len(),<br/> "matches": repaired_matches,<br/> })<br/> );<br/> assert_eq!(repaired_payload, payload);<br/> }<br/><br/> #[test]<br/> fn perfect_ip_event_round_trips_through_nostr_content() {<br/> let slice = ProtocolSlice {<br/> id: "ROOT.0".to_string(),<br/> header: Header {<br/> seq_num: 1,<br/> total_packets: 3,<br/> },<br/> data: vec![0xDE, 0xAD, 0xBE, 0xEF],<br/> is_parity: false,<br/> };<br/> let keys = Keys::new(<br/> SecretKey::from_hex("0000000000000000000000000000000000000000000000000000000000000001")<br/> .expect("secret key"),<br/> );<br/><br/> let event = slice_to_event(&slice)<br/> .expect("serialize slice")<br/> .finalize_unsigned(keys.public_key());<br/><br/> println!("perfect_ip nostr event kind: {:?}", event.kind);<br/> println!("perfect_ip nostr event content: {}", event.content);<br/> println!(<br/> "perfect_ip nostr event tags: {:?}",<br/> event<br/> .tags<br/> .iter()<br/> .map(|tag| tag.as_slice().to_vec())<br/> .collect::<Vec<_>>()<br/> );<br/><br/> let decoded = unsigned_event_to_slice(&event)<br/> .expect("decode event")<br/> .expect("perfect_ip event");<br/><br/> println!("perfect_ip decoded slice id: {}", decoded.id);<br/> println!(<br/> "perfect_ip decoded slice json: {}",<br/> serde_json::to_string(&decoded).expect("serialize decoded slice")<br/> );<br/> println!(<br/> "perfect_ip nostr filter: {}",<br/> serde_json::to_string(&perfect_ip_filter(Some("ROOT.0"))).expect("serialize filter")<br/> );<br/><br/> assert_eq!(decoded, slice);<br/> assert_eq!(event.kind, PERFECT_IP_KIND);<br/> assert!(<br/> event<br/> .tags<br/> .iter()<br/> .any(|tag| tag.kind().as_str() == "d" && tag.content() == Some("ROOT.0"))<br/> );<br/> assert!(<br/> event<br/> .tags<br/> .iter()<br/> .any(|tag| tag.kind().as_str() == "t" && tag.content() == Some(PERFECT_IP_HASHTAG))<br/> );<br/> assert!(<br/> perfect_ip_filter(Some("ROOT.0"))<br/> .kinds<br/> .unwrap()<br/> .contains(&PERFECT_IP_KIND)<br/> );<br/> }<br/>}<br/>
2026-10-09T01:54:52Zhttps://njump.me/nevent1qqs2qav0m0cr9jz6pp6yx8dksjy3fxxy5ryx3480jsaqcsenezxq7sqzyp2xhcyfwmc3jdu98up2074n3zznz6ye259qzdm0pp7qwhqtg2z6jfhcwjfRelay URL,Latitude,Longitude wot.nostr.party,36.1627,-86.7816 ...
Relay URL,Latitude,Longitude<br/>wot.nostr.party,36.1627,-86.7816<br/>nostr.simplex.icu,50.1109,8.68213<br/>relay.snort.social,53.3498,-6.26031<br/>nostr.stakey.net,52.3676,4.90414<br/>relay.mccormick.cx,52.3563,4.95714<br/>nostr.overmind.lol,43.6532,-79.3832<br/>nostriches.club,43.6532,-79.3832<br/>kanagrovv-pyramid.kozow.com,43.4305,-83.9638<br/>relay.toastr.net,40.8054,-74.0241<br/>relay.primal.net,43.6532,-79.3832<br/>r.bitcoinhold.net,43.6532,-79.3832<br/>wot.dtonon.com,43.6532,-79.3832<br/>santo.iguanatech.net,40.8302,-74.1299<br/>relay2.ngengine.org,43.6532,-79.3832<br/>nostr.oxtr.dev,50.4754,12.3683<br/>simplex.icu,50.1109,8.68213<br/>bitchat.nostr1.com,38.6327,-90.1961<br/>relay.nostu.be,40.4167,-3.70329<br/>nostr.mifen.me,43.6532,-79.3832<br/>relay.vantis.ninja,43.6532,-79.3832<br/>nostr-kyomu-haskell.onrender.com,37.7775,-122.397<br/>nostr-relay.amethyst.name,39.0067,-77.4291<br/>relay.bitcoindistrict.org,43.6532,-79.3832<br/>nos.xmark.cc,50.6924,3.20113<br/>relay01.lnfi.network,35.6764,139.65<br/>nostr-dev.wellorder.net,45.5201,-122.99<br/>nostr.rblb.it,43.7094,10.6582<br/>offchain.pub,39.1585,-94.5728<br/>wot.nostr.place,32.7767,-96.797<br/>fanfares.nostr1.com,38.6327,-90.1961<br/>ephemeral.snowflare.cc,43.6532,-79.3832<br/>relay.visionfusen.org,43.6532,-79.3832<br/>nostr.carroarmato0.be,51.0368,3.21186<br/>social.amanah.eblessing.co,48.1046,11.6002<br/>relay.cyphernomad.com,60.4032,25.0321<br/>nostr-rs-relay-qj1h.onrender.com,37.7775,-122.397<br/>relay.ngengine.org,43.6532,-79.3832<br/>relay.nosto.re,51.1792,5.89444<br/>rusty-uat.siberian-albacore.ts.net:8443,35.6764,139.65<br/>nostr.luisschwab.net,43.6532,-79.3832<br/>nostr.aruku.ovh,1.27994,103.849<br/>srtrelay.c-stellar.net,43.6532,-79.3832<br/>nostr.tagomago.me,3.139,101.687<br/>relay.threenine.services,51.5222,-0.62916<br/>nostr.robosats.org,64.1476,-21.9392<br/>nostr.2b9t.xyz,34.0549,-118.243<br/>strfry.apps3.slidestr.net,40.4167,-3.70329<br/>kitchen.zap.cooking,43.6532,-79.3832<br/>relay.homeinhk.xyz,45.5152,-122.678<br/>relay.seq1.net,43.6532,-79.3832<br/>relay.bornheimer.app,50.1109,8.68213<br/>relay.vrtmrz.net,43.6532,-79.3832<br/>nostr.red5d.dev,43.6532,-79.3832<br/>relay-freeharmonypeople.space,38.7223,-9.13934<br/>aaa-api.freefrom.space/v1/ws,43.6532,-79.3832<br/>dev.relay.edufeed.org,49.4521,11.0767<br/>nostr.myshosholoza.co.za,52.3913,4.66545<br/>nostr.plantroon.com,50.1013,8.62643<br/>wot.dergigi.com,64.1476,-21.9392<br/>npub1spxdug4m3y24hpx5crm0el4zhkk0wafs8kp6m0xu0wecygqej2xqq8gyhx.fips.network,43.6532,-79.3832<br/>nostrelay.circum.space,52.3676,4.90414<br/>relay.dreamith.to,43.6532,-79.3832<br/>relay.nostriches.club,43.6532,-79.3832<br/>nostr-relayrs.gateway.in.th,15.5163,103.194<br/>nostr.chrissexton.org,43.6532,-79.3832<br/>relay.flashapp.me,43.652,-79.3633<br/>nostr-relay-1.trustlessenterprise.com,43.6532,-79.3832<br/>strfry.shock.network,39.0438,-77.4874<br/>relay.snotr.nl:49999,52.0195,4.42946<br/>spatia-arcana.com,34.0362,-118.443<br/>nostr.computingcache.com,34.0356,-118.442<br/>nostr.self-determined.de,53.5,10.25<br/>relay.sharegap.net,43.6532,-79.3832<br/>spookstr2.nostr1.com,38.6327,-90.1961<br/>v-relay.d02.vrtmrz.net,34.6937,135.502<br/>bridge.tagomago.me,3.139,101.687<br/>antiprimal.net,43.6532,-79.3832<br/>relay.nostrdice.com,-33.8688,151.209<br/>purpura.cloud,43.6532,-79.3832<br/>espelho.girino.org,43.6532,-79.3832<br/>relay.mostro.network,40.8302,-74.1299<br/>temp.iris.to,43.6532,-79.3832<br/>pyramid.self-determined.de,53.5,10.25<br/>relay.jeffg.fyi,43.6532,-79.3832<br/>nostr.aruku.kro.kr,37.3589,127.115<br/>chat-relay.zap-work.com,43.6532,-79.3832<br/>relay.islandbitcoin.com,12.8498,77.6545<br/>nostr.zoracle.org,45.6018,-121.185<br/>relay-dev.satlantis.io,40.8302,-74.1299<br/>relay.earthly.city,34.0362,-118.443<br/>speakeasy.cellar.social,49.4543,11.0746<br/>relay.bnos.space,43.6532,-79.3832<br/>relay.henryxplace.eu.org:9988,31.2304,121.474<br/>relay.bitmacro.cloud,43.6532,-79.3832<br/>nostr.thebiglake.org,32.71,-96.6745<br/>relay.lab.rytswd.com,49.4543,11.0746<br/>nostr.nadajnik.org,50.1109,8.68213<br/>relay.evanverma.com,40.8302,-74.1299<br/>relay2.angor.io,48.1046,11.6002<br/>prl.plus,55.7628,37.5983<br/>myvoiceourstory.org,37.3598,-121.981<br/>relay.arx-ccn.com,50.4754,12.3683<br/>wot.sudocarlos.com,43.6532,-79.3832<br/>relayrs.notoshi.win,43.6532,-79.3832<br/>nostrcity-club.fly.dev,48.8575,2.35138<br/>relay.tagayasu.xyz,45.4215,-75.6972<br/>nostr.blankfors.se,60.1699,24.9384<br/>nrs-01.darkcloudarcade.com,39.1008,-94.5811<br/>relay.lightning.pub,39.0438,-77.4874<br/>nostr-02.yakihonne.com,1.32123,103.695<br/>relay.nostrverse.net,43.6532,-79.3832<br/>nostr.wecsats.io,43.6532,-79.3832<br/>relay.illuminodes.com,47.6062,-122.332<br/>api.freefrom.space/v1/ws,43.6532,-79.3832<br/>nostr-relay.psfoundation.info,39.0438,-77.4874<br/>relay.samt.st,40.8302,-74.1299<br/>nostr-relay.cbrx.io,43.6532,-79.3832<br/>inbox.mycelium.social,38.627,-90.1994<br/>relay.anmore.me,49.281,-123.117<br/>no.str.cr,10.074,-84.2155<br/>nstr.a0a1.space,52.3563,4.95714<br/>relay.typedcypher.com,51.5072,-0.127586<br/>relay.bitmacro.pro,43.6532,-79.3832<br/>relay.nostrzh.org,43.6532,-79.3832<br/>ynostr.yael.at,60.1699,24.9384<br/>nostr-relay.zeabur.app,25.0797,121.234<br/>dynasty.libretechsystems.xyz,55.4724,9.87335<br/>nostr.bitcoiner.social,47.6743,-117.112<br/>nostr.girino.org,43.6532,-79.3832<br/>nostr2.girino.org,43.6532,-79.3832<br/>nostr-verified.wellorder.net,45.5201,-122.99<br/>relay.fundstr.me,42.3601,-71.0589<br/>relay.mapboss.co.th,13.7234,100.784<br/>relay.qstr.app,51.5072,-0.127586<br/>nostr-rs-relay-ishosta.phamthanh.me,43.6532,-79.3832<br/>relay.klabo.world,47.674,-122.122<br/>relay.minibolt.info,43.6532,-79.3832<br/>x.kojira.io,43.6532,-79.3832<br/>relay-dev.gulugulu.moe,43.6532,-79.3832<br/>relay.nostriot.com,41.5695,-83.9786<br/>relayone.soundhsa.com,39.1008,-94.5811<br/>nr.yay.so,46.2126,6.1154<br/>relay.bithome.site,52.3563,4.95714<br/>relay.damus.io,43.6532,-79.3832<br/>nostr.mikoshi.de,50.1109,8.68213<br/>nostr.defucc.me,50.1109,8.68213<br/>relay.malxte.de,52.52,13.405<br/>relay.orangepill.ovh,49.1689,-0.358841<br/>bbw-nostr.xyz,41.5284,-87.4237<br/>kasztanowa.bieda.it,43.6532,-79.3832<br/>bitcoiner.social,47.6743,-117.112<br/>relay.lacompagniemaximus.com,45.3147,-73.8785<br/>relay.mostr.pub,43.6532,-79.3832<br/>relay.lanavault.space,60.1699,24.9384<br/>kotukonostr.onrender.com,37.7775,-122.397<br/>relay.ditto.pub,43.6532,-79.3832<br/>relay.erybody.com,41.4513,-81.7021<br/>nostr.dlcdevkit.com,40.0992,-83.1141<br/>ribo.us.nostria.app,41.5868,-93.625<br/>relay.paulstephenborile.com,49.4543,11.0746<br/>testnet-relay.samt.st,40.8302,-74.1299<br/>relay.purplefrog.cloud,35.6916,139.768<br/>relay.agorist.space,52.3734,4.89406<br/>nostr-relay.zimage.com,34.0549,-118.243<br/>nostr.azzamo.net,52.2633,21.0283<br/>strfry.elswa-dev.online,50.1109,8.68213<br/>wot.shaving.kiwi,43.6532,-79.3832<br/>okn.czas.plus,50.1109,8.68213<br/>bcast.seutoba.com.br,43.6532,-79.3832<br/>relay.sigit.io,50.4754,12.3683<br/>syb.lol,34.0549,-118.243<br/>relay.libernet.app,43.6532,-79.3832<br/>relay.angor.io,48.1046,11.6002<br/>relay.staging.commonshub.brussels,49.4543,11.0746<br/>strfry.atlantislabs.space,43.6532,-79.3832<br/>nostr.wom.wtf,43.6532,-79.3832<br/>nostrride.io,37.3986,-121.964<br/>nostr.dpinkerton.com,39.1008,-94.5811<br/>r.0kb.io,32.789,-96.7989<br/>nostr.hekster.org,37.3986,-121.964<br/>satsage.xyz,37.3986,-121.964<br/>nostr.islandarea.net,35.4669,-97.6473<br/>ve.agorawlc.com,50.4754,12.3683<br/>relay.openfarmtools.org,60.1699,24.9384<br/>top.testrelay.top,43.6532,-79.3832<br/>relay-rpi.edufeed.org,49.4521,11.0767<br/>pyramid.cult.cash,32.9483,-96.7299<br/>relay.edino.net,56.6268,47.9193<br/>nostr.snowbla.de,60.1699,24.9384<br/>relay.wavefunc.live,39.7392,-104.99<br/>tenex.chat,50.4754,12.3683<br/>relay.getsafebox.app,43.6532,-79.3832<br/>nostr.bond,50.1109,8.68213<br/>nostrelites.org,41.8781,-87.6298<br/>relay.plebeian.market,50.1109,8.68213<br/>relay.laantungir.net,-19.4692,-42.5315<br/>relay.decentnewsroom.com,50.4754,12.3683<br/>nostr-relay.nextblockvending.com,47.2343,-119.853<br/>relay.spacetomatoes.net,42.3601,-71.0589<br/>nostrbtc.com,43.6532,-79.3832<br/>relay.puresignal.news,43.6532,-79.3832<br/>relay-testnet.k8s.layer3.news,37.3387,-121.885<br/>relay.binaryrobot.com,43.6532,-79.3832<br/>relay.wavlake.com,41.2619,-95.8608<br/>inbox.scuba323.com,40.8218,-74.45<br/>nostr.spaceshell.xyz,43.6532,-79.3832<br/>relay.nostr.place,32.7767,-96.797<br/>holland-excited-charming-experiencing.trycloudflare.com,43.6532,-79.3832<br/>theoutpost.life,64.1476,-21.9392<br/>relay.fckstate.net,59.3293,18.0686<br/>bcast.girino.org,43.6532,-79.3832<br/>discovery.us.nostria.app,52.3676,4.90414<br/>relay.bullishbounty.com,43.6532,-79.3832<br/>nostr.88mph.life,51.5072,-0.127586<br/>nostr.tadryanom.me,43.6532,-79.3832<br/>nostr.sathoarder.com,48.5734,7.75211<br/>relay.nostr.net,43.6532,-79.3832<br/>zw.agorawlc.com,50.4754,12.3683<br/>relay.internationalright-wing.org,-22.5022,-48.7114<br/>nostr.vulpem.com,49.4543,11.0746<br/>wot.codingarena.top,50.4754,12.3683<br/>reraw.pbla2fish.cc,43.6532,-79.3832<br/>plebchain.club,43.6532,-79.3832<br/>orly-relay.imwald.eu,48.8575,2.35138<br/>relay.satnam.pub,43.6532,-79.3832<br/>cs-relay.nostrdev.com,50.4754,12.3683<br/>schnorr.me,43.6532,-79.3832<br/>nostr-relay.online,43.6532,-79.3832<br/>relay.routstr.com,43.6532,-79.3832<br/>relay.ohstr.com,43.6532,-79.3832<br/>relay.lanacoin-eternity.com,40.8302,-74.1299<br/>wot.nostr.net,43.6532,-79.3832<br/>nostr.ps1829.com,33.8851,130.883<br/>yabu.me,35.6092,139.73<br/>soloco.nl,43.6532,-79.3832<br/>librerelay.aaroniumii.com,43.6532,-79.3832<br/>relay.mmwaves.de,48.8575,2.35138<br/>relay.artx.market,43.6548,-79.3885<br/>nostr.jerrynya.fun,31.2304,121.474<br/>relay-arg.zombi.cloudrodion.com,1.35208,103.82<br/>relay.edufeed.org,49.4521,11.0767<br/>discovery.eu.nostria.app,52.3676,4.90414<br/>relay.layer.systems,49.0291,8.35695<br/>nostr-rs-relay.dev.fedibtc.com,39.0438,-77.4874<br/>relay.0xchat.com,43.6532,-79.3832<br/>nos.lol,50.4754,12.3683<br/>lightning.red,53.3498,-6.26031<br/>slick.mjex.me,39.0418,-77.4744<br/>relay.boredvictor.xyz,41.3888,2.15899<br/>nostr.rtvslawenia.com,49.4543,11.0746<br/>relay.mitchelltribe.com,39.0438,-77.4874<br/>nostr.4rs.nl,49.0291,8.35696<br/>relay.olas.app,50.4754,12.3683<br/>memlay.v0l.io,53.3498,-6.26031<br/>nostr-01.yakihonne.com,1.29524,103.79<br/>relay.satmaxt.xyz,43.6532,-79.3832<br/>nostrcheck.tnsor.network,43.6532,-79.3832<br/>relay.guggero.org,46.0037,8.95105<br/>ai.techunder.tech:56711,22.5429,114.06<br/>premium.primal.net,43.6532,-79.3832<br/>nostr.tac.lol,47.4748,-122.273<br/>relay.zone667.com,60.1699,24.9384<br/>nostr-relay.gateway.in.th,15.5163,103.194<br/>vault.iris.to,43.6532,-79.3832<br/>strfry.bonsai.com,37.8716,-122.273<br/>ribo.eu.nostria.app,52.3676,4.90414<br/>relay.wellorder.net,45.5201,-122.99<br/>relay.tapestry.ninja,40.8054,-74.0241<br/>relay.dwadziesciajeden.pl,52.2297,21.0122<br/>relay.satlantis.io,32.8769,-80.0114<br/>nostr.pbfs.io,50.4754,12.3683<br/>freelay.sovbit.host,64.1476,-21.9392<br/>articles.layer3.news,37.3387,-121.885<br/>nostr.na.social,43.6532,-79.3832<br/>relay.fountain.fm,43.6532,-79.3832<br/>dev.relay.stream,43.6532,-79.3832<br/>nostr.n7ekb.net,36.1527,-95.9902<br/>relay5.bitransfer.org,43.6532,-79.3832<br/>relay.og.coop,43.6532,-79.3832<br/>nostr-server-production.up.railway.app,45.5019,-73.5674<br/>bucket.coracle.social,37.7775,-122.397<br/>relay.gulugulu.moe,43.6532,-79.3832<br/>relay.nostr-check.me,43.6532,-79.3832<br/>nostr.faultables.net,43.6532,-79.3832<br/>strfry.openhoofd.nl,51.9229,4.40833<br/>nostr.rblb.it:7777,43.7094,10.6582<br/>relay.nostrcheck.me,43.6532,-79.3832<br/>0x-nostr-relay.fly.dev,48.8575,2.35138<br/>nostr.thalheim.io,60.1699,24.9384<br/>relay-nl.zombi.cloudrodion.com,50.8943,6.06237<br/>relay.shadowbip.com,51.5072,-0.127586<br/>nostr-relay.corb.net,38.8353,-104.822<br/>purplerelay.com,43.6532,-79.3832<br/>nostr-pub.wellorder.net,45.5201,-122.99<br/>herbstmeister.com,34.0549,-118.243<br/>nostrcheck.me,43.6532,-79.3832<br/>pyramid.nostr.technology,52.3947,4.66399<br/>nostr.spicyz.io,43.6532,-79.3832<br/>nrs-02.darkcloudarcade.com,39.9526,-75.1652<br/>nestr.nedao.ch,47.0151,6.98832<br/>nostr.nodesmap.com,59.3327,18.0656<br/>nittom.nostr1.com,38.6327,-90.1961<br/>public.crostr.com,43.6532,-79.3832<br/>relay.cypherflow.ai,48.8575,2.35138<br/>nostr.bitczat.pl,60.1699,24.9384<br/>relayone.geektank.ai,39.1008,-94.5811<br/>testrelay.era21.space,43.6532,-79.3832<br/>relay.npubhaus.com,43.6532,-79.3832<br/>relay.bitmacro.io,48.8566,2.35222<br/>nostr.data.haus,50.4754,12.3683<br/>relay.credenso.cafe,43.3601,-80.3127<br/>relay.ru.ac.th,13.7607,100.627<br/>relay-fra.zombi.cloudrodion.com,48.8566,2.35222<br/>nostr.chaima.info,50.1109,8.68213<br/>nostr.mom,50.4754,12.3683
2026-10-09T01:54:52Zhttps://njump.me/nevent1qqszkkeqjuc287f7qte4hdaagxxe24z6cytcdt34eyuwm7s7ls3urwqzyp2xhcyfwmc3jdu98up2074n3zznz6ye259qzdm0pp7qwhqtg2z6jqf2d9h//! A crate providing the `get_file_hash!` procedural macro. //! ...
//! A crate providing the `get_file_hash!` procedural macro.<br/>//!<br/>//! This macro allows you to compute the SHA-256 hash of a file at compile time,<br/>//! embedding the resulting hash string directly into your Rust executable.<br/><br/>pub use get_file_hash_core::get_file_hash;<br/><br/>#[cfg(feature = "nostr")]<br/>use nostr_sdk::{Event, EventBuilder, EventId, Keys, Tag, UnsignedEvent};<br/><br/>#[cfg(feature = "nostr")]<br/>const DEFAULT_MAX_POW_ATTEMPTS: u128 = 100_000_000;<br/><br/>/// Mine a Nostr event whose ID starts with the given lowercase-hex prefix.<br/>///<br/>/// The SDK's [`EventBuilder::pow`](nostr_sdk::EventBuilder::pow) only supports<br/>/// NIP-13 leading-zero-bits difficulty. This helper does custom-prefix mining<br/>/// by brute-forcing a `["nonce", "<nonce>", "0"]` tag until the computed<br/>/// event ID matches the desired prefix.<br/>///<br/>/// # Arguments<br/>///<br/>/// * `keys` - The keypair used to sign the event.<br/>/// * `builder` - A pre-configured event builder (content, tags, kind, ...).<br/>/// * `prefix` - The desired hex prefix (case-insensitive). Each extra hex<br/>/// character increases the expected search time by a factor of 16.<br/>/// * `max_attempts` - Safety cap. Returns `None` if no matching nonce is found.<br/>///<br/>/// # Example<br/>///<br/>/// ```no_run<br/>/// use get_file_hash::mine_event_with_prefix;<br/>/// use nostr_sdk::{EventBuilder, Keys, Tag};<br/>///<br/>/// let keys = Keys::generate(); ## padded commit hash?<br/>/// let builder = EventBuilder::text_note("hello")<br/>/// .tag(Tag::parse(["example", "pow"]).unwrap());<br/>///<br/>/// if let Some(event) = mine_event_with_prefix(&keys, builder, "0000", 10_000_000) {<br/>/// println!("mined event id: {}", event.id);<br/>/// }<br/>/// ```<br/>#[cfg(feature = "nostr")]<br/>pub fn mine_event_with_prefix(<br/> keys: &Keys,<br/> builder: EventBuilder,<br/> prefix: &str,<br/> max_attempts: u128,<br/>) -> Option<Event> {<br/> let pubkey = keys.public_key();<br/> let prefix = prefix.to_ascii_lowercase();<br/> let mut nonce: u128 = 0;<br/><br/> loop {<br/> let mut attempt = builder.clone();<br/> attempt = attempt.tag(Tag::pow(nonce, 0));<br/><br/> let mut unsigned: UnsignedEvent = attempt.build(pubkey);<br/> let id: EventId = unsigned.id();<br/><br/> if id.to_hex().starts_with(&prefix) {<br/> return unsigned.sign_with_keys(keys).ok();<br/> }<br/><br/> nonce += 1;<br/> if nonce > max_attempts {<br/> return None;<br/> }<br/> }<br/>}<br/><br/>/// Convenience wrapper around [`mine_event_with_prefix`] with a default attempt<br/>/// cap of 100,000,000.<br/>#[cfg(feature = "nostr")]<br/>pub fn mine_event_with_prefix_or_default(<br/> keys: &Keys,<br/> builder: EventBuilder,<br/> prefix: &str,<br/>) -> Option<Event> {<br/> mine_event_with_prefix(keys, builder, prefix, DEFAULT_MAX_POW_ATTEMPTS)<br/>}<br/><br/>/// The SHA-256 hash of this crate's `build.rs` at the time of compilation.<br/>pub const BUILD_HASH: &str = env!("BUILD_HASH");<br/><br/>/// The SHA-256 hash of this crate's `Cargo.toml` at the time of compilation.<br/>pub const CARGO_TOML_HASH: &str = env!("CARGO_TOML_HASH");<br/><br/>/// The SHA-256 hash of this crate's `src/lib.rs` at the time of compilation.<br/>pub const LIB_HASH: &str = env!("LIB_HASH");<br/><br/>/// The name of the package as specified in Cargo.toml.<br/>pub const CARGO_PKG_NAME: &str = env!("CARGO_PKG_NAME");<br/><br/>/// The version of the package as specified in Cargo.toml.<br/>pub const CARGO_PKG_VERSION: &str = env!("CARGO_PKG_VERSION");<br/><br/>#[cfg(feature = "nostr")]<br/>/// The git commit hash of the repository at the time of compilation.<br/>pub const GIT_COMMIT_HASH: &str = env!("GIT_COMMIT_HASH");<br/><br/>#[cfg(feature = "nostr")]<br/>/// The git branch of the repository at the time of compilation.<br/>pub const GIT_BRANCH: &str = env!("GIT_BRANCH");<br/><br/>#[cfg(test)]<br/>mod tests {<br/> use sha2::{Digest, Sha256};<br/><br/> use super::*;<br/><br/> /// Verifies that the exported CARGO_TOML_HASH is not empty.<br/> #[test]<br/> fn test_injected_hash_exists() {<br/> assert!(!BUILD_HASH.is_empty());<br/> println!("Verified build.rs Hash:<br/>{}", BUILD_HASH);<br/><br/> assert!(!CARGO_TOML_HASH.is_empty());<br/> println!("Verified Cargo.toml Hash:<br/>{}", CARGO_TOML_HASH);<br/><br/> assert!(!LIB_HASH.is_empty());<br/> println!("Verified src/lib.rs Hash:\n{}", LIB_HASH);<br/><br/> assert!(!CARGO_PKG_NAME.is_empty());<br/> println!("Verified Package Name:\n{}", CARGO_PKG_NAME);<br/><br/> assert!(!CARGO_PKG_VERSION.is_empty());<br/> println!("Verified Package Version:\n{}", CARGO_PKG_VERSION);<br/><br/> #[cfg(feature = "nostr")]<br/> {<br/> assert!(!GIT_COMMIT_HASH.is_empty());<br/> println!("Verified Git Commit Hash:\n{}", GIT_COMMIT_HASH);<br/><br/> assert!(!GIT_BRANCH.is_empty());<br/> println!("Verified Git Branch:\n{}", GIT_BRANCH);<br/> }<br/> }<br/><br/> /// Tests that the `get_file_hash!` macro correctly computes the SHA-256<br/> /// hash of `lib.rs` and that it matches a manually computed hash of the<br/> /// same file.<br/> #[test]<br/> fn test_get_lib_hash() {<br/> let file_content = include_bytes!("lib.rs");<br/><br/> let mut hasher = Sha256::new();<br/> hasher.update(file_content);<br/> let expected_hash = hasher<br/> .finalize()<br/> .iter()<br/> .map(|b| format!("{:02x}", b))<br/> .collect::<String>();<br/><br/> let actual_hash = get_file_hash!("lib.rs");<br/> assert_eq!(actual_hash, expected_hash);<br/> }<br/>}<br/>
2026-10-09T01:54:52Zhttps://njump.me/nevent1qqs2my2lshe9ctx740ypkt05x5gl5pp5w9c5z5r5s3y0yjpt39lgs4szyp2xhcyfwmc3jdu98up2074n3zznz6ye259qzdm0pp7qwhqtg2z6j8x9fe2[package] name = "get_file_hash_core" version = { ...
[package]<br/>name = "get_file_hash_core"<br/>version = { workspace = true }<br/>edition = { workspace = true }<br/>description = { workspace = true }<br/>license = { workspace = true }<br/>documentation = { workspace = true }<br/>homepage = { workspace = true }<br/>repository = { workspace = true }<br/>authors = { workspace = true }<br/><br/>[features]<br/>nostr = ["dep:nostr", "dep:nostr-sdk", "dep:serde", "dep:serde_json", "dep:sha2", "dep:hex", "dep:reqwest", "dep:tokio", "dep:csv", "dep:url", "dep:frost-secp256k1-tr", "dep:rand"]<br/>frost = ["dep:nostr", "dep:nostr-sdk", "dep:serde", "dep:serde_json", "dep:sha2", "dep:hex", "dep:reqwest", "dep:tokio", "dep:csv", "dep:url", "dep:frost-secp256k1-tr", "dep:rand"]<br/><br/>[dependencies]<br/>sha2 = { workspace = true, optional = true }<br/>nostr = { workspace = true, optional = true }<br/>serde = { workspace = true, optional = true }<br/>serde_json = { workspace = true, optional = true }<br/>nostr-sdk = { workspace = true, optional = true }<br/>hex = { workspace = true, optional = true }<br/>csv = { workspace = true, optional = true }<br/>url = { workspace = true, optional = true }<br/>frost-secp256k1-tr = { workspace = true, optional = true }<br/>rand = { workspace = true, optional = true }<br/><br/>[dev-dependencies]<br/>sha2 = { workspace = true }<br/>tempfile = { workspace = true }<br/>nostr = { workspace = true }<br/>nostr-sdk = { workspace = true }<br/>serde = { workspace = true }<br/>serde_json = { workspace = true }<br/>hex = { workspace = true }<br/>tokio = { workspace = true, features = ["macros", "rt-multi-thread"] }<br/>csv = { workspace = true }<br/>url = { workspace = true }<br/>frost-secp256k1-tr = { workspace = true }<br/>serial_test = { workspace = true, features = ["test_logging"] }<br/>log = { workspace = true }<br/><br/>[build-dependencies]<br/>reqwest = { workspace = true, features = ["json"], optional = true }<br/>tokio = { workspace = true, features = ["macros", "rt-multi-thread"], optional = true }<br/>
2026-10-09T01:54:51Zhttps://njump.me/nevent1qqsf8zqmpmffx7kdtfuslh3jtkswz0hf9kr3wdqppkqu72k5fjqxewszyp2xhcyfwmc3jdu98up2074n3zznz6ye259qzdm0pp7qwhqtg2z6js3g9yx#![cfg(feature = "nostr")] use frost_secp256k1_tr as ...
#![cfg(feature = "nostr")]<br/><br/>use frost_secp256k1_tr as frost;<br/>use frost::keys::PublicKeyPackage;<br/>use frost::round2::SignatureShare;<br/>use frost::SigningPackage;<br/>use hex;<br/>use rand::thread_rng;<br/>use std::collections::BTreeMap;<br/>use sha2::Sha256;<br/>use serde_json;<br/>use sha2::Digest;<br/><br/>pub fn process_relay_share(<br/> relay_payload_hex: &str,<br/> signer_id_u16: u16,<br/> _signing_package: &SigningPackage,<br/> _pubkey_package: &PublicKeyPackage,<br/>) -> Result<(), Box<dyn std::error::Error>> {<br/> // In a real scenario, this function would deserialize the share, perform<br/> // individual verification, and store it for aggregation.<br/> // For this example, we'll just acknowledge receipt.<br/> let _share_bytes = hex::decode(relay_payload_hex)?;<br/> let _share = SignatureShare::deserialize(&_share_bytes)?;<br/> let _identifier = frost::Identifier::try_from(signer_id_u16)?;<br/><br/> println!("✅ Share from Signer {} processed (simplified).", signer_id_u16);<br/> Ok(())<br/>}<br/><br/>pub fn simulate_frost_mailbox_coordinator() -> Result<(), Box<dyn std::error::Error>> {<br/> let mut rng = thread_rng();<br/> let (max_signers, min_signers) = (2, 2);<br/><br/> let (shares, pubkey_package) = frost::keys::generate_with_dealer(<br/> max_signers,<br/> min_signers,<br/> frost::keys::IdentifierList::Default,<br/> &mut rng,<br/> )?;<br/><br/> let signer1_id = frost::Identifier::try_from(1 as u16)?;<br/> let key_package1: frost::keys::KeyPackage = shares[&signer1_id].clone().try_into()?;<br/> let signer2_id = frost::Identifier::try_from(2 as u16)?;<br/> let key_package2: frost::keys::KeyPackage = shares[&signer2_id].clone().try_into()?;<br/><br/> let message = b"BIP-64MOD: Anchor Data Proposal v1";<br/><br/> let (nonces1, comms1) = frost::round1::commit(key_package1.signing_share(), &mut rng);<br/> let (nonces2, comms2) = frost::round1::commit(key_package2.signing_share(), &mut rng);<br/><br/> let mut session_commitments = BTreeMap::new();<br/> session_commitments.insert(signer1_id, comms1);<br/> session_commitments.insert(signer2_id, comms2);<br/><br/> let signing_package = frost::SigningPackage::new(session_commitments.clone(), message);<br/><br/> let share1 = frost::round2::sign(&signing_package, &nonces1, &key_package1)?;<br/> let share1_hex = hex::encode(share1.serialize());<br/><br/> let share2 = frost::round2::sign(&signing_package, &nonces2, &key_package2)?;<br/> let share2_hex = hex::encode(share2.serialize());<br/><br/> println!("Coordinator listening for Nostr events (simulated)...");<br/><br/> process_relay_share(&share1_hex, 1_u16, &signing_package, &pubkey_package)?;<br/> process_relay_share(&share2_hex, 2_u16, &signing_package, &pubkey_package)?;<br/> println!("All required shares processed. Coordinator would now aggregate.");<br/><br/> Ok(())<br/>}<br/><br/>/// Simulates a Signer producing a FROST signature share and preparing a Nostr event<br/>/// to be sent to a coordinator via a "mailbox" relay.<br/>///<br/>/// In a real ROAST setup, signers would generate their share and post it<br/>/// encrypted (e.g., using NIP-44) to a coordinator's "mailbox" on a Nostr relay.<br/>/// This function demonstrates the creation of the signature share and the<br/>/// construction of a *simplified* Nostr event JSON.<br/>///<br/>/// # Arguments<br/>///<br/>/// * `_identifier` - The FROST identifier of the signer. (Currently unused in this specific function body).<br/>/// * `signing_package` - The FROST signing package received from the coordinator.<br/>/// * `nonces` - The signer's nonces generated in Round 1.<br/>/// * `key_package` - The signer's FROST key package.<br/>/// * `coordinator_pubkey` - The hex-encoded public key of the ROAST coordinator,<br/>/// used to tag the Nostr event.<br/>///<br/>/// # Returns<br/>///<br/>/// A `Result` containing the JSON string of the Nostr event if successful,<br/>/// or a `Box<dyn std::error::Error>` if an error occurs.<br/>pub fn create_signer_event(<br/> _identifier: frost::Identifier,<br/> signing_package: &frost::SigningPackage,<br/> nonces: &frost::round1::SigningNonces,<br/> key_package: &frost::keys::KeyPackage,<br/> coordinator_pubkey: &str, // The Hex pubkey of the ROAST coordinator<br/>) -> Result<String, Box<dyn std::error::Error>> {<br/><br/> // 1. Generate the partial signature share (Round 2 of FROST)<br/> // This share is the core cryptographic output from the signer.<br/> let share = frost::round2::sign(signing_package, nonces, key_package)?;<br/> let share_bytes = share.serialize();<br/> let share_hex = hex::encode(share_bytes);<br/><br/> // 2. Create a Session ID to tag the event<br/> // This ID is derived from the signing package hash, allowing the coordinator<br/> // to correlate shares belonging to the same signing session.<br/> let mut hasher = Sha256::new();<br/> hasher.update(signing_package.serialize()?);<br/> let session_id = hex::encode(hasher.finalize());<br/><br/> // 3. Construct the Nostr Event JSON (Simplified)<br/> // This JSON represents the event that a signer would post to a relay.<br/> // In a production ROAST system, the 'content' field (the signature share)<br/> // would be encrypted for the coordinator using NIP-44.<br/> let event = serde_json::json!({<br/> "kind": 4, // Example: Using Kind 4 (Private Message), though custom Kinds could be used for Sovereign Stack.<br/> "pubkey": hex::encode(key_package.verifying_key().serialize()?.as_slice()), // Signer's public key<br/> "created_at": 1712050000, // Example timestamp<br/> "tags": [<br/> ["p", coordinator_pubkey], // 'p' tag: Directs the event to the coordinator.<br/> ["i", session_id], // 'i' tag: Provides a session identifier for filtering/requests.<br/> ["t", "frost-signature-share"] // 't' tag: A searchable label for the event type.<br/> ],<br/> "content": share_hex, // The actual signature share (would be encrypted in production).<br/> "id": "...", // Event ID (filled by relay upon publishing)<br/> "sig": "..." // Event signature (filled by relay upon publishing)<br/> });<br/><br/> Ok(event.to_string())<br/>}<br/><br/>pub fn simulate_frost_mailbox_post_signer() -> Result<(), Box<dyn std::error::Error>> {<br/> use rand::thread_rng;<br/> use std::collections::BTreeMap;<br/> use frost_secp256k1_tr as frost;<br/><br/> // This example simulates a single signer's role in a ROAST mailbox post workflow.<br/> // The general workflow is:<br/> // 1. Coordinator sends a request for signatures (e.g., on a BIP-64MOD proposal).<br/> // 2. Signers receive the proposal, perform local verification.<br/> // 3. Each signer generates their signature share and posts it (encrypted) to a<br/> // Nostr relay, targeting the coordinator's mailbox.<br/> // 4. The coordinator collects enough shares to aggregate the final signature.<br/><br/> let mut rng = thread_rng();<br/> // For this example, we simulate a 2-of-2 threshold for simplicity.<br/> let (max_signers, min_signers) = (2, 2);<br/><br/> ////////////////////////////////////////////////////////////////////////////<br/> // 1. Key Generation (Simulated Trusted Dealer)<br/> ////////////////////////////////////////////////////////////////////////////<br/> // In a real distributed setup, this would be DKG. Here, a "trusted dealer"<br/> // generates the shares and public key package.<br/> let (shares, _pubkey_package) = frost::keys::generate_with_dealer(<br/> max_signers,<br/> min_signers,<br/> frost::keys::IdentifierList::Default,<br/> &mut rng,<br/> )?;<br/><br/> // For a 2-of-2 scheme, we have two signers. Let's pick signer 1.<br/> let signer1_id = frost::Identifier::try_from(1 as u16)?;<br/> let key_package1: frost::keys::KeyPackage = shares[&signer1_id].clone().try_into()?;<br/><br/> let signer2_id = frost::Identifier::try_from(2 as u16)?;<br/> let key_package2: frost::keys::KeyPackage = shares[&signer2_id].clone().try_into()?;<br/><br/> // The message that is to be signed (e.g., a hash of a Git commit or a Nostr event ID).<br/> let message = b"This is a test message for ROAST mailbox post.";<br/><br/> ////////////////////////////////////////////////////////////////////////////<br/> // 2. Round 1: Commitment Phase (Signer's role)<br/> ////////////////////////////////////////////////////////////////////////////<br/> // Each signer generates nonces and commitments.<br/> let (nonces1, comms1) = frost::round1::commit(key_package1.signing_share(), &mut rng);<br/> let (nonces2, comms2) = frost::round1::commit(key_package2.signing_share(), &mut rng);<br/> <br/> // The coordinator collects these commitments. Here, we simulate by putting them in a BTreeMap.<br/> let mut session_commitments = BTreeMap::new();<br/> session_commitments.insert(signer1_id, comms1);<br/> session_commitments.insert(signer2_id, comms2);<br/><br/> ////////////////////////////////////////////////////////////////////////////<br/> // 3. Signing Package Creation (Coordinator's role, simulated for context)<br/> ////////////////////////////////////////////////////////////////////////////<br/> // The coordinator combines the collected commitments and the message to be signed<br/> // into a signing package, which is then sent back to the signers.<br/> let signing_package = frost::SigningPackage::new(session_commitments, message);<br/><br/> // Dummy coordinator public key. In a real scenario, this would be the<br/> // actual public key of the ROAST coordinator, used for event tagging<br/> // and encryption (NIP-44).<br/> let coordinator_pubkey_hex = "0000000000000000000000000000000000000000000000000000000000000001";<br/><br/> ////////////////////////////////////////////////////////////////////////////<br/> // 4. Create the Signer Event (Signer's role)<br/> ////////////////////////////////////////////////////////////////////////////<br/> // We demonstrate for signer 1. Signer 2 would perform a similar action.<br/> let event_json_signer1 = create_signer_event(<br/> signer1_id,<br/> &signing_package,<br/> &nonces1,<br/> &key_package1,<br/> coordinator_pubkey_hex,<br/> )?;<br/><br/> println!("Generated Nostr Event for Signer 1 Mailbox Post:<br/>{}", event_json_signer1);<br/><br/> // Similarly, Signer 2 would generate their event:<br/> let event_json_signer2 = create_signer_event(<br/> signer2_id,<br/> &signing_package,<br/> &nonces2,<br/> &key_package2,<br/> coordinator_pubkey_hex,<br/> )?;<br/> println!("Generated Nostr Event for Signer 2 Mailbox Post:<br/>{}", event_json_signer2);<br/><br/> Ok(())<br/>}
2026-10-09T01:54:51Zhttps://njump.me/nevent1qqsysp65xetgeg6y6ydyz7ls76zc0y85jwtvuqzd2wwgp9dj3fk4mfqzyp2xhcyfwmc3jdu98up2074n3zznz6ye259qzdm0pp7qwhqtg2z6jc3qe0u// n34-relay - A nostr GRASP relay implementation // Copyright ...
// n34-relay - A nostr GRASP relay implementation<br/>// Copyright (C) 2025 Awiteb <a@4rs.nl><br/>//<br/>// This program is free software: you can redistribute it and/or modify<br/>// it under the terms of the GNU Affero General Public License as published<br/>// by the Free Software Foundation, either version 3 of the License, or<br/>// (at your option) any later version.<br/>//<br/>// This program is distributed in the hope that it will be useful,<br/>// but WITHOUT ANY WARRANTY; without even the implied warranty of<br/>// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the<br/>// GNU Affero General Public License for more details.<br/>//<br/>// You should have received a copy of the GNU Affero General Public License<br/>// along with this program. If not, see <<a href="https://gnu.org/licenses/agpl-3.0>">https://gnu.org/licenses/agpl-3.0></a>;.<br/><br/>use std::{net::SocketAddr, process::ExitCode, sync::Arc};<br/><br/>use axum::Extension;<br/>use hyper::{Method, header};<br/>use tokio::signal;<br/>use tower_http::{<br/> cors,<br/> decompression::RequestDecompressionLayer,<br/> trace::{DefaultMakeSpan, TraceLayer},<br/>};<br/>use tracing::level_filters::LevelFilter;<br/>use tracing_subscriber::{EnvFilter, Layer, layer::SubscriberExt};<br/><br/>/// Relay endpoints<br/>use n34_relay::endpoints;<br/>/// Relay errors.<br/>use n34_relay::errors;<br/>// /// Extension traits<br/>// use n34_relay::ext_traits;<br/>/// GRASP git server<br/>use n34_relay::git_server;<br/>// /// Relay pathes.<br/>// use n34_relay::pathes;<br/>// /// Raw axum websocket<br/>// use n34_relay::raw_websocket;<br/>/// Our relay.<br/>use n34_relay::relay;<br/>/// Relay configuration.<br/>use n34_relay::relay_config;<br/>/// Router state<br/>use n34_relay::router_state;<br/>/// Some useful utils.<br/>use n34_relay::utils;<br/><br/>use self::{errors::RelayResult, relay_config::RelayConfig, router_state::RouterState};<br/><br/>/// Sets up default logging with two outputs, stderr and a log file.<br/>///<br/>/// Log level for stderr is controlled by `RUST_LOG` environment variable,<br/>/// defaults to `ERROR`. The log file always uses `TRACE` level.<br/>fn setup_logs() -> errors::RelayResult<()> {<br/> tracing::subscriber::set_global_default(<br/> tracing_subscriber::registry()<br/> .with(<br/> tracing_subscriber::fmt::layer()<br/> .with_ansi(true)<br/> .with_writer(std::io::stderr)<br/> .without_time()<br/> .with_filter(EnvFilter::from_default_env()),<br/> )<br/> .with(<br/> tracing_subscriber::fmt::layer()<br/> .with_ansi(false)<br/> .with_writer(utils::logs_file()?)<br/> .with_file(false)<br/> .with_line_number(false)<br/> .with_filter(LevelFilter::TRACE),<br/> ),<br/> )<br/> .ok();<br/><br/> Ok(())<br/>}<br/><br/>async fn shutdown_signal() {<br/> let ctrl_c = async {<br/> signal::ctrl_c()<br/> .await<br/> .expect("Failed to install CTRL+C handler");<br/> };<br/><br/> #[cfg(unix)]<br/> let terminate = async {<br/> use tokio::signal::unix::SignalKind;<br/><br/> signal::unix::signal(SignalKind::terminate())<br/> .expect("Failed to create SIGTERM handler")<br/> .recv()<br/> .await;<br/> };<br/><br/> #[cfg(not(unix))]<br/> let terminate = std::future::pending::<()>();<br/><br/> tokio::select! {<br/> _ = ctrl_c => {},<br/> _ = terminate => {},<br/> }<br/>}<br/><br/>async fn try_main() -> RelayResult<()> {<br/> setup_logs()?;<br/> let config = Arc::new(RelayConfig::reload()?);<br/> let relay_db = config.get_relay_db().await?;<br/> let n34_relay = Arc::new(relay::build_relay(Arc::clone(&config), Arc::clone(&relay_db)).await);<br/> let addr = SocketAddr::new(config.net.ip, config.net.port);<br/><br/> tracing::debug!("Running relay with configuration: {config:#?}");<br/> tracing::info!("Relay is running at `{}`", n34_relay.url().await);<br/><br/> let mut app = axum::Router::new()<br/> // main handler. GET and POST<br/> .route("/", axum::routing::get(endpoints::main_handler).post(endpoints::main_handler));<br/><br/> if config.grasp.enable {<br/> tracing::info!("Git server is running");<br/> app = app.merge(git_server::router(&config));<br/> }<br/><br/> app = app<br/> // enable cross-origin access<br/> .route(<br/> "/",<br/> axum::routing::options(|| async { hyper::StatusCode::NO_CONTENT }),<br/> )<br/> .layer(<br/> cors::CorsLayer::new()<br/> .allow_origin(cors::Any)<br/> .allow_methods([Method::GET, Method::POST])<br/> .allow_headers([header::CONTENT_TYPE]),<br/> )<br/> .layer(<br/> TraceLayer::new_for_http()<br/> .make_span_with(DefaultMakeSpan::default().include_headers(true)),<br/> )<br/> .layer(RequestDecompressionLayer::new())<br/> .layer(Extension(Arc::new(RouterState::new(<br/> config, n34_relay, relay_db,<br/> ))));<br/><br/> axum::serve(<br/> tokio::net::TcpListener::bind(addr).await?,<br/> app.into_make_service_with_connect_info::<SocketAddr>(),<br/> )<br/> .with_graceful_shutdown(shutdown_signal())<br/> .await?;<br/> Ok(())<br/>}<br/><br/>#[tokio::main]<br/>async fn main() -> ExitCode {<br/> if let Err(err) = try_main().await {<br/> eprintln!("{err}");<br/> return ExitCode::FAILURE;<br/> }<br/><br/> tracing::info!("Exited gracefully without any errors");<br/> ExitCode::SUCCESS<br/>}<br/>
2026-10-09T01:54:51Zhttps://njump.me/nevent1qqsyduj07ez2du7fzrcgr5n2mf0nctxu88fv3f6vgaylmm53t3pcx2czyp2xhcyfwmc3jdu98up2074n3zznz6ye259qzdm0pp7qwhqtg2z6jv465t4// Copyright (c) 2023-2025 Rust Nostr Developers // Distributed ...
// Copyright (c) 2023-2025 Rust Nostr Developers<br/>// Distributed under the MIT software license<br/><br/>use std::error::Error;<br/>use std::ffi::OsStr;<br/>use std::path::{Path, PathBuf};<br/>use std::{env, fs};<br/><br/>use nostr::hashes::{Hash, sha256};<br/>use get_file_hash_core::pip::{<br/> MTU_PAYLOAD, PIP_MANIFEST_KIND, PIP_SLICE_KIND, PacketManifest, ProtocolSlice,<br/> manifest_packet_event_ids, packet_manifest_to_event, packet_slice_from_event,<br/> packet_slice_to_event, packetize,<br/>};<br/>use nostr::prelude::*;<br/>use nostr_sdk::prelude::Client;<br/><br/>const SECRET_KEY_HEX: &str = "0000000000000000000000000000000000000000000000000000000000000001";<br/><br/>type CliResult<T> = std::result::Result<T, Box<dyn Error + Send + Sync>>;<br/><br/>#[derive(Debug)]<br/>struct Options {<br/> relay: RelayUrl,<br/> mode: Mode,<br/>}<br/><br/>#[derive(Debug)]<br/>enum Input {<br/> File(PathBuf),<br/> Directory(PathBuf),<br/>}<br/><br/>#[derive(Debug)]<br/>enum Mode {<br/> Publish(Input),<br/> Reconstruct { manifest: EventId, out: PathBuf },<br/>}<br/><br/>#[tokio::main]<br/>async fn main() -> CliResult<()> {<br/> let options = parse_args()?;<br/> let keys = Keys::new(SecretKey::from_hex(SECRET_KEY_HEX)?);<br/><br/> let client = Client::default();<br/> client.add_relay(&options.relay).and_connect().await?;<br/><br/> match options.mode {<br/> Mode::Publish(Input::File(path)) => {<br/> let base = path.parent().unwrap_or_else(|| Path::new("."));<br/> push_file(&client, &options.relay, &keys, base, &path).await?<br/> }<br/> Mode::Publish(Input::Directory(path)) => {<br/> push_directory(&client, &options.relay, &keys, &path).await?<br/> }<br/> Mode::Reconstruct { manifest, out } => {<br/> reconstruct_from_manifest(&client, &options.relay, manifest, &out).await?<br/> }<br/> }<br/><br/> client.shutdown().await;<br/> Ok(())<br/>}<br/><br/>fn parse_args() -> CliResult<Options> {<br/> let mut relay: Option<RelayUrl> = None;<br/> let mut file: Option<PathBuf> = None;<br/> let mut directory: Option<PathBuf> = None;<br/> let mut manifest: Option<EventId> = None;<br/> let mut out: Option<PathBuf> = None;<br/><br/> let mut args = env::args().skip(1);<br/> while let Some(arg) = args.next() {<br/> match arg.as_str() {<br/> "--help" | "-h" => {<br/> print_usage();<br/> std::process::exit(0);<br/> }<br/> "--relay" => {<br/> let value = args<br/> .next()<br/> .ok_or_else(|| usage_error("--relay requires a value"))?;<br/> relay = Some(RelayUrl::parse(&value)?);<br/> }<br/> "--file" => {<br/> let value = args<br/> .next()<br/> .ok_or_else(|| usage_error("--file requires a value"))?;<br/> file = Some(PathBuf::from(value));<br/> }<br/> "--directory" | "--folder" => {<br/> let value = args<br/> .next()<br/> .ok_or_else(|| usage_error("--directory requires a value"))?;<br/> directory = Some(PathBuf::from(value));<br/> }<br/> "--manifest" => {<br/> let value = args<br/> .next()<br/> .ok_or_else(|| usage_error("--manifest requires a value"))?;<br/> manifest = Some(EventId::parse(&value)?);<br/> }<br/> "--out" => {<br/> let value = args<br/> .next()<br/> .ok_or_else(|| usage_error("--out requires a value"))?;<br/> out = Some(PathBuf::from(value));<br/> }<br/> other => {<br/> return Err(usage_error(format!("unknown argument: {other}")));<br/> }<br/> }<br/> }<br/><br/> let relay = relay.ok_or_else(|| usage_error("--relay is required"))?;<br/><br/> let mode = match (file, directory, manifest, out) {<br/> (Some(file), None, None, None) => Mode::Publish(Input::File(file)),<br/> (None, Some(directory), None, None) => Mode::Publish(Input::Directory(directory)),<br/> (None, None, Some(manifest), Some(out)) => Mode::Reconstruct { manifest, out },<br/> (Some(_), Some(_), _, _) => {<br/> return Err(usage_error("use either --file or --directory/--folder"));<br/> }<br/> (_, _, Some(_), None) => return Err(usage_error("--out is required with --manifest")),<br/> (_, _, None, Some(_)) => return Err(usage_error("--manifest is required with --out")),<br/> _ => {<br/> return Err(usage_error(<br/> "provide either --file/--directory/--folder or --manifest/--out",<br/> ));<br/> }<br/> };<br/><br/> Ok(Options { relay, mode })<br/>}<br/><br/>fn print_usage() {<br/> eprintln!(<br/> "Usage:\n cargo run -p nostr --example nip-pip -- --file <path> --relay <ws(s)://relay>\n cargo run -p nostr --example nip-pip -- --directory <path> --relay <ws(s)://relay>\n cargo run -p nostr --example nip-pip -- --folder <path> --relay <ws(s)://relay>\n cargo run -p nostr --example nip-pip -- --manifest <event-id> --out <path> --relay <ws(s)://relay>"<br/> );<br/>}<br/><br/>fn usage_error(message: impl Into<String>) -> Box<dyn Error + Send + Sync> {<br/> Box::new(std::io::Error::new(<br/> std::io::ErrorKind::InvalidInput,<br/> message.into(),<br/> ))<br/>}<br/><br/>async fn push_directory(<br/> client: &Client,<br/> relay: &RelayUrl,<br/> keys: &Keys,<br/> directory: &Path,<br/>) -> CliResult<()> {<br/> let mut files = Vec::new();<br/> collect_files(directory, &mut files)?;<br/> files.sort();<br/><br/> for file in files {<br/> push_file(client, relay, keys, directory, &file).await?;<br/> }<br/><br/> Ok(())<br/>}<br/><br/>async fn push_file(<br/> client: &Client,<br/> relay: &RelayUrl,<br/> keys: &Keys,<br/> base: &Path,<br/> file: &Path,<br/>) -> CliResult<()> {<br/> let bytes = fs::read(file)?;<br/> let relative = file<br/> .strip_prefix(base)<br/> .unwrap_or(file)<br/> .to_string_lossy()<br/> .replace('\\', "/");<br/> let root_id = packet_root_id(&relative);<br/> let batch = packetize(root_id.clone(), bytes.clone());<br/> let mut packet_events = Vec::with_capacity(batch.packets.len());<br/> let mut packet_event_ids = Vec::with_capacity(batch.total_packets as usize);<br/> let manifest = PacketManifest {<br/> root: root_id,<br/> sha256: sha256::Hash::hash(&bytes).to_string(),<br/> size: bytes.len() as u64,<br/> packets: batch.total_packets as u64,<br/> depth: packet_depth(&batch.packets),<br/> mtu: MTU_PAYLOAD as u64,<br/> encoding: String::from("json"),<br/> path: relative.clone(),<br/> };<br/> println!(<br/> "{}",<br/> serde_json::json!({<br/> "event": "perfect_ip file push start",<br/> "file": relative,<br/> "relay": relay.as_str(),<br/> "bytes": bytes.len(),<br/> "packets": batch.total_packets,<br/> })<br/> );<br/><br/> for slice in batch.packets {<br/> let event = packet_slice_to_event(&slice)?.finalize(keys)?;<br/> let event_id = event.id.to_string();<br/><br/> let output = client.send_event(&event).to([relay]).await?;<br/> packet_event_ids.push(event.id);<br/> packet_events.push(event);<br/> println!(<br/> "{}",<br/> serde_json::json!({<br/> "event": "perfect_ip packet pushed",<br/> "file": relative,<br/> "packet": slice.id,<br/> "event_id": event_id,<br/> "relay": relay.as_str(),<br/> "ok_relays": output.success.len(),<br/> "failed_relays": output.failed.len(),<br/> })<br/> );<br/> }<br/><br/> let manifest_event = packet_manifest_to_event(&manifest, &packet_event_ids)?.finalize(keys)?;<br/> println!("{}", manifest_event.as_json());<br/> let manifest_output = client.send_event(&manifest_event).to([relay]).await?;<br/> println!(<br/> "{}",<br/> serde_json::json!({<br/> "event": "perfect_ip manifest pushed",<br/> "file": relative,<br/> "event_id": manifest_event.id.to_string(),<br/> "relay": relay.as_str(),<br/> "ok_relays": manifest_output.success.len(),<br/> "failed_relays": manifest_output.failed.len(),<br/> })<br/> );<br/> let reconstructed = reconstruct_payload_from_fetched_events(&packet_events)?;<br/> let reconstructed_hash = sha256::Hash::hash(&reconstructed).to_string();<br/> println!(<br/> "{}",<br/> serde_json::json!({<br/> "event": "perfect_ip file reconstructed",<br/> "file": relative,<br/> "bytes": reconstructed.len(),<br/> "matches": reconstructed == bytes,<br/> "sha256_matches": reconstructed_hash == manifest.sha256,<br/> })<br/> );<br/><br/> println!(<br/> "{}",<br/> serde_json::json!({<br/> "event": "perfect_ip file push complete",<br/> "file": relative,<br/> "relay": relay.as_str(),<br/> })<br/> );<br/><br/> Ok(())<br/>}<br/><br/>async fn reconstruct_from_manifest(<br/> client: &Client,<br/> relay: &RelayUrl,<br/> manifest_id: EventId,<br/> out: &Path,<br/>) -> CliResult<()> {<br/> let manifest_filter = Filter::new().kind(PIP_MANIFEST_KIND).ids([manifest_id]);<br/> let manifest_events = client.fetch_events(manifest_filter).await?;<br/> let manifest_event = manifest_events<br/> .first()<br/> .cloned()<br/> .ok_or_else(|| usage_error("manifest event not found"))?;<br/> let manifest: PacketManifest = serde_json::from_str(&manifest_event.content)?;<br/> let packet_event_ids = manifest_packet_event_ids(&manifest_event);<br/> let packet_event_count = packet_event_ids.len();<br/> if packet_event_ids.is_empty() {<br/> return Err(usage_error(<br/> "manifest event does not reference any packet events",<br/> ));<br/> }<br/><br/> let packet_filter = Filter::new()<br/> .kind(PIP_SLICE_KIND)<br/> .ids(packet_event_ids.clone());<br/> let packet_events = client.fetch_events(packet_filter).await?;<br/> let packet_events = packet_events.into_iter().collect::<Vec<_>>();<br/> let reconstructed = reconstruct_payload_from_fetched_events(&packet_events)?;<br/> let reconstructed_hash = sha256::Hash::hash(&reconstructed).to_string();<br/> let output_path = resolve_output_path(out, &manifest);<br/><br/> if let Some(parent) = output_path.parent() {<br/> fs::create_dir_all(parent)?;<br/> }<br/> fs::write(&output_path, &reconstructed)?;<br/><br/> println!(<br/> "{}",<br/> serde_json::json!({<br/> "event": "perfect_ip manifest fetched",<br/> "relay": relay.as_str(),<br/> "manifest": manifest_id.to_string(),<br/> "manifest_event": manifest_event.id.to_string(),<br/> "packet_events": packet_event_count,<br/> "out": output_path.display().to_string(),<br/> "bytes": reconstructed.len(),<br/> "matches": reconstructed_hash == manifest.sha256,<br/> })<br/> );<br/><br/> Ok(())<br/>}<br/><br/>fn reconstruct_payload_from_fetched_events(events: &[Event]) -> CliResult<Vec<u8>> {<br/> let mut slices: Vec<ProtocolSlice> = Vec::new();<br/><br/> for event in events {<br/> if let Some(slice) = packet_slice_from_event(event)? {<br/> if !slice.is_parity {<br/> slices.push(slice);<br/> }<br/> }<br/> }<br/><br/> slices.sort_by_key(|slice| slice.header.seq_num);<br/><br/> Ok(slices.into_iter().flat_map(|slice| slice.data).collect())<br/>}<br/><br/>fn resolve_output_path(out: &Path, manifest: &PacketManifest) -> PathBuf {<br/> let manifest_name = Path::new(&manifest.path)<br/> .file_name()<br/> .unwrap_or_else(|| OsStr::new(&manifest.path));<br/><br/> if out.is_dir() || out.extension().is_none() {<br/> out.join(manifest_name)<br/> } else {<br/> out.to_path_buf()<br/> }<br/>}<br/><br/>fn packet_depth(packets: &[ProtocolSlice]) -> u32 {<br/> packets<br/> .iter()<br/> .map(|slice| slice.id.matches('.').count() as u32)<br/> .max()<br/> .unwrap_or(0)<br/>}<br/><br/>fn collect_files(directory: &Path, files: &mut Vec<PathBuf>) -> CliResult<()> {<br/> for entry in fs::read_dir(directory)? {<br/> let entry = entry?;<br/> let path = entry.path();<br/><br/> if path.is_dir() {<br/> collect_files(&path, files)?;<br/> } else if path.is_file() {<br/> files.push(path);<br/> }<br/> }<br/><br/> Ok(())<br/>}<br/><br/>fn packet_root_id(relative: &str) -> String {<br/> let mut hash: u64 = 0xcbf29ce484222325;<br/><br/> for byte in relative.as_bytes() {<br/> hash ^= u64::from(*byte);<br/> hash = hash.wrapping_mul(0x100000001b3);<br/> }<br/><br/> format!("ROOT.{hash:016x}")<br/>}<br/>
2026-10-09T01:54:51Zhttps://njump.me/nevent1qqszy9ve7uctrvuj7utsnyyu88j0ygud4n6wg9lrm7hyvk6xg3vzvjqzyp2xhcyfwmc3jdu98up2074n3zznz6ye259qzdm0pp7qwhqtg2z6jvqegdq#[cfg(all(not(debug_assertions), feature = "nostr"))] ...
#[cfg(all(not(debug_assertions), feature = "nostr"))]<br/>#[tokio::main]<br/>async fn main() {<br/> use std::fs;<br/> use std::path::PathBuf;<br/><br/> let manifest_dir = PathBuf::from(std::env::var("CARGO_MANIFEST_DIR").unwrap());<br/> let crate_src_path = manifest_dir.join("src").join("online_relays_gps.csv");<br/><br/> // Only download if the file doesn't exist or is empty<br/> if !crate_src_path.exists() || fs::metadata(&crate_src_path).map(|m| m.len() == 0).unwrap_or(true) {<br/> println!("cargo:warning=Downloading online_relays_gps.csv...");<br/> let url = "<a href="https://raw.githubusercontent.com/permissionlesstech/bitchat/main/relays/online_relays_gps.csv"">https://raw.githubusercontent.com/permissionlesstech/bitchat/main/relays/online_relays_gps.csv"</a>;;<br/> match reqwest::get(url).await {<br/> Ok(response) => {<br/> if response.status().is_success() {<br/> match response.text().await {<br/> Ok(content) => {<br/> fs::write(&crate_src_path, content).expect("Unable to write online_relays_gps.csv");<br/> println!("cargo:warning=Successfully downloaded online_relays_gps.csv to {:?}", crate_src_path);<br/> },<br/> Err(e) => {<br/> println!("cargo:warning=Failed to get text from response: {}", e);<br/> }<br/> }<br/> } else {<br/> println!("cargo:warning=Failed to download online_relays_gps.csv: HTTP status {}", response.status());<br/> }<br/> },<br/> Err(e) => {<br/> println!("cargo:warning=Failed to fetch online_relays_gps.csv: {}", e);<br/> }<br/> }<br/> }<br/>}<br/><br/>#[cfg(not(all(not(debug_assertions), feature = "nostr")))]<br/>fn main() {<br/> // Placeholder for when the nostr feature is not enabled or in debug mode<br/> println!("cargo:warning=Skipping online_relays_gps.csv download (nostr feature not enabled or debug mode)");<br/>}<br/>
2026-10-09T01:54:51Zhttps://njump.me/nevent1qqspuglmeq3gv7z72f33zfzpdeqm33kar5kwvl8797jtxqmayuznldqzyp2xhcyfwmc3jdu98up2074n3zznz6ye259qzdm0pp7qwhqtg2z6jd6ep3r// n34 - A CLI to interact with NIP-34 and other stuff related to ...
// n34 - A CLI to interact with NIP-34 and other stuff related to codes in nostr<br/>// Copyright (C) 2025 Awiteb <a@4rs.nl><br/>//<br/>// This program is free software: you can redistribute it and/or modify<br/>// it under the terms of the GNU General Public License as published by<br/>// the Free Software Foundation, either version 3 of the License, or<br/>// (at your option) any later version.<br/>//<br/>// This program is distributed in the hope that it will be useful,<br/>// but WITHOUT ANY WARRANTY; without even the implied warranty of<br/>// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the<br/>// GNU General Public License for more details.<br/>//<br/>// You should have received a copy of the GNU General Public License<br/>// along with this program. If not, see <<a href="https://gnu.org/licenses/gpl-3.0.html>">https://gnu.org/licenses/gpl-3.0.html></a>;.<br/><br/>/// Command line interface module<br/>use n34::cli;<br/>// /// N34 errors<br/>// use n34::error;<br/>// /// Nostr utils module<br/>// use n34::nostr_utils;<br/><br/>use std::{<br/> process::ExitCode,<br/> sync::atomic::{AtomicBool, Ordering},<br/>};<br/><br/>use clap::Parser;<br/>use clap_verbosity_flag::Verbosity;<br/>use tracing::Level;<br/>use tracing_subscriber::{Layer, filter, layer::SubscriberExt};<br/><br/>use self::cli::Cli;<br/><br/>/// Whether the editor is currently open. Prevents logging while the editor is<br/>/// open.<br/>static EDITOR_OPEN: AtomicBool = AtomicBool::new(false);<br/><br/>/// Configures the logging level based on the provided verbosity.<br/>///<br/>/// When verbosity is set to TRACE, includes file and line numbers in logs.<br/>fn set_log_level(verbosity: Verbosity) {<br/> let is_trace = verbosity<br/> .tracing_level()<br/> .is_some_and(|l| l == tracing::Level::TRACE);<br/><br/> let logs_filter = filter::dynamic_filter_fn(move |m, _| {<br/> // Disable all logs while editor is open<br/> verbosity.tracing_level().unwrap_or(Level::ERROR) >= *m.level()<br/> && !EDITOR_OPEN.load(Ordering::Relaxed)<br/> });<br/><br/> let logs_layer = tracing_subscriber::fmt::layer()<br/> .with_file(is_trace)<br/> .with_line_number(is_trace)<br/> .without_time();<br/> let subscriber = tracing_subscriber::registry().with(logs_layer.with_filter(logs_filter));<br/> tracing::subscriber::set_global_default(subscriber).ok();<br/>}<br/><br/>#[tokio::main]<br/>async fn main() -> ExitCode {<br/> let cli = match cli::post_cli(Cli::parse()) {<br/> Ok(cli) => cli,<br/> Err(err) => {<br/> eprintln!("{err}");<br/> return ExitCode::FAILURE;<br/> }<br/> };<br/><br/> set_log_level(cli.verbosity);<br/><br/> if let Err(err) = cli.run().await {<br/> tracing::error!("{err}");<br/> return err.exit_code();<br/> }<br/><br/> ExitCode::SUCCESS<br/>}<br/>
2026-10-09T01:54:51Zhttps://njump.me/nevent1qqsqfq9rm230ql64uzkrrudtzaxjejcn8dd2y7lqdhr7ujfj4jet3kszyp2xhcyfwmc3jdu98up2074n3zznz6ye259qzdm0pp7qwhqtg2z6j6l3ycw//! A simple command-line tool that calculates and displays the ...
//! A simple command-line tool that calculates and displays the SHA-256 hash of<br/>//! its own source file.<br/>//!<br/>//! This utility demonstrates how to use the `get_file_hash!` macro to obtain<br/>//! the hash of a specified file at compile time and incorporate it into runtime<br/>//! logic.<br/>use get_file_hash::{BUILD_HASH, CARGO_TOML_HASH, LIB_HASH};<br/>use get_file_hash_core::get_file_hash;<br/>use sha2::{Digest, Sha256};<br/><br/>const README_TEMPLATE_PART0: &str = r##"# `get_file_hash` macro<br/><br/>This project provides a Rust procedural macro, `get_file_hash!`, designed to compute the SHA-256 hash of a specified file at compile time. This hash is then embedded directly into your compiled executable. This feature is invaluable for:<br/><br/>* **Integrity Verification:** Ensuring the deployed code hasn't been tampered with.<br/>* **Versioning:** Embedding a unique identifier linked to the exact source code version.<br/>* **Cache Busting:** Generating unique names for assets based on their content.<br/><br/>## Project Structure<br/><br/>* `get_file_hash_core`: A foundational crate containing the `get_file_hash!` macro definition.<br/>* `get_file_hash`: The main library crate that re-exports the macro.<br/>* `src/bin/get_file_hash.rs`: An example executable demonstrating the macro's usage by hashing its own source file and updating this `README.md`.<br/>* `build.rs`: A build script that also utilizes the `get_file_hash!` macro to hash `Cargo.toml` during the build process.<br/><br/>## Usage of `get_file_hash!` Macro<br/><br/>To use the `get_file_hash!` macro, ensure you have `get_file_hash` (or `get_file_hash_core` for direct usage) as a dependency in your `Cargo.toml`.<br/><br/>### Example<br/><br/>```rust<br/>use get_file_hash::get_file_hash;<br/>use get_file_hash::CARGO_TOML_HASH;<br/>use sha2::{Digest, Sha256};<br/><br/>fn main() {<br/> // The macro resolves the path relative to CARGO_MANIFEST_DIR<br/> let readme_hash = get_file_hash!("src/bin/readme.rs");<br/> let lib_hash = get_file_hash!("src/lib.rs");<br/> println!("The SHA-256 hash of src/lib.rs is: {}", lib_hash);<br/> println!("The SHA-256 hash of src/bin/readme.rs is: {}", readme_hash);<br/> println!("The SHA-256 hash of Cargo.toml is: {}", CARGO_TOML_HASH);<br/>}<br/>```<br/><br/>"##;<br/><br/>const README_TEMPLATE_PART1: &str = r"## Release<br/>## [`README.md`](./README.md)<br/><br/>```bash<br/>cargo run --bin readme > README.md<br/>```<br/><br/>## [`src/bin/readme.rs`](src/bin/readme.rs)<br/><br/>* **Target File:** `src/bin/readme.rs`<br/>";<br/><br/>const README_TEMPLATE_PART2: &str = r"##<br/><br/>## [`build.rs`](build.rs)<br/><br/>* **Target File:** `build.rs`<br/>";<br/><br/>const README_TEMPLATE_PART3: &str = r"##<br/><br/>## [`Cargo.toml`](Cargo.toml)<br/><br/>* **Target File:** `Cargo.toml`<br/>";<br/><br/>const README_TEMPLATE_PART4: &str = r"##<br/><br/>## [`src/lib.rs`](src/lib.rs)<br/><br/>* **Target File:** `src/lib.rs`<br/>";<br/><br/>const README_TEMPLATE_PART_NIP34: &str = r"## NIP-34 Integration: Git Repository Events on Nostr<br/><br/>This library provides a set of powerful macros and functions for integrating Git repository events with the Nostr protocol, adhering to the [NIP-34: Git Repositories on Nostr](<a href="https://github.com/nostr-protocol/nips/blob/master/34.md">https://github.com/nostr-protocol/nips/blob/master/34.md</a>) specification.<br/><br/>These tools allow you to publish various Git-related events to Nostr relays, enabling decentralized tracking and collaboration for your code repositories.<br/><br/>### Available NIP-34 Macros<br/><br/>Each macro provides a convenient way to publish specific NIP-34 event kinds:<br/><br/>* [`repository_announcement!`](#repository_announcement)<br/> * Publishes a `Repository Announcement` event (Kind 30617) to announce a new or updated Git repository.<br/>* [`publish_patch!`](#publish_patch)<br/> * Publishes a `Patch` event (Kind 1617) containing a Git patch (diff) for a specific commit.<br/>* [`publish_pull_request!`](#publish_pull_request)<br/> * Publishes a `Pull Request` event (Kind 1618) to propose changes and facilitate code review.<br/>* [`publish_pr_update!`](#publish_pr_update)<br/> * Publishes a `Pull Request Update` event (Kind 1619) to update an existing pull request.<br/>* [`publish_repository_state!`](#publish_repository_state)<br/> * Publishes a `Repository State` event (Kind 1620) to announce the current state of a branch (e.g., its latest commit).<br/>* [`publish_issue!`](#publish_issue)<br/> * Publishes an `Issue` event (Kind 1621) to report bugs, request features, or track tasks.<br/><br/>### Running NIP-34 Examples<br/><br/>To see these macros in action, navigate to the `examples/` directory and run each example individually with the `nostr` feature enabled:<br/><br/>```bash<br/>cargo run --example repository_announcement --features nostr<br/>cargo run --example publish_patch --features nostr<br/>cargo run --example publish_pull_request --features nostr<br/>cargo run --example publish_pr_update --features nostr<br/>cargo run --example publish_repository_state --features nostr<br/>cargo run --example publish_issue --features nostr<br/>```<br/><br/>";<br/><br/>/// The main entry point of the application.<br/>///<br/>/// This function calculates the SHA-256 hash of the `get_file_hash.rs` source<br/>/// file using a custom procedural macro and then prints the hash to the<br/>/// console. It also includes a basic integrity verification check.<br/>fn main() {<br/> // Calculate the SHA-256 hash of the current file (`readme.rs`) at<br/> // compile time. The `get_file_hash!` macro reads the file content and<br/> // computes its hash.<br/> let self_hash = get_file_hash!("readme.rs");<br/><br/> let status_message = if self_hash.starts_with("e3b0") {<br/> "Warning: This hash represents an empty file."<br/> } else {<br/> "Integrity Verified."<br/> };<br/><br/> let build_message = if BUILD_HASH.starts_with("e3b0") {<br/> "Warning: This hash represents an empty file."<br/> } else {<br/> "Integrity Verified."<br/> };<br/> let cargo_message = if CARGO_TOML_HASH.starts_with("e3b0") {<br/> "Warning: This hash represents an empty file."<br/> } else {<br/> "Integrity Verified."<br/> };<br/> let lib_message = if LIB_HASH.starts_with("e3b0") {<br/> "Warning: This hash represents an empty file."<br/> } else {<br/> "Integrity Verified."<br/> };<br/><br/> print!("{}{}{}", README_TEMPLATE_PART0, README_TEMPLATE_PART1, README_TEMPLATE_PART_NIP34);<br/> println!("* **SHA-256 Hash:** {}", self_hash);<br/> println!("* **Status:** {}.\n", status_message);<br/> //<br/> print!("{}", README_TEMPLATE_PART2);<br/> println!("* **SHA-256 Hash:** {}", BUILD_HASH);<br/> println!("* **Status:** {}.\n", build_message);<br/> //<br/> print!("{}", README_TEMPLATE_PART3);<br/> println!("* **SHA-256 Hash:** {}", CARGO_TOML_HASH);<br/> println!("* **Status:** {}.\n", cargo_message);<br/> //<br/> print!("{}", README_TEMPLATE_PART4);<br/> println!("* **SHA-256 Hash:** {}", LIB_HASH);<br/> println!("* **Status:** {}.\n", lib_message);<br/>}<br/>
2026-10-09T01:54:51Zhttps://njump.me/nevent1qqsyxlpcy6np6r0fwjj5dnr56ew6uqvhy3qz03puvthvu3ceneaj8xqzyp2xhcyfwmc3jdu98up2074n3zznz6ye259qzdm0pp7qwhqtg2z6j4u8vzr//! A simple command-line tool that calculates and displays the ...
//! A simple command-line tool that calculates and displays the SHA-256 hash of<br/>//! its own source file.<br/>//!<br/>//! This utility demonstrates how to use the `get_file_hash!` macro to obtain<br/>//! the hash of a specified file at compile time and incorporate it into runtime<br/>//! logic.<br/><br/>use get_file_hash_core::get_file_hash;<br/>use sha2::{Digest, Sha256};<br/><br/>const README_TEMPLATE_PART1: &str = r##"# `get_file_hash` macro<br/><br/>This project provides a Rust procedural macro, `get_file_hash!`, designed to compute the SHA-256 hash of a specified file at compile time. This hash is then embedded directly into your compiled executable. This feature is invaluable for:<br/><br/>* **Integrity Verification:** Ensuring the deployed code hasn't been tampered with.<br/>* **Versioning:** Embedding a unique identifier linked to the exact source code version.<br/>* **Cache Busting:** Generating unique names for assets based on their content.<br/><br/>## Project Structure<br/><br/>* `get_file_hash_core`: A foundational crate containing the `get_file_hash!` macro definition.<br/>* `get_file_hash`: The main library crate that re-exports the macro.<br/>* `src/bin/get_file_hash.rs`: An example executable demonstrating the macro's usage by hashing its own source file and updating this `README.md`.<br/>* `build.rs`: A build script that also utilizes the `get_file_hash!` macro to hash `Cargo.toml` during the build process.<br/><br/>## Usage of `get_file_hash!` Macro<br/><br/>To use the `get_file_hash!` macro, ensure you have `get_file_hash` (or `get_file_hash_core` for direct usage) as a dependency in your `Cargo.toml`.<br/><br/>### Example<br/><br/>```rust<br/>use get_file_hash::get_file_hash;<br/>use sha2::{Digest, Sha256};<br/><br/>fn main() {<br/> // The macro resolves the path relative to CARGO_MANIFEST_DIR<br/> let file_hash = get_file_hash!("src/lib.rs");<br/> println!("The SHA-256 hash of src/lib.rs is: {}", file_hash);<br/>}<br/>```<br/><br/>"##;<br/><br/>const README_TEMPLATE_PART2: &str = r"## Setup and Building<br/><br/>1. **Clone the repository:**<br/> ```bash<br/> git clone <repository-url><br/> cd <repository-name><br/> ```<br/>2. **Build the project:**<br/> ```bash<br/> cargo build<br/> ```<br/> During the build, `build.rs` will execute and print the hash of `Cargo.toml`.<br/>3. **Run the example executable:**<br/> ```bash<br/> cargo run --bin get_file_hash<br/> ```<br/> This will print the hash of `src/bin/get_file_hash.rs` to your console.<br/><br/>## Updating this `README.md`<br/><br/>The hash information in this `README.md` is automatically generated by running the example executable.<br/>To update it, execute:<br/><br/>```bash<br/>cargo run --bin get_file_hash > README.md<br/>```<br/><br/>## Current File Hash Information (of `src/bin/get_file_hash.rs`)<br/><br/>* **Target File:** `src/bin/get_file_hash.rs`<br/>";<br/><br/>/// The main entry point of the application.<br/>///<br/>/// This function calculates the SHA-256 hash of the `get_file_hash.rs` source<br/>/// file using a custom procedural macro and then prints the hash to the<br/>/// console. It also includes a basic integrity verification check.<br/>fn main() {<br/> // Calculate the SHA-256 hash of the current file (`get_file_hash.rs`) at<br/> // compile time. The `get_file_hash!` macro reads the file content and<br/> // computes its hash.<br/> let self_hash = get_file_hash!("get_file_hash.rs");<br/><br/> let status_message = if self_hash.starts_with("e3b0") {<br/> "Warning: This hash represents an empty file."<br/> } else {<br/> "Integrity Verified."<br/> };<br/><br/> print!("{}{}", README_TEMPLATE_PART1, README_TEMPLATE_PART2);<br/> println!("* **SHA-256 Hash:** `{}`", self_hash);<br/> println!("* **Status:** {}.\n", status_message);<br/>}<br/>
2026-10-09T01:54:50Zhttps://njump.me/nevent1qqsve37cjq03pl2fm700zvyl9lkdfjwh97jk8n9v30awucfmhephf6qzyp2xhcyfwmc3jdu98up2074n3zznz6ye259qzdm0pp7qwhqtg2z6jg6n3ae<?xml version='1.0' ...
<?xml version='1.0' encoding='windows-1252'?>
<br/><!--
<br/> Copyright (C) 2017 Christopher R. Field.
<br/>
<br/> Licensed under the Apache License, Version 2.0 (the "License");
<br/> you may not use this file except in compliance with the License.
<br/> You may obtain a copy of the License at
<br/>
<br/> <a href="http://www.apache.org/licenses/LICENSE-2.0">http://www.apache.org/licenses/LICENSE-2.0</a>
<br/>
<br/> Unless required by applicable law or agreed to in writing, software
<br/> distributed under the License is distributed on an "AS IS" BASIS,
<br/> WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
<br/> See the License for the specific language governing permissions and
<br/> limitations under the License.
<br/>-->
<br/>
<br/><!--
<br/> The "cargo wix" subcommand provides a variety of predefined variables available
<br/> for customization of this template. The values for each variable are set at
<br/> installer creation time. The following variables are available:
<br/>
<br/> TargetTriple = The rustc target triple name.
<br/> TargetEnv = The rustc target environment. This is typically either
<br/> "msvc" or "gnu" depending on the toolchain downloaded and
<br/> installed.
<br/> TargetVendor = The rustc target vendor. This is typically "pc", but Rust
<br/> does support other vendors, like "uwp".
<br/> CargoTargetBinDir = The complete path to the directory containing the
<br/> binaries (exes) to include. The default would be
<br/> "target\release\". If an explicit rustc target triple is
<br/> used, i.e. cross-compiling, then the default path would
<br/> be "target\<CARGO_TARGET>\<CARGO_PROFILE>",
<br/> where "<CARGO_TARGET>" is replaced with the "CargoTarget"
<br/> variable value and "<CARGO_PROFILE>" is replaced with the
<br/> value from the "CargoProfile" variable. This can also
<br/> be overridden manually with the "target-bin-dir" flag.
<br/> CargoTargetDir = The path to the directory for the build artifacts, i.e.
<br/> "target".
<br/> CargoProfile = The cargo profile used to build the binaries
<br/> (usually "debug" or "release").
<br/> Version = The version for the installer. The default is the
<br/> "Major.Minor.Fix" semantic versioning number of the Rust
<br/> package.
<br/>-->
<br/>
<br/><!--
<br/> Please do not remove these pre-processor If-Else blocks. These are used with
<br/> the `cargo wix` subcommand to automatically determine the installation
<br/> destination for 32-bit versus 64-bit installers. Removal of these lines will
<br/> cause installation errors.
<br/>-->
<br/><?if $(sys.BUILDARCH) = x64 or $(sys.BUILDARCH) = arm64 ?>
<br/> <?define PlatformProgramFilesFolder = "ProgramFiles64Folder" ?>
<br/><?else ?>
<br/> <?define PlatformProgramFilesFolder = "ProgramFilesFolder" ?>
<br/><?endif ?>
<br/>
<br/><Wix xmlns='<a href="http://schemas.microsoft.com/wix/2006/wi'>">http://schemas.microsoft.com/wix/2006/wi'></a>;
<br/>
<br/> <Product
<br/> Id='*'
<br/> Name='n34'
<br/> UpgradeCode='5E8926D0-4A18-48E9-A070-AFB0F698F04C'
<br/> Manufacturer='Awiteb'
<br/> Language='1033'
<br/> Codepage='1252'
<br/> Version='$(var.Version)'>
<br/>
<br/> <Package Id='*'
<br/> Keywords='Installer'
<br/> Description='A CLI to interact with NIP-34 and other stuff related to code in Nostr'
<br/> Manufacturer='Awiteb'
<br/> InstallerVersion='450'
<br/> Languages='1033'
<br/> Compressed='yes'
<br/> InstallScope='perMachine'
<br/> SummaryCodepage='1252'
<br/> />
<br/>
<br/> <MajorUpgrade
<br/> Schedule='afterInstallInitialize'
<br/> DowngradeErrorMessage='A newer version of [ProductName] is already installed. Setup will now exit.'/>
<br/>
<br/> <Media Id='1' Cabinet='media1.cab' EmbedCab='yes' DiskPrompt='CD-ROM #1'/>
<br/> <Property Id='DiskPrompt' Value='n34 Installation'/>
<br/>
<br/> <Directory Id='TARGETDIR' Name='SourceDir'>
<br/> <Directory Id='$(var.PlatformProgramFilesFolder)' Name='PFiles'>
<br/> <Directory Id='APPLICATIONFOLDER' Name='n34'>
<br/>
<br/> <!--
<br/> Enabling the license sidecar file in the installer is a four step process:
<br/>
<br/> 1. Uncomment the `Component` tag and its contents.
<br/> 2. Change the value for the `Source` attribute in the `File` tag to a path
<br/> to the file that should be included as the license sidecar file. The path
<br/> can, and probably should be, relative to this file.
<br/> 3. Change the value for the `Name` attribute in the `File` tag to the
<br/> desired name for the file when it is installed alongside the `bin` folder
<br/> in the installation directory. This can be omitted if the desired name is
<br/> the same as the file name.
<br/> 4. Uncomment the `ComponentRef` tag with the Id attribute value of "License"
<br/> further down in this file.
<br/> -->
<br/> <!--
<br/> <Component Id='License' Guid='*'>
<br/> <File Id='LicenseFile' Name='ChangeMe' DiskId='1' Source='C:\Path\To\File' KeyPath='yes'/>
<br/> </Component>
<br/> -->
<br/>
<br/> <Directory Id='Bin' Name='bin'>
<br/> <Component Id='Path' Guid='7A2E5F6A-FC23-498B-AEC1-5FA63678FBFD' KeyPath='yes'>
<br/> <Environment
<br/> Id='PATH'
<br/> Name='PATH'
<br/> Value='[Bin]'
<br/> Permanent='no'
<br/> Part='last'
<br/> Action='set'
<br/> System='yes'/>
<br/> </Component>
<br/> <Component Id='binary0' Guid='*'>
<br/> <File
<br/> Id='exe0'
<br/> Name='n34-cli.exe'
<br/> DiskId='1'
<br/> Source='$(var.CargoTargetBinDir)\n34-cli.exe'
<br/> KeyPath='yes'/>
<br/> </Component>
<br/> </Directory>
<br/> </Directory>
<br/> </Directory>
<br/> </Directory>
<br/>
<br/> <Feature
<br/> Id='Binaries'
<br/> Title='Application'
<br/> Description='Installs all binaries and the license.'
<br/> Level='1'
<br/> ConfigurableDirectory='APPLICATIONFOLDER'
<br/> AllowAdvertise='no'
<br/> Display='expand'
<br/> Absent='disallow'>
<br/>
<br/> <!--
<br/> Uncomment the following `ComponentRef` tag to add the license
<br/> sidecar file to the installer.
<br/> -->
<br/> <!--<ComponentRef Id='License'/>-->
<br/>
<br/> <ComponentRef Id='binary0'/>
<br/>
<br/> <Feature
<br/> Id='Environment'
<br/> Title='PATH Environment Variable'
<br/> Description='Add the install location of the [ProductName] executable to the PATH system environment variable. This allows the [ProductName] executable to be called from any location.'
<br/> Level='1'
<br/> Absent='allow'>
<br/> <ComponentRef Id='Path'/>
<br/> </Feature>
<br/> </Feature>
<br/>
<br/> <SetProperty Id='ARPINSTALLLOCATION' Value='[APPLICATIONFOLDER]' After='CostFinalize'/>
<br/>
<br/>
<br/> <!--
<br/> Uncomment the following `Icon` and `Property` tags to change the product icon.
<br/>
<br/> The product icon is the graphic that appears in the Add/Remove
<br/> Programs control panel for the application.
<br/> -->
<br/> <!--<Icon Id='ProductICO' SourceFile='wix\Product.ico'/>-->
<br/> <!--<Property Id='ARPPRODUCTICON' Value='ProductICO' />-->
<br/>
<br/> <Property Id='ARPHELPLINK' Value='<a href="https://n34.dev/commands.html'/>">https://n34.dev/commands.html'/></a>;
<br/>
<br/> <UI>
<br/> <UIRef Id='WixUI_FeatureTree'/>
<br/>
<br/> <!--
<br/> Enabling the EULA dialog in the installer is a three step process:
<br/>
<br/> 1. Comment out or remove the two `Publish` tags that follow the
<br/> `WixVariable` tag.
<br/> 2. Uncomment the `<WixVariable Id='WixUILicenseRtf' Value='Path\to\Eula.rft'>` tag further down
<br/> 3. Replace the `Value` attribute of the `WixVariable` tag with
<br/> the path to a RTF file that will be used as the EULA and
<br/> displayed in the license agreement dialog.
<br/> -->
<br/> <Publish Dialog='WelcomeDlg' Control='Next' Event='NewDialog' Value='CustomizeDlg' Order='99'>1</Publish>
<br/> <Publish Dialog='CustomizeDlg' Control='Back' Event='NewDialog' Value='WelcomeDlg' Order='99'>1</Publish>
<br/>
<br/> </UI>
<br/>
<br/>
<br/> <!--
<br/> Enabling the EULA dialog in the installer requires uncommenting
<br/> the following `WixUILicenseRTF` tag and changing the `Value`
<br/> attribute.
<br/> -->
<br/> <!-- <WixVariable Id='WixUILicenseRtf' Value='Relative\Path\to\Eula.rtf'/> -->
<br/>
<br/>
<br/> <!--
<br/> Uncomment the next `WixVariable` tag to customize the installer's
<br/> Graphical User Interface (GUI) and add a custom banner image across
<br/> the top of each screen. See the WiX Toolset documentation for details
<br/> about customization.
<br/>
<br/> The banner BMP dimensions are 493 x 58 pixels.
<br/> -->
<br/> <!--<WixVariable Id='WixUIBannerBmp' Value='wix\Banner.bmp'/>-->
<br/>
<br/>
<br/> <!--
<br/> Uncomment the next `WixVariable` tag to customize the installer's
<br/> Graphical User Interface (GUI) and add a custom image to the first
<br/> dialog, or screen. See the WiX Toolset documentation for details about
<br/> customization.
<br/>
<br/> The dialog BMP dimensions are 493 x 312 pixels.
<br/> -->
<br/> <!--<WixVariable Id='WixUIDialogBmp' Value='wix\Dialog.bmp'/>-->
<br/>
<br/> </Product>
<br/>
<br/></Wix>
<br/>
2026-10-09T01:54:49Zhttps://njump.me/nevent1qqs9v656ed7gnde2ln5adm26juny6jz3f386p526k3aeefee8m7cl8czyp2xhcyfwmc3jdu98up2074n3zznz6ye259qzdm0pp7qwhqtg2z6j2xh2he// n34 - A CLI to interact with NIP-34 and other stuff related to ...
// n34 - A CLI to interact with NIP-34 and other stuff related to codes in nostr<br/>// Copyright (C) 2025 Awiteb <a@4rs.nl><br/>//<br/>// This program is free software: you can redistribute it and/or modify<br/>// it under the terms of the GNU General Public License as published by<br/>// the Free Software Foundation, either version 3 of the License, or<br/>// (at your option) any later version.<br/>//<br/>// This program is distributed in the hope that it will be useful,<br/>// but WITHOUT ANY WARRANTY; without even the implied warranty of<br/>// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the<br/>// GNU General Public License for more details.<br/>//<br/>// You should have received a copy of the GNU General Public License<br/>// along with this program. If not, see <<a href="https://gnu.org/licenses/gpl-3.0.html>">https://gnu.org/licenses/gpl-3.0.html></a>;.<br/><br/>use convert_case::{Case, Casing};<br/>use nostr::hashes::sha1::Hash as Sha1Hash;<br/>use nostr::{<br/> event::{Event, EventBuilder, EventId, Kind, Tag, TagKind, TagStandard, Tags},<br/> key::PublicKey,<br/> nips::{<br/> nip01::Coordinate,<br/> nip19::Nip19Coordinate,<br/> nip21::Nip21,<br/> nip34::{GitIssue, GitRepositoryAnnouncement},<br/> },<br/> parser::Token,<br/> types::{RelayUrl, Url},<br/>};<br/>use nostr_keyring::KeyringError;<br/><br/>use crate::cli::issue::ISSUE_ALT_PREFIX;<br/>use crate::cli::patch::{<br/> LEGACY_NGIT_REVISION_ROOT_HASHTAG_CONTENT,<br/> REVISION_ROOT_HASHTAG_CONTENT,<br/> ROOT_HASHTAG_CONTENT,<br/>};<br/>use crate::error::{N34Error, N34Result};<br/><br/><br/>/// A trait to add helper instance function to [`Tags`] type<br/>#[easy_ext::ext(TagsExt)]<br/>impl Tags {<br/> /// Search for the given tag and map it value to a function<br/> #[inline]<br/> pub fn map_tag<T>(&self, kind: TagKind, f: impl FnOnce(&TagStandard) -> T) -> Option<T> {<br/> self.find_standardized(kind).map(f)<br/> }<br/><br/> /// Search for the given tag and map it value to a function. If the tag not<br/> /// found return the default `T`<br/> #[inline]<br/> pub fn dmap_tag<T>(&self, kind: TagKind, f: impl FnOnce(&TagStandard) -> T) -> T<br/> where<br/> T: Default,<br/> {<br/> self.map_tag(kind, f).unwrap_or_default()<br/> }<br/><br/> /// Finds the first standard tag of the given kind with the specified<br/> /// marker, then applies the function to the tag and returns the result.<br/> #[inline]<br/> pub fn map_marker<T>(<br/> &self,<br/> kind: TagKind,<br/> marker: &str,<br/> f: impl FnOnce(&TagStandard) -> T,<br/> ) -> Option<T> {<br/> self.filter_standardized(kind)<br/> .find(|t| (*t).clone().to_vec().last().is_some_and(|m| m == marker))<br/> .map(f)<br/> }<br/>}<br/><br/>/// Trait for building [`GitRepositoryAnnouncement`] events<br/>#[easy_ext::ext(NewGitRepositoryAnnouncement)]<br/>impl EventBuilder {<br/> /// Creates a new [`GitRepositoryAnnouncement`] event builder with the given<br/> /// repository details.<br/> #[allow(clippy::too_many_arguments)]<br/> pub fn new_git_repo(<br/> repo_id: String,<br/> name: Option<String>,<br/> description: Option<String>,<br/> web: Vec<Url>,<br/> clone: Vec<Url>,<br/> relays: Vec<RelayUrl>,<br/> maintainers: Vec<PublicKey>,<br/> labels: Vec<String>,<br/> force_id: bool,<br/> ) -> N34Result<EventBuilder> {<br/> let repo_id = repo_id.trim();<br/> let kebab_repo_id = repo_id.to_case(Case::Kebab);<br/> if repo_id.is_empty() || (!force_id && repo_id != kebab_repo_id) {<br/> if repo_id != kebab_repo_id {<br/> tracing::error!(<br/> "The repo id should be `{kebab_repo_id}` (kebab-case). Use `--force-id` to \<br/> override this check"<br/> );<br/> }<br/> return Err(N34Error::InvalidRepoId);<br/> }<br/><br/> Ok(<br/> EventBuilder::git_repository_announcement(GitRepositoryAnnouncement {<br/> id: repo_id.to_owned(),<br/> name,<br/> description,<br/> web,<br/> clone,<br/> relays,<br/> euc: None,<br/> maintainers,<br/> })?<br/> .dedup_tags()<br/> .tags(labels.into_iter().map(Tag::hashtag)),<br/> )<br/> }<br/><br/> /// Creates a new [`GitIssue`] event builder with the given<br/> /// issue details.<br/> pub fn new_git_issue(<br/> coordinates: &[Coordinate],<br/> content: String,<br/> subject: Option<String>,<br/> labels: Vec<String>,<br/> ) -> N34Result<EventBuilder> {<br/> let mut coordinates = coordinates.iter();<br/> let first_coordinate = coordinates.next().ok_or(N34Error::EmptyNaddrs)?;<br/><br/> let mut event_builder = EventBuilder::git_issue(GitIssue {<br/> repository: first_coordinate.clone(),<br/> content,<br/> subject: subject.clone(),<br/> labels: labels.into_iter().map(|l| l.trim().to_owned()).collect(),<br/> })<br/> .map_err(N34Error::from)?<br/> .tags(<br/> coordinates<br/> .clone()<br/> .map(|c| Tag::coordinate(c.clone(), None)),<br/> )<br/> .tags(coordinates.map(|c| Tag::public_key(c.public_key)));<br/><br/> if let Some(issue_subject) = subject {<br/> event_builder =<br/> event_builder.tag(Tag::alt(format!("{ISSUE_ALT_PREFIX}{issue_subject}")))<br/> }<br/><br/> Ok(event_builder)<br/> }<br/>}<br/><br/>/// Helper functions for [`Token`] type<br/>#[easy_ext::ext(TokenUtils)]<br/>impl Token<'_> {<br/> /// Returns `Some((public_key, relays))` from the givin token if it's npub1<br/> /// or nprofile1<br/> #[inline]<br/> pub fn extract_public_key(&self) -> Option<(PublicKey, Vec<RelayUrl>)> {<br/> match self {<br/> Token::Nostr(nip21) => {<br/> match nip21 {<br/> Nip21::Pubkey(pkey) => Some((*pkey, Vec::new())),<br/> Nip21::Profile(profile) => Some((profile.public_key, profile.relays.clone())),<br/> _ => None,<br/> }<br/> }<br/> _ => None,<br/> }<br/> }<br/><br/> /// Returns `Some((note_id, relays))` from the givin token if it's note1 or<br/> /// nevent1<br/> #[inline]<br/> pub fn extract_event_id(&self) -> Option<(EventId, Vec<RelayUrl>)> {<br/> match self {<br/> Token::Nostr(nip21) => {<br/> match nip21 {<br/> Nip21::EventId(event_id) => Some((*event_id, Vec::new())),<br/> Nip21::Event(event) => Some((event.event_id, event.relays.clone())),<br/> _ => None,<br/> }<br/> }<br/> _ => None,<br/> }<br/> }<br/><br/> /// Returns `Some(hashtag)` from the givin token if it's a hashtag<br/> #[inline]<br/> pub fn extract_hashtag(&self) -> Option<String> {<br/> match self {<br/> Token::Hashtag(tag) => Some(tag.trim().to_owned()),<br/> _ => None,<br/> }<br/> }<br/>}<br/><br/>/// Utility functions for working with lists of NIP-19 coordinates<br/>#[easy_ext::ext(NaddrsUtils)]<br/>impl Vec<Nip19Coordinate> {<br/> /// Converts these coordinate addresses to basic coordinates<br/> #[inline]<br/> pub fn into_coordinates(self) -> Vec<Coordinate> {<br/> self.into_iter().map(|n| n.coordinate).collect()<br/> }<br/><br/> /// Returns all repository owners' public keys from these coordinates.<br/> #[inline]<br/> pub fn extract_owners(&self) -> Vec<PublicKey> {<br/> self.iter().map(|n| n.public_key).collect()<br/> }<br/><br/> /// Extracts all relay URLs from these coordinates<br/> #[inline]<br/> pub fn extract_relays(&self) -> Vec<RelayUrl> {<br/> self.iter().flat_map(|n| n.relays.clone()).collect()<br/> }<br/>}<br/><br/>/// Utility functions for working with lists of repository announcement<br/>#[easy_ext::ext(ReposUtils)]<br/>impl Vec<GitRepositoryAnnouncement> {<br/> /// Extracts all relay URLs from these repositories<br/> #[inline]<br/> pub fn extract_relays(&self) -> Vec<RelayUrl> {<br/> self.iter().flat_map(|n| n.relays.clone()).collect()<br/> }<br/><br/> /// Extract all the maintainers from these repositories<br/> #[inline]<br/> pub fn extract_maintainers(&self) -> Vec<PublicKey> {<br/> self.iter().flat_map(|r| r.maintainers.clone()).collect()<br/> }<br/><br/> /// Gets the first EUC hash from the reposotoies if it exists.<br/> #[inline]<br/> pub fn extract_euc(&self) -> Option<&Sha1Hash> {<br/> self.iter().find_map(|r| r.euc.as_ref())<br/> }<br/>}<br/><br/>/// Utility functions for working with patch events<br/>#[easy_ext::ext(GitPatchUtils)]<br/>impl Event {<br/> /// Returns whether the patch is a root or not<br/> #[inline]<br/> pub fn is_root_patch(&self) -> bool {<br/> self.kind == Kind::GitPatch<br/> && self<br/> .tags<br/> .filter(TagKind::t())<br/> .any(|t| t.content() == Some(ROOT_HASHTAG_CONTENT))<br/> }<br/><br/> /// Returns whether the patch is patch-revision or not<br/> #[inline]<br/> pub fn is_revision_patch(&self) -> bool {<br/> self.kind == Kind::GitPatch<br/> && self.tags.filter(TagKind::t()).any(|t| {<br/> [<br/> Some(REVISION_ROOT_HASHTAG_CONTENT),<br/> Some(LEGACY_NGIT_REVISION_ROOT_HASHTAG_CONTENT),<br/> ]<br/> .contains(&t.content())<br/> })<br/> }<br/><br/> /// Gets the root patch ID from a patch-revision event by finding the `e`<br/> /// tag that replies to it. Fails if no such tag is found or if the tag<br/> /// contains an invalid event ID.<br/> pub fn root_patch_from_revision(&self) -> N34Result<EventId> {<br/> self.tags<br/> .iter()<br/> .find(|tag| tag.is_reply())<br/> .ok_or_else(|| {<br/> N34Error::InvalidEvent(<br/> "A patch revision without `e`-reply to the root patch".to_owned(),<br/> )<br/> })?<br/> .content()<br/> .ok_or_else(|| N34Error::InvalidEvent("`e` tag without an event".to_owned()))?<br/> .parse()<br/> .map_err(|err| N34Error::InvalidEvent(format!("Invalid event ID in `e` tag: {err}")))<br/> }<br/>}<br/><br/>/// Utility functions for working with issue events<br/>#[easy_ext::ext(GitIssueUtils)]<br/>impl Event {<br/> /// Gets the subject line of the issue or "N/A" if none exists<br/> #[inline]<br/> pub fn extract_issue_subject(&self) -> &str {<br/> self.tags<br/> .find(TagKind::Subject)<br/> .and_then(|t| t.content())<br/> .unwrap_or("N/A")<br/> }<br/><br/> /// Gets all issue labels formatted as comma-separated hashtags (e.g. "#bug,<br/> /// #feature")<br/> #[inline]<br/> pub fn extract_issue_labels(&self) -> String {<br/> self.tags<br/> .filter(TagKind::t())<br/> .filter_map(|t| t.content().map(|l| format!("#{l}")))<br/> .collect::<Vec<_>>()<br/> .join(", ")<br/> }<br/>}<br/><br/>#[easy_ext::ext(NostrKeyringErrorUtils)]<br/>impl nostr_keyring::Error {<br/> /// Checks if the error indicates a missing keyring entry.<br/> #[inline]<br/> pub fn is_keyring_no_entry(&self) -> bool {<br/> matches!(self, nostr_keyring::Error::Keyring(KeyringError::NoEntry))<br/> }<br/>}<br/>
2026-10-09T01:54:49Zhttps://njump.me/nevent1qqsycn5sn6327dw99v06uym38sr6p5k7unpuhgj3jawgc3s560quhcqzyp2xhcyfwmc3jdu98up2074n3zznz6ye259qzdm0pp7qwhqtg2z6j3j77a9// n34 - A CLI to interact with NIP-34 and other stuff related to ...
// n34 - A CLI to interact with NIP-34 and other stuff related to codes in nostr<br/>// Copyright (C) 2025 Awiteb <a@4rs.nl><br/>//<br/>// This program is free software: you can redistribute it and/or modify<br/>// it under the terms of the GNU General Public License as published by<br/>// the Free Software Foundation, either version 3 of the License, or<br/>// (at your option) any later version.<br/>//<br/>// This program is distributed in the hope that it will be useful,<br/>// but WITHOUT ANY WARRANTY; without even the implied warranty of<br/>// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the<br/>// GNU General Public License for more details.<br/>//<br/>// You should have received a copy of the GNU General Public License<br/>// along with this program. If not, see <<a href="https://gnu.org/licenses/gpl-3.0.html>">https://gnu.org/licenses/gpl-3.0.html></a>;.<br/><br/>use std::{<br/> fmt,<br/> fs,<br/> path::{Path, PathBuf},<br/> str::FromStr,<br/> sync::atomic::Ordering,<br/>};<br/><br/>use nostr::{<br/> event::{Event, EventId, Kind, Tag, TagKind, TagStandard},<br/> filter::Alphabet,<br/> key::PublicKey,<br/> nips::{<br/> nip01::Coordinate,<br/> nip10::Marker,<br/> nip19::{Nip19Coordinate, Nip19Event, ToBech32},<br/> nip34::GitRepositoryAnnouncement,<br/> nip65::{self, RelayMetadata},<br/> },<br/> types::RelayUrl,<br/>};<br/><br/>use super::traits::TagsExt;<br/>use crate::{<br/> cli::{NOSTR_ADDRESS_FILE, parsers},<br/> error::{N34Error, N34Result},<br/>};<br/><br/>/// Returns the value of the given tag<br/>#[inline]<br/>fn tag_value(tag: &TagStandard) -> String {<br/> tag.clone().to_vec().remove(1)<br/>}<br/><br/>/// Parses the tag value into type `T` if possible.<br/>#[inline]<br/>fn parse_value<T: FromStr>(tag: &TagStandard) -> Option<T> {<br/> tag_value(tag).parse().ok()<br/>}<br/><br/>/// Gets all values from the tag. If any value fails to parse, returns an empty<br/>/// vector.<br/>#[inline]<br/>fn tag_values<T>(tag: &TagStandard) -> Vec<T><br/>where<br/> T: FromStr + fmt::Debug,<br/> <T as FromStr>::Err: fmt::Debug,<br/>{<br/> tag.clone()<br/> .to_vec()<br/> .into_iter()<br/> .skip(1)<br/> .map(|t| {<br/> let result = T::from_str(t.as_str());<br/> tracing::trace!("Parsing `{t}` result: `{result:?}`");<br/> result<br/> })<br/> .collect::<Result<_, _>>()<br/> .unwrap_or_default()<br/>}<br/><br/>/// Convert [`Event`] to [`GitRepositoryAnnouncement`]<br/>pub fn event_into_repo(event: Event, repo_id: impl Into<String>) -> GitRepositoryAnnouncement {<br/> let tags = &event.tags;<br/><br/> GitRepositoryAnnouncement {<br/> id: repo_id.into(),<br/> name: tags.map_tag(TagKind::Name, tag_value),<br/> description: tags.map_tag(TagKind::Description, tag_value),<br/> euc: tags<br/> .map_marker(<br/> TagKind::single_letter(Alphabet::R, false),<br/> "euc",<br/> parse_value,<br/> )<br/> .flatten(),<br/> web: tags.dmap_tag(TagKind::Web, tag_values),<br/> clone: tags.dmap_tag(TagKind::Clone, tag_values),<br/> relays: tags.dmap_tag(TagKind::Relays, tag_values),<br/> maintainers: tags.dmap_tag(TagKind::Maintainers, tag_values),<br/> }<br/>}<br/><br/>/// Returns a new string with leading and trailing whitespace removed.<br/>pub fn str_trim(s: String) -> String {<br/> s.trim().to_owned()<br/>}<br/><br/>/// Returns a vector with duplicate elements removed.<br/>pub fn dedup<I, T>(iter: I) -> Vec<T><br/>where<br/> T: std::cmp::Ord,<br/> I: Iterator<Item = T>,<br/>{<br/> let mut vector: Vec<T> = iter.collect();<br/> vector.sort_unstable();<br/> vector.dedup();<br/> vector<br/>}<br/><br/>/// Sorts items from the iterator using the given key function.<br/>/// The sorting is unstable, but faster than stable sorting.<br/>pub fn sort_by_key<I, T, K>(iterator: I, key: impl FnMut(&T) -> K) -> impl Iterator<Item = T><br/>where<br/> I: IntoIterator<Item = T>,<br/> K: Ord,<br/>{<br/> let mut vector = Vec::<T>::from_iter(iterator);<br/> vector.sort_unstable_by_key(key);<br/> vector.into_iter()<br/>}<br/><br/>/// Creates a new NIP-19 nevent string from an event ID and up to 3 unique relay<br/>/// URLs.<br/>#[inline]<br/>pub fn new_nevent(event_id: EventId, relays: &[RelayUrl]) -> N34Result<String> {<br/> Nip19Event::new(event_id)<br/> .relays(<br/> dedup(relays.iter().cloned())<br/> .into_iter()<br/> .take(3)<br/> .collect::<Vec<_>>(),<br/> )<br/> .to_bech32()<br/> .map_err(N34Error::from)<br/>}<br/><br/>/// Creates a NIP-19 naddr string for a git repository announcement and up to 3<br/>/// unique relay URLs.<br/>#[inline]<br/>pub fn repo_naddr(<br/> repo_id: impl Into<String>,<br/> pubk: PublicKey,<br/> relays: &[RelayUrl],<br/>) -> N34Result<String> {<br/> Nip19Coordinate::new(<br/> Coordinate::new(Kind::GitRepoAnnouncement, pubk).identifier(repo_id),<br/> dedup(relays.iter().cloned()).into_iter().take(3),<br/> )<br/> .to_bech32()<br/> .map_err(N34Error::from)<br/>}<br/><br/>/// Extracts write relay URLs from an event if present, otherwise returns an<br/>/// empty vector.<br/>pub fn add_write_relays(event: Option<&Event>) -> Vec<RelayUrl> {<br/> let mut vector = Vec::new();<br/> if let Some(event) = event {<br/> vector.extend(<br/> nip65::extract_owned_relay_list(event.clone())<br/> .filter_map(|(r, m)| m.is_none_or(|m| m == RelayMetadata::Write).then_some(r)),<br/> );<br/> }<br/> vector<br/>}<br/><br/>/// Extracts read relay URLs from an event if present, otherwise returns an<br/>/// empty vector.<br/>pub fn add_read_relays(event: Option<&Event>) -> Vec<RelayUrl> {<br/> let mut vector = Vec::new();<br/> if let Some(event) = event {<br/> vector.extend(<br/> nip65::extract_owned_relay_list(event.clone())<br/> .filter_map(|(r, m)| m.is_none_or(|m| m == RelayMetadata::Read).then_some(r)),<br/> );<br/> }<br/> vector<br/>}<br/><br/><br/>/// Opens the user's default editor ($EDITOR) to edit a temporary file with<br/>/// given suffix, then reads and returns the file contents. The temporary file<br/>/// is automatically deleted.<br/>pub fn read_editor(file_pre_content: Option<&str>, file_suffix: &str) -> N34Result<String> {<br/> let Ok(editor) = std::env::var("EDITOR") else {<br/> return Err(N34Error::EditorNotFound);<br/> };<br/><br/> let temp_path = tempfile::NamedTempFile::with_suffix(file_suffix)?.into_temp_path();<br/><br/> if let Some(pre_content) = file_pre_content {<br/> fs::write(&temp_path, pre_content)?;<br/> }<br/><br/> // Disable the logs to not show up in a terminal text editor<br/> crate::EDITOR_OPEN.store(true, Ordering::Relaxed);<br/> let exit_status = std::process::Command::new(&editor)<br/> .arg(temp_path.to_str().expect("The path is valid utf8"))<br/> .spawn()?<br/> .wait()?;<br/> crate::EDITOR_OPEN.store(false, Ordering::Relaxed);<br/><br/> if !exit_status.success()<br/> && let Some(code) = exit_status.code()<br/> {<br/> return Err(N34Error::EditorErr(editor, code));<br/> }<br/><br/> let content = fs::read_to_string(&temp_path)<br/> .map_err(N34Error::from)?<br/> .trim()<br/> .to_owned();<br/><br/> if content.is_empty() {<br/> return Err(N34Error::EmptyEditorFile);<br/> }<br/> Ok(content)<br/>}<br/><br/>/// Returns the given content if it's `Option::Some` or call [`read_editor`]<br/>pub fn get_content(<br/> content: Option<impl AsRef<str>>,<br/> quoted_content: Option<impl AsRef<str>>,<br/> file_suffix: &str,<br/>) -> N34Result<String> {<br/> if let Some(content) = content {<br/> return Ok(content.as_ref().trim().to_owned());<br/> }<br/> read_editor(<br/> quoted_content.map(|s| s.as_ref().to_owned()).as_deref(),<br/> file_suffix,<br/> )<br/>}<br/><br/>/// Path to the `nostr-address` file in current directory.<br/>#[inline]<br/>pub fn nostr_address_path() -> std::io::Result<PathBuf> {<br/> std::env::current_dir().map(|p| p.join(NOSTR_ADDRESS_FILE))<br/>}<br/><br/>/// Returns the given coordinates if Some, otherwise attempts to read and parse<br/>/// coordinates from the specified file. Returns an empty vector if the file<br/>/// doesn't exist.<br/>pub fn naddrs_or_file(<br/> naddrs: Option<Vec<Nip19Coordinate>>,<br/> address_file_path: &Path,<br/>) -> N34Result<Vec<Nip19Coordinate>> {<br/> if let Some(naddrs) = naddrs {<br/> return Ok(naddrs);<br/> }<br/><br/> if address_file_path.exists() {<br/> parsers::parse_nostr_address_file(address_file_path)<br/> } else {<br/> Ok(Vec::new())<br/> }<br/>}<br/><br/>/// Generate a reply tag for an event with the given ID, relay URL (if any), and<br/>/// marker.<br/>#[inline]<br/>pub fn event_reply_tag(reply_to: &EventId, relay: Option<&RelayUrl>, marker: Marker) -> Tag {<br/> Tag::custom(<br/> TagKind::e(),<br/> [<br/> reply_to.to_hex(),<br/> relay.map(|r| r.to_string()).unwrap_or_default(),<br/> marker.to_string(),<br/> ],<br/> )<br/>}<br/><br/>/// Wraps text into lines no longer than max_width, breaking only at whitespace.<br/>pub fn smart_wrap(text: &str, max_width: usize) -> String {<br/> text.lines()<br/> .map(|line| {<br/> if !line.trim().is_empty() {<br/> line.split(" ")<br/> .fold((String::new(), 0), |(result, last_newline), word| {<br/> let result_len = result.chars().count();<br/> if result_len == 0 {<br/> (word.to_owned(), 0)<br/> } else if (result_len - last_newline) + word.chars().count() > max_width {<br/> (format!("{result}\n{word}"), result_len + 1)<br/> } else {<br/> (format!("{result} {word}"), last_newline)<br/> }<br/> })<br/> .0<br/> } else {<br/> String::new()<br/> }<br/> })<br/> .collect::<Vec<_>>()<br/> .join("\n")<br/>}<br/><br/>/// Returns an error if the given naddrs is empty otherwise returned it<br/>pub fn check_empty_naddrs(naddrs: Vec<Nip19Coordinate>) -> N34Result<Vec<Nip19Coordinate>> {<br/> if naddrs.is_empty() {<br/> return Err(N34Error::EmptyNaddrs);<br/> }<br/><br/> Ok(naddrs)<br/>}<br/>
2026-10-09T01:54:49Zhttps://njump.me/nevent1qqs02gmpmqyq27trypnfr4zcgcgn822f778k6vjp4uj96axc96n2s4gzyp2xhcyfwmc3jdu98up2074n3zznz6ye259qzdm0pp7qwhqtg2z6ju9guen// n34 - A CLI to interact with NIP-34 and other stuff related to ...
// n34 - A CLI to interact with NIP-34 and other stuff related to codes in nostr<br/>// Copyright (C) 2025 Awiteb <a@4rs.nl><br/>//<br/>// This program is free software: you can redistribute it and/or modify<br/>// it under the terms of the GNU General Public License as published by<br/>// the Free Software Foundation, either version 3 of the License, or<br/>// (at your option) any later version.<br/>//<br/>// This program is distributed in the hope that it will be useful,<br/>// but WITHOUT ANY WARRANTY; without even the implied warranty of<br/>// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the<br/>// GNU General Public License for more details.<br/>//<br/>// You should have received a copy of the GNU General Public License<br/>// along with this program. If not, see <<a href="https://gnu.org/licenses/gpl-3.0.html>">https://gnu.org/licenses/gpl-3.0.html></a>;.<br/><br/>/// Extension traits for nostr types.<br/>pub mod traits;<br/>/// Utility functions for nostr.<br/>pub mod utils;<br/><br/>use std::{collections::HashSet, time::Duration};<br/><br/>use futures::future;<br/>use nostr::{<br/> event::{Event, EventId, Kind, Tag, TagKind, TagStandard, Tags, UnsignedEvent},<br/> filter::Filter,<br/> key::PublicKey,<br/> nips::{<br/> nip01::{Coordinate, Metadata},<br/> nip19::ToBech32,<br/> nip22,<br/> nip34::GitRepositoryAnnouncement,<br/> },<br/> parser::NostrParser,<br/> types::RelayUrl,<br/>};<br/>use nostr_sdk::{Client, ClientOptions};<br/>use traits::TokenUtils;<br/><br/>use crate::{<br/> cli::{CliOptions, issue::IssueStatus, patch::PatchStatus},<br/> error::{N34Error, N34Result},<br/>};<br/><br/>/// Timeout duration for the client.<br/>const CLIENT_TIMEOUT: Duration = Duration::from_millis(1500);<br/>/// Length of a Nostr npub (public key) in characters.<br/>const NPUB_LEN: usize = 63;<br/><br/>/// Parsed content details<br/>#[derive(Clone)]<br/>pub struct ContentDetails {<br/> /// Public keys of users mentioned in the content.<br/> pub p_tagged: HashSet<PublicKey>,<br/> /// Event IDs and optional relay URLs for quoted events.<br/> pub quotes: HashSet<(EventId, Option<RelayUrl>)>,<br/> /// Hashtags found in the content.<br/> pub hashtags: HashSet<String>,<br/> /// Relays where mentioned users and quoted authors are read.<br/> pub write_relays: HashSet<RelayUrl>,<br/>}<br/><br/>/// A client for interacting with the Nostr relays<br/>#[derive(Clone)]<br/>pub struct NostrClient {<br/> /// The underlying Nostr client implementation<br/> pub client: Client,<br/>}<br/><br/>impl ContentDetails {<br/> /// Create a new [`ContentDetails`] instance<br/> pub fn new(<br/> users: impl IntoIterator<Item = PublicKey>,<br/> quotes: impl IntoIterator<Item = (EventId, Option<RelayUrl>)>,<br/> hashtags: impl IntoIterator<Item = String>,<br/> write_relays: impl IntoIterator<Item = RelayUrl>,<br/> ) -> Self {<br/> Self {<br/> p_tagged: HashSet::from_iter(users),<br/> quotes: HashSet::from_iter(quotes),<br/> hashtags: HashSet::from_iter(hashtags),<br/> write_relays: HashSet::from_iter(write_relays),<br/> }<br/> }<br/><br/> /// Converts the instance into a list of tags including hashtags, p-tagged<br/> /// users, and quoted events.<br/> pub fn into_tags(self) -> Tags {<br/> let mut tags = Tags::new();<br/> tags.extend(self.hashtags.into_iter().map(Tag::hashtag));<br/> tags.extend(self.p_tagged.into_iter().map(Tag::public_key));<br/> tags.extend(self.quotes.into_iter().map(|(event_id, relay_url)| {<br/> // TODO: Add the author public key if we know it<br/> Tag::from_standardized(TagStandard::Quote {<br/> event_id,<br/> relay_url,<br/> public_key: None,<br/> })<br/> }));<br/> tags<br/> }<br/>}<br/><br/>impl NostrClient {<br/> /// Creates a new [`NostrClient`] with the given client and options.<br/> const fn new(client: Client) -> Self {<br/> Self { client }<br/> }<br/><br/> /// Initializes a new [`NostrClient`] instance and connects to the specified<br/> /// relays.<br/> pub async fn init(options: &CliOptions, relays: &[RelayUrl]) -> Self {<br/> let mut client_builder =<br/> Client::builder().opts(ClientOptions::new().verify_subscriptions(true));<br/><br/> if let Ok(Some(signer)) = options.signer().await {<br/> client_builder = client_builder.signer(signer);<br/> }<br/><br/> let client = Self::new(client_builder.build());<br/><br/> client.add_relays(relays).await;<br/> client<br/> }<br/><br/> //// Returns the users public key<br/> pub async fn pubkey(&self) -> N34Result<PublicKey> {<br/> self.client<br/> .signer()<br/> .await?<br/> .get_public_key()<br/> .await<br/> .map_err(N34Error::SignerError)<br/> }<br/><br/> /// Add relays and connect to them<br/> pub async fn add_relays(&self, relays: &[RelayUrl]) {<br/> if relays.is_empty() {<br/> return;<br/> }<br/><br/> let mut tasks = Vec::new();<br/> for relay in relays {<br/> let relay = relay.clone();<br/> let client = self.client.clone();<br/> tasks.push(tokio::spawn(async move {<br/> client<br/> .add_relay(&relay)<br/> .await<br/> .expect("It's a valid relay url");<br/> if let Err(err) = client.try_connect_relay(&relay, CLIENT_TIMEOUT).await {<br/> tracing::error!("Failed to connect to relay '{relay}': {err}");<br/> }<br/> }));<br/> }<br/> future::join_all(tasks).await;<br/> }<br/><br/> /// Add a relay hint and connect to it<br/> pub async fn add_relay_hint(&self, hint: Option<RelayUrl>) {<br/> if let Some(relay) = hint {<br/> self.add_relays(&[relay]).await<br/> }<br/> }<br/><br/> /// broadcast an event to the given relays<br/> pub async fn broadcast(&self, event: &Event, relays: &[RelayUrl]) -> N34Result<()> {<br/> self.client.send_event_to(relays, event).await?;<br/> Ok(())<br/> }<br/><br/> /// Broadcasts an unsigned event to given relays, optionally broadcast the<br/> /// relays list event. Returns URLs of relays that successfully received<br/> /// the event.<br/> pub async fn send_event_to(<br/> &self,<br/> mut event: UnsignedEvent,<br/> relays_list: Option<&Event>,<br/> relays: &[RelayUrl],<br/> ) -> N34Result<Vec<RelayUrl>> {<br/> self.add_relays(relays).await;<br/> let event_id = event.id();<br/><br/> let (result, ..) = futures::join!(<br/> async {<br/> N34Result::Ok(<br/> self.client<br/> .send_event_to(relays, &event.sign(&self.client.signer().await?).await?)<br/> .await?,<br/> )<br/> },<br/> async {<br/> if let Some(event) = relays_list {<br/> let _ = self.client.send_event_to(relays, event).await;<br/> }<br/> }<br/> );<br/> let result = result?;<br/><br/> for relay in &result.success {<br/> tracing::info!(event_id = %event_id, relay = %relay, "Event sent successfully");<br/> }<br/> for (relay, reason) in &result.failed {<br/> tracing::warn!(event_id = %event_id, relay = %relay, reason = %reason, "Failed to send event");<br/> }<br/><br/> Ok(result.success.into_iter().collect())<br/> }<br/><br/> /// Fetches the first event matching the given filter, or None if no event<br/> /// is found.<br/> pub async fn fetch_event(&self, filter: Filter) -> N34Result<Option<Event>> {<br/> Ok(self<br/> .client<br/> .fetch_events(filter.limit(1), CLIENT_TIMEOUT)<br/> .await?<br/> .first_owned())<br/> }<br/><br/> /// Fetches the events matching the given filter<br/> pub async fn fetch_events(&self, filter: Filter) -> N34Result<Vec<Event>> {<br/> // Multiply timeout by 5 to account for multiple events being fetched<br/> Ok(self<br/> .client<br/> .fetch_events(filter, CLIENT_TIMEOUT * 5)<br/> .await?<br/> .to_vec())<br/> }<br/><br/> /// Try to fetch the repositories and returns them<br/> pub async fn fetch_repos(<br/> &self,<br/> repo_naddrs: &[Coordinate],<br/> ) -> N34Result<Vec<GitRepositoryAnnouncement>> {<br/> future::join_all(repo_naddrs.iter().map(|c| {<br/> async {<br/> self.fetch_event(<br/> Filter::new()<br/> .author(c.public_key)<br/> .identifier(&c.identifier)<br/> .kind(Kind::GitRepoAnnouncement),<br/> )<br/> .await?<br/> .map(|e| utils::event_into_repo(e, &c.identifier))<br/> .ok_or(N34Error::NotFoundRepo)<br/> }<br/> }))<br/> .await<br/> .into_iter()<br/> .collect()<br/> }<br/><br/> /// Fetch the patch by the given id. None if not found<br/> pub async fn fetch_patch(&self, patch_id: EventId) -> N34Result<Event> {<br/> self.fetch_event(Filter::new().id(patch_id).kind(Kind::GitPatch))<br/> .await?<br/> .ok_or(N34Error::CanNotFoundPatch)<br/> }<br/><br/> /// Returns the username for a given public key. If no username is found,<br/> /// falls back to a shortened version of the public key.<br/> pub async fn get_username(&self, user: PublicKey) -> String {<br/> self.fetch_event(Filter::new().kind(Kind::Metadata).author(user))<br/> .await<br/> .ok()<br/> .flatten()<br/> .and_then(|e| Metadata::try_from(&e).ok())<br/> .and_then(|m| m.display_name.or(m.name))<br/> .unwrap_or_else(|| {<br/> let pubkey = user.to_bech32().expect("The error is `Infallible`");<br/> format!("{}...{}", &pubkey[..8], &pubkey[NPUB_LEN - 8..])<br/> })<br/> }<br/><br/> /// Get the latest status of an issue by its ID, only considering status<br/> /// events from authorized_pubkeys. If no valid status event is found,<br/> /// defaults to Open.<br/> pub async fn fetch_issue_status(<br/> &self,<br/> issue_id: EventId,<br/> authorized_pubkeys: Vec<PublicKey>,<br/> ) -> N34Result<IssueStatus> {<br/> self.fetch_events(<br/> Filter::new()<br/> .event(issue_id)<br/> .kinds([<br/> Kind::GitStatusOpen,<br/> Kind::GitStatusApplied,<br/> Kind::GitStatusClosed,<br/> ])<br/> .authors(utils::dedup(authorized_pubkeys.into_iter())),<br/> )<br/> .await?<br/> .into_iter()<br/> .max_by_key(|e| e.created_at)<br/> .map(|status| IssueStatus::try_from(status.kind))<br/> .unwrap_or_else(|| Ok(IssueStatus::Open))<br/> }<br/><br/> /// Gets the status of a patch. If it's a revision patch, checks if it's<br/> /// closed when the root patch is already merged/applied but doesn't<br/> /// reference this revision. Defaults to Open status if no status event<br/> /// is found.<br/> pub async fn fetch_patch_status(<br/> &self,<br/> root_patch: EventId,<br/> root_revision: Option<EventId>,<br/> authorized_pubkeys: Vec<PublicKey>,<br/> ) -> N34Result<PatchStatus> {<br/> let (root_status, event_tags) = self<br/> .fetch_events(<br/> Filter::new()<br/> .event(root_patch)<br/> .kinds([<br/> Kind::GitStatusOpen,<br/> Kind::GitStatusApplied,<br/> Kind::GitStatusClosed,<br/> Kind::GitStatusDraft,<br/> ])<br/> .authors(utils::dedup(authorized_pubkeys.into_iter())),<br/> )<br/> .await?<br/> .into_iter()<br/> .max_by_key(|e| e.created_at)<br/> .map(|status| N34Result::Ok((PatchStatus::try_from(status.kind)?, status.tags)))<br/> .unwrap_or_else(|| Ok((PatchStatus::Open, Tags::new())))?;<br/><br/> if let Some(revision_id) = root_revision<br/> && root_status.is_merged_or_applied()<br/> && !event_tags<br/> .filter(TagKind::e())<br/> .any(|t| t.is_reply() && t.content().is_some_and(|c| c == revision_id.to_hex()))<br/> {<br/> return Ok(PatchStatus::Closed);<br/> }<br/><br/> Ok(root_status)<br/> }<br/><br/> pub async fn fetch_patch_series(<br/> &self,<br/> root_patch_id: EventId,<br/> root_patch_author: PublicKey,<br/> ) -> N34Result<Vec<Event>> {<br/> Ok(self<br/> .fetch_events(<br/> Filter::new()<br/> .kind(Kind::GitPatch)<br/> .author(root_patch_author)<br/> .event(root_patch_id),<br/> )<br/> .await?<br/> .into_iter()<br/> .filter(|e| {<br/> e.tags.iter().any(|t| {<br/> t.is_root() && t.content().is_some_and(|c| c == root_patch_id.to_hex())<br/> })<br/> })<br/> .collect())<br/> }<br/><br/> /// Finds the root issue or patch for a given event. If the event is already<br/> /// a root (issue/patch), returns it directly. For comments, follows<br/> /// parent/root references until finding the root or failing. Returns<br/> /// None if no root can be found.<br/> pub async fn find_root(&self, mut event: Event) -> N34Result<Option<Event>> {<br/> if !matches!(event.kind, Kind::GitIssue | Kind::GitPatch | Kind::Comment) {<br/> return Err(N34Error::CanNotReplyToEvent);<br/> }<br/><br/> loop {<br/> if matches!(event.kind, Kind::GitIssue | Kind::GitPatch) {<br/> return Ok(Some(event));<br/> }<br/><br/> if let Some(nip22::CommentTarget::Event { id, relay_hint, .. }) =<br/> nip22::extract_root(&event)<br/> {<br/> self.add_relay_hint(relay_hint.cloned()).await;<br/> let root_event = self.fetch_event(Filter::new().id(*id)).await?;<br/> if let Some(ref root_event) = root_event<br/> && !matches!(root_event.kind, Kind::GitIssue | Kind::GitPatch)<br/> {<br/> return Err(N34Error::CanNotReplyToEvent);<br/> }<br/> return Ok(root_event);<br/> } else if let Some(nip22::CommentTarget::Event { id, relay_hint, .. }) =<br/> nip22::extract_parent(&event)<br/> {<br/> self.add_relay_hint(relay_hint.cloned()).await;<br/> if let Ok(Some(parent_event)) = self.fetch_event(Filter::new().id(*id)).await {<br/> event = parent_event;<br/> continue;<br/> }<br/> }<br/><br/> // Break if: no root/parent tags found, parent/root event fetch failed<br/> break;<br/> }<br/><br/> Ok(None)<br/> }<br/><br/> /// Fetches the relay list (kind 10002) for the given user. Returns None if<br/> /// no relays are found.<br/> pub async fn user_relays_list(&self, user: PublicKey) -> N34Result<Option<Event>> {<br/> self.fetch_event(Filter::new().author(user).kind(Kind::RelayList))<br/> .await<br/> }<br/><br/> /// Gets the author of the specified event, if found.<br/> pub async fn event_author(&self, event_id: EventId) -> N34Result<Option<PublicKey>> {<br/> Ok(self<br/> .fetch_event(Filter::new().id(event_id))<br/> .await?<br/> .map(|e| e.pubkey))<br/> }<br/><br/> /// Returns the read relays of the given user if found, otherwise empty<br/> /// vector<br/> pub async fn read_relays_from_user(&self, user: PublicKey) -> Vec<RelayUrl> {<br/> utils::add_read_relays(self.user_relays_list(user).await.ok().flatten().as_ref())<br/> }<br/><br/> /// Returns the read relays of the given users if found, otherwise empty<br/> /// vector<br/> pub async fn read_relays_from_users(&self, users: &[PublicKey]) -> Vec<RelayUrl> {<br/> self.fetch_events(<br/> Filter::new()<br/> .kind(nostr::event::Kind::RelayList)<br/> .authors(utils::dedup(users.iter().copied())),<br/> )<br/> .await<br/> .unwrap_or_default()<br/> .into_iter()<br/> .flat_map(|e| utils::add_read_relays(Some(&e)))<br/> .collect()<br/> }<br/><br/> /// Parse the given content and returns the details that inside it<br/> pub async fn parse_content(&self, content: &str) -> ContentDetails {<br/> let mut write_relays = Vec::new();<br/> let tokens = NostrParser::new().parse(content).collect::<Vec<_>>();<br/><br/> let mut p_tagged_users = tokens<br/> .iter()<br/> .filter_map(TokenUtils::extract_public_key)<br/> .collect::<Vec<_>>();<br/> let quotes = tokens<br/> .iter()<br/> .filter_map(TokenUtils::extract_event_id)<br/> .collect::<Vec<_>>();<br/> let hashtags = tokens<br/> .iter()<br/> .filter_map(TokenUtils::extract_hashtag)<br/> .collect::<Vec<_>>();<br/><br/> for (user, relays) in &p_tagged_users {<br/> self.add_relays(relays).await;<br/> write_relays.extend(self.read_relays_from_user(*user).await);<br/> }<br/> for (event_id, relays) in &quotes {<br/> self.add_relays(relays).await;<br/> // Add the event author to the p-tagged users<br/> if let Ok(Some(author)) = self.event_author(*event_id).await {<br/> p_tagged_users.push((author, Vec::new()));<br/> write_relays.extend(self.read_relays_from_user(author).await);<br/> }<br/> }<br/><br/> ContentDetails::new(<br/> p_tagged_users.into_iter().map(|(p, _)| p),<br/> quotes.into_iter().map(|(e, r)| (e, r.first().cloned())),<br/> hashtags,<br/> write_relays,<br/> )<br/> }<br/>}<br/>
2026-10-09T01:54:43Zhttps://njump.me/nevent1qqs0m7rtlal83efud3qd7ewtdfj6va5n33g9akmxv6wlc659cvuvqlqzyp2xhcyfwmc3jdu98up2074n3zznz6ye259qzdm0pp7qwhqtg2z6jujkuq2// n34 - A CLI to interact with NIP-34 and other stuff related to ...
// n34 - A CLI to interact with NIP-34 and other stuff related to codes in nostr<br/>// Copyright (C) 2025 Awiteb <a@4rs.nl><br/>//<br/>// This program is free software: you can redistribute it and/or modify<br/>// it under the terms of the GNU General Public License as published by<br/>// the Free Software Foundation, either version 3 of the License, or<br/>// (at your option) any later version.<br/>//<br/>// This program is distributed in the hope that it will be useful,<br/>// but WITHOUT ANY WARRANTY; without even the implied warranty of<br/>// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the<br/>// GNU General Public License for more details.<br/>//<br/>// You should have received a copy of the GNU General Public License<br/>// along with this program. If not, see <<a href="https://gnu.org/licenses/gpl-3.0.html>">https://gnu.org/licenses/gpl-3.0.html></a>;.<br/><br/>use std::str::FromStr;<br/><br/>use nostr::{<br/> event::{EventId, Kind},<br/> nips::{<br/> nip01::Coordinate,<br/> nip05::{Nip05Address, Nip05Profile},<br/> nip19::{self, FromBech32, Nip19Coordinate},<br/> },<br/> types::RelayUrl,<br/> util::BoxedFuture,<br/>};<br/>use nostr_connect::client::AuthUrlHandler;<br/>use tokio::runtime::Handle;<br/><br/>use super::parsers;<br/>use crate::{<br/> cli::{RepoRelaySet, traits::RepoRelaySetsExt},<br/> error::{N34Error, N34Result},<br/>};<br/><br/>/// Either a NIP-19 coordinate (naddr) or a named set.<br/>#[derive(Debug, Clone)]<br/>pub enum NaddrOrSet {<br/> /// NIP-19 coordinate.<br/> Naddr(Nip19Coordinate),<br/> /// Name of a set (may not exist).<br/> Set(String),<br/>}<br/><br/>/// Either relay URL or a named set.<br/>#[derive(Debug, Clone)]<br/>pub enum RelayOrSet {<br/> /// Relay URL.<br/> Relay(RelayUrl),<br/> /// Name of a set (may not exist).<br/> Set(String),<br/>}<br/><br/>/// Parses and represents a Nostr `nevent1` or `note1`.<br/>#[derive(Debug, Clone)]<br/>pub struct NostrEvent {<br/> /// Unique identifier for the event.<br/> pub event_id: EventId,<br/> /// List of relay URLs associated with the event. Empty if parsing a<br/> /// `note1`.<br/> pub relays: Vec<RelayUrl>,<br/>}<br/><br/>#[derive(Debug)]<br/>pub struct EchoAuthUrl;<br/><br/>impl AuthUrlHandler for EchoAuthUrl {<br/> fn on_auth_url(<br/> &self,<br/> auth_url: nostr::Url,<br/> ) -> BoxedFuture<'_, Result<(), Box<dyn std::error::Error>>> {<br/> Box::pin(async move {<br/> println!("The bunker requires authentication. Please open this URL: {auth_url}");<br/> Ok(())<br/> })<br/> }<br/>}<br/><br/>impl NaddrOrSet {<br/> /// Returns the naddr if `Naddr` or try to get the relays from the set.<br/> /// Returns error if the set naddrs are empty or the set not found.<br/> pub fn get_naddrs(self, sets: &[RepoRelaySet]) -> N34Result<Vec<Nip19Coordinate>> {<br/> match self {<br/> Self::Naddr(nip19_coordinate) => Ok(vec![nip19_coordinate]),<br/> Self::Set(name) => {<br/> let set = sets<br/> .get_set(&name)<br/> .map_err(|_| N34Error::InvalidNaddrArg(name.clone()))?;<br/> if set.naddrs.is_empty() {<br/> Err(N34Error::EmptySetNaddrs(name))<br/> } else {<br/> Ok(Vec::from_iter(set.naddrs.clone()))<br/> }<br/> }<br/> }<br/> }<br/>}<br/><br/><br/>impl RelayOrSet {<br/> /// Returns the relay if `Relay` or try to get the relays from the set.<br/> /// Returns error if the set relays are empty or the set not found<br/> pub fn get_relays(self, sets: &[RepoRelaySet]) -> N34Result<Vec<RelayUrl>> {<br/> match self {<br/> Self::Relay(relay) => Ok(vec![relay]),<br/> Self::Set(name) => {<br/> let set = sets<br/> .get_set(&name)<br/> .map_err(|_| N34Error::InvalidRelaysArg(name.clone()))?;<br/> if set.relays.is_empty() {<br/> Err(N34Error::EmptySetRelays(name))<br/> } else {<br/> Ok(Vec::from_iter(set.relays.clone()))<br/> }<br/> }<br/> }<br/> }<br/>}<br/><br/>impl NostrEvent {<br/> /// Create a new [`NostrEvent`] instance<br/> fn new(event_id: EventId, relays: Vec<RelayUrl>) -> Self {<br/> Self { event_id, relays }<br/> }<br/>}<br/><br/>impl FromStr for NaddrOrSet {<br/> type Err = String;<br/><br/> /// Parses a Git repository address which can be either:<br/> /// - A bech32-encoded naddr (e.g. "naddr1...") for Git repository<br/> /// announcements (kind 30617)<br/> /// - A NIP-05 identifier with repository ID (e.g. "4rs.nl/n34" or<br/> /// "_@4rs.nl/n34")<br/> /// - A set name.<br/> ///<br/> /// Returns an error for invalid formats, failed bech32 decoding, wrong<br/> /// event kind.<br/> fn from_str(naddr_or_set: &str) -> Result<Self, Self::Err> {<br/> let naddr_or_set = naddr_or_set.trim();<br/><br/> if naddr_or_set.contains("/") {<br/> let (nip5, repo_id) = naddr_or_set.split_once("/").expect("There is a `/`");<br/> parse_nip5_repo(nip5, repo_id)<br/> } else if naddr_or_set.starts_with("naddr1") || naddr_or_set.starts_with("nostr:naddr1") {<br/> parsers::parse_repo_naddr(naddr_or_set.trim_start_matches("nostr:")).map(Self::Naddr)<br/> } else {<br/> Ok(Self::Set(naddr_or_set.to_owned()))<br/> }<br/> }<br/>}<br/><br/>impl FromStr for RelayOrSet {<br/> type Err = String;<br/><br/> /// Parse a string into a relay URL or a set name.<br/> /// If the string is a valid URL (e.g., "wss://example.com"), it's treated<br/> /// as a relay URL. Otherwise, it's treated as a set name, and its<br/> /// associated relays will be merged.<br/> fn from_str(relay_or_set: &str) -> Result<Self, Self::Err> {<br/> let relay_or_set = relay_or_set.trim();<br/><br/> if relay_or_set.starts_with("wss://") {<br/> RelayUrl::from_str(relay_or_set)<br/> .map_err(|err| err.to_string())<br/> .map(Self::Relay)<br/> } else {<br/> Ok(Self::Set(relay_or_set.to_owned()))<br/> }<br/> }<br/>}<br/><br/>impl FromStr for NostrEvent {<br/> type Err = String;<br/><br/> fn from_str(s: &str) -> Result<Self, Self::Err> {<br/> let str_event = s.trim().trim_start_matches("nostr:");<br/> if str_event.starts_with("nevent1") {<br/> let event = nip19::Nip19Event::from_bech32(str_event).map_err(|e| e.to_string())?;<br/> Ok(Self::new(event.event_id, event.relays))<br/> } else if str_event.starts_with("note1") {<br/> Ok(Self::new(<br/> EventId::from_bech32(str_event).map_err(|e| e.to_string())?,<br/> Vec::new(),<br/> ))<br/> } else {<br/> Err("Invalid event id, must starts with `note1` or `nevent1`".to_owned())<br/> }<br/> }<br/>}<br/><br/>fn parse_nip5_repo(nip5: &str, repo_id: &str) -> Result<NaddrOrSet, String> {<br/> let (username, domain) = nip5.split_once("@").unwrap_or(("_", nip5));<br/><br/> let nip5_address =<br/> Nip05Address::parse(&format!("{username}@{domain}")).map_err(|err| err.to_string())?;<br/><br/> let nip5_json = tokio::task::block_in_place(|| {<br/> Handle::current().block_on(async {<br/> reqwest::get(nip5_address.url().as_str())<br/> .await<br/> .map_err(|err| err.to_string())?<br/> .text()<br/> .await<br/> .map_err(|err| err.to_string())<br/> })<br/> })?;<br/><br/> let nip5_profile =<br/> Nip05Profile::from_raw_json(&nip5_address, &nip5_json).map_err(|err| err.to_string())?;<br/><br/> Ok(NaddrOrSet::Naddr(Nip19Coordinate::new(<br/> Coordinate::new(Kind::GitRepoAnnouncement, nip5_profile.public_key).identifier(repo_id),<br/> nip5_profile.relays,<br/> )))<br/>}<br/>
2026-10-09T01:54:39Zhttps://njump.me/nevent1qqstde0cffse532qqqjq8yakhtmgwcpv6vskvpxz73tc9vvpe0pf27szyp2xhcyfwmc3jdu98up2074n3zznz6ye259qzdm0pp7qwhqtg2z6jfh03k4// n34 - A CLI to interact with NIP-34 and other stuff related to ...
// n34 - A CLI to interact with NIP-34 and other stuff related to codes in nostr<br/>// Copyright (C) 2025 Awiteb <a@4rs.nl><br/>//<br/>// This program is free software: you can redistribute it and/or modify<br/>// it under the terms of the GNU General Public License as published by<br/>// the Free Software Foundation, either version 3 of the License, or<br/>// (at your option) any later version.<br/>//<br/>// This program is distributed in the hope that it will be useful,<br/>// but WITHOUT ANY WARRANTY; without even the implied warranty of<br/>// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the<br/>// GNU General Public License for more details.<br/>//<br/>// You should have received a copy of the GNU General Public License<br/>// along with this program. If not, see <<a href="https://gnu.org/licenses/gpl-3.0.html>">https://gnu.org/licenses/gpl-3.0.html></a>;.<br/><br/>/// Commands module<br/>pub mod commands;<br/>/// Common commands used by multiply commands<br/>pub mod common_commands;<br/>/// The CLI config<br/>pub mod config;<br/>/// Default lazy values for CLI arguments<br/>pub mod defaults;<br/>/// Macros for CLI application.<br/>pub mod macros;<br/>/// Represents the state used for CLI options.<br/>pub mod options_state;<br/>/// CLI arguments parsers<br/>pub mod parsers;<br/>/// CLI traits<br/>pub mod traits;<br/>/// Common helper types used throughout the CLI.<br/>pub mod types;<br/><br/><br/>use clap::Parser;<br/>use clap_verbosity_flag::Verbosity;<br/>use nostr::key::Keys;<br/>use nostr::key::SecretKey;<br/>use nostr_browser_signer_proxy::BrowserSignerProxy;<br/>use nostr_browser_signer_proxy::BrowserSignerProxyOptions;<br/>use nostr_keyring::KeyringError;<br/>use nostr_keyring::NostrKeyring;<br/>use types::RelayOrSet;<br/><br/>pub use self::commands::*;<br/>pub use self::config::*;<br/>use self::traits::CommandRunner;<br/>use crate::cli::options_state::BROWSER_SIGNER_PROXY_TIMEOUT;<br/>use crate::error::N34Error;<br/>use crate::error::N34Result;<br/>use crate::nostr_utils::traits::NostrKeyringErrorUtils;<br/><br/>/// Header message, used in the help message<br/>const HEADER: &str = r#"Copyright (C) 2025 Awiteb <a@4rs.nl><br/>License GNU GPL-3.0-or-later <<a href="https://gnu.org/licenses/gpl-3.0.html>">https://gnu.org/licenses/gpl-3.0.html></a>;<br/>This is free software: you are free to change and redistribute it.<br/>There is NO WARRANTY, to the extent permitted by law.<br/><br/>Git repository: <a href="https://git.4rs.nl/awiteb/n34.git"#">https://git.4rs.nl/awiteb/n34.git"#</a>;<br/><br/>/// Footer message, used in the help message<br/>const FOOTER: &str = r#"Please report bugs to <naddr1qqpkuve5qgsqqqqqq9g9uljgjfcyd6dm4fegk8em2yfz0c3qp3tc6mntkrrhawgrqsqqqauesksc39>."#;<br/><br/><br/>/// Name of the file storing the repository address<br/>pub const NOSTR_ADDRESS_FILE: &str = "nostr-address";<br/><br/>#[derive(Parser, Debug)]<br/>#[command(about, version, before_long_help = HEADER, after_long_help = FOOTER)]<br/>/// A command-line interface for interacting with NIP-34 and other Nostr<br/>/// code-related stuff.<br/>pub struct Cli {<br/> #[command(flatten)]<br/> pub options: commands::CliOptions,<br/> /// Controls the verbosity level of output<br/> #[command(flatten)]<br/> pub verbosity: Verbosity,<br/> /// The subcommand to execute<br/> #[command(subcommand)]<br/> pub command: commands::Commands,<br/>}<br/><br/><br/>impl Cli {<br/> /// Keyring service name of n34<br/> pub const N34_KEYRING_SERVICE_NAME: &str = "n34";<br/> /// Keyring entry name of the n34 keypair<br/> pub const N34_KEY_PAIR_ENTRY: &str = "n34_keypair";<br/> /// Keyring entry name of the user secret key<br/> pub const USER_KEY_PAIR_ENTRY: &str = "user_keypair";<br/><br/> /// Executes the command<br/> pub async fn run(self) -> N34Result<()> {<br/> self.command.run(self.options).await<br/> }<br/><br/> /// Gets the n34 keypair from the keyring or generates and stores a new one<br/> /// if none exists.<br/> pub fn n34_keypair() -> N34Result<Keys> {<br/> let keyring = NostrKeyring::new(Self::N34_KEYRING_SERVICE_NAME);<br/><br/> match keyring.get(Self::N34_KEY_PAIR_ENTRY) {<br/> Ok(keys) => Ok(keys),<br/> Err(nostr_keyring::Error::Keyring(KeyringError::NoEntry)) => {<br/> let new_keys = Keys::generate();<br/> keyring.set(Self::N34_KEY_PAIR_ENTRY, &new_keys)?;<br/> Ok(new_keys)<br/> }<br/> Err(err) => Err(N34Error::Keyring(err)),<br/> }<br/> }<br/><br/> /// Retrieves the user's keypair from the keyring. If no key exists and one<br/> /// is provided, stores and returns it. If no key exists and none is<br/> /// provided, returns an error.<br/> pub fn user_keypair(secret_key: Option<SecretKey>) -> N34Result<Keys> {<br/> let keyring = NostrKeyring::new(Self::N34_KEYRING_SERVICE_NAME);<br/> let keyring_key = keyring.get(Self::USER_KEY_PAIR_ENTRY);<br/><br/> if let Err(ref err) = keyring_key<br/> && err.is_keyring_no_entry()<br/> && let Some(secret_key) = secret_key<br/> {<br/> let keypair = Keys::new(secret_key);<br/> keyring.set(Self::USER_KEY_PAIR_ENTRY, &keypair)?;<br/> return Ok(keypair);<br/> }<br/><br/> keyring_key.map_err(|err| {<br/> if err.is_keyring_no_entry() {<br/> N34Error::SecretKeyKeyringWithoutEntry<br/> } else {<br/> N34Error::Keyring(err)<br/> }<br/> })<br/> }<br/>}<br/><br/>/// Processes the CLI configuration by applying fallback values from config if<br/>/// needed. Returns the processed Cli configuration if successful.<br/>pub fn post_cli(mut cli: Cli) -> N34Result<Cli> {<br/> cli.options.pow = cli.options.pow.or(cli.options.config.pow);<br/><br/> if cli.options.relays.is_empty()<br/> && let Some(relays) = &cli.options.config.fallback_relays<br/> {<br/> cli.options.relays = relays.iter().cloned().map(RelayOrSet::Relay).collect();<br/> }<br/><br/> // Automatically sets the signer based on the configuration if no signer<br/> // is provided.<br/> if !cli.options.nip07<br/> && cli.options.bunker_url.is_none()<br/> && (cli.options.secret_key.is_none() || cli.options.config.keyring_secret_key)<br/> {<br/> if let Some(addr) = cli.options.config.nip07 {<br/> cli.options.nip07 = true;<br/> cli.options.state.browser_signer_proxy = BrowserSignerProxy::new(<br/> BrowserSignerProxyOptions::default()<br/> .timeout(BROWSER_SIGNER_PROXY_TIMEOUT)<br/> .ip_addr(addr.ip())<br/> .port(addr.port()),<br/> );<br/> } else if let Some(bunker_url) = &cli.options.config.bunker_url {<br/> cli.options.bunker_url = Some(bunker_url.clone());<br/> } else if cli.options.config.keyring_secret_key {<br/> cli.options.secret_key = Some(<br/> Cli::user_keypair(cli.options.secret_key)?<br/> .secret_key()<br/> .clone(),<br/> );<br/> }<br/> }<br/><br/> Ok(cli)<br/>}<br/>
2026-10-09T01:54:39Zhttps://njump.me/nevent1qqst8pq6ez7nx30fly6f7vq9z0hv80g0synphg6jn046wsxl4jgmkggzyp2xhcyfwmc3jdu98up2074n3zznz6ye259qzdm0pp7qwhqtg2z6jh3skxz// n34 - A CLI to interact with NIP-34 and other stuff related to ...
// n34 - A CLI to interact with NIP-34 and other stuff related to codes in nostr<br/>// Copyright (C) 2025 Awiteb <a@4rs.nl><br/>//<br/>// This program is free software: you can redistribute it and/or modify<br/>// it under the terms of the GNU General Public License as published by<br/>// the Free Software Foundation, either version 3 of the License, or<br/>// (at your option) any later version.<br/>//<br/>// This program is distributed in the hope that it will be useful,<br/>// but WITHOUT ANY WARRANTY; without even the implied warranty of<br/>// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the<br/>// GNU General Public License for more details.<br/>//<br/>// You should have received a copy of the GNU General Public License<br/>// along with this program. If not, see <<a href="https://gnu.org/licenses/gpl-3.0.html>">https://gnu.org/licenses/gpl-3.0.html></a>;.<br/><br/>use super::traits::CommandRunner;<br/><br/><br/>/// Returns whether the command runner type `T` requires relays.<br/>pub fn get_relays_state<T: CommandRunner>(_v: &T) -> bool {<br/> T::NEED_RELAYS<br/>}<br/><br/>/// Returns whether the command runner type `T` requires a signer.<br/>pub fn get_signer_state<T: CommandRunner>(_v: &T) -> bool {<br/> T::NEED_SIGNER<br/>}<br/><br/>/// Executes a command with required setup checks. The first parameter is the<br/>/// command to match on (often `self`), followed by options. Optional<br/>/// subcommands come next, and commands with arguments (after `&`) are listed<br/>/// last.<br/>#[macro_export]<br/>macro_rules! run_command {<br/> ($command:ident, $options:ident, $($subcommands:ident)* & $($commands:ident)*) => {<br/> match $command {<br/> $(<br/> Self::$subcommands { subcommands } => subcommands.run($options).await,<br/> )*<br/> $(<br/> Self::$commands ( args ) => {<br/> if $crate::cli::macros::get_relays_state(&args) {<br/> $options.ensure_relays()?;<br/> }<br/> if $crate::cli::macros::get_signer_state(&args) {<br/> $options.ensure_signer()?;<br/> }<br/> args.run($options).await<br/> },<br/> )*<br/> }<br/> };<br/>}<br/>
2026-10-09T01:54:39Zhttps://njump.me/nevent1qqsf2zepja5pxaeswp4uzh4vtvv3hnnjuxna89utz3crzccumcfdmkgzyp2xhcyfwmc3jdu98up2074n3zznz6ye259qzdm0pp7qwhqtg2z6j8c4q9c// n34 - A CLI to interact with NIP-34 and other stuff related to ...
// n34 - A CLI to interact with NIP-34 and other stuff related to codes in nostr<br/>// Copyright (C) 2025 Awiteb <a@4rs.nl><br/>//<br/>// This program is free software: you can redistribute it and/or modify<br/>// it under the terms of the GNU General Public License as published by<br/>// the Free Software Foundation, either version 3 of the License, or<br/>// (at your option) any later version.<br/>//<br/>// This program is distributed in the hope that it will be useful,<br/>// but WITHOUT ANY WARRANTY; without even the implied warranty of<br/>// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the<br/>// GNU General Public License for more details.<br/>//<br/>// You should have received a copy of the GNU General Public License<br/>// along with this program. If not, see <<a href="https://gnu.org/licenses/gpl-3.0.html>">https://gnu.org/licenses/gpl-3.0.html></a>;.<br/><br/>use std::{net::AddrParseError, process::ExitCode};<br/><br/>use nostr::{<br/> event::{Kind, builder::Error as EventBuilderError},<br/> signer::SignerError,<br/>};<br/>use nostr_sdk::client::Error as ClientError;<br/><br/>use crate::cli::ConfigError;<br/><br/>/// The input data was incorrect in some way. This should only be used for<br/>/// user’s data and not system file.<br/>const DATA_ERROR: u8 = 65;<br/><br/>/// An internal software error has been detected. This should be limited to<br/>/// non-operating system related errors.<br/>const SOFTWARE_ERROR: u8 = 70;<br/><br/>/// An error occurred while doing I/O on some file.<br/>const IO_ERROR: u8 = 74;<br/><br/>/// Something was found in an unconfigured or misconfigured state.<br/>const CONFIG_ERROR: u8 = 78;<br/><br/>pub type N34Result<T> = Result<T, N34Error>;<br/><br/>/// N34 errors<br/>#[derive(Debug, thiserror::Error)]<br/>pub enum N34Error {<br/> #[error("IO: {0}")]<br/> Io(#[from] std::io::Error),<br/> #[error("Signer Error: {0}")]<br/> SignerError(#[from] SignerError),<br/> #[error("Invalid Browser Signer Proxy Address: {0}")]<br/> Addr(#[from] AddrParseError),<br/> #[error("Browser Signer Proxy Error: {0}")]<br/> BrowserSignerProxy(#[from] nostr_browser_signer_proxy::Error),<br/> #[error("Keyring error: {0}")]<br/> Keyring(#[from] nostr_keyring::Error),<br/> #[error("{0}")]<br/> Config(#[from] ConfigError),<br/> #[error("No editor specified in the `EDITOR` environment variable")]<br/> EditorNotFound,<br/> #[error("The file you edited is empty. Please save your changes before exiting the editor.")]<br/> EmptyEditorFile,<br/> #[error("The editor `{0}` exit with unsuccessful exit code `{1}`")]<br/> EditorErr(String, i32),<br/> #[error("Client Error: {0}")]<br/> Client(#[from] ClientError),<br/> #[error("Unable to locate the repository. The repository may not exists in the given relays")]<br/> NotFoundRepo,<br/> #[error("Failed building an event: {0}")]<br/> EventBuilder(#[from] EventBuilderError),<br/> #[error("Invalid repository id, it can't be empty and must be kebab-case")]<br/> InvalidRepoId,<br/> #[error("Invalid event: {0}")]<br/> InvalidEvent(String),<br/> #[error("Bech32 error: {0}")]<br/> Bech32(#[from] nostr::nips::nip19::Error),<br/> #[error("Event error: {0}")]<br/> Event(#[from] nostr::event::Error),<br/> #[error("Event not found in the specified relays")]<br/> EventNotFound,<br/> #[error(<br/> "Can't reply to this event. Only Git issues, patches, and their comments can be replied \<br/> to."<br/> )]<br/> CanNotReplyToEvent,<br/> #[error("No repository address given and couldn't read `nostr-address` file: {0}")]<br/> CanNotReadNostrAddressFile(std::io::Error),<br/> #[error(<br/> "The `nostr-address` file is empty. Please add a valid Nostr repository address (naddr) \<br/> to the file or provide it manually as a flag."<br/> )]<br/> EmptyNostrAddressFile,<br/> #[error("Invalid `nostr-address` file content: {0}")]<br/> InvalidNostrAddressFileContent(String),<br/> #[error("This command requires at least one relay, but none were provided")]<br/> EmptyRelays,<br/> #[error("One naddr is required for this command")]<br/> EmptyNaddrs,<br/> #[error(<br/> "This command requires a signer to sign events. Use `--secret-key`, `--nip07` or \<br/> `--bunker-url` to provide a signer"<br/> )]<br/> SignerRequired,<br/> #[error(<br/> "Invalid repository address. Expected one of these formats:\n- NIP-05 identifier with \<br/> repository ID: `<user@domain.com>/<repo_id>`\n- Valid NIP-19 naddr string (starts with \<br/> 'naddr1...')\n- Existing set name (merges all repositories in set)\nError: No set named \<br/> '{0}' exists."<br/> )]<br/> InvalidNaddrArg(String),<br/> #[error(<br/> "Invalid relays. Expected a relay url or a set name that contains some relays\nError: No \<br/> set named '{0}' exists."<br/> )]<br/> InvalidRelaysArg(String),<br/> #[error(<br/> "The set '{0}' doesn't contain any addresses. Use 'sets update' to add addresses to it."<br/> )]<br/> EmptySetNaddrs(String),<br/> #[error("The set '{0}' doesn't contain any relays. Use 'sets update' to add relays to it.")]<br/> EmptySetRelays(String),<br/> #[error(<br/> "Issue not found, make sure it is in the relays and make sure that the ID is an issue ID"<br/> )]<br/> CanNotFoundIssue,<br/> #[error(<br/> "Patch not found, make sure it is in the relays and make sure that the ID is an patch ID"<br/> )]<br/> CanNotFoundPatch,<br/> #[error(r#"The given patch id is not a root patch. It must contains `["t", "root"]` tag"#)]<br/> NotRootPatch,<br/> #[error("This status kind can't be set for an issue: {0}")]<br/> InvalidIssueStatus(Kind),<br/> #[error("This status kind can't be set for a patch: {0}")]<br/> InvalidPatchStatus(Kind),<br/> #[error("Can't find the root patch of the given patch-revision")]<br/> RevisionRootNotFound,<br/> #[error("Invalid status for the issue/patch: {0}")]<br/> InvalidStatus(String),<br/> #[error("Not valid bunker URL")]<br/> NotBunkerUrl,<br/> #[error(<br/> "No secret key found in the keyring. Please use the secret key at least once while \<br/> keyring is enabled to store it"<br/> )]<br/> SecretKeyKeyringWithoutEntry,<br/>}<br/><br/>impl N34Error {<br/> /// Returns the exit code associated with this error<br/> pub fn exit_code(&self) -> ExitCode {<br/> match self {<br/> Self::Io(_) | Self::CanNotReadNostrAddressFile(_) => ExitCode::from(IO_ERROR),<br/> Self::Config(_) => ExitCode::from(CONFIG_ERROR),<br/> Self::EditorErr(..) => ExitCode::from(SOFTWARE_ERROR),<br/> Self::InvalidRepoId<br/> | Self::EmptyNostrAddressFile<br/> | Self::InvalidNostrAddressFileContent(_)<br/> | Self::EmptyRelays<br/> | Self::EmptyNaddrs<br/> | Self::SignerRequired<br/> | Self::InvalidNaddrArg(_)<br/> | Self::InvalidRelaysArg(_)<br/> | Self::EmptySetNaddrs(_)<br/> | Self::EmptySetRelays(_)<br/> | Self::NotRootPatch => ExitCode::from(DATA_ERROR),<br/> _ => ExitCode::FAILURE,<br/> }<br/> }<br/>}<br/>
2026-10-09T01:54:39Zhttps://njump.me/nevent1qqs889kr28tl6jf7g4ku2trlxrwvexefejraxw9kp2gzenl6q0w8a3gzyp2xhcyfwmc3jdu98up2074n3zznz6ye259qzdm0pp7qwhqtg2z6jglzq0r#![allow(unused)] // n34 - A CLI to interact with NIP-34 and ...
#![allow(unused)]<br/>// n34 - A CLI to interact with NIP-34 and other stuff related to codes in nostr<br/>// Copyright (C) 2025 Awiteb <a@4rs.nl><br/>//<br/>// This program is free software: you can redistribute it and/or modify<br/>// it under the terms of the GNU General Public License as published by<br/>// the Free Software Foundation, either version 3 of the License, or<br/>// (at your option) any later version.<br/>//<br/>// This program is distributed in the hope that it will be useful,<br/>// but WITHOUT ANY WARRANTY; without even the implied warranty of<br/>// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the<br/>// GNU General Public License for more details.<br/>//<br/>// You should have received a copy of the GNU General Public License<br/>// along with this program. If not, see <<a href="https://gnu.org/licenses/gpl-3.0.html>">https://gnu.org/licenses/gpl-3.0.html></a>;.<br/><br/>/// Command line interface module<br/>pub mod cli;<br/>/// N34 errors<br/>pub mod error;<br/>/// Nostr utils module<br/>pub mod nostr_utils;<br/><br/>use std::{<br/> process::ExitCode,<br/> sync::atomic::{AtomicBool, Ordering},<br/>};<br/><br/>use clap::Parser;<br/>use clap_verbosity_flag::Verbosity;<br/>use tracing::Level;<br/>use tracing_subscriber::{Layer, filter, layer::SubscriberExt};<br/><br/>use self::cli::Cli;<br/><br/>/// Whether the editor is currently open. Prevents logging while the editor is<br/>/// open.<br/>static EDITOR_OPEN: AtomicBool = AtomicBool::new(false);<br/><br/>/// Configures the logging level based on the provided verbosity.<br/>///<br/>/// When verbosity is set to TRACE, includes file and line numbers in logs.<br/>fn set_log_level(verbosity: Verbosity) {<br/> let is_trace = verbosity<br/> .tracing_level()<br/> .is_some_and(|l| l == tracing::Level::TRACE);<br/><br/> let logs_filter = filter::dynamic_filter_fn(move |m, _| {<br/> // Disable all logs while editor is open<br/> verbosity.tracing_level().unwrap_or(Level::ERROR) >= *m.level()<br/> && !EDITOR_OPEN.load(Ordering::Relaxed)<br/> });<br/><br/> let logs_layer = tracing_subscriber::fmt::layer()<br/> .with_file(is_trace)<br/> .with_line_number(is_trace)<br/> .without_time();<br/> let subscriber = tracing_subscriber::registry().with(logs_layer.with_filter(logs_filter));<br/> tracing::subscriber::set_global_default(subscriber).ok();<br/>}<br/><br/>// ```rust<br/>// #[tokio::main]<br/>// async fn main() -> ExitCode {<br/>// let cli = match cli::post_cli(Cli::parse()) {<br/>// Ok(cli) => cli,<br/>// Err(err) => {<br/>// eprintln!("{err}");<br/>// return ExitCode::FAILURE;<br/>// }<br/>// };<br/>// <br/>// set_log_level(cli.verbosity);<br/>// <br/>// if let Err(err) = cli.run().await {<br/>// tracing::error!("{err}");<br/>// return err.exit_code();<br/>// }<br/>// <br/>// ExitCode::SUCCESS<br/>// }<br/>// ```<br/>
2026-10-09T01:54:39Zhttps://njump.me/nevent1qqsxc3nw7vapmunx9g0uxh42gungcxa9ahjwr5z4420l5h6rrdjxzjczyp2xhcyfwmc3jdu98up2074n3zznz6ye259qzdm0pp7qwhqtg2z6jrkshfc// n34 - A CLI to interact with NIP-34 and other stuff related to ...
// n34 - A CLI to interact with NIP-34 and other stuff related to codes in nostr<br/>// Copyright (C) 2025 Awiteb <a@4rs.nl><br/>//<br/>// This program is free software: you can redistribute it and/or modify<br/>// it under the terms of the GNU General Public License as published by<br/>// the Free Software Foundation, either version 3 of the License, or<br/>// (at your option) any later version.<br/>//<br/>// This program is distributed in the hope that it will be useful,<br/>// but WITHOUT ANY WARRANTY; without even the implied warranty of<br/>// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the<br/>// GNU General Public License for more details.<br/>//<br/>// You should have received a copy of the GNU General Public License<br/>// along with this program. If not, see <<a href="https://gnu.org/licenses/gpl-3.0.html>">https://gnu.org/licenses/gpl-3.0.html></a>;.<br/><br/>use std::{iter, str::FromStr, sync::Arc};<br/><br/>use either::Either;<br/>use futures::future;<br/>use nostr::{<br/> event::{Event, EventBuilder, EventId, Kind, Tag, TagKind},<br/> filter::Filter,<br/> hashes::sha1::Hash as Sha1Hash,<br/> nips::{nip10::Marker, nip19::ToBech32},<br/> types::RelayUrl,<br/>};<br/><br/>use super::{<br/> issue::IssueStatus,<br/> patch::PatchStatus,<br/> types::{NaddrOrSet, NostrEvent},<br/>};<br/>use crate::{<br/> cli::traits::{OptionNaddrOrSetVecExt, RelayOrSetVecExt},<br/> nostr_utils::{NostrClient, traits::NaddrsUtils, utils},<br/>};<br/>use crate::{<br/> cli::{CliOptions, patch::GitPatch},<br/> error::{N34Error, N34Result},<br/> nostr_utils::traits::{GitIssueUtils, GitPatchUtils, ReposUtils},<br/>};<br/><br/>/// Updates the issue's status to `new_status` after validating it with<br/>/// `check_fn`.<br/>pub async fn issue_status_command(<br/> options: CliOptions,<br/> issue_id: NostrEvent,<br/> naddrs: Option<Vec<NaddrOrSet>>,<br/> new_status: IssueStatus,<br/> check_fn: impl FnOnce(&IssueStatus) -> N34Result<()>,<br/>) -> N34Result<()> {<br/> let naddrs = utils::naddrs_or_file(<br/> naddrs.flat_naddrs(&options.config.sets)?,<br/> &utils::nostr_address_path()?,<br/> )?;<br/> let relays = options.relays.clone().flat_relays(&options.config.sets)?;<br/> let client = NostrClient::init(&options, &relays).await;<br/> let user_pubk = client.pubkey().await?;<br/> client<br/> .add_relays(&[naddrs.extract_relays(), issue_id.relays].concat())<br/> .await;<br/><br/> let owners = naddrs.extract_owners();<br/> let coordinates = naddrs.clone().into_coordinates();<br/> let repos = client.fetch_repos(&coordinates).await?;<br/> let maintainers = repos.extract_maintainers();<br/> let relay_hint = repos.extract_relays().first().cloned();<br/> client.add_relays(&repos.extract_relays()).await;<br/><br/> let issue_event = client<br/> .fetch_event(Filter::new().id(issue_id.event_id))<br/> .await?<br/> .ok_or(N34Error::CanNotFoundIssue)?;<br/><br/> let issue_status = client<br/> .fetch_issue_status(<br/> issue_id.event_id,<br/> [maintainers.as_slice(), &[issue_event.pubkey], &owners].concat(),<br/> )<br/> .await?;<br/><br/> check_fn(&issue_status)?;<br/><br/> let status_event = EventBuilder::new(new_status.kind(), "")<br/> .pow(options.pow.unwrap_or_default())<br/> .tag(utils::event_reply_tag(<br/> &issue_id.event_id,<br/> relay_hint.as_ref(),<br/> Marker::Root,<br/> ))<br/> .tag(Tag::public_key(issue_event.pubkey))<br/> .tags(maintainers.iter().map(|p| Tag::public_key(*p)))<br/> .tags(owners.iter().map(|p| Tag::public_key(*p)))<br/> .tags(<br/> coordinates<br/> .into_iter()<br/> .map(|c| Tag::coordinate(c, relay_hint.clone())),<br/> )<br/> .dedup_tags()<br/> .build(user_pubk);<br/><br/> let event_id = status_event.id.expect("There is an id");<br/> let user_relays_list = client.user_relays_list(user_pubk).await?;<br/> let write_relays = [<br/> relays,<br/> naddrs.extract_relays(),<br/> repos.extract_relays(),<br/> utils::add_write_relays(user_relays_list.as_ref()),<br/> client.read_relays_from_user(issue_event.pubkey).await,<br/> client<br/> .read_relays_from_users(&[maintainers, owners].concat())<br/> .await,<br/> ]<br/> .concat();<br/><br/> let success = client<br/> .send_event_to(status_event, user_relays_list.as_ref(), &write_relays)<br/> .await?;<br/> let nevent = utils::new_nevent(event_id, &success)?;<br/> println!("Issue status created: {nevent}");<br/><br/> Ok(())<br/>}<br/><br/>/// Updates the patch's status to `new_status` after validating it with<br/>/// `check_fn`.<br/>pub async fn patch_status_command(<br/> options: CliOptions,<br/> patch_id: NostrEvent,<br/> naddrs: Option<Vec<NaddrOrSet>>,<br/> new_status: PatchStatus,<br/> merge_or_applied_commits: Option<Either<Sha1Hash, Vec<Sha1Hash>>>,<br/> merge_or_applied_patches: Vec<EventId>,<br/> check_fn: impl FnOnce(&PatchStatus) -> N34Result<()>,<br/>) -> N34Result<()> {<br/> let naddrs = utils::naddrs_or_file(<br/> naddrs.flat_naddrs(&options.config.sets)?,<br/> &utils::nostr_address_path()?,<br/> )?;<br/> let relays = options.relays.clone().flat_relays(&options.config.sets)?;<br/> let client = NostrClient::init(&options, &relays).await;<br/> let user_pubk = client.pubkey().await?;<br/> client<br/> .add_relays(&[naddrs.extract_relays(), patch_id.relays].concat())<br/> .await;<br/><br/> let owners = naddrs.extract_owners();<br/> let coordinates = naddrs.clone().into_coordinates();<br/> let repos = client.fetch_repos(&coordinates).await?;<br/> let maintainers = repos.extract_maintainers();<br/> let relay_hint = repos.extract_relays().first().cloned();<br/> client.add_relays(&repos.extract_relays()).await;<br/><br/> let patch_event = client.fetch_patch(patch_id.event_id).await?;<br/><br/> if patch_event.is_revision_patch() && !new_status.is_merged_or_applied() {<br/> return Err(N34Error::InvalidStatus(<br/> "Invalid action for patch revision. Only 'apply' or 'merge' are allowed, 'open', \<br/> 'close', and 'draft' are not supported."<br/> .to_owned(),<br/> ));<br/> }<br/><br/> let (root_patch, root_revision) = get_patch_root_revision(&patch_event)?;<br/> let patch_status = client<br/> .fetch_patch_status(<br/> root_patch,<br/> root_revision,<br/> [maintainers.as_slice(), &[patch_event.pubkey], &owners].concat(),<br/> )<br/> .await?;<br/><br/> check_fn(&patch_status)?;<br/><br/> let mut status_builder = EventBuilder::new(new_status.kind(), "")<br/> .pow(options.pow.unwrap_or_default())<br/> .tag(utils::event_reply_tag(<br/> &root_patch,<br/> relay_hint.as_ref(),<br/> Marker::Root,<br/> ))<br/> .tag(Tag::public_key(patch_event.pubkey))<br/> .tags(maintainers.iter().map(|p| Tag::public_key(*p)))<br/> .tags(owners.iter().map(|p| Tag::public_key(*p)))<br/> .tags(<br/> coordinates<br/> .into_iter()<br/> .map(|c| Tag::coordinate(c, relay_hint.clone())),<br/> );<br/><br/> if new_status.is_merged_or_applied() {<br/> if let Some(merge_commit) = merge_or_applied_commits<br/> .as_ref()<br/> .and_then(|e| e.as_ref().left())<br/> {<br/> let commit = merge_commit.to_string();<br/> status_builder = status_builder<br/> .tag(Tag::custom(<br/> TagKind::custom("merge-commit"),<br/> iter::once(&commit),<br/> ))<br/> .tag(Tag::reference(commit));<br/> } else if let Some(applied_commits) = merge_or_applied_commits.and_then(|e| e.right()) {<br/> let commits = applied_commits<br/> .iter()<br/> .map(ToString::to_string)<br/> .collect::<Vec<_>>();<br/> status_builder = status_builder<br/> .tag(Tag::custom(TagKind::custom("applied-as-commits"), &commits))<br/> .tags(commits.into_iter().map(Tag::reference));<br/> };<br/><br/> if let Some(root_revision) = root_revision {<br/> status_builder = status_builder.tag(utils::event_reply_tag(<br/> &root_revision,<br/> relay_hint.as_ref(),<br/> Marker::Reply,<br/> ));<br/> }<br/><br/> if !merge_or_applied_patches.is_empty() {<br/> status_builder = status_builder.tags(<br/> build_patches_quote(client.clone(), relay_hint.clone(), merge_or_applied_patches)<br/> .await,<br/> );<br/> }<br/> }<br/><br/> let status_event = status_builder.dedup_tags().build(user_pubk);<br/><br/> let event_id = status_event.id.expect("There is an id");<br/> let user_relays_list = client.user_relays_list(user_pubk).await?;<br/> let write_relays = [<br/> relays,<br/> naddrs.extract_relays(),<br/> repos.extract_relays(),<br/> utils::add_write_relays(user_relays_list.as_ref()),<br/> client.read_relays_from_user(patch_event.pubkey).await,<br/> client<br/> .read_relays_from_users(&[maintainers, owners].concat())<br/> .await,<br/> ]<br/> .concat();<br/><br/> let success = client<br/> .send_event_to(status_event, user_relays_list.as_ref(), &write_relays)<br/> .await?;<br/> let nevent = utils::new_nevent(event_id, &success)?;<br/> println!("Patch status created: {nevent}");<br/><br/> Ok(())<br/>}<br/><br/>/// Fetch and display patches and issues for given repositories.<br/>/// If `list_patches` is true, lists patches instead of issues.<br/>/// `limit` controls the maximum number of items to fetch.<br/>pub async fn list_patches_and_issues(<br/> options: CliOptions,<br/> naddrs: Option<Vec<NaddrOrSet>>,<br/> list_patches: bool,<br/> limit: usize,<br/>) -> N34Result<()> {<br/> let naddrs = utils::check_empty_naddrs(utils::naddrs_or_file(<br/> naddrs.flat_naddrs(&options.config.sets)?,<br/> &utils::nostr_address_path()?,<br/> )?)?;<br/><br/> let relays = options.relays.clone().flat_relays(&options.config.sets)?;<br/> let client = NostrClient::init(&options, &relays).await;<br/> client.add_relays(&naddrs.extract_relays()).await;<br/><br/> let coordinates = naddrs.clone().into_coordinates();<br/> let repos = client.fetch_repos(&coordinates).await?;<br/> let authorized_pubkeys = [naddrs.extract_owners(), repos.extract_maintainers()].concat();<br/> client.add_relays(&repos.extract_relays()).await;<br/> // This helps discover issues and their status.<br/> client<br/> .add_relays(&client.read_relays_from_users(&authorized_pubkeys).await)<br/> .await;<br/><br/> let kind = if list_patches {<br/> Kind::GitPatch<br/> } else {<br/> Kind::GitIssue<br/> };<br/><br/> let mut filter = Filter::new()<br/> .coordinates(coordinates.iter())<br/> .kind(kind)<br/> .limit(limit);<br/><br/> if list_patches {<br/> filter = filter.hashtag("root");<br/> }<br/><br/> let arc_client = Arc::new(client);<br/> // Events are sorted by kind in ascending order:<br/> // 1630 (Open), 1631 (Resolved/Applied), 1632 (Closed), 1633 (Draft)<br/> let events = utils::sort_by_key(<br/> future::join_all(<br/> arc_client<br/> .fetch_events(filter)<br/> .await?<br/> .into_iter()<br/> .take(limit)<br/> .map(|event| {<br/> let c = arc_client.clone();<br/> let keys = authorized_pubkeys.clone();<br/> async move {<br/> let status = if list_patches {<br/> let (root, root_revision) = get_patch_root_revision(&event)?;<br/> c.fetch_patch_status(<br/> root,<br/> root_revision,<br/> [keys.as_slice(), &[event.pubkey]].concat(),<br/> )<br/> .await<br/> .map(Either::Left)?<br/> } else {<br/> c.fetch_issue_status(<br/> event.id,<br/> [keys.as_slice(), &[event.pubkey]].concat(),<br/> )<br/> .await<br/> .map(Either::Right)?<br/> };<br/> N34Result::Ok((event, status))<br/> }<br/> }),<br/> )<br/> .await<br/> .into_iter()<br/> .filter_map(|r| r.ok()),<br/> |(_, status)| status.as_ref().either_into::<Kind>(),<br/> );<br/><br/> let lines = events<br/> .map(|(event, status)| format_patch_and_issue(&event, status))<br/> .collect::<Vec<String>>();<br/><br/> let max_width = lines<br/> .iter()<br/> .map(|s| s.split_once('\n').map_or(85, |(l, _)| l.chars().count()))<br/> .max()<br/> .unwrap_or(85)<br/> .max(67); // length of the event id<br/><br/> println!("{}", lines.join(&format!("{}\n", "-".repeat(max_width))));<br/><br/> Ok(())<br/>}<br/><br/>/// Returns a tuple of (root_id, patch_id) if this is a valid root or revision<br/>/// patch.<br/>fn get_patch_root_revision(patch_event: &Event) -> N34Result<(EventId, Option<EventId>)> {<br/> if patch_event.is_revision_patch() {<br/> Ok((<br/> patch_event.root_patch_from_revision()?,<br/> Some(patch_event.id),<br/> ))<br/> } else if patch_event.is_root_patch() {<br/> Ok((patch_event.id, None))<br/> } else {<br/> Err(N34Error::NotRootPatch)<br/> }<br/>}<br/><br/>/// Formats an event as either a patch or an issue. For patches, extracts the<br/>/// subject line from the Git patch format. For issues, combines the subject<br/>/// with labels. The output includes status and formatted ID.<br/>fn format_patch_and_issue(event: &Event, status: Either<PatchStatus, IssueStatus>) -> String {<br/> let subject = if status.is_left() {<br/> GitPatch::from_str(&event.content)<br/> .map(|p| p.subject)<br/> .unwrap_or_else(|_| {<br/> event<br/> .content<br/> .lines()<br/> .find(|line| line.trim().starts_with("Subject: "))<br/> .unwrap_or_default()<br/> .trim()<br/> .trim_start_matches("Subject: ")<br/> .to_owned()<br/> })<br/> } else {<br/> let labels = event.extract_issue_labels();<br/> let subject = event.extract_issue_subject();<br/><br/> if labels.is_empty() {<br/> subject.to_owned()<br/> } else {<br/> format!(r#""{subject}" {labels}"#)<br/> }<br/> };<br/> format!(<br/> "({status}) {}\nID: {}\n",<br/> utils::smart_wrap(&subject, 85),<br/> event.id.to_bech32().expect("Infallible")<br/> )<br/>}<br/><br/>/// Generates a list of tags for quoting patches in merge/applied status events.<br/>async fn build_patches_quote(<br/> client: NostrClient,<br/> relay_hint: Option<RelayUrl>,<br/> patches: Vec<EventId>,<br/>) -> Vec<Tag> {<br/> let client = Arc::new(client);<br/> let relay_hint = Arc::new(relay_hint);<br/><br/> future::join_all(patches.into_iter().map(|eid| {<br/> let task_relay = Arc::clone(&relay_hint);<br/> let task_client = Arc::clone(&client);<br/><br/> async move {<br/> Tag::custom(<br/> TagKind::q(),<br/> [<br/> eid.to_hex(),<br/> task_relay<br/> .as_ref()<br/> .as_ref()<br/> .map(|r| r.to_string())<br/> .unwrap_or_default(),<br/> task_client<br/> .event_author(eid)<br/> .await<br/> .ok()<br/> .flatten()<br/> .map(|p| p.to_hex())<br/> .unwrap_or_default(),<br/> ],<br/> )<br/> }<br/> }))<br/> .await<br/>}<br/>
2026-10-09T01:54:39Zhttps://njump.me/nevent1qqsy40u7x6eqclcucu0g56vgv7majwtcak73jr2wpghh9j77zx9v5uqzyp2xhcyfwmc3jdu98up2074n3zznz6ye259qzdm0pp7qwhqtg2z6j8uq0k2// n34 - A CLI to interact with NIP-34 and other stuff related to ...
// n34 - A CLI to interact with NIP-34 and other stuff related to codes in nostr<br/>// Copyright (C) 2025 Awiteb <a@4rs.nl><br/>//<br/>// This program is free software: you can redistribute it and/or modify<br/>// it under the terms of the GNU General Public License as published by<br/>// the Free Software Foundation, either version 3 of the License, or<br/>// (at your option) any later version.<br/>//<br/>// This program is distributed in the hope that it will be useful,<br/>// but WITHOUT ANY WARRANTY; without even the implied warranty of<br/>// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the<br/>// GNU General Public License for more details.<br/>//<br/>// You should have received a copy of the GNU General Public License<br/>// along with this program. If not, see <<a href="https://gnu.org/licenses/gpl-3.0.html>">https://gnu.org/licenses/gpl-3.0.html></a>;.<br/><br/>use nostr::{event::EventId, nips::nip19::Nip19Coordinate, types::RelayUrl};<br/><br/>use super::CliOptions;<br/>use crate::{<br/> cli::{<br/> ConfigError,<br/> RepoRelaySet,<br/> types::{NaddrOrSet, NostrEvent, RelayOrSet},<br/> },<br/> error::{N34Error, N34Result},<br/>};<br/><br/>/// A trait defining the interface for command runners in the CLI.<br/>pub trait CommandRunner {<br/> /// Whether this command needs the relays option (false by default).<br/> /// Only applies to commands, not subcommands.<br/> const NEED_RELAYS: bool = false;<br/> /// Indicates if this command requires the signer. Defaults to true.<br/> /// Only applies to commands, not subcommands.<br/> const NEED_SIGNER: bool = true;<br/><br/> /// Executes the command and returns a Result indicating success or failure.<br/> fn run(self, options: CliOptions) -> impl Future<Output = N34Result<()>> + Send;<br/>}<br/><br/>#[easy_ext::ext(VecNostrEventExt)]<br/>impl Vec<NostrEvent> {<br/> /// Extracts `EventId` from each `NostrEvent` and collects them into a<br/> /// `Vec<EventId>`.<br/> pub fn into_event_ids(self) -> Vec<EventId> {<br/> self.into_iter().map(|e| e.event_id).collect()<br/> }<br/>}<br/><br/>#[easy_ext::ext(NaddrOrSetVecExt)]<br/>impl Vec<NaddrOrSet> {<br/> /// Converts this vector of [`NaddrOrSet`] into a flat vector of<br/> /// [`Nip19Coordinate`] using the given sets.<br/> pub fn flat_naddrs(self, sets: &[RepoRelaySet]) -> N34Result<Vec<Nip19Coordinate>> {<br/> self.into_iter()<br/> .map(|n| n.get_naddrs(sets))<br/> .try_fold(Vec::new(), |mut acc, item| {<br/> acc.extend(item?);<br/> Ok(acc)<br/> })<br/> }<br/>}<br/><br/>#[easy_ext::ext(RelayOrSetVecExt)]<br/>impl Vec<RelayOrSet> {<br/> /// Converts this vector of [`RelayOrSet`] into a flat vector of<br/> /// [`RelayUrl`] using the given sets.<br/> pub fn flat_relays(self, sets: &[RepoRelaySet]) -> N34Result<Vec<RelayUrl>> {<br/> self.into_iter()<br/> .map(|n| n.get_relays(sets))<br/> .try_fold(Vec::new(), |mut acc, item| {<br/> acc.extend(item?);<br/> Ok(acc)<br/> })<br/> }<br/>}<br/><br/><br/>#[easy_ext::ext(OptionNaddrOrSetVecExt)]<br/>impl Option<Vec<NaddrOrSet>> {<br/> /// Converts this vector of [`NaddrOrSet`] into a flat vector of<br/> /// [`Nip19Coordinate`] using the given sets.<br/> pub fn flat_naddrs(&self, sets: &[RepoRelaySet]) -> N34Result<Option<Vec<Nip19Coordinate>>> {<br/> // Clones self here to simplify command code<br/> self.clone()<br/> .map(|naddrs| naddrs.flat_naddrs(sets))<br/> .transpose()<br/> }<br/>}<br/><br/>#[easy_ext::ext(MutRepoRelaySetsExt)]<br/>impl Vec<RepoRelaySet> {<br/> /// Removes duplicate repository addresses from each set.<br/> ///<br/> /// Relays are automatically deduplicated by the HashSet, but<br/> /// repository addresses may appear duplicated if relays are sorted<br/> /// differently or when relay counts vary. This compares addresses by<br/> /// their coordinates, ignoring any embedded relay details.<br/> pub fn dedup_naddrs(&mut self) {<br/> self.iter_mut().for_each(RepoRelaySet::dedup_naddrs);<br/> }<br/><br/> /// Finds and returns a mutable reference a set with the given name. Returns<br/> /// an error if no set with this name exists.<br/> pub fn get_mut_set(&mut self, name: impl AsRef<str>) -> N34Result<&mut RepoRelaySet> {<br/> let name = name.as_ref();<br/> let set = self<br/> .iter_mut()<br/> .find(|set| set.name == name)<br/> .ok_or_else(|| N34Error::from(ConfigError::SetNotFound(name.to_owned())))?;<br/><br/> tracing::trace!(<br/> name = %name, set = ?set,<br/> "Successfully located a set with the giving name"<br/> );<br/><br/> Ok(set)<br/> }<br/><br/> /// Creates and pushes a new set with the given name.<br/> ///<br/> /// Returns an error if a set with the same name already exists.<br/> pub fn push_set(<br/> &mut self,<br/> name: impl Into<String>,<br/> repos: impl IntoIterator<Item = Nip19Coordinate>,<br/> relays: impl IntoIterator<Item = RelayUrl>,<br/> ) -> N34Result<()> {<br/> let set_name: String = name.into();<br/> tracing::trace!(sets = ?self, "Pushing set '{set_name}' to sets collection");<br/><br/> if self.as_slice().exists(&set_name) {<br/> return Err(ConfigError::SetDuplicateName(set_name).into());<br/> }<br/><br/> self.push(RepoRelaySet::new(set_name, repos, relays));<br/><br/> Ok(())<br/> }<br/><br/> /// Removes the set with the given name if it exists. Returns an error if<br/> /// the set is not found.<br/> pub fn remove_set(&mut self, name: impl Into<String>) -> N34Result<()> {<br/> let set_name: String = name.into();<br/> tracing::trace!(set_name, sets = ?self, "Removing set '{set_name}' from sets collection");<br/><br/> if !self.as_slice().exists(&set_name) {<br/> return Err(ConfigError::SetNotFound(set_name).into());<br/> }<br/><br/> self.retain(|s| s.name != set_name);<br/><br/> Ok(())<br/> }<br/><br/> /// Removes the given relays from the specified set.<br/> pub fn remove_relays(<br/> &mut self,<br/> name: impl Into<String>,<br/> relays: impl Iterator<Item = RelayUrl>,<br/> ) -> N34Result<()> {<br/> let relays = Vec::from_iter(relays);<br/> let set = self.get_mut_set(name.into())?;<br/><br/> set.relays.retain(|r| !relays.contains(r));<br/><br/> Ok(())<br/> }<br/><br/> /// Removes the given naddrs from the specified set.<br/> pub fn remove_naddrs(<br/> &mut self,<br/> name: impl Into<String>,<br/> naddrs: impl Iterator<Item = Nip19Coordinate>,<br/> ) -> N34Result<()> {<br/> let coordinates = Vec::from_iter(naddrs.map(|n| n.coordinate));<br/> let set = self.get_mut_set(name.into())?;<br/><br/> set.naddrs.retain(|n| !coordinates.contains(&n.coordinate));<br/><br/> Ok(())<br/> }<br/>}<br/><br/>#[easy_ext::ext(RepoRelaySetsExt)]<br/>impl &[RepoRelaySet] {<br/> /// Checks for duplicate set names. Returns an error if any duplicates are<br/> /// found.<br/> pub fn ensure_names(&self) -> N34Result<()> {<br/> let mut names = Vec::with_capacity(self.len());<br/> names.extend(self.iter().map(|s| s.name.to_owned()));<br/><br/> names.sort_unstable();<br/><br/> if let Some(duplicate) = duplicate_in_sorted(&names) {<br/> return Err(ConfigError::SetDuplicateName(duplicate.clone()).into());<br/> }<br/> Ok(())<br/> }<br/><br/> /// Check if a set with the given name exists.<br/> pub fn exists(&self, set_name: &str) -> bool {<br/> self.iter().any(|set| set.name == set_name)<br/> }<br/><br/> /// Finds and returns a reference a set with the given name. Returns an<br/> /// error if no set with this name exists.<br/> pub fn get_set(&self, name: impl AsRef<str>) -> N34Result<&RepoRelaySet> {<br/> let name = name.as_ref();<br/> let set = self<br/> .iter()<br/> .find(|set| set.name == name)<br/> .ok_or_else(|| N34Error::from(ConfigError::SetNotFound(name.to_owned())))?;<br/> tracing::trace!(<br/> name = %name, set = ?set,<br/> "Successfully located a set with the giving name"<br/> );<br/> Ok(set)<br/> }<br/>}<br/><br/>/// Helper function that checks for duplicates in a sorted slice<br/>fn duplicate_in_sorted<T: PartialEq + Clone>(items: &[T]) -> Option<&T> {<br/> items.windows(2).find(|w| w[0] == w[1]).map(|w| &w[0])<br/>}<br/>
2026-10-09T01:54:39Zhttps://njump.me/nevent1qqszjj980zmfq27z5wzsthsqdj74fr6u46n7lgpt80h5ckkehfzm2qgzyp2xhcyfwmc3jdu98up2074n3zznz6ye259qzdm0pp7qwhqtg2z6jt2gnjv// n34 - A CLI to interact with NIP-34 and other stuff related to ...
// n34 - A CLI to interact with NIP-34 and other stuff related to codes in nostr<br/>// Copyright (C) 2025 Awiteb <a@4rs.nl><br/>//<br/>// This program is free software: you can redistribute it and/or modify<br/>// it under the terms of the GNU General Public License as published by<br/>// the Free Software Foundation, either version 3 of the License, or<br/>// (at your option) any later version.<br/>//<br/>// This program is distributed in the hope that it will be useful,<br/>// but WITHOUT ANY WARRANTY; without even the implied warranty of<br/>// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the<br/>// GNU General Public License for more details.<br/>//<br/>// You should have received a copy of the GNU General Public License<br/>// along with this program. If not, see <<a href="https://gnu.org/licenses/gpl-3.0.html>">https://gnu.org/licenses/gpl-3.0.html></a>;.<br/><br/>use std::{collections::HashSet, fs, net::SocketAddr, path::PathBuf};<br/><br/>use nostr::{<br/> nips::{nip19::Nip19Coordinate, nip46::NostrConnectURI},<br/> types::RelayUrl,<br/>};<br/><br/>use crate::{<br/> cli::traits::{MutRepoRelaySetsExt, RepoRelaySetsExt},<br/> error::N34Result,<br/>};<br/><br/>/// Errors that can occur when working with configuration files.<br/>#[derive(thiserror::Error, Debug)]<br/>pub enum ConfigError {<br/> #[error(<br/> "Could not determine the default config path: both `$XDG_CONFIG_HOME` and `$HOME` \<br/> environment variables are missing or unset."<br/> )]<br/> CanNotFindConfigPath,<br/> #[error("Couldn't read the config file: {0}")]<br/> ReadFile(std::io::Error),<br/> #[error("Couldn't write in the config file: {0}")]<br/> WriteFile(std::io::Error),<br/> #[error("Couldn't serialize the config. This is a bug, please report it: {0}")]<br/> Serialize(toml::ser::Error),<br/> #[error("Failed to parse the config file: {0}")]<br/> ParseFile(toml::de::Error),<br/> #[error("Duplicate configuration set name detected: '{0}'. Each set must have a unique name.")]<br/> SetDuplicateName(String),<br/> #[error("No set with the given name `{0}`")]<br/> SetNotFound(String),<br/> #[error("You can't create an new empty set.")]<br/> NewEmptySet,<br/>}<br/><br/>/// Configuration for the command-line interface.<br/>#[derive(serde::Serialize, serde::Deserialize, Clone, Default, Debug)]<br/>pub struct CliConfig {<br/> /// Path to the configuration file (not serialized)<br/> #[serde(skip)]<br/> path: PathBuf,<br/> /// Groups of repositories and relays.<br/> #[serde(default, skip_serializing_if = "Vec::is_empty")]<br/> pub sets: Vec<RepoRelaySet>,<br/> /// The default PoW difficulty<br/> #[serde(skip_serializing_if = "Option::is_none")]<br/> pub pow: Option<u8>,<br/> /// List of fallback relays used if no fallback relays was provided.<br/> #[serde(skip_serializing_if = "Option::is_none")]<br/> pub fallback_relays: Option<Vec<RelayUrl>>,<br/> /// Default Nostr bunker URL used for signing events.<br/> #[serde(<br/> default,<br/> skip_serializing_if = "Option::is_none",<br/> deserialize_with = "super::parsers::de_bunker_url",<br/> serialize_with = "super::parsers::ser_bunker_url"<br/> )]<br/> pub bunker_url: Option<NostrConnectURI>,<br/> /// Whether to use the system keyring to store the secret key.<br/> #[serde(default)]<br/> pub keyring_secret_key: bool,<br/> /// Signs events using the browser's NIP-07 extension.<br/> #[serde(default)]<br/> pub nip07: Option<SocketAddr>,<br/>}<br/><br/>/// A named group of repositories and relays.<br/>#[derive(serde::Serialize, serde::Deserialize, Default, Clone, Debug)]<br/>pub struct RepoRelaySet {<br/> /// Unique identifier for this group.<br/> pub name: String,<br/> /// Repository addresses in this group.<br/> #[serde(<br/> default,<br/> skip_serializing_if = "HashSet::is_empty",<br/> serialize_with = "super::parsers::ser_naddrs",<br/> deserialize_with = "super::parsers::de_naddrs"<br/> )]<br/> pub naddrs: HashSet<Nip19Coordinate>,<br/> /// Relay URLs in this group.<br/> #[serde(default, skip_serializing_if = "HashSet::is_empty")]<br/> pub relays: HashSet<RelayUrl>,<br/>}<br/><br/>impl CliConfig {<br/> /// Reads and parse a TOML config file from the given path, creating it if<br/> /// missing.<br/> pub fn load(file_path: PathBuf) -> N34Result<Self> {<br/> tracing::info!(path = %file_path.display(), "Loading configuration from file");<br/> // Make sure the file is exist<br/> if let Some(parent) = file_path.parent()<br/> && !parent.exists()<br/> {<br/> fs::create_dir_all(parent)?;<br/> }<br/><br/> let _ = fs::File::create_new(&file_path);<br/><br/> let mut config: Self =<br/> toml::from_str(&fs::read_to_string(&file_path).map_err(ConfigError::ReadFile)?)<br/> .map_err(ConfigError::ParseFile)?;<br/> config.path = file_path;<br/><br/> config.post_sets()?;<br/><br/> Ok(config)<br/> }<br/><br/> /// Dump the config as toml in a file<br/> pub fn dump(mut self) -> N34Result<()> {<br/> tracing::debug!(config = ?self, "Writing configuration to {}", self.path.display());<br/> self.post_sets()?;<br/><br/> fs::write(<br/> &self.path,<br/> toml::to_string_pretty(&self).map_err(ConfigError::Serialize)?,<br/> )<br/> .map_err(ConfigError::WriteFile)?;<br/><br/> Ok(())<br/> }<br/><br/> /// Performs post-processing validation on the sets after loading or before<br/> /// dumping.<br/> fn post_sets(&mut self) -> N34Result<()> {<br/> self.sets.as_slice().ensure_names()?;<br/> self.sets.dedup_naddrs();<br/><br/> Ok(())<br/> }<br/>}<br/><br/>impl RepoRelaySet {<br/> /// Create a new [`RepoRelaySet`]<br/> pub fn new(<br/> name: impl Into<String>,<br/> naddrs: impl IntoIterator<Item = Nip19Coordinate>,<br/> relays: impl IntoIterator<Item = RelayUrl>,<br/> ) -> Self {<br/> Self {<br/> name: name.into(),<br/> naddrs: HashSet::from_iter(naddrs),<br/> relays: HashSet::from_iter(relays),<br/> }<br/> }<br/><br/> /// Removes duplicate repository addresses by comparing their coordinates,<br/> /// ignoring embedded relays.<br/> pub fn dedup_naddrs(&mut self) {<br/> let mut seen = HashSet::new();<br/> self.naddrs.retain(|n| seen.insert(n.coordinate.clone()));<br/> }<br/>}<br/>
2026-10-09T01:54:39Zhttps://njump.me/nevent1qqszx6mast5zs6plrngec3skglknw9pt77vapz6fqjx6wwsxnpsehzgzyp2xhcyfwmc3jdu98up2074n3zznz6ye259qzdm0pp7qwhqtg2z6jpfelp8// n34 - A CLI to interact with NIP-34 and other stuff related to ...
// n34 - A CLI to interact with NIP-34 and other stuff related to codes in nostr<br/>// Copyright (C) 2025 Awiteb <a@4rs.nl><br/>//<br/>// This program is free software: you can redistribute it and/or modify<br/>// it under the terms of the GNU General Public License as published by<br/>// the Free Software Foundation, either version 3 of the License, or<br/>// (at your option) any later version.<br/>//<br/>// This program is distributed in the hope that it will be useful,<br/>// but WITHOUT ANY WARRANTY; without even the implied warranty of<br/>// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the<br/>// GNU General Public License for more details.<br/>//<br/>// You should have received a copy of the GNU General Public License<br/>// along with this program. If not, see <<a href="https://gnu.org/licenses/gpl-3.0.html>">https://gnu.org/licenses/gpl-3.0.html></a>;.<br/><br/>use std::{<br/> collections::HashSet,<br/> fs,<br/> path::{Path, PathBuf},<br/>};<br/><br/>use nostr::{<br/> Kind,<br/> nips::{<br/> nip19::{FromBech32, Nip19Coordinate, ToBech32},<br/> nip46::NostrConnectURI,<br/> },<br/>};<br/>use serde::{Deserialize, Serialize, Serializer};<br/><br/>use super::CliConfig;<br/>use crate::{<br/> cli::DEFAULT_FALLBACK_PATH,<br/> error::{N34Error, N34Result},<br/>};<br/><br/>pub fn parse_repo_naddr(repo_naddr: &str) -> Result<Nip19Coordinate, String> {<br/> let naddr = Nip19Coordinate::from_bech32(repo_naddr).map_err(|err| err.to_string())?;<br/> if naddr.relays.is_empty() {<br/> tracing::warn!("The repository naddr does not contain any relay hints");<br/> }<br/><br/> (naddr.kind == Kind::GitRepoAnnouncement)<br/> .then_some(naddr)<br/> .ok_or_else(|| "Invalid naddr: must be of kind 30617 (GitRepoAnnouncement)".to_owned())<br/>}<br/><br/>/// Parses a nostr-address file into a NIP-19 coordinates. Expects the file to<br/>/// contain a repository announcements.<br/>pub fn parse_nostr_address_file(file_path: &Path) -> N34Result<Vec<Nip19Coordinate>> {<br/> let addresses = fs::read_to_string(file_path)<br/> .map_err(N34Error::CanNotReadNostrAddressFile)?<br/> .split("\n")<br/> .filter_map(|line| {<br/> (!line.starts_with("#") && !line.trim().is_empty())<br/> .then_some(parse_repo_naddr(line).map_err(N34Error::InvalidNostrAddressFileContent))<br/> })<br/> .collect::<N34Result<Vec<Nip19Coordinate>>>()?;<br/> if addresses.is_empty() {<br/> return Err(N34Error::EmptyNostrAddressFile);<br/> }<br/> Ok(addresses)<br/>}<br/><br/>/// Loads CLI configuration from given path. Uses default config path if input<br/>/// matches fallback path.<br/>pub fn parse_config_path(config_path: &str) -> N34Result<CliConfig> {<br/> let mut path = PathBuf::from(config_path.trim());<br/><br/> if config_path == DEFAULT_FALLBACK_PATH {<br/> path = super::defaults::config_path()?;<br/> };<br/><br/> CliConfig::load(path)<br/>}<br/><br/>/// Parses a bunker URL and checks if it's a valid Nostr Connect URI.<br/>/// Returns an error if the URL is not a valid bunker URL.<br/>pub fn parse_bunker_url(bunker_url: &str) -> N34Result<NostrConnectURI> {<br/> match NostrConnectURI::parse(bunker_url) {<br/> Ok(url) if url.is_bunker() => Ok(url),<br/> _ => Err(N34Error::NotBunkerUrl),<br/> }<br/>}<br/><br/>/// Serializes a set of NIP-19 coordinates as a list of bech32 strings.<br/>pub fn ser_naddrs<S>(naddr: &HashSet<Nip19Coordinate>, serializer: S) -> Result<S::Ok, S::Error><br/>where<br/> S: Serializer,<br/>{<br/> let str_naddrs = naddr<br/> .iter()<br/> .map(|n| n.to_bech32().map_err(|err| err.to_string()))<br/> .collect::<Result<Vec<_>, _>>()<br/> .map_err(serde::ser::Error::custom)?;<br/><br/> str_naddrs.serialize(serializer)<br/>}<br/><br/>/// Deserializes a list of bech32 strings into a set of NIP-19 coordinates.<br/>pub fn de_naddrs<'de, D>(deserializer: D) -> Result<HashSet<Nip19Coordinate>, D::Error><br/>where<br/> D: serde::Deserializer<'de>,<br/>{<br/> Vec::<String>::deserialize(deserializer)?<br/> .into_iter()<br/> .map(|naddr| Nip19Coordinate::from_bech32(&naddr))<br/> .collect::<Result<HashSet<_>, _>>()<br/> .map_err(serde::de::Error::custom)<br/>}<br/><br/>pub fn ser_bunker_url<S>(<br/> bunker_url: &Option<NostrConnectURI>,<br/> serializer: S,<br/>) -> Result<S::Ok, S::Error><br/>where<br/> S: Serializer,<br/>{<br/> bunker_url<br/> .as_ref()<br/> .map(|u| u.to_string())<br/> .serialize(serializer)<br/>}<br/><br/>pub fn de_bunker_url<'de, D>(deserializer: D) -> Result<Option<NostrConnectURI>, D::Error><br/>where<br/> D: serde::Deserializer<'de>,<br/>{<br/> Option::<String>::deserialize(deserializer)?<br/> .map(|u| parse_bunker_url(&u))<br/> .transpose()<br/> .map_err(serde::de::Error::custom)<br/>}<br/>
2026-10-09T01:54:39Zhttps://njump.me/nevent1qqspk3wpvp59cfa8vz5wlufgcgq6xp7p3w02cjaa6pl4qy8hk2grxfqzyp2xhcyfwmc3jdu98up2074n3zznz6ye259qzdm0pp7qwhqtg2z6jrddwdz// n34 - A CLI to interact with NIP-34 and other stuff related to ...
// n34 - A CLI to interact with NIP-34 and other stuff related to codes in nostr<br/>// Copyright (C) 2025 Awiteb <a@4rs.nl><br/>//<br/>// This program is free software: you can redistribute it and/or modify<br/>// it under the terms of the GNU General Public License as published by<br/>// the Free Software Foundation, either version 3 of the License, or<br/>// (at your option) any later version.<br/>//<br/>// This program is distributed in the hope that it will be useful,<br/>// but WITHOUT ANY WARRANTY; without even the implied warranty of<br/>// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the<br/>// GNU General Public License for more details.<br/>//<br/>// You should have received a copy of the GNU General Public License<br/>// along with this program. If not, see <<a href="https://gnu.org/licenses/gpl-3.0.html>">https://gnu.org/licenses/gpl-3.0.html></a>;.<br/><br/>/// Command line interface module<br/>pub mod cli;<br/>/// N34 errors<br/>pub mod error;<br/>/// Nostr utils module<br/>pub mod nostr_utils;<br/><br/>use std::{<br/> process::ExitCode,<br/> sync::atomic::{AtomicBool, Ordering},<br/>};<br/><br/>use clap::Parser;<br/>use clap_verbosity_flag::Verbosity;<br/>use tracing::Level;<br/>use tracing_subscriber::{Layer, filter, layer::SubscriberExt};<br/><br/>use self::cli::Cli;<br/><br/>/// Whether the editor is currently open. Prevents logging while the editor is<br/>/// open.<br/>static EDITOR_OPEN: AtomicBool = AtomicBool::new(false);<br/><br/>/// Configures the logging level based on the provided verbosity.<br/>///<br/>/// When verbosity is set to TRACE, includes file and line numbers in logs.<br/>fn set_log_level(verbosity: Verbosity) {<br/> let is_trace = verbosity<br/> .tracing_level()<br/> .is_some_and(|l| l == tracing::Level::TRACE);<br/><br/> let logs_filter = filter::dynamic_filter_fn(move |m, _| {<br/> // Disable all logs while editor is open<br/> verbosity.tracing_level().unwrap_or(Level::ERROR) >= *m.level()<br/> && !EDITOR_OPEN.load(Ordering::Relaxed)<br/> });<br/><br/> let logs_layer = tracing_subscriber::fmt::layer()<br/> .with_file(is_trace)<br/> .with_line_number(is_trace)<br/> .without_time();<br/> let subscriber = tracing_subscriber::registry().with(logs_layer.with_filter(logs_filter));<br/> tracing::subscriber::set_global_default(subscriber).ok();<br/>}<br/><br/>#[tokio::main]<br/>async fn main() -> ExitCode {<br/> let cli = match cli::post_cli(Cli::parse()) {<br/> Ok(cli) => cli,<br/> Err(err) => {<br/> eprintln!("{err}");<br/> return ExitCode::FAILURE;<br/> }<br/> };<br/><br/> set_log_level(cli.verbosity);<br/><br/> if let Err(err) = cli.run().await {<br/> tracing::error!("{err}");<br/> return err.exit_code();<br/> }<br/><br/> ExitCode::SUCCESS<br/>}<br/>
2026-10-09T01:54:39Zhttps://njump.me/nevent1qqspp2wyv0luc6a649jdpnnhaxjcnymnwy6t6zkdc93mwuzkscvn2hszyp2xhcyfwmc3jdu98up2074n3zznz6ye259qzdm0pp7qwhqtg2z6jj8xyct// n34 - A CLI to interact with NIP-34 and other stuff related to ...
// n34 - A CLI to interact with NIP-34 and other stuff related to codes in nostr<br/>// Copyright (C) 2025 Awiteb <a@4rs.nl><br/>//<br/>// This program is free software: you can redistribute it and/or modify<br/>// it under the terms of the GNU General Public License as published by<br/>// the Free Software Foundation, either version 3 of the License, or<br/>// (at your option) any later version.<br/>//<br/>// This program is distributed in the hope that it will be useful,<br/>// but WITHOUT ANY WARRANTY; without even the implied warranty of<br/>// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the<br/>// GNU General Public License for more details.<br/>//<br/>// You should have received a copy of the GNU General Public License<br/>// along with this program. If not, see <<a href="https://gnu.org/licenses/gpl-3.0.html>">https://gnu.org/licenses/gpl-3.0.html></a>;.<br/><br/>use std::{<br/> net::{Ipv4Addr, SocketAddr, SocketAddrV4},<br/> time::Duration,<br/>};<br/><br/>use nostr_browser_signer_proxy::{BrowserSignerProxy, BrowserSignerProxyOptions};<br/><br/>/// The default socket address used for the NIP-07 signer proxy, set to<br/>/// localhost on port 51034.<br/>pub const DEFAULT_NIP07_PROXY_ADDR: SocketAddr =<br/> SocketAddr::V4(SocketAddrV4::new(Ipv4Addr::LOCALHOST, 51034));<br/><br/>/// How long to wait for the proxy response (3 minutes).<br/>pub const BROWSER_SIGNER_PROXY_TIMEOUT: Duration = Duration::from_secs(60 * 3);<br/><br/><br/>/// Represents the state used for CLI options.<br/>pub struct OptionsState {<br/> /// The browser signer proxy, will be used if `--nip07` is enabled<br/> pub browser_signer_proxy: BrowserSignerProxy,<br/>}<br/><br/>impl Default for OptionsState {<br/> fn default() -> Self {<br/> Self {<br/> browser_signer_proxy: default_browser_signer_proxy(),<br/> }<br/> }<br/>}<br/><br/>/// Build the default browser signer proxy<br/>#[inline]<br/>fn default_browser_signer_proxy() -> BrowserSignerProxy {<br/> BrowserSignerProxy::new(<br/> BrowserSignerProxyOptions::default()<br/> .timeout(BROWSER_SIGNER_PROXY_TIMEOUT)<br/> .ip_addr(DEFAULT_NIP07_PROXY_ADDR.ip())<br/> .port(DEFAULT_NIP07_PROXY_ADDR.port()),<br/> )<br/>}<br/>
2026-10-09T01:54:39Zhttps://njump.me/nevent1qqsq9dtqvdk3vv07k2w4uumwnj6ejuzk8p09whky8l347926tn8yewqzyp2xhcyfwmc3jdu98up2074n3zznz6ye259qzdm0pp7qwhqtg2z6jchawca// n34 - A CLI to interact with NIP-34 and other stuff related to ...
// n34 - A CLI to interact with NIP-34 and other stuff related to codes in nostr<br/>// Copyright (C) 2025 Awiteb <a@4rs.nl><br/>//<br/>// This program is free software: you can redistribute it and/or modify<br/>// it under the terms of the GNU General Public License as published by<br/>// the Free Software Foundation, either version 3 of the License, or<br/>// (at your option) any later version.<br/>//<br/>// This program is distributed in the hope that it will be useful,<br/>// but WITHOUT ANY WARRANTY; without even the implied warranty of<br/>// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the<br/>// GNU General Public License for more details.<br/>//<br/>// You should have received a copy of the GNU General Public License<br/>// along with this program. If not, see <<a href="https://gnu.org/licenses/gpl-3.0.html>">https://gnu.org/licenses/gpl-3.0.html></a>;.<br/><br/>use std::path::PathBuf;<br/><br/>use crate::{cli::ConfigError, error::N34Result};<br/><br/><br/>/// Default config path<br/>pub fn config_path() -> N34Result<PathBuf> {<br/> Ok(dirs::config_dir()<br/> .ok_or(ConfigError::CanNotFindConfigPath)?<br/> .join("n34")<br/> .join("config.toml"))<br/>}<br/>
2026-10-09T01:54:39Zhttps://njump.me/nevent1qqsgkjgktvsdnq6yamrcuv9y8ke0zgekgh7thackn7vj3w8cpexvrxczyp2xhcyfwmc3jdu98up2074n3zznz6ye259qzdm0pp7qwhqtg2z6jaldzqp// n34 - A CLI to interact with NIP-34 and other stuff related to ...
// n34 - A CLI to interact with NIP-34 and other stuff related to codes in nostr<br/>// Copyright (C) 2025 Awiteb <a@4rs.nl><br/>//<br/>// This program is free software: you can redistribute it and/or modify<br/>// it under the terms of the GNU General Public License as published by<br/>// the Free Software Foundation, either version 3 of the License, or<br/>// (at your option) any later version.<br/>//<br/>// This program is distributed in the hope that it will be useful,<br/>// but WITHOUT ANY WARRANTY; without even the implied warranty of<br/>// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the<br/>// GNU General Public License for more details.<br/>//<br/>// You should have received a copy of the GNU General Public License<br/>// along with this program. If not, see <<a href="https://gnu.org/licenses/gpl-3.0.html>">https://gnu.org/licenses/gpl-3.0.html></a>;.<br/><br/>use std::collections::HashSet;<br/><br/>use clap::Args;<br/><br/>use crate::{<br/> cli::{<br/> CliOptions,<br/> traits::{CommandRunner, MutRepoRelaySetsExt, NaddrOrSetVecExt, RelayOrSetVecExt},<br/> types::{NaddrOrSet, RelayOrSet},<br/> },<br/> error::N34Result,<br/>};<br/><br/>#[derive(Args, Debug)]<br/>pub struct UpdateArgs {<br/> /// Name of the set to update<br/> name: String,<br/> /// Add relay to the set, either as URL or set name to extract its relays.<br/> /// [aliases: `--sr`]<br/> #[arg(long = "set-relay", alias("sr"))]<br/> relays: Vec<RelayOrSet>,<br/> /// Repository address in `naddr` format (`naddr1...`), NIP-05 format<br/> /// (`4rs.nl/n34` or `_@4rs.nl/n34`), or a set name like `kernel`.<br/> #[arg(value_name = "NADDR-NIP05-OR-SET", long = "repo")]<br/> naddrs: Vec<NaddrOrSet>,<br/> /// Replace existing relays/repositories instead of adding to them<br/> #[arg(long = "override")]<br/> override_set: bool,<br/>}<br/><br/>impl CommandRunner for UpdateArgs {<br/> const NEED_SIGNER: bool = false;<br/><br/> async fn run(self, mut options: CliOptions) -> N34Result<()> {<br/> let naddrs = self.naddrs.flat_naddrs(&options.config.sets)?;<br/> let relays = self.relays.flat_relays(&options.config.sets)?;<br/><br/> let set = options.config.sets.get_mut_set(&self.name)?;<br/><br/> if self.override_set {<br/> if !relays.is_empty() {<br/> set.relays = HashSet::from_iter(relays);<br/> }<br/> if !naddrs.is_empty() {<br/> set.naddrs = HashSet::from_iter(naddrs)<br/> }<br/> } else {<br/> set.relays.extend(relays);<br/> set.naddrs.extend(naddrs);<br/> }<br/><br/> options.config.dump()<br/> }<br/>}<br/>
2026-10-09T01:54:38Zhttps://njump.me/nevent1qqs8mtd8dgcqttkgz09phv8mrdx3rg6m5upf2s4ug7wl3sph3vs2kagzyp2xhcyfwmc3jdu98up2074n3zznz6ye259qzdm0pp7qwhqtg2z6jlc6hu2// n34 - A CLI to interact with NIP-34 and other stuff related to ...
// n34 - A CLI to interact with NIP-34 and other stuff related to codes in nostr<br/>// Copyright (C) 2025 Awiteb <a@4rs.nl><br/>//<br/>// This program is free software: you can redistribute it and/or modify<br/>// it under the terms of the GNU General Public License as published by<br/>// the Free Software Foundation, either version 3 of the License, or<br/>// (at your option) any later version.<br/>//<br/>// This program is distributed in the hope that it will be useful,<br/>// but WITHOUT ANY WARRANTY; without even the implied warranty of<br/>// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the<br/>// GNU General Public License for more details.<br/>//<br/>// You should have received a copy of the GNU General Public License<br/>// along with this program. If not, see <<a href="https://gnu.org/licenses/gpl-3.0.html>">https://gnu.org/licenses/gpl-3.0.html></a>;.<br/><br/>use clap::Args;<br/>use nostr::nips::nip19::ToBech32;<br/><br/>use crate::{<br/> cli::{<br/> CliOptions,<br/> RepoRelaySet,<br/> traits::{CommandRunner, RepoRelaySetsExt},<br/> },<br/> error::N34Result,<br/>};<br/><br/>#[derive(Args, Debug)]<br/>pub struct ShowArgs {<br/> /// Name of the set to display. If not provided, lists all available sets.<br/> name: Option<String>,<br/>}<br/><br/>impl CommandRunner for ShowArgs {<br/> const NEED_SIGNER: bool = false;<br/><br/> async fn run(self, options: CliOptions) -> N34Result<()> {<br/> if let Some(name) = self.name {<br/> println!(<br/> "{}",<br/> format_set(options.config.sets.as_slice().get_set(&name)?)<br/> );<br/> } else {<br/> println!(<br/> "{}",<br/> options<br/> .config<br/> .sets<br/> .iter()<br/> .map(format_set)<br/> .collect::<Vec<_>>()<br/> .join("\n----------\n")<br/> );<br/> }<br/><br/> Ok(())<br/> }<br/>}<br/><br/>/// Format a set to view it to the user<br/>fn format_set(set: &RepoRelaySet) -> String {<br/> let naddrs = if set.naddrs.is_empty() {<br/> "Nothing".to_owned()<br/> } else {<br/> format!(<br/> "\n- {}",<br/> set.naddrs<br/> .iter()<br/> .map(|naddr| naddr.to_bech32().expect("We did decoded before"))<br/> .collect::<Vec<_>>()<br/> .join("\n- ")<br/> )<br/> };<br/> let relays = if set.relays.is_empty() {<br/> "Nothing".to_owned()<br/> } else {<br/> format!(<br/> "\n- {}",<br/> set.relays<br/> .iter()<br/> .map(|relay| relay.to_string())<br/> .collect::<Vec<_>>()<br/> .join("\n- ")<br/> )<br/> };<br/><br/> format!(<br/> "Name: {}\nّّRepositories: {naddrs}\nRelays: {relays}",<br/> set.name<br/> )<br/>}<br/>
2026-10-09T01:54:38Zhttps://njump.me/nevent1qqsr4s9hzs4swds6vut3q4f6hewm76l4zky43wa7yfvlftpa7wz9k2czyp2xhcyfwmc3jdu98up2074n3zznz6ye259qzdm0pp7qwhqtg2z6j0sc9cx// n34 - A CLI to interact with NIP-34 and other stuff related to ...
// n34 - A CLI to interact with NIP-34 and other stuff related to codes in nostr<br/>// Copyright (C) 2025 Awiteb <a@4rs.nl><br/>//<br/>// This program is free software: you can redistribute it and/or modify<br/>// it under the terms of the GNU General Public License as published by<br/>// the Free Software Foundation, either version 3 of the License, or<br/>// (at your option) any later version.<br/>//<br/>// This program is distributed in the hope that it will be useful,<br/>// but WITHOUT ANY WARRANTY; without even the implied warranty of<br/>// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the<br/>// GNU General Public License for more details.<br/>//<br/>// You should have received a copy of the GNU General Public License<br/>// along with this program. If not, see <<a href="https://gnu.org/licenses/gpl-3.0.html>">https://gnu.org/licenses/gpl-3.0.html></a>;.<br/><br/>use clap::Args;<br/><br/>use crate::{<br/> cli::{<br/> CliOptions,<br/> traits::{CommandRunner, MutRepoRelaySetsExt, NaddrOrSetVecExt, RelayOrSetVecExt},<br/> types::{NaddrOrSet, RelayOrSet},<br/> },<br/> error::N34Result,<br/>};<br/><br/>#[derive(Args, Debug)]<br/>pub struct RemoveArgs {<br/> /// Set name to delete<br/> name: String,<br/> /// Specific relay to remove it from the set, either as URL or set name to<br/> /// extract its relays. [aliases: `--sr`]<br/> #[arg(long = "set-relay", alias("sr"))]<br/> relays: Vec<RelayOrSet>,<br/><br/> /// Repository address in `naddr` format (`naddr1...`), NIP-05 format<br/> /// (`4rs.nl/n34` or `_@4rs.nl/n34`), or a set name like `kernel`.<br/> #[arg(value_name = "NADDR-NIP05-OR-SET", long = "repo")]<br/> naddrs: Vec<NaddrOrSet>,<br/>}<br/><br/>impl CommandRunner for RemoveArgs {<br/> const NEED_SIGNER: bool = false;<br/><br/> async fn run(self, mut options: CliOptions) -> N34Result<()> {<br/> let naddrs = self.naddrs.flat_naddrs(&options.config.sets)?;<br/> let relays = self.relays.flat_relays(&options.config.sets)?;<br/><br/> if relays.is_empty() && naddrs.is_empty() {<br/> options.config.sets.remove_set(self.name)?;<br/> } else {<br/> if !relays.is_empty() {<br/> options<br/> .config<br/> .sets<br/> .remove_relays(&self.name, relays.into_iter())?;<br/> }<br/> if !naddrs.is_empty() {<br/> options<br/> .config<br/> .sets<br/> .remove_naddrs(self.name, naddrs.into_iter())?;<br/> }<br/> }<br/><br/> options.config.dump()<br/> }<br/>}<br/>
2026-10-09T01:54:37Zhttps://njump.me/nevent1qqsvhsk8nuahn4mmjx48avg525lhffjeu9yst07c4f2gd0w2arnfzyqzyp2xhcyfwmc3jdu98up2074n3zznz6ye259qzdm0pp7qwhqtg2z6jfxfmcf// n34 - A CLI to interact with NIP-34 and other stuff related to ...
// n34 - A CLI to interact with NIP-34 and other stuff related to codes in nostr<br/>// Copyright (C) 2025 Awiteb <a@4rs.nl><br/>//<br/>// This program is free software: you can redistribute it and/or modify<br/>// it under the terms of the GNU General Public License as published by<br/>// the Free Software Foundation, either version 3 of the License, or<br/>// (at your option) any later version.<br/>//<br/>// This program is distributed in the hope that it will be useful,<br/>// but WITHOUT ANY WARRANTY; without even the implied warranty of<br/>// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the<br/>// GNU General Public License for more details.<br/>//<br/>// You should have received a copy of the GNU General Public License<br/>// along with this program. If not, see <<a href="https://gnu.org/licenses/gpl-3.0.html>">https://gnu.org/licenses/gpl-3.0.html></a>;.<br/><br/>use clap::Args;<br/><br/>use crate::{<br/> cli::{<br/> CliOptions,<br/> ConfigError,<br/> traits::{CommandRunner, MutRepoRelaySetsExt, NaddrOrSetVecExt, RelayOrSetVecExt},<br/> types::{NaddrOrSet, RelayOrSet},<br/> },<br/> error::N34Result,<br/>};<br/><br/>#[derive(Args, Debug)]<br/>pub struct NewArgs {<br/> /// Unique name for the set<br/> name: String,<br/> /// Optional relay to add it to the set, either as URL or set name to<br/> /// extract its relays. [aliases: `--sr`]<br/> #[arg(long = "set-relay", alias("sr"))]<br/> relays: Vec<RelayOrSet>,<br/> /// Repository address in `naddr` format (`naddr1...`), NIP-05 format<br/> /// (`4rs.nl/n34` or `_@4rs.nl/n34`), or a set name like `kernel`.<br/> #[arg(value_name = "NADDR-NIP05-OR-SET", long = "repo")]<br/> naddrs: Vec<NaddrOrSet>,<br/>}<br/><br/>impl CommandRunner for NewArgs {<br/> const NEED_SIGNER: bool = false;<br/><br/> async fn run(self, mut options: CliOptions) -> N34Result<()> {<br/> let naddrs = self.naddrs.flat_naddrs(&options.config.sets)?;<br/> let relays = self.relays.flat_relays(&options.config.sets)?;<br/><br/> if relays.is_empty() && naddrs.is_empty() {<br/> return Err(ConfigError::NewEmptySet.into());<br/> }<br/><br/> options.config.sets.push_set(self.name, naddrs, relays)?;<br/> options.config.dump()<br/> }<br/>}<br/>
2026-10-09T01:54:32Zhttps://njump.me/nevent1qqs0h0hnhm2cth5hmsmxy36ztnf0jv29zyk809axq6flfv5wy7h84kczyp2xhcyfwmc3jdu98up2074n3zznz6ye259qzdm0pp7qwhqtg2z6jpvde3z// n34 - A CLI to interact with NIP-34 and other stuff related to ...
// n34 - A CLI to interact with NIP-34 and other stuff related to codes in nostr<br/>// Copyright (C) 2025 Awiteb <a@4rs.nl><br/>//<br/>// This program is free software: you can redistribute it and/or modify<br/>// it under the terms of the GNU General Public License as published by<br/>// the Free Software Foundation, either version 3 of the License, or<br/>// (at your option) any later version.<br/>//<br/>// This program is distributed in the hope that it will be useful,<br/>// but WITHOUT ANY WARRANTY; without even the implied warranty of<br/>// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the<br/>// GNU General Public License for more details.<br/>//<br/>// You should have received a copy of the GNU General Public License<br/>// along with this program. If not, see <<a href="https://gnu.org/licenses/gpl-3.0.html>">https://gnu.org/licenses/gpl-3.0.html></a>;.<br/><br/>use clap::Args;<br/><br/>use super::PatchStatus;<br/>use crate::{<br/> cli::{<br/> CliOptions,<br/> traits::CommandRunner,<br/> types::{NaddrOrSet, NostrEvent},<br/> },<br/> error::{N34Error, N34Result},<br/>};<br/><br/>#[derive(Debug, Args)]<br/>pub struct CloseArgs {<br/> /// Repository address in `naddr` format (`naddr1...`), NIP-05 format<br/> /// (`4rs.nl/n34` or `_@4rs.nl/n34`), or a set name like `kernel`.<br/> ///<br/> /// If omitted, looks for a `nostr-address` file.<br/> #[arg(value_name = "NADDR-NIP05-OR-SET", long = "repo")]<br/> naddrs: Option<Vec<NaddrOrSet>>,<br/> /// The open/drafted patch id to close it. Must be orignal root patch<br/> patch_id: NostrEvent,<br/>}<br/><br/>impl CommandRunner for CloseArgs {<br/> async fn run(self, options: CliOptions) -> N34Result<()> {<br/> crate::cli::common_commands::patch_status_command(<br/> options,<br/> self.patch_id,<br/> self.naddrs,<br/> PatchStatus::Closed,<br/> None,<br/> Vec::new(),<br/> |patch_status| {<br/> if patch_status.is_closed() {<br/> return Err(N34Error::InvalidStatus(<br/> "You can't close an already closed patch".to_owned(),<br/> ));<br/> }<br/><br/> if patch_status.is_merged_or_applied() {<br/> return Err(N34Error::InvalidStatus(<br/> "You can't close a merged/applied patch".to_owned(),<br/> ));<br/> }<br/> Ok(())<br/> },<br/> )<br/> .await<br/> }<br/>}<br/>
2026-10-09T01:54:27Zhttps://njump.me/nevent1qqsv5crd7ylyqhf2y2aazhdkq7l83lmqt9uq6wld2gwxvc9g3tajxjgzyp2xhcyfwmc3jdu98up2074n3zznz6ye259qzdm0pp7qwhqtg2z6j4grc5d// n34 - A CLI to interact with NIP-34 and other stuff related to ...
// n34 - A CLI to interact with NIP-34 and other stuff related to codes in nostr<br/>// Copyright (C) 2025 Awiteb <a@4rs.nl><br/>//<br/>// This program is free software: you can redistribute it and/or modify<br/>// it under the terms of the GNU General Public License as published by<br/>// the Free Software Foundation, either version 3 of the License, or<br/>// (at your option) any later version.<br/>//<br/>// This program is distributed in the hope that it will be useful,<br/>// but WITHOUT ANY WARRANTY; without even the implied warranty of<br/>// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the<br/>// GNU General Public License for more details.<br/>//<br/>// You should have received a copy of the GNU General Public License<br/>// along with this program. If not, see <<a href="https://gnu.org/licenses/gpl-3.0.html>">https://gnu.org/licenses/gpl-3.0.html></a>;.<br/><br/>/// `sets new` command<br/>mod new;<br/>/// `sets remove` command<br/>mod remove;<br/>/// `sets show` commands<br/>mod show;<br/>/// `sets update` command<br/>mod update;<br/><br/>use clap::Subcommand;<br/><br/>use self::new::NewArgs;<br/>use self::remove::RemoveArgs;<br/>use self::show::ShowArgs;<br/>use self::update::UpdateArgs;<br/>use super::{CliOptions, CommandRunner};<br/>use crate::error::N34Result;<br/><br/>#[derive(Subcommand, Debug)]<br/>pub enum SetsSubcommands {<br/> /// Remove a set, or specific repos and relays within it<br/> Remove(RemoveArgs),<br/> /// Create a new set<br/> New(NewArgs),<br/> /// Modify an existing set<br/> Update(UpdateArgs),<br/> /// Show a single set or all the stored sets<br/> Show(ShowArgs),<br/>}<br/><br/><br/>impl CommandRunner for SetsSubcommands {<br/> async fn run(self, options: CliOptions) -> N34Result<()> {<br/> crate::run_command!(self, options, & Remove New Update Show)<br/> }<br/>}<br/>
2026-10-09T01:54:27Zhttps://njump.me/nevent1qqsvzhelz26sfryeh889usw38ran00dz2t44heejclclkwww50t4sjszyp2xhcyfwmc3jdu98up2074n3zznz6ye259qzdm0pp7qwhqtg2z6j7a70a3// n34 - A CLI to interact with NIP-34 and other stuff related to ...
// n34 - A CLI to interact with NIP-34 and other stuff related to codes in nostr<br/>// Copyright (C) 2025 Awiteb <a@4rs.nl><br/>//<br/>// This program is free software: you can redistribute it and/or modify<br/>// it under the terms of the GNU General Public License as published by<br/>// the Free Software Foundation, either version 3 of the License, or<br/>// (at your option) any later version.<br/>//<br/>// This program is distributed in the hope that it will be useful,<br/>// but WITHOUT ANY WARRANTY; without even the implied warranty of<br/>// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the<br/>// GNU General Public License for more details.<br/>//<br/>// You should have received a copy of the GNU General Public License<br/>// along with this program. If not, see <<a href="https://gnu.org/licenses/gpl-3.0.html>">https://gnu.org/licenses/gpl-3.0.html></a>;.<br/><br/>use super::*;<br/><br/>#[test]<br/>fn patch_normal() {<br/> let patch_content = r#"From 24e8522268ad675996fc3b35209ce23951236bdc Mon Sep 17 00:00:00 2001<br/>From: Awiteb <a@4rs.nl><br/>Date: Tue, 27 May 2025 19:20:42 +0000<br/>Subject: [PATCH] chore: a to abc<br/><br/>Abc patch<br/>---<br/> src/nostr_utils/mod.rs | 1 +<br/> 1files changed, 3 insertions(+), 1 deletions(-)<br/><br/>diff --git a/src/nostr_utils/mod.rs b/src/nostr_utils/mod.rs<br/>index 4120f5a..e68783c 100644<br/>--- a/src/nostr_utils/mod.rs<br/>+++ b/src/nostr_utils/mod.rs<br/>@@ -103,31 +103,9 @@ impl CommandRunner for NewArgs {<br/><br/>- a<br/>+ abc<br/>-- <br/>2.49.0"#;<br/> let patch = GitPatch::from_str(patch_content).unwrap();<br/> assert_eq!(patch.subject, "[PATCH] chore: a to abc");<br/> assert_eq!(patch.body, "Abc patch");<br/>}<br/><br/>#[test]<br/>fn patch_normal_with_patch_in_content() {<br/> let patch_content = r#"From 24e8522268ad675996fc3b35209ce23951236bdc Mon Sep 17 00:00:00 2001<br/>From: Awiteb <a@4rs.nl><br/>Date: Tue, 27 May 2025 19:20:42 +0000<br/>Subject: [PATCH] chore: Subject in subject<br/><br/>A good test patch<br/>---<br/> src/nostr_utils/mod.rs | 1 +<br/> 1files changed, 3 insertions(+), 1 deletions(-)<br/><br/>diff --git a/src/nostr_utils/mod.rs b/src/nostr_utils/mod.rs<br/>index 4120f5a..e68783c 100644<br/>--- a/src/nostr_utils/mod.rs<br/>+++ b/src/nostr_utils/mod.rs<br/>@@ -103,31 +103,9 @@ impl CommandRunner for NewArgs {<br/><br/>From: Awiteb <a@4rs.nl><br/>Date: Tue, 27 May 2025 19:20:42 +0000<br/>Subject: [PATCH] chore: What a subject<br/><br/>hi<br/>---<br/>-- <br/>2.49.0"#;<br/> let patch = GitPatch::from_str(patch_content).unwrap();<br/> assert_eq!(patch.subject, "[PATCH] chore: Subject in subject");<br/> assert_eq!(patch.body, "A good test patch");<br/>}<br/><br/>#[test]<br/>fn patch_multiline_subject() {<br/> let patch_content = r#"From 24e8522268ad675996fc3b35209ce23951236bdc Mon Sep 17 00:00:00 2001<br/>From: Awiteb <a@4rs.nl><br/>Date: Tue, 27 May 2025 19:20:42 +0000<br/>Subject: [PATCH] chore: Some long subject yes so long one Some long subject yes<br/> so long one<br/><br/>Abc patch<br/>---<br/> src/nostr_utils/mod.rs | 1 +<br/> 1files changed, 3 insertions(+), 1 deletions(-)<br/><br/>diff --git a/src/nostr_utils/mod.rs b/src/nostr_utils/mod.rs<br/>index 4120f5a..e68783c 100644<br/>--- a/src/nostr_utils/mod.rs<br/>+++ b/src/nostr_utils/mod.rs<br/>@@ -103,31 +103,9 @@ impl CommandRunner for NewArgs {<br/><br/>- a<br/>+ abc<br/>-- <br/>2.49.0"#;<br/> let patch = GitPatch::from_str(patch_content).unwrap();<br/> assert_eq!(<br/> patch.subject,<br/> "[PATCH] chore: Some long subject yes so long one Some long subject yes so long one"<br/> );<br/> assert_eq!(patch.body, "Abc patch");<br/>}<br/><br/>#[test]<br/>fn patch_multiline_body() {<br/> let patch_content = r#"From 24e8522268ad675996fc3b35209ce23951236bdc Mon Sep 17 00:00:00 2001<br/>From: Awiteb <a@4rs.nl><br/>Date: Tue, 27 May 2025 19:20:42 +0000<br/>Subject: [PATCH] chore: a to abc<br/><br/>Lorem ipsum dolor sit amet. 33 laborum galisum aut fugiat dicta vel accusamus<br/>aliquam vel quisquam fuga in incidunt voluptas a aliquid neque ab iure pariatur.<br/>Et molestiae vero a consectetur laborum et accusantium sequi. Et ratione<br/>atque et molestiae dolorem in asperiores amet id dolor corporis in adipisci<br/>aspernatur.<br/>---<br/> src/nostr_utils/mod.rs | 1 +<br/> 1files changed, 3 insertions(+), 1 deletions(-)<br/><br/>diff --git a/src/nostr_utils/mod.rs b/src/nostr_utils/mod.rs<br/>index 4120f5a..e68783c 100644<br/>--- a/src/nostr_utils/mod.rs<br/>+++ b/src/nostr_utils/mod.rs<br/>@@ -103,31 +103,9 @@ impl CommandRunner for NewArgs {<br/><br/>- a<br/>+ abc<br/>-- <br/>2.49.0"#;<br/> let patch = GitPatch::from_str(patch_content).unwrap();<br/> assert_eq!(patch.subject, "[PATCH] chore: a to abc");<br/> assert_eq!(<br/> patch.body,<br/> "Lorem ipsum dolor sit amet. 33 laborum galisum aut fugiat dicta vel accusamus<br/>aliquam vel quisquam fuga in incidunt voluptas a aliquid neque ab iure pariatur.<br/>Et molestiae vero a consectetur laborum et accusantium sequi. Et ratione<br/>atque et molestiae dolorem in asperiores amet id dolor corporis in adipisci<br/>aspernatur."<br/> );<br/>}<br/><br/>#[test]<br/>fn patch_cover_letter() {<br/> let patch_content = r#"From 864f3018f62ab2e1265edb670d5493dafe7d2cb2 Mon Sep 17 00:00:00 2001<br/>From: Awiteb <a@4rs.nl><br/>Date: Tue, 3 Jun 2025 08:41:12 +0000<br/>Subject: [PATCH v2 0/7] feat: Some test just a test<br/><br/>Cover body<br/><br/>Awiteb (1):<br/> chore: Update `README.md`<br/><br/> README.md | 2 +-<br/><br/><br/>base-commit: f670859b92d525874fd621452080c8479964ac6a<br/>-- <br/>2.49.0"#;<br/> let patch = GitPatch::from_str(patch_content).unwrap();<br/> assert_eq!(patch.subject, "[PATCH v2 0/7] feat: Some test just a test");<br/> assert_eq!(<br/> patch.body,<br/> "Cover body<br/><br/>Awiteb (1):<br/> chore: Update `README.md`<br/><br/> README.md | 2 +-<br/><br/><br/>base-commit: f670859b92d525874fd621452080c8479964ac6a"<br/> );<br/>}<br/><br/>#[test]<br/>fn patch_multiline_cover_subject() {<br/> let patch_content = r#"From 864f3018f62ab2e1265edb670d5493dafe7d2cb2 Mon Sep 17 00:00:00 2001<br/>From: Awiteb <a@4rs.nl><br/>Date: Tue, 3 Jun 2025 08:41:12 +0000<br/>Subject: [PATCH v2 0/7] feat: Some test just a test some test just a test some<br/> test just a test<br/><br/>Cover body<br/><br/>Awiteb (1):<br/> chore: Update `README.md`<br/><br/> README.md | 2 +-<br/><br/><br/>base-commit: f670859b92d525874fd621452080c8479964ac6a<br/>-- <br/>2.49.0"#;<br/> let patch = GitPatch::from_str(patch_content).unwrap();<br/> assert_eq!(<br/> patch.subject,<br/> "[PATCH v2 0/7] feat: Some test just a test some test just a test some test just a test"<br/> );<br/> assert_eq!(<br/> patch.body,<br/> "Cover body<br/><br/>Awiteb (1):<br/> chore: Update `README.md`<br/><br/> README.md | 2 +-<br/><br/><br/>base-commit: f670859b92d525874fd621452080c8479964ac6a"<br/> );<br/>}<br/><br/>#[test]<br/>fn patch_multiline_cover_body() {<br/> let patch_content = r#"From 864f3018f62ab2e1265edb670d5493dafe7d2cb2 Mon Sep 17 00:00:00 2001<br/>From: Awiteb <a@4rs.nl><br/>Date: Tue, 3 Jun 2025 08:41:12 +0000<br/>Subject: [PATCH v2 0/7] feat: Some test just a test some test just a test some<br/> test just a test<br/><br/>Lorem ipsum dolor sit amet. 33 laborum galisum aut fugiat dicta vel accusamus<br/>aliquam vel quisquam fuga in incidunt voluptas a aliquid neque ab iure pariatur.<br/>Et molestiae vero a consectetur laborum et accusantium sequi. Et ratione<br/>atque et molestiae dolorem in asperiores amet id dolor corporis in adipisci<br/>aspernatur.<br/><br/>Awiteb (1):<br/> chore: Update `README.md`<br/><br/> README.md | 2 +-<br/><br/><br/>base-commit: f670859b92d525874fd621452080c8479964ac6a<br/>-- <br/>2.49.0"#;<br/> let patch = GitPatch::from_str(patch_content).unwrap();<br/> assert_eq!(<br/> patch.subject,<br/> "[PATCH v2 0/7] feat: Some test just a test some test just a test some test just a test"<br/> );<br/> assert_eq!(<br/> patch.body,<br/> "Lorem ipsum dolor sit amet. 33 laborum galisum aut fugiat dicta vel accusamus<br/>aliquam vel quisquam fuga in incidunt voluptas a aliquid neque ab iure pariatur.<br/>Et molestiae vero a consectetur laborum et accusantium sequi. Et ratione<br/>atque et molestiae dolorem in asperiores amet id dolor corporis in adipisci<br/>aspernatur.<br/><br/>Awiteb (1):<br/> chore: Update `README.md`<br/><br/> README.md | 2 +-<br/><br/><br/>base-commit: f670859b92d525874fd621452080c8479964ac6a"<br/> );<br/>}<br/><br/>#[test]<br/>fn normal_patch_filename() {<br/> let mut patch = GitPatch {<br/> inner: String::new(),<br/> subject: String::new(),<br/> body: String::new(),<br/> };<br/><br/> patch.subject = "[PATCH v2 0/3] feat: Some test just a test".to_owned();<br/> assert_eq!(<br/> patch.filename("").unwrap(),<br/> PathBuf::from("v2-0000-cover-letter.patch")<br/> );<br/> patch.subject = "[PATCH 0/3] feat: Some test just a test".to_owned();<br/> assert_eq!(<br/> patch.filename("").unwrap(),<br/> PathBuf::from("0000-cover-letter.patch")<br/> );<br/> patch.subject = "[PATCH v2 1/3] feat: Some test just a test".to_owned();<br/> assert_eq!(<br/> patch.filename("").unwrap(),<br/> PathBuf::from("v2-0001-feat-some-test-just-a-test.patch")<br/> );<br/> patch.subject = "[PATCH v42 1/3] feat: Some test just a test".to_owned();<br/> assert_eq!(<br/> patch.filename("").unwrap(),<br/> PathBuf::from("v42-0001-feat-some-test-just-a-test.patch")<br/> );<br/> patch.subject = "[PATCH v42 23/30] feat: Some test just a test".to_owned();<br/> assert_eq!(<br/> patch.filename("").unwrap(),<br/> PathBuf::from("v42-0023-feat-some-test-just-a-test.patch")<br/> );<br/> patch.subject = "[PATCH 1/3] feat: Some test just a test".to_owned();<br/> assert_eq!(<br/> patch.filename("").unwrap(),<br/> PathBuf::from("0001-feat-some-test-just-a-test.patch")<br/> );<br/> patch.subject = "[PATCH 32/50] feat: Some test just a test".to_owned();<br/> assert_eq!(<br/> patch.filename("").unwrap(),<br/> PathBuf::from("0032-feat-some-test-just-a-test.patch")<br/> );<br/> patch.subject = "[PATCH v100 32/50] feat: some long subject some long subject some long \<br/> subject some long subject"<br/> .to_owned();<br/> assert_eq!(<br/> patch.filename("").unwrap(),<br/> PathBuf::from("v100-0032-feat-some-long-subject-some-long-subject-some-long-subject.patch")<br/> );<br/>}<br/><br/>#[test]<br/>fn patch_filename_without_patch() {<br/> let mut patch = GitPatch {<br/> inner: String::new(),<br/> subject: "[RFC v5 1/2] Something".to_owned(),<br/> body: String::new(),<br/> };<br/><br/> assert!(patch.filename("").is_err());<br/> patch.subject = "Something".to_owned();<br/> assert!(patch.filename("").is_err());<br/>}<br/><br/>#[test]<br/>fn patch_filename_without_number() {<br/> let mut patch = GitPatch {<br/> inner: String::new(),<br/> subject: "[PATCH v5 /2] Something".to_owned(),<br/> body: String::new(),<br/> };<br/><br/> assert!(patch.filename("").is_err());<br/> patch.subject = "[PATCH v5 2/] Something".to_owned();<br/> assert!(patch.filename("").is_err());<br/>}<br/><br/>#[test]<br/>fn patch_filename_without_version() {<br/> let patch = GitPatch {<br/> inner: String::new(),<br/> subject: "[PATCH 1/2] Something".to_owned(),<br/> body: String::new(),<br/> };<br/><br/> assert!(patch.filename("").is_ok());<br/>}<br/>
2026-10-09T01:54:27Zhttps://njump.me/nevent1qqs2zeet7tcx85z2kuaxug4qn5k9wvg7j65wqqt52un7z620lrwv7yszyp2xhcyfwmc3jdu98up2074n3zznz6ye259qzdm0pp7qwhqtg2z6jdyxwrz// n34 - A CLI to interact with NIP-34 and other stuff related to ...
// n34 - A CLI to interact with NIP-34 and other stuff related to codes in nostr<br/>// Copyright (C) 2025 Awiteb <a@4rs.nl><br/>//<br/>// This program is free software: you can redistribute it and/or modify<br/>// it under the terms of the GNU General Public License as published by<br/>// the Free Software Foundation, either version 3 of the License, or<br/>// (at your option) any later version.<br/>//<br/>// This program is distributed in the hope that it will be useful,<br/>// but WITHOUT ANY WARRANTY; without even the implied warranty of<br/>// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the<br/>// GNU General Public License for more details.<br/>//<br/>// You should have received a copy of the GNU General Public License<br/>// along with this program. If not, see <<a href="https://gnu.org/licenses/gpl-3.0.html>">https://gnu.org/licenses/gpl-3.0.html></a>;.<br/><br/>use clap::Args;<br/>use nostr::hashes::sha1::Hash as Sha1Hash;<br/><br/>use super::PatchStatus;<br/>use crate::{<br/> cli::{<br/> CliOptions,<br/> traits::{CommandRunner, VecNostrEventExt},<br/> types::{NaddrOrSet, NostrEvent},<br/> },<br/> error::{N34Error, N34Result},<br/>};<br/><br/>#[derive(Debug, Args)]<br/>pub struct ApplyArgs {<br/> /// Repository address in `naddr` format (`naddr1...`), NIP-05 format<br/> /// (`4rs.nl/n34` or `_@4rs.nl/n34`), or a set name like `kernel`.<br/> ///<br/> /// If omitted, looks for a `nostr-address` file.<br/> #[arg(value_name = "NADDR-NIP05-OR-SET", long = "repo")]<br/> naddrs: Option<Vec<NaddrOrSet>>,<br/> /// The open patch id to apply it. Must be orignal root patch or<br/> /// revision root<br/> patch_id: NostrEvent,<br/> /// Patches that have been applied. Use this when only some patches have<br/> /// been applied, not all.<br/> #[arg(long = "patches", value_name = "PATCH-EVENT-ID")]<br/> applied_patches: Vec<NostrEvent>,<br/> /// The applied commits<br/> #[arg(num_args = 1..)]<br/> applied_commits: Vec<Sha1Hash>,<br/>}<br/><br/>impl CommandRunner for ApplyArgs {<br/> async fn run(self, options: CliOptions) -> N34Result<()> {<br/> crate::cli::common_commands::patch_status_command(<br/> options,<br/> self.patch_id,<br/> self.naddrs,<br/> PatchStatus::MergedApplied,<br/> Some(either::Either::Right(self.applied_commits)),<br/> self.applied_patches.into_event_ids(),<br/> |patch_status| {<br/> if patch_status.is_merged_or_applied() {<br/> return Err(N34Error::InvalidStatus(<br/> "You can't apply an already applied patch".to_owned(),<br/> ));<br/> }<br/><br/> if patch_status.is_closed() {<br/> return Err(N34Error::InvalidStatus(<br/> "You can't apply a closed patch".to_owned(),<br/> ));<br/> }<br/><br/> if patch_status.is_drafted() {<br/> return Err(N34Error::InvalidStatus(<br/> "You can't apply a drafted patch".to_owned(),<br/> ));<br/> }<br/> Ok(())<br/> },<br/> )<br/> .await<br/> }<br/>}<br/>
2026-10-09T01:54:27Zhttps://njump.me/nevent1qqs2pu8gv208a6hd720hyt2fsw3sx2dcry52xvn8wehke2nh4kyhlwqzyp2xhcyfwmc3jdu98up2074n3zznz6ye259qzdm0pp7qwhqtg2z6jxhwwnc// n34 - A CLI to interact with NIP-34 and other stuff related to ...
// n34 - A CLI to interact with NIP-34 and other stuff related to codes in nostr<br/>// Copyright (C) 2025 Awiteb <a@4rs.nl><br/>//<br/>// This program is free software: you can redistribute it and/or modify<br/>// it under the terms of the GNU General Public License as published by<br/>// the Free Software Foundation, either version 3 of the License, or<br/>// (at your option) any later version.<br/>//<br/>// This program is distributed in the hope that it will be useful,<br/>// but WITHOUT ANY WARRANTY; without even the implied warranty of<br/>// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the<br/>// GNU General Public License for more details.<br/>//<br/>// You should have received a copy of the GNU General Public License<br/>// along with this program. If not, see <<a href="https://gnu.org/licenses/gpl-3.0.html>">https://gnu.org/licenses/gpl-3.0.html></a>;.<br/><br/>use std::{<br/> fs,<br/> path::{Path, PathBuf},<br/> str::FromStr,<br/>};<br/><br/>use clap::Args;<br/>use nostr::{<br/> event::{Kind, TagKind},<br/> filter::Filter,<br/> nips::nip19::ToBech32,<br/>};<br/><br/>use crate::{<br/> cli::{<br/> CliOptions,<br/> traits::{CommandRunner, OptionNaddrOrSetVecExt, RelayOrSetVecExt},<br/> types::{NaddrOrSet, NostrEvent},<br/> },<br/> error::{N34Error, N34Result},<br/> nostr_utils::{<br/> NostrClient,<br/> traits::{NaddrsUtils, ReposUtils},<br/> utils,<br/> },<br/>};<br/><br/>#[derive(Debug, Args)]<br/>pub struct FetchArgs {<br/> /// Repository address in `naddr` format (`naddr1...`), NIP-05 format<br/> /// (`4rs.nl/n34` or `_@4rs.nl/n34`), or a set name like `kernel`.<br/> ///<br/> /// If omitted, looks for a `nostr-address` file.<br/> #[arg(value_name = "NADDR-NIP05-OR-SET", long = "repo")]<br/> naddrs: Option<Vec<NaddrOrSet>>,<br/> /// Output directory for the patches. Default to the current directory<br/> #[arg(short, long, value_name = "PATH")]<br/> output: Option<PathBuf>,<br/> /// The patch id to fetch it<br/> patch_id: NostrEvent,<br/>}<br/><br/>impl CommandRunner for FetchArgs {<br/> const NEED_SIGNER: bool = false;<br/><br/> async fn run(self, options: CliOptions) -> N34Result<()> {<br/> let naddrs = utils::naddrs_or_file(<br/> self.naddrs.flat_naddrs(&options.config.sets)?,<br/> &utils::nostr_address_path()?,<br/> )?;<br/> let relays = options.relays.clone().flat_relays(&options.config.sets)?;<br/> let client = NostrClient::init(&options, &relays).await;<br/> let output_path = self.output.unwrap_or_default();<br/><br/> client<br/> .add_relays(<br/> &[<br/> naddrs.extract_relays(),<br/> self.patch_id.relays,<br/> client<br/> .fetch_repos(&naddrs.into_coordinates())<br/> .await?<br/> .extract_relays(),<br/> ]<br/> .concat(),<br/> )<br/> .await;<br/><br/> let root_patch = client<br/> .fetch_event(<br/> Filter::new()<br/> .id(self.patch_id.event_id)<br/> .kind(Kind::GitPatch),<br/> )<br/> .await?<br/> .ok_or(N34Error::CanNotFoundPatch)?;<br/><br/> if !root_patch<br/> .tags<br/> .iter()<br/> .any(|t| t.kind() == TagKind::t() && t.content().is_some_and(|c| c == "root"))<br/> {<br/> return Err(N34Error::NotRootPatch);<br/> }<br/><br/> let root_author = root_patch.pubkey;<br/> let root_patch = super::GitPatch::from_str(&root_patch.content)<br/> .map_err(|err| N34Error::InvalidEvent(format!("Failed to parse the patch: {err}")))?;<br/><br/> tracing::info!("Found the root patch: `{}`", root_patch.subject);<br/><br/> let mut patches = client<br/> .fetch_patch_series(self.patch_id.event_id, root_author)<br/> .await?<br/> .into_iter()<br/> .map(|p| {<br/> let patch = super::GitPatch::from_str(&p.content).map_err(|err| {<br/> N34Error::InvalidEvent(format!(<br/> "Failed to parse the patch `{}`: {err}",<br/> p.id.to_bech32().expect("Infallible")<br/> ))<br/> })?;<br/> N34Result::Ok((patch.filename(&output_path)?, patch))<br/> })<br/> .collect::<N34Result<Vec<_>>>()?;<br/> patches.push((root_patch.filename(&output_path)?, root_patch));<br/> patches.sort_unstable_by_key(|p| p.0.clone());<br/> patches.dedup_by_key(|p| p.0.clone());<br/><br/> if output_path.as_path() != Path::new("") && !output_path.exists() {<br/> fs::create_dir_all(&output_path)?;<br/> }<br/><br/> for (patch_path, patch) in patches {<br/> tracing::info!("Writeing `{}` in `{}`", patch.subject, patch_path.display());<br/> fs::write(patch_path, patch.inner)?;<br/> }<br/><br/> Ok(())<br/> }<br/>}<br/>
2026-10-09T01:54:27Zhttps://njump.me/nevent1qqsfsh57hxg69t3hcqpat36as25al6cusv9gaqym7fnvjr75hfcxxzszyp2xhcyfwmc3jdu98up2074n3zznz6ye259qzdm0pp7qwhqtg2z6j4gamuc// n34 - A CLI to interact with NIP-34 and other stuff related to ...
// n34 - A CLI to interact with NIP-34 and other stuff related to codes in nostr<br/>// Copyright (C) 2025 Awiteb <a@4rs.nl><br/>//<br/>// This program is free software: you can redistribute it and/or modify<br/>// it under the terms of the GNU General Public License as published by<br/>// the Free Software Foundation, either version 3 of the License, or<br/>// (at your option) any later version.<br/>//<br/>// This program is distributed in the hope that it will be useful,<br/>// but WITHOUT ANY WARRANTY; without even the implied warranty of<br/>// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the<br/>// GNU General Public License for more details.<br/>//<br/>// You should have received a copy of the GNU General Public License<br/>// along with this program. If not, see <<a href="https://gnu.org/licenses/gpl-3.0.html>">https://gnu.org/licenses/gpl-3.0.html></a>;.<br/><br/>use std::{fs, io::Write};<br/><br/>use clap::Args;<br/>use futures::future;<br/>use nostr::{event::EventBuilder, key::PublicKey, types::Url};<br/><br/>use crate::{<br/> cli::{CliOptions, CommandRunner, NOSTR_ADDRESS_FILE, traits::RelayOrSetVecExt},<br/> error::N34Result,<br/> nostr_utils::{NostrClient, traits::NewGitRepositoryAnnouncement, utils},<br/>};<br/><br/>/// Header written to new `nostr-address` files. Contains two trailing newline<br/>/// for formatting.<br/>const NOSTR_ADDRESS_FILE_HEADER: &str = r##"# This file contains NIP-19 `naddr` entities for repositories that accept this<br/># project's issues and patches.<br/>#<br/># The file acts as a **read-only reference** for retrieving repository relays<br/># when embedded in an `naddr` and mentions those repositories when opening<br/># patches or issues. Modifications here will not affect in the relays, as the<br/># file is **explicitly untracked**. Its goal is to simplify contributions by<br/># removing the need for manual address entry.<br/>#<br/># Each entry must start with "naddr". Embedded relays are **strongly recommended**<br/># to assist client-side discovery.<br/>#<br/># Empty lines are ignored. Lines starting with "#" are treated as comments.<br/><br/>"##;<br/><br/>/// Arguments for the `repo announce` command<br/>#[derive(Args, Debug)]<br/>pub struct AnnounceArgs {<br/> /// Unique identifier for the repository in kebab-case.<br/> #[arg(long = "id")]<br/> repo_id: String,<br/> /// A name for the repository.<br/> #[arg(short, long)]<br/> name: Option<String>,<br/> /// A description for the repository.<br/> #[arg(short, long)]<br/> description: Option<String>,<br/> /// Webpage URLs for the repository (if provided by the git server).<br/> #[arg(short, long)]<br/> web: Vec<Url>,<br/> /// URLs for cloning the repository.<br/> #[arg(short, long)]<br/> clone: Vec<Url>,<br/> /// Additional maintainers of the repository (besides yourself).<br/> #[arg(short, long)]<br/> maintainers: Vec<PublicKey>,<br/> /// Labels to categorize the repository. Can be specified multiple times.<br/> #[arg(short, long)]<br/> label: Vec<String>,<br/> /// Skip kebab-case validation for the repository ID<br/> #[arg(long)]<br/> force_id: bool,<br/> /// If set, creates a `nostr-address` file to enable automatic address<br/> /// discovery by n34<br/> #[arg(long)]<br/> address_file: bool,<br/>}<br/><br/>impl CommandRunner for AnnounceArgs {<br/> const NEED_RELAYS: bool = true;<br/><br/> async fn run(mut self, options: CliOptions) -> N34Result<()> {<br/> let relays = options.relays.clone().flat_relays(&options.config.sets)?;<br/> let client = NostrClient::init(&options, &relays).await;<br/> let user_pubk = client.pubkey().await?;<br/> let relays_list = client.user_relays_list(user_pubk).await?;<br/> client<br/> .add_relays(&utils::add_read_relays(relays_list.as_ref()))<br/> .await;<br/><br/> if !self.maintainers.contains(&user_pubk) {<br/> self.maintainers.insert(0, user_pubk);<br/> }<br/><br/> let naddr = utils::repo_naddr(&self.repo_id, user_pubk, &relays)?;<br/> let event = EventBuilder::new_git_repo(<br/> self.repo_id,<br/> self.name.map(utils::str_trim),<br/> self.description.map(utils::str_trim),<br/> self.web,<br/> self.clone,<br/> relays.clone(),<br/> self.maintainers.clone(),<br/> self.label.into_iter().map(utils::str_trim).collect(),<br/> self.force_id,<br/> )?<br/> .dedup_tags()<br/> .pow(options.pow.unwrap_or_default())<br/> .build(user_pubk);<br/><br/><br/> if self.address_file {<br/> let address_path = std::env::current_dir()?.join(NOSTR_ADDRESS_FILE);<br/> if !address_path.exists() {<br/> tracing::info!(<br/> "Creating new address file: '{NOSTR_ADDRESS_FILE}' at path '{}' with default \<br/> header",<br/> address_path.display()<br/> );<br/> fs::write(&address_path, NOSTR_ADDRESS_FILE_HEADER)?;<br/> }<br/><br/> let mut file = fs::OpenOptions::new().append(true).open(&address_path)?;<br/><br/> tracing::info!("Appending naddr '{naddr}' to address file: '{NOSTR_ADDRESS_FILE}'");<br/> file.write_all(format!("{naddr}\n").as_bytes())?;<br/> tracing::info!("Successfully wrote naddr to address file");<br/> }<br/><br/> let write_relays = [<br/> relays,<br/> utils::add_write_relays(relays_list.as_ref()),<br/> // Include read relays for each maintainer (if found)<br/> future::join_all(<br/> self.maintainers<br/> .iter()<br/> .map(|pkey| client.read_relays_from_user(*pkey)),<br/> )<br/> .await<br/> .into_iter()<br/> .flatten()<br/> .collect(),<br/> ]<br/> .concat();<br/> let nevent = utils::new_nevent(event.id.expect("There is an id"), &write_relays)?;<br/><br/> client<br/> .send_event_to(event, relays_list.as_ref(), &write_relays)<br/> .await?;<br/><br/> println!("Event: {nevent}",);<br/> println!("Repo Address: {naddr}",);<br/><br/> Ok(())<br/> }<br/>}<br/>
2026-10-09T01:54:27Zhttps://njump.me/nevent1qqsg67c7tlkmjdv9jv9pzy5h4n4uh7ydj8dcsskcwz4sdtvmzcx769czyp2xhcyfwmc3jdu98up2074n3zznz6ye259qzdm0pp7qwhqtg2z6jmef6au// n34 - A CLI to interact with NIP-34 and other stuff related to ...
// n34 - A CLI to interact with NIP-34 and other stuff related to codes in nostr<br/>// Copyright (C) 2025 Awiteb <a@4rs.nl><br/>//<br/>// This program is free software: you can redistribute it and/or modify<br/>// it under the terms of the GNU General Public License as published by<br/>// the Free Software Foundation, either version 3 of the License, or<br/>// (at your option) any later version.<br/>//<br/>// This program is distributed in the hope that it will be useful,<br/>// but WITHOUT ANY WARRANTY; without even the implied warranty of<br/>// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the<br/>// GNU General Public License for more details.<br/>//<br/>// You should have received a copy of the GNU General Public License<br/>// along with this program. If not, see <<a href="https://gnu.org/licenses/gpl-3.0.html>">https://gnu.org/licenses/gpl-3.0.html></a>;.<br/><br/>use std::num::NonZeroUsize;<br/><br/>use clap::Args;<br/><br/>use crate::{<br/> cli::{CliOptions, common_commands, traits::CommandRunner, types::NaddrOrSet},<br/> error::N34Result,<br/>};<br/><br/>#[derive(Debug, Args)]<br/>pub struct ListArgs {<br/> /// Repository address in `naddr` format (`naddr1...`), NIP-05 format<br/> /// (`4rs.nl/n34` or `_@4rs.nl/n34`), or a set name like `kernel`.<br/> ///<br/> /// If omitted, looks for a `nostr-address` file.<br/> #[arg(value_name = "NADDR-NIP05-OR-SET")]<br/> naddrs: Option<Vec<NaddrOrSet>>,<br/> /// Maximum number of patches to list<br/> #[arg(long, default_value = "15")]<br/> limit: NonZeroUsize,<br/>}<br/><br/>impl CommandRunner for ListArgs {<br/> const NEED_SIGNER: bool = false;<br/><br/> async fn run(self, options: CliOptions) -> N34Result<()> {<br/> common_commands::list_patches_and_issues(options, self.naddrs, true, self.limit.into())<br/> .await<br/> }<br/>}<br/>
2026-10-09T01:54:27Zhttps://njump.me/nevent1qqs890qczhhnlrjl5rd4jgr3m0vd9uzzu9rjarv5dhx7dz35y9gu8pgzyp2xhcyfwmc3jdu98up2074n3zznz6ye259qzdm0pp7qwhqtg2z6j8qdxxh// n34 - A CLI to interact with NIP-34 and other stuff related to ...
// n34 - A CLI to interact with NIP-34 and other stuff related to codes in nostr<br/>// Copyright (C) 2025 Awiteb <a@4rs.nl><br/>//<br/>// This program is free software: you can redistribute it and/or modify<br/>// it under the terms of the GNU General Public License as published by<br/>// the Free Software Foundation, either version 3 of the License, or<br/>// (at your option) any later version.<br/>//<br/>// This program is distributed in the hope that it will be useful,<br/>// but WITHOUT ANY WARRANTY; without even the implied warranty of<br/>// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the<br/>// GNU General Public License for more details.<br/>//<br/>// You should have received a copy of the GNU General Public License<br/>// along with this program. If not, see <<a href="https://gnu.org/licenses/gpl-3.0.html>">https://gnu.org/licenses/gpl-3.0.html></a>;.<br/><br/>use clap::Args;<br/><br/>use super::PatchStatus;<br/>use crate::{<br/> cli::{<br/> CliOptions,<br/> traits::CommandRunner,<br/> types::{NaddrOrSet, NostrEvent},<br/> },<br/> error::{N34Error, N34Result},<br/>};<br/><br/>#[derive(Debug, Args)]<br/>pub struct ReopenArgs {<br/> /// Repository address in `naddr` format (`naddr1...`), NIP-05 format<br/> /// (`4rs.nl/n34` or `_@4rs.nl/n34`), or a set name like `kernel`.<br/> ///<br/> /// If omitted, looks for a `nostr-address` file.<br/> #[arg(value_name = "NADDR-NIP05-OR-SET", long = "repo")]<br/> naddrs: Option<Vec<NaddrOrSet>>,<br/> /// The closed/drafted patch id to reopen it. Must be orignal root patch<br/> patch_id: NostrEvent,<br/>}<br/><br/>impl CommandRunner for ReopenArgs {<br/> async fn run(self, options: CliOptions) -> N34Result<()> {<br/> crate::cli::common_commands::patch_status_command(<br/> options,<br/> self.patch_id,<br/> self.naddrs,<br/> PatchStatus::Open,<br/> None,<br/> Vec::new(),<br/> |patch_status| {<br/> if patch_status.is_open() {<br/> return Err(N34Error::InvalidStatus(<br/> "You can't open an already open patch".to_owned(),<br/> ));<br/> }<br/><br/> if patch_status.is_merged_or_applied() {<br/> return Err(N34Error::InvalidStatus(<br/> "You can't open a merged/applied patch".to_owned(),<br/> ));<br/> }<br/><br/> Ok(())<br/> },<br/> )<br/> .await<br/> }<br/>}<br/>
2026-10-09T01:54:27Zhttps://njump.me/nevent1qqsxa59wzeuapl7hpgv32e6akjtsndxuhzkk7az8fm6fsqglcz25wkgzyp2xhcyfwmc3jdu98up2074n3zznz6ye259qzdm0pp7qwhqtg2z6ja7sthm// n34 - A CLI to interact with NIP-34 and other stuff related to ...
// n34 - A CLI to interact with NIP-34 and other stuff related to codes in nostr<br/>// Copyright (C) 2025 Awiteb <a@4rs.nl><br/>//<br/>// This program is free software: you can redistribute it and/or modify<br/>// it under the terms of the GNU General Public License as published by<br/>// the Free Software Foundation, either version 3 of the License, or<br/>// (at your option) any later version.<br/>//<br/>// This program is distributed in the hope that it will be useful,<br/>// but WITHOUT ANY WARRANTY; without even the implied warranty of<br/>// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the<br/>// GNU General Public License for more details.<br/>//<br/>// You should have received a copy of the GNU General Public License<br/>// along with this program. If not, see <<a href="https://gnu.org/licenses/gpl-3.0.html>">https://gnu.org/licenses/gpl-3.0.html></a>;.<br/><br/>use std::fs;<br/><br/>use clap::{ArgGroup, Args};<br/>use futures::future;<br/>use nostr::{<br/> event::{Event, EventBuilder, Kind},<br/> filter::Filter,<br/> nips::nip01::Coordinate,<br/> types::RelayUrl,<br/>};<br/><br/>use super::{CliOptions, CommandRunner};<br/>use crate::{<br/> cli::{<br/> traits::{OptionNaddrOrSetVecExt, RelayOrSetVecExt},<br/> types::{NaddrOrSet, NostrEvent},<br/> },<br/> error::{N34Error, N34Result},<br/> nostr_utils::{<br/> NostrClient,<br/> traits::{NaddrsUtils, ReposUtils},<br/> utils,<br/> },<br/>};<br/><br/>/// The max date "9999-01-01 at 00:00 UTC"<br/>const MAX_DATE: i64 = 253370764800;<br/><br/>/// Arguments for the `reply` command<br/>#[derive(Args, Debug)]<br/>#[clap(<br/> group(<br/> ArgGroup::new("comment-content")<br/> .args(["comment", "editor"])<br/> .required(true)<br/> ),<br/> group(<br/> ArgGroup::new("quote-reply-to")<br/> .args(["comment", "quote_to"])<br/> )<br/>)]<br/>pub struct ReplyArgs {<br/> /// The issue, patch, or comment to reply to<br/> #[arg(value_name = "nevent1-or-note1")]<br/> to: NostrEvent,<br/> /// Quote the replied-to event in the editor<br/> #[arg(long)]<br/> quote_to: bool,<br/> /// Repository address in `naddr` format (`naddr1...`), NIP-05 format<br/> /// (`4rs.nl/n34` or `_@4rs.nl/n34`), or a set name like `kernel`.<br/> ///<br/> /// If omitted, looks for a `nostr-address` file.<br/> #[arg(value_name = "NADDR-NIP05-OR-SET", long = "repo")]<br/> naddrs: Option<Vec<NaddrOrSet>>,<br/> /// The comment (cannot be used with --editor)<br/> #[arg(short, long)]<br/> comment: Option<String>,<br/> /// Open editor to write comment (cannot be used with --content)<br/> #[arg(short, long)]<br/> editor: bool,<br/>}<br/><br/>impl CommandRunner for ReplyArgs {<br/> async fn run(self, options: CliOptions) -> N34Result<()> {<br/> let nostr_address_path = utils::nostr_address_path()?;<br/> let relays = options.relays.clone().flat_relays(&options.config.sets)?;<br/> let client = NostrClient::init(&options, &relays).await;<br/> let user_pubk = client.pubkey().await?;<br/> let repo_naddrs = if let Some(naddrs) = self.naddrs.flat_naddrs(&options.config.sets)? {<br/> client.add_relays(&naddrs.extract_relays()).await;<br/> Some(naddrs)<br/> } else if fs::exists(&nostr_address_path).is_ok() {<br/> let naddrs = utils::naddrs_or_file(None, &nostr_address_path)?;<br/> client.add_relays(&naddrs.extract_relays()).await;<br/> Some(naddrs)<br/> } else {<br/> None<br/> };<br/><br/> client.add_relays(&self.to.relays).await;<br/> let relays_list = client.user_relays_list(user_pubk).await?;<br/> let author_read_relays =<br/> utils::add_read_relays(client.user_relays_list(user_pubk).await?.as_ref());<br/> client.add_relays(&author_read_relays).await;<br/><br/><br/> let reply_to = client<br/> .fetch_event(Filter::new().id(self.to.event_id))<br/> .await?<br/> .ok_or(N34Error::EventNotFound)?;<br/> let root = client.find_root(reply_to.clone()).await?;<br/><br/> let repos_coordinate = if let Some(naddrs) = repo_naddrs {<br/> naddrs.into_coordinates()<br/> } else if let Some(ref root_event) = root {<br/> coordinates_from_root(root_event)?<br/> } else {<br/> return Err(N34Error::NotFoundRepo);<br/> };<br/><br/> let repos = client.fetch_repos(&repos_coordinate).await?;<br/> let maintainers = repos.extract_maintainers();<br/><br/> let quoted_content = if self.quote_to {<br/> Some(quote_reply_to_content(&client, &reply_to).await)<br/> } else {<br/> None<br/> };<br/><br/> let content = utils::get_content(self.comment.as_ref(), quoted_content.as_ref(), ".txt")?;<br/> let content_details = client.parse_content(&content).await;<br/><br/> let event = EventBuilder::comment(<br/> content,<br/> &reply_to,<br/> root.as_ref(),<br/> repos.first().and_then(|r| r.relays.first()).cloned(),<br/> )<br/> .dedup_tags()<br/> .pow(options.pow.unwrap_or_default())<br/> .tags(content_details.clone().into_tags())<br/> .build(user_pubk);<br/><br/> let event_id = event.id.expect("There is an id");<br/> let write_relays = [<br/> relays,<br/> utils::add_write_relays(relays_list.as_ref()),<br/> // Merge repository announcement relays into write relays<br/> repos.extract_relays(),<br/> // Include read relays for each repository maintainer (if found)<br/> client.read_relays_from_users(&maintainers).await,<br/> // read relays of the root event and the reply to event<br/> {<br/> let (r1, r2) = future::join(<br/> client.read_relays_from_user(reply_to.pubkey),<br/> event_author_read_relays(&client, root.as_ref()),<br/> )<br/> .await;<br/> [r1, r2].concat()<br/> },<br/> content_details.write_relays.into_iter().collect(),<br/> ]<br/> .concat();<br/><br/> tracing::trace!(relays = ?write_relays, "Write relays list");<br/> let (success, ..) = futures::join!(<br/> client.send_event_to(event, relays_list.as_ref(), &write_relays),<br/> client.broadcast(&reply_to, &author_read_relays),<br/> async {<br/> if let Some(root_event) = root {<br/> let _ = client.broadcast(&root_event, &author_read_relays).await;<br/> }<br/> },<br/> );<br/><br/><br/> let nevent = utils::new_nevent(event_id, &success?)?;<br/> println!("Comment created: {nevent}");<br/><br/> Ok(())<br/> }<br/>}<br/><br/>/// Creates a quoted reply string in the format "On yyyy-mm-dd at hh:mm UTC,<br/>/// {author} wrote:" followed by the event content. Uses display name if<br/>/// available, otherwise falls back to a shortened npub string. Dates are<br/>/// formatted in UTC.<br/>async fn quote_reply_to_content(client: &NostrClient, quoted_event: &Event) -> String {<br/> let author_name = client.get_username(quoted_event.pubkey).await;<br/><br/> let fdate = chrono::DateTime::from_timestamp(<br/> quoted_event<br/> .created_at<br/> .as_u64()<br/> .try_into()<br/> .unwrap_or(MAX_DATE),<br/> 0,<br/> )<br/> .map(|datetime| datetime.format("On %F at %R UTC, ").to_string())<br/> .unwrap_or_default();<br/><br/> format!(<br/> "{fdate}{author_name} wrote:\n> {}",<br/> quoted_event.content.trim().replace("\n", "\n> ")<br/> )<br/>}<br/><br/>/// Gets the repository coordinate from a root Nostr event's tags.<br/>/// The event must contain a coordinate tag with GitRepoAnnouncement kind.<br/>fn coordinates_from_root(root: &Event) -> N34Result<Vec<Coordinate>> {<br/> let coordinates: Vec<Coordinate> = root<br/> .tags<br/> .coordinates()<br/> .filter(|c| c.kind == Kind::GitRepoAnnouncement)<br/> .cloned()<br/> .collect();<br/><br/> if coordinates.is_empty() {<br/> return Err(N34Error::InvalidEvent(<br/> "The Git issue/patch does not specify a target repository".to_owned(),<br/> ));<br/> }<br/><br/> Ok(coordinates)<br/>}<br/><br/>/// Returns the event author read relays if found, otherwise an empty vector<br/>async fn event_author_read_relays(client: &NostrClient, event: Option<&Event>) -> Vec<RelayUrl> {<br/> if let Some(root_event) = event {<br/> client.read_relays_from_user(root_event.pubkey).await<br/> } else {<br/> Vec::new()<br/> }<br/>}<br/>
2026-10-09T01:54:27Zhttps://njump.me/nevent1qqs9saz366e9qaeg3xadftr2t06x625e3fz93pxhgpduqrmcvn6dzrqzyp2xhcyfwmc3jdu98up2074n3zznz6ye259qzdm0pp7qwhqtg2z6j8pyc99// n34 - A CLI to interact with NIP-34 and other stuff related to ...
// n34 - A CLI to interact with NIP-34 and other stuff related to codes in nostr<br/>// Copyright (C) 2025 Awiteb <a@4rs.nl><br/>//<br/>// This program is free software: you can redistribute it and/or modify<br/>// it under the terms of the GNU General Public License as published by<br/>// the Free Software Foundation, either version 3 of the License, or<br/>// (at your option) any later version.<br/>//<br/>// This program is distributed in the hope that it will be useful,<br/>// but WITHOUT ANY WARRANTY; without even the implied warranty of<br/>// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the<br/>// GNU General Public License for more details.<br/>//<br/>// You should have received a copy of the GNU General Public License<br/>// along with this program. If not, see <<a href="https://gnu.org/licenses/gpl-3.0.html>">https://gnu.org/licenses/gpl-3.0.html></a>;.<br/><br/>/// `patch apply` suubcommand<br/>mod apply;<br/>/// `patch close` subcommand<br/>mod close;<br/>/// `patch draft` subcommand<br/>mod draft;<br/>/// `patch fetch` subcommand<br/>mod fetch;<br/>/// `patch list` subcommand<br/>mod list;<br/>/// `patch merge` subcommand<br/>mod merge;<br/>/// `patch reopen` subcommand<br/>mod reopen;<br/>/// `patch send` subcommand<br/>mod send;<br/>#[cfg(test)]<br/>mod tests;<br/><br/>use std::{<br/> fmt,<br/> path::{Path, PathBuf},<br/> str::FromStr,<br/> sync::LazyLock,<br/>};<br/><br/>use clap::Subcommand;<br/>use nostr::event::Kind;<br/>use regex::Regex;<br/><br/>use self::apply::ApplyArgs;<br/>use self::close::CloseArgs;<br/>use self::draft::DraftArgs;<br/>use self::fetch::FetchArgs;<br/>use self::list::ListArgs;<br/>use self::merge::MergeArgs;<br/>use self::reopen::ReopenArgs;<br/>use self::send::SendArgs;<br/>use super::{CliOptions, CommandRunner};<br/>use crate::error::{N34Error, N34Result};<br/><br/>/// Regular expression for extracting the patch subject.<br/>static SUBJECT_RE: LazyLock<Regex> =<br/> LazyLock::new(|| Regex::new(r"(?m)^Subject: (.*(?:\n .*)*)").unwrap());<br/><br/>/// Regular expression for extracting the patch body.<br/>static BODY_RE: LazyLock<Regex> =<br/> LazyLock::new(|| Regex::new(r"\n\n((?:.|\n)*?)(?:\n--[ -]|\z)").unwrap());<br/><br/>/// Regular expiration for extracting the patch version and number<br/>static PATCH_VERSION_NUMBER_RE: LazyLock<Regex> = LazyLock::new(|| {<br/> Regex::new(r"\[PATCH\s+(?:v(?<version>\d+)\s*)?(?<number>\d+)/(?:\d+)").unwrap()<br/>});<br/><br/>/// Content of the hashtag representing the root patch.<br/>pub const ROOT_HASHTAG_CONTENT: &str = "root";<br/>/// Content of the hashtag representing the root revision patch.<br/>pub const REVISION_ROOT_HASHTAG_CONTENT: &str = "root-revision";<br/>/// The content of the hashtag used by `ngit-cli` to represent a root revision<br/>/// patch before the commit 6ae42e67d9da36f6c2e1356acba30a3a62112bc7. This was a<br/>/// typo.<br/>pub const LEGACY_NGIT_REVISION_ROOT_HASHTAG_CONTENT: &str = "revision-root";<br/><br/>#[derive(Subcommand, Debug)]<br/>pub enum PatchSubcommands {<br/> /// Send one or more patches to a repository.<br/> Send(SendArgs),<br/> /// Fetches a patch by its id.<br/> Fetch(FetchArgs),<br/> /// Closes an open or drafted patch.<br/> Close(CloseArgs),<br/> /// Converts an open patch to draft state.<br/> Draft(DraftArgs),<br/> /// Reopens a closed or drafted patch.<br/> Reopen(ReopenArgs),<br/> /// Set an open patch status to applied.<br/> Apply(ApplyArgs),<br/> /// Set an open patch status to merged.<br/> Merge(MergeArgs),<br/> /// List the repositories patches.<br/> List(ListArgs),<br/>}<br/><br/>/// Represents a git patch<br/>#[derive(Clone, Debug)]<br/>pub struct GitPatch {<br/> /// Full content of the patch file<br/> pub inner: String,<br/> /// Short description of the patch changes<br/> pub subject: String,<br/> /// Detailed explanation of the patch changes<br/> pub body: String,<br/>}<br/><br/>#[derive(Debug)]<br/>pub enum PatchStatus {<br/> /// The patch is currently open<br/> Open,<br/> /// The patch has been merged/applied<br/> MergedApplied,<br/> /// The patch has been closed<br/> Closed,<br/> /// A patch that has been drafted but not yet applied.<br/> Draft,<br/>}<br/><br/>impl PatchStatus {<br/> /// Maps the issue status to its corresponding Nostr kind.<br/> #[inline]<br/> pub fn kind(&self) -> Kind {<br/> match self {<br/> Self::Open => Kind::GitStatusOpen,<br/> Self::MergedApplied => Kind::GitStatusApplied,<br/> Self::Closed => Kind::GitStatusClosed,<br/> Self::Draft => Kind::GitStatusDraft,<br/> }<br/> }<br/><br/> /// Returns the string representation of the patch status.<br/> pub const fn as_str(&self) -> &'static str {<br/> match self {<br/> Self::Open => "Open",<br/> Self::MergedApplied => "Merged/Applied",<br/> Self::Closed => "Closed",<br/> Self::Draft => "Draft",<br/> }<br/> }<br/><br/> /// Check if the patch is open.<br/> #[inline]<br/> pub fn is_open(&self) -> bool {<br/> matches!(self, Self::Open)<br/> }<br/><br/> /// Check if the patch is merged/applied.<br/> #[inline]<br/> pub fn is_merged_or_applied(&self) -> bool {<br/> matches!(self, Self::MergedApplied)<br/> }<br/><br/> /// Check if the patch is closed.<br/> #[inline]<br/> pub fn is_closed(&self) -> bool {<br/> matches!(self, Self::Closed)<br/> }<br/><br/> /// Check if the patch is drafted<br/> #[inline]<br/> pub fn is_drafted(&self) -> bool {<br/> matches!(self, Self::Draft)<br/> }<br/>}<br/><br/>impl From<&PatchStatus> for Kind {<br/> fn from(status: &PatchStatus) -> Self {<br/> status.kind()<br/> }<br/>}<br/><br/>impl fmt::Display for PatchStatus {<br/> fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {<br/> write!(f, "{}", self.as_str())<br/> }<br/>}<br/><br/><br/>impl TryFrom<Kind> for PatchStatus {<br/> type Error = N34Error;<br/><br/> fn try_from(kind: Kind) -> Result<Self, Self::Error> {<br/> match kind {<br/> Kind::GitStatusOpen => Ok(Self::Open),<br/> Kind::GitStatusApplied => Ok(Self::MergedApplied),<br/> Kind::GitStatusClosed => Ok(Self::Closed),<br/> Kind::GitStatusDraft => Ok(Self::Draft),<br/> _ => Err(N34Error::InvalidPatchStatus(kind)),<br/> }<br/> }<br/>}<br/><br/>impl GitPatch {<br/> /// Returns the patch file name from the subject<br/> pub fn filename(&self, parent: impl AsRef<Path>) -> N34Result<PathBuf> {<br/> let (patch_version, patch_number) = if self.subject.contains("[PATCH]") {<br/> (String::new(), "1")<br/> } else {<br/> patch_version_and_subject(&self.subject)?<br/> };<br/><br/> let patch_name = if patch_number == "0" {<br/> "cover-letter".to_owned()<br/> } else {<br/> patch_file_name(&self.subject)?<br/> };<br/><br/> Ok(parent<br/> .as_ref()<br/> .join(format!("{patch_version}{patch_number:0>4}-{patch_name}").replace("--", "-"))<br/> .with_extension("patch"))<br/> }<br/>}<br/><br/>impl CommandRunner for PatchSubcommands {<br/> async fn run(self, options: CliOptions) -> N34Result<()> {<br/> crate::run_command!(self, options, & Send Fetch Close Reopen Draft Apply Merge List)<br/> }<br/>}<br/><br/>impl FromStr for GitPatch {<br/> type Err = String;<br/><br/> fn from_str(patch_content: &str) -> Result<Self, Self::Err> {<br/> // Regex for subject (handles multi-line subjects)<br/> let subject = SUBJECT_RE<br/> .captures(patch_content)<br/> .and_then(|cap| cap.get(1))<br/> .ok_or("No subject found")?<br/> .as_str()<br/> .trim()<br/> .replace('\n', "")<br/> .to_string();<br/><br/> // Regex for body<br/> let body = BODY_RE<br/> .captures(patch_content)<br/> .and_then(|cap| cap.get(1))<br/> .ok_or("No body found")?<br/> .as_str()<br/> .trim()<br/> .to_string();<br/> Ok(Self {<br/> inner: patch_content.to_owned(),<br/> subject,<br/> body,<br/> })<br/> }<br/>}<br/><br/>/// Extracts the version prefix and patch number from a patch subject string.<br/>///<br/>/// The version prefix is formatted as "v{version}-" if present, or an empty<br/>/// string. The patch number is mandatory and will cause an error if not found.<br/>fn patch_version_and_subject(subject: &str) -> N34Result<(String, &str)> {<br/> let captures = PATCH_VERSION_NUMBER_RE.captures(subject).ok_or_else(|| {<br/> N34Error::InvalidEvent(format!("Can not parse the patch subject `{subject}`"))<br/> })?;<br/> Ok((<br/> captures<br/> .name("version")<br/> .map(|m| format!("v{}-", m.as_str()))<br/> .unwrap_or_default(),<br/> captures<br/> .name("number")<br/> .map(|m| m.as_str())<br/> .expect("It's not optional, regex will fail if it's not found"),<br/> ))<br/>}<br/><br/>/// Extracts a clean file name from the patch subject by removing version info<br/>/// and special characters. Converts to lowercase and ensures the name only<br/>/// contains alphanumeric, '.', '-', or '_' characters.<br/>fn patch_file_name(subject: &str) -> N34Result<String> {<br/> Ok(subject<br/> .split_once("]")<br/> .ok_or_else(|| {<br/> N34Error::InvalidEvent(format!(<br/> "Invalid patch subject. No `[PATCH ...]`: `{subject}`",<br/> ))<br/> })?<br/> .1<br/> .trim()<br/> .to_lowercase()<br/> .replace(<br/> |c: char| !c.is_ascii_alphanumeric() && !['.', '-', '_'].contains(&c),<br/> "-",<br/> )<br/> .chars()<br/> .take(60)<br/> .collect::<String>()<br/> .trim_matches('-')<br/> .trim()<br/> .replace("--", "-"))<br/>}<br/>
2026-10-09T01:54:27Zhttps://njump.me/nevent1qqsr7v5wuxg2ya8z3v58xavkjq0vu8nvctsyjlqnj98j4cp3mhw3hrqzyp2xhcyfwmc3jdu98up2074n3zznz6ye259qzdm0pp7qwhqtg2z6j6qa7ag// n34 - A CLI to interact with NIP-34 and other stuff related to ...
// n34 - A CLI to interact with NIP-34 and other stuff related to codes in nostr<br/>// Copyright (C) 2025 Awiteb <a@4rs.nl><br/>//<br/>// This program is free software: you can redistribute it and/or modify<br/>// it under the terms of the GNU General Public License as published by<br/>// the Free Software Foundation, either version 3 of the License, or<br/>// (at your option) any later version.<br/>//<br/>// This program is distributed in the hope that it will be useful,<br/>// but WITHOUT ANY WARRANTY; without even the implied warranty of<br/>// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the<br/>// GNU General Public License for more details.<br/>//<br/>// You should have received a copy of the GNU General Public License<br/>// along with this program. If not, see <<a href="https://gnu.org/licenses/gpl-3.0.html>">https://gnu.org/licenses/gpl-3.0.html></a>;.<br/><br/>use clap::Args;<br/>use nostr::hashes::sha1::Hash as Sha1Hash;<br/><br/>use super::PatchStatus;<br/>use crate::{<br/> cli::{<br/> CliOptions,<br/> traits::{CommandRunner, VecNostrEventExt},<br/> types::{NaddrOrSet, NostrEvent},<br/> },<br/> error::{N34Error, N34Result},<br/>};<br/><br/>#[derive(Debug, Args)]<br/>pub struct MergeArgs {<br/> /// Repository address in `naddr` format (`naddr1...`), NIP-05 format<br/> /// (`4rs.nl/n34` or `_@4rs.nl/n34`), or a set name like `kernel`.<br/> ///<br/> /// If omitted, looks for a `nostr-address` file.<br/> #[arg(value_name = "NADDR-NIP05-OR-SET", long = "repo")]<br/> naddrs: Option<Vec<NaddrOrSet>>,<br/> /// The open patch id to merge it. Must be orignal root patch or<br/> /// revision root<br/> patch_id: NostrEvent,<br/> /// Patches that have been merged. Use this when only some patches have been<br/> /// merged, not all.<br/> #[arg(long = "patches", value_name = "PATCH-EVENT-ID")]<br/> merged_patches: Vec<NostrEvent>,<br/> /// The merge commit id<br/> merge_commit: Sha1Hash,<br/>}<br/><br/>impl CommandRunner for MergeArgs {<br/> async fn run(self, options: CliOptions) -> N34Result<()> {<br/> crate::cli::common_commands::patch_status_command(<br/> options,<br/> self.patch_id,<br/> self.naddrs,<br/> PatchStatus::MergedApplied,<br/> Some(either::Either::Left(self.merge_commit)),<br/> self.merged_patches.into_event_ids(),<br/> |patch_status| {<br/> if patch_status.is_merged_or_applied() {<br/> return Err(N34Error::InvalidStatus(<br/> "You can't merge an already merged patch".to_owned(),<br/> ));<br/> }<br/><br/> if patch_status.is_closed() {<br/> return Err(N34Error::InvalidStatus(<br/> "You can't merge a closed patch".to_owned(),<br/> ));<br/> }<br/><br/> if patch_status.is_drafted() {<br/> return Err(N34Error::InvalidStatus(<br/> "You can't merge a drafted patch".to_owned(),<br/> ));<br/> }<br/><br/> Ok(())<br/> },<br/> )<br/> .await<br/> }<br/>}<br/>
2026-10-09T01:54:27Zhttps://njump.me/nevent1qqsru3533592mxn5p6yfuvqmujlfneh5yll0nnecmx2lkqty6x42l0czyp2xhcyfwmc3jdu98up2074n3zznz6ye259qzdm0pp7qwhqtg2z6jd0fsmd// n34 - A CLI to interact with NIP-34 and other stuff related to ...
// n34 - A CLI to interact with NIP-34 and other stuff related to codes in nostr<br/>// Copyright (C) 2025 Awiteb <a@4rs.nl><br/>//<br/>// This program is free software: you can redistribute it and/or modify<br/>// it under the terms of the GNU General Public License as published by<br/>// the Free Software Foundation, either version 3 of the License, or<br/>// (at your option) any later version.<br/>//<br/>// This program is distributed in the hope that it will be useful,<br/>// but WITHOUT ANY WARRANTY; without even the implied warranty of<br/>// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the<br/>// GNU General Public License for more details.<br/>//<br/>// You should have received a copy of the GNU General Public License<br/>// along with this program. If not, see <<a href="https://gnu.org/licenses/gpl-3.0.html>">https://gnu.org/licenses/gpl-3.0.html></a>;.<br/><br/>use clap::Args;<br/><br/>use super::PatchStatus;<br/>use crate::{<br/> cli::{<br/> CliOptions,<br/> traits::CommandRunner,<br/> types::{NaddrOrSet, NostrEvent},<br/> },<br/> error::{N34Error, N34Result},<br/>};<br/><br/>#[derive(Debug, Args)]<br/>pub struct DraftArgs {<br/> /// Repository address in `naddr` format (`naddr1...`), NIP-05 format<br/> /// (`4rs.nl/n34` or `_@4rs.nl/n34`), or a set name like `kernel`.<br/> ///<br/> /// If omitted, looks for a `nostr-address` file.<br/> #[arg(value_name = "NADDR-NIP05-OR-SET", long = "repo")]<br/> naddrs: Option<Vec<NaddrOrSet>>,<br/> /// The open patch id to draft it. Must be orignal root patch<br/> patch_id: NostrEvent,<br/>}<br/><br/>impl CommandRunner for DraftArgs {<br/> async fn run(self, options: CliOptions) -> N34Result<()> {<br/> crate::cli::common_commands::patch_status_command(<br/> options,<br/> self.patch_id,<br/> self.naddrs,<br/> PatchStatus::Draft,<br/> None,<br/> Vec::new(),<br/> |patch_status| {<br/> if patch_status.is_drafted() {<br/> return Err(N34Error::InvalidStatus(<br/> "You can't draft an already drafted patch".to_owned(),<br/> ));<br/> }<br/><br/> if patch_status.is_closed() {<br/> return Err(N34Error::InvalidStatus(<br/> "You can't draft a closed patch".to_owned(),<br/> ));<br/> }<br/><br/> if patch_status.is_merged_or_applied() {<br/> return Err(N34Error::InvalidStatus(<br/> "You can't draft a merged/applied patch".to_owned(),<br/> ));<br/> }<br/><br/> Ok(())<br/> },<br/> )<br/> .await<br/> }<br/>}<br/>
2026-10-09T01:54:27Zhttps://njump.me/nevent1qqsr9jfzwrkmp6p4t5scrvhv6a0fqefq5dnuc94rtxleht4g2netr4szyp2xhcyfwmc3jdu98up2074n3zznz6ye259qzdm0pp7qwhqtg2z6jucm3n7// n34 - A CLI to interact with NIP-34 and other stuff related to ...
// n34 - A CLI to interact with NIP-34 and other stuff related to codes in nostr<br/>// Copyright (C) 2025 Awiteb <a@4rs.nl><br/>//<br/>// This program is free software: you can redistribute it and/or modify<br/>// it under the terms of the GNU General Public License as published by<br/>// the Free Software Foundation, either version 3 of the License, or<br/>// (at your option) any later version.<br/>//<br/>// This program is distributed in the hope that it will be useful,<br/>// but WITHOUT ANY WARRANTY; without even the implied warranty of<br/>// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the<br/>// GNU General Public License for more details.<br/>//<br/>// You should have received a copy of the GNU General Public License<br/>// along with this program. If not, see <<a href="https://gnu.org/licenses/gpl-3.0.html>">https://gnu.org/licenses/gpl-3.0.html></a>;.<br/><br/>use std::{fs, str::FromStr};<br/><br/>use clap::Args;<br/>use futures::future;<br/>use nostr::{<br/> event::{EventBuilder, EventId, Kind, Tag, TagKind, Tags, UnsignedEvent},<br/> hashes::sha1::Hash as Sha1Hash,<br/> key::PublicKey,<br/> nips::{nip01::Coordinate, nip10::Marker},<br/> types::RelayUrl,<br/>};<br/><br/>use super::GitPatch;<br/>use crate::{<br/> cli::{<br/> CliOptions,<br/> patch::{REVISION_ROOT_HASHTAG_CONTENT, ROOT_HASHTAG_CONTENT},<br/> traits::{CommandRunner, OptionNaddrOrSetVecExt, RelayOrSetVecExt},<br/> types::{NaddrOrSet, NostrEvent},<br/> },<br/> error::N34Result,<br/> nostr_utils::{<br/> NostrClient,<br/> traits::{NaddrsUtils, ReposUtils},<br/> utils,<br/> },<br/>};<br/><br/>/// Prefix used for git patch alt.<br/>const PATCH_ALT_PREFIX: &str = "git patch: ";<br/><br/>#[derive(Args, Debug)]<br/>pub struct SendArgs {<br/> /// Repository address in `naddr` format (`naddr1...`), NIP-05 format<br/> /// (`4rs.nl/n34` or `_@4rs.nl/n34`), or a set name like `kernel`.<br/> ///<br/> /// If omitted, looks for a `nostr-address` file.<br/> #[arg(value_name = "NADDR-NIP05-OR-SET", long = "repo")]<br/> naddrs: Option<Vec<NaddrOrSet>>,<br/> /// List of patch files to send (space separated).<br/> ///<br/> /// For p-tagging users, include them in the cover letter with<br/> /// `nostr:npub1...`.<br/> #[arg(value_name = "PATCH-PATH", required = true, value_parser = parse_patch_path)]<br/> patches: Vec<GitPatch>,<br/> /// Original patch ID if this is a revision of it<br/> #[arg(long, value_name = "EVENT-ID")]<br/> original_patch: Option<NostrEvent>,<br/>}<br/><br/>impl CommandRunner for SendArgs {<br/> async fn run(self, options: CliOptions) -> N34Result<()> {<br/> let naddrs = utils::check_empty_naddrs(utils::naddrs_or_file(<br/> self.naddrs.flat_naddrs(&options.config.sets)?,<br/> &utils::nostr_address_path()?,<br/> )?)?;<br/><br/> let repo_coordinates = naddrs.clone().into_coordinates();<br/> let relays = options.relays.clone().flat_relays(&options.config.sets)?;<br/> let client = NostrClient::init(&options, &relays).await;<br/> let user_pubk = client.pubkey().await?;<br/><br/> client.add_relays(&naddrs.extract_relays()).await;<br/> if let Some(original_patch) = &self.original_patch {<br/> client.add_relays(&original_patch.relays).await;<br/> }<br/> let relays_list = client.user_relays_list(user_pubk).await?;<br/> client<br/> .add_relays(&utils::add_read_relays(relays_list.as_ref()))<br/> .await;<br/> let repos = client.fetch_repos(&repo_coordinates).await?;<br/> let euc = repos.extract_euc();<br/> let maintainers = repos.extract_maintainers();<br/> client.add_relays(&repos.extract_relays()).await;<br/><br/> let (events, events_write_relays) = make_patch_series(<br/> &client,<br/> self.patches,<br/> self.original_patch.as_ref().map(|e| e.event_id),<br/> repos.extract_relays().first().cloned(),<br/> repo_coordinates,<br/> euc,<br/> user_pubk,<br/> )<br/> .await?;<br/><br/> let write_relays = [<br/> relays,<br/> repos.extract_relays(),<br/> events_write_relays,<br/> naddrs.extract_relays(),<br/> self.original_patch.map(|e| e.relays).unwrap_or_default(),<br/> utils::add_write_relays(relays_list.as_ref()),<br/> client.read_relays_from_users(&maintainers).await,<br/> ]<br/> .concat();<br/><br/> tracing::trace!(write_relays = ?write_relays, "Write relays of the patches");<br/> let nevents = future::join_all(events.into_iter().map(|mut event| {<br/> async {<br/> let event_id = event.id();<br/> let subject = event<br/> .tags<br/> .find(TagKind::Alt)<br/> .and_then(Tag::content)<br/> .expect("There is an alt")<br/> .replace(PATCH_ALT_PREFIX, "");<br/> client<br/> .send_event_to(event, relays_list.as_ref(), &write_relays)<br/> .await<br/> .map(|r| Ok((subject, utils::new_nevent(event_id, &r)?)))?<br/> }<br/> }))<br/> .await<br/> .into_iter()<br/> .collect::<N34Result<Vec<_>>>()?;<br/><br/> for (subject, nevent) in nevents {<br/> println!("Created '{subject}': {nevent}");<br/> }<br/><br/> Ok(())<br/> }<br/>}<br/><br/>fn parse_patch_path(patch_path: &str) -> Result<GitPatch, String> {<br/> tracing::debug!("Parsing patch file `{patch_path}`");<br/> let patch_content = fs::read_to_string(patch_path)<br/> .map_err(|err| format!("Failed to read patch file `{patch_path}`: {err}"))?;<br/> GitPatch::from_str(&patch_content)<br/>}<br/><br/>async fn make_patch_series(<br/> client: &NostrClient,<br/> patches: Vec<GitPatch>,<br/> original_patch: Option<EventId>,<br/> relay_hint: Option<RelayUrl>,<br/> repo_coordinates: Vec<Coordinate>,<br/> euc: Option<&Sha1Hash>,<br/> author_pkey: PublicKey,<br/>) -> N34Result<(Vec<UnsignedEvent>, Vec<RelayUrl>)> {<br/> let mut write_relays = Vec::new();<br/> let mut patch_series = Vec::new();<br/> let mut patches = patches.into_iter();<br/> let root_patch = patches.next().expect("Patches can't be empty");<br/> let (root_event, root_relays) = make_patch(<br/> client,<br/> root_patch,<br/> None,<br/> original_patch,<br/> relay_hint.as_ref(),<br/> &repo_coordinates,<br/> euc,<br/> author_pkey,<br/> )<br/> .await;<br/> write_relays.extend(root_relays);<br/> let root_id = *root_event.id.as_ref().expect("There is an id");<br/> let mut previous_patch = root_id;<br/> patch_series.push(root_event);<br/><br/> for patch in patches {<br/> let (patch_event, patch_relays) = make_patch(<br/> client,<br/> patch,<br/> Some(root_id),<br/> Some(previous_patch),<br/> relay_hint.as_ref(),<br/> &repo_coordinates,<br/> euc,<br/> author_pkey,<br/> )<br/> .await;<br/> previous_patch = patch_event.id.expect("there is an id");<br/> write_relays.extend(patch_relays);<br/> patch_series.push(patch_event);<br/> }<br/><br/> Ok((patch_series, write_relays))<br/>}<br/><br/>#[allow(clippy::too_many_arguments)]<br/>async fn make_patch(<br/> client: &NostrClient,<br/> patch: GitPatch,<br/> root: Option<EventId>,<br/> reply_to: Option<EventId>,<br/> write_relay: Option<&RelayUrl>,<br/> repo_coordinates: &[Coordinate],<br/> euc: Option<&Sha1Hash>,<br/> author_pkey: PublicKey,<br/>) -> (UnsignedEvent, Vec<RelayUrl>) {<br/> let content_details = client.parse_content(&patch.body).await;<br/> let content_relays = content_details.write_relays.clone();<br/> // NIP-34 compliance requires referencing the previous patch using `NIP-10 e<br/> // reply`. However, this fails for the second patch when<br/> // `EventBuilder::dedup_tags` is enabled because:<br/> // 1. The tag is treated as a duplicate based on its content (the root ID).<br/> // 2. The second patch would reply to the root twice:<br/> // - First with the 'root' marker<br/> // - Then with the 'reply' marker<br/> // The `EventBuilder::dedup_tags` function then removes the 'reply' marker as a<br/> // duplicate.<br/> let mut safe_dedup_tags = Tags::new();<br/> safe_dedup_tags.push(Tag::alt(format!("{PATCH_ALT_PREFIX}{}", patch.subject)));<br/> safe_dedup_tags.push(Tag::description(patch.subject));<br/> safe_dedup_tags.extend(content_details.into_tags());<br/> safe_dedup_tags.extend(<br/> repo_coordinates<br/> .iter()<br/> .map(|c| Tag::coordinate(c.clone(), None)),<br/> );<br/> safe_dedup_tags.extend(<br/> repo_coordinates<br/> .iter()<br/> .map(|c| Tag::public_key(c.public_key)),<br/> );<br/> if let Some(euc) = euc {<br/> safe_dedup_tags.push(Tag::reference(euc.to_string()));<br/> }<br/> safe_dedup_tags.dedup();<br/> let mut event_builder = EventBuilder::new(Kind::GitPatch, patch.inner).tags(safe_dedup_tags);<br/><br/> // If the root is None, this indicates we're handling the root event<br/> if let Some(root_id) = root {<br/> event_builder =<br/> event_builder.tag(utils::event_reply_tag(&root_id, write_relay, Marker::Root));<br/> } else {<br/> event_builder = event_builder.tag(Tag::hashtag(ROOT_HASHTAG_CONTENT));<br/> }<br/><br/> // Handles the case where there is a patch to reply to but no root. This<br/> // indicates we are processing a revision, as the root revision should reply<br/> // directly to the original patch.<br/> if let Some(reply_to_id) = reply_to {<br/> if root.is_none() {<br/> event_builder = event_builder.tags([<br/> utils::event_reply_tag(&reply_to_id, write_relay, Marker::Reply),<br/> Tag::hashtag(REVISION_ROOT_HASHTAG_CONTENT),<br/> ]);<br/> } else {<br/> event_builder = event_builder.tag(utils::event_reply_tag(<br/> &reply_to_id,<br/> write_relay,<br/> Marker::Reply,<br/> ));<br/> }<br/> }<br/> (<br/> event_builder.build(author_pkey),<br/> content_relays.into_iter().collect(),<br/> )<br/>}<br/>
2026-10-09T01:54:27Zhttps://njump.me/nevent1qqsrprxgp5km5u2gwh6sy70z5unwr4jldd89mmacj6tr5k7n2dde8yszyp2xhcyfwmc3jdu98up2074n3zznz6ye259qzdm0pp7qwhqtg2z6jsxdup6// n34 - A CLI to interact with NIP-34 and other stuff related to ...
// n34 - A CLI to interact with NIP-34 and other stuff related to codes in nostr<br/>// Copyright (C) 2025 Awiteb <a@4rs.nl><br/>//<br/>// This program is free software: you can redistribute it and/or modify<br/>// it under the terms of the GNU General Public License as published by<br/>// the Free Software Foundation, either version 3 of the License, or<br/>// (at your option) any later version.<br/>//<br/>// This program is distributed in the hope that it will be useful,<br/>// but WITHOUT ANY WARRANTY; without even the implied warranty of<br/>// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the<br/>// GNU General Public License for more details.<br/>//<br/>// You should have received a copy of the GNU General Public License<br/>// along with this program. If not, see <<a href="https://gnu.org/licenses/gpl-3.0.html>">https://gnu.org/licenses/gpl-3.0.html></a>;.<br/><br/>/// `repo announce` subcommand<br/>mod announce;<br/>/// `repo view` subcommand<br/>mod view;<br/><br/>use clap::Subcommand;<br/><br/>use self::announce::AnnounceArgs;<br/>use self::view::ViewArgs;<br/>use super::{CliOptions, CommandRunner};<br/>use crate::error::N34Result;<br/><br/>#[derive(Subcommand, Debug)]<br/>pub enum RepoSubcommands {<br/> /// View details of a nostr git repository<br/> View(ViewArgs),<br/> /// Broadcast and update a git repository<br/> Announce(AnnounceArgs),<br/>}<br/><br/>impl CommandRunner for RepoSubcommands {<br/> async fn run(self, options: CliOptions) -> N34Result<()> {<br/> crate::run_command!(self, options, & View Announce)<br/> }<br/>}<br/>
2026-10-09T01:54:27Zhttps://njump.me/nevent1qqszn0l0jg7ysun5hlxyfm98k26h7rfux5d26ahs58k6y5gwpy5qekqzyp2xhcyfwmc3jdu98up2074n3zznz6ye259qzdm0pp7qwhqtg2z6j4twtdz// n34 - A CLI to interact with NIP-34 and other stuff related to ...
// n34 - A CLI to interact with NIP-34 and other stuff related to codes in nostr<br/>// Copyright (C) 2025 Awiteb <a@4rs.nl><br/>//<br/>// This program is free software: you can redistribute it and/or modify<br/>// it under the terms of the GNU General Public License as published by<br/>// the Free Software Foundation, either version 3 of the License, or<br/>// (at your option) any later version.<br/>//<br/>// This program is distributed in the hope that it will be useful,<br/>// but WITHOUT ANY WARRANTY; without even the implied warranty of<br/>// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the<br/>// GNU General Public License for more details.<br/>//<br/>// You should have received a copy of the GNU General Public License<br/>// along with this program. If not, see <<a href="https://gnu.org/licenses/gpl-3.0.html>">https://gnu.org/licenses/gpl-3.0.html></a>;.<br/><br/>use std::fmt;<br/><br/>use clap::Args;<br/>use nostr::nips::nip19::ToBech32;<br/><br/>use crate::{<br/> cli::{<br/> CliOptions,<br/> CommandRunner,<br/> traits::{OptionNaddrOrSetVecExt, RelayOrSetVecExt},<br/> types::NaddrOrSet,<br/> },<br/> error::N34Result,<br/> nostr_utils::{NostrClient, traits::NaddrsUtils, utils},<br/>};<br/><br/>/// Arguments for the `repo view` command<br/>#[derive(Args, Debug)]<br/>pub struct ViewArgs {<br/> /// Repository address in `naddr` format (`naddr1...`), NIP-05 format<br/> /// (`4rs.nl/n34` or `_@4rs.nl/n34`), or a set name like `kernel`.<br/> ///<br/> /// If omitted, looks for a `nostr-address` file.<br/> #[arg(value_name = "NADDR-NIP05-OR-SET")]<br/> naddrs: Option<Vec<NaddrOrSet>>,<br/>}<br/><br/>impl CommandRunner for ViewArgs {<br/> const NEED_SIGNER: bool = false;<br/><br/> async fn run(self, options: CliOptions) -> N34Result<()> {<br/> let naddrs = utils::check_empty_naddrs(utils::naddrs_or_file(<br/> self.naddrs.flat_naddrs(&options.config.sets)?,<br/> &utils::nostr_address_path()?,<br/> )?)?;<br/> let relays = options.relays.clone().flat_relays(&options.config.sets)?;<br/> let client = NostrClient::init(&options, &relays).await;<br/> client.add_relays(&naddrs.extract_relays()).await;<br/><br/> let repos = client.fetch_repos(&naddrs.into_coordinates()).await?;<br/> let mut repos_details: Vec<String> = Vec::new();<br/><br/> for repo in repos {<br/> let mut repo_details = format!("ID: {}", repo.id);<br/><br/> if let Some(name) = repo.name {<br/> repo_details.push_str(&format!("\nName: {name}"));<br/> }<br/> if let Some(desc) = repo.description {<br/> repo_details.push_str(&format!("\nDescription: {desc}"));<br/> }<br/> if !repo.web.is_empty() {<br/> repo_details.push_str(&format!("\nWebpages:\n{}", format_list(repo.web)));<br/> }<br/> if !repo.clone.is_empty() {<br/> repo_details.push_str(&format!("\nClone urls:\n{}", format_list(repo.clone)));<br/> }<br/> if !repo.relays.is_empty() {<br/> repo_details.push_str(&format!("\nRelays:\n{}", format_list(repo.relays)));<br/> }<br/> if let Some(euc) = repo.euc {<br/> repo_details.push_str(&format!("\nEarliest unique commit: {euc}"));<br/> }<br/> if !repo.maintainers.is_empty() {<br/> repo_details.push_str(&format!(<br/> "\nMaintainers:\n{}",<br/> format_list(<br/> repo.maintainers<br/> .iter()<br/> .map(|p| p.to_bech32().expect("Infallible"))<br/> )<br/> ));<br/> }<br/> repos_details.push(repo_details);<br/> }<br/><br/> println!("{}", repos_details.join("\n----------\n"));<br/> Ok(())<br/> }<br/>}<br/><br/>/// Format a vector to print it<br/>fn format_list<I, T>(iterator: I) -> String<br/>where<br/> I: IntoIterator<Item = T>,<br/> T: fmt::Display,<br/>{<br/> iterator<br/> .into_iter()<br/> .map(|t| format!(" - {t}"))<br/> .collect::<Vec<String>>()<br/> .join("\n")<br/>}<br/>
2026-10-09T01:54:27Zhttps://njump.me/nevent1qqspyds2exgundyluluqsa5ru4xfxegjdm4l08kmy372e747h0e567gzyp2xhcyfwmc3jdu98up2074n3zznz6ye259qzdm0pp7qwhqtg2z6jzxnkzz// n34 - A CLI to interact with NIP-34 and other stuff related to ...
// n34 - A CLI to interact with NIP-34 and other stuff related to codes in nostr<br/>// Copyright (C) 2025 Awiteb <a@4rs.nl><br/>//<br/>// This program is free software: you can redistribute it and/or modify<br/>// it under the terms of the GNU General Public License as published by<br/>// the Free Software Foundation, either version 3 of the License, or<br/>// (at your option) any later version.<br/>//<br/>// This program is distributed in the hope that it will be useful,<br/>// but WITHOUT ANY WARRANTY; without even the implied warranty of<br/>// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the<br/>// GNU General Public License for more details.<br/>//<br/>// You should have received a copy of the GNU General Public License<br/>// along with this program. If not, see <<a href="https://gnu.org/licenses/gpl-3.0.html>">https://gnu.org/licenses/gpl-3.0.html></a>;.<br/><br/>/// `config` subcommands<br/>pub mod config;<br/>/// `issue` subcommands<br/>pub mod issue;<br/>/// `patch` subcommands<br/>pub mod patch;<br/>/// `reply` command<br/>pub mod reply;<br/>/// `repo` subcommands<br/>pub mod repo;<br/>/// `sets` subcommands<br/>pub mod sets;<br/><br/>use std::fmt;<br/>use std::sync::Arc;<br/>use std::time::Duration;<br/><br/>use clap::{Args, Parser};<br/>use nostr::key::{Keys, SecretKey};<br/>use nostr::nips::nip46::NostrConnectURI;<br/>use nostr::signer::{IntoNostrSigner, NostrSigner};<br/>use nostr_connect::client::NostrConnect;<br/><br/>use self::config::ConfigSubcommands;<br/>use self::issue::IssueSubcommands;<br/>use self::patch::PatchSubcommands;<br/>use self::reply::ReplyArgs;<br/>use self::repo::RepoSubcommands;<br/>use self::sets::SetsSubcommands;<br/>use super::CliConfig;<br/>use super::options_state::OptionsState;<br/>use super::types::RelayOrSet;<br/>use super::{parsers, traits::CommandRunner};<br/>use crate::cli::Cli;<br/>use crate::cli::types::EchoAuthUrl;<br/>use crate::error::{N34Error, N34Result};<br/><br/>/// Default path used when no path is provided via command line arguments.<br/>///<br/>/// This is a workaround since Clap doesn't support lazy evaluation of defaults.<br/>pub const DEFAULT_FALLBACK_PATH: &str = "I_DO_NOT_KNOW_WHY_CLAP_DO_NOT_SUPPORT_LAZY_DEFAULT";<br/><br/>/// How long to wait for bunker response (3 minutes).<br/>const BUNKER_TIMEOUT: Duration = Duration::from_secs(60 * 3);<br/><br/>/// The command-line interface options<br/>#[derive(Args)]<br/>pub struct CliOptions {<br/> /// Your Nostr secret key<br/> #[arg(short, long, group = "signer")]<br/> pub secret_key: Option<SecretKey>,<br/> /// NIP-46 bunker url used for signing events<br/> #[arg(short, long, group = "signer", value_parser = parsers::parse_bunker_url)]<br/> pub bunker_url: Option<NostrConnectURI>,<br/> /// Enables signing events using the browser's NIP-07 extension. Listens on<br/> /// `127.0.0.1:51034`.<br/> #[arg(short = '7', long, group = "signer")]<br/> pub nip07: bool,<br/> /// Fallbacks relay to write and read from it. Multiple relays can be<br/> /// passed.<br/> #[arg(short, long)]<br/> pub relays: Vec<RelayOrSet>,<br/> /// Proof of Work difficulty when creatring events<br/> #[arg(long, value_name = "DIFFICULTY")]<br/> pub pow: Option<u8>,<br/> /// Config path [default: `$XDG_CONFIG_HOME` or `$HOME/.config`]<br/> #[arg(long, value_name = "PATH", default_value = DEFAULT_FALLBACK_PATH,<br/> hide_default_value = true, value_parser = parsers::parse_config_path<br/> )]<br/> pub config: CliConfig,<br/> /// The state of options. Some values that are used by them but should not<br/> /// be entered via the CLI<br/> #[arg(skip)]<br/> pub state: OptionsState,<br/>}<br/><br/>/// N34 commands<br/>#[derive(Parser, Debug)]<br/>pub enum Commands {<br/> /// Manage repositories and relays sets<br/> Sets {<br/> #[command(subcommand)]<br/> subcommands: SetsSubcommands,<br/> },<br/> /// Manage repositories<br/> Repo {<br/> #[command(subcommand)]<br/> subcommands: RepoSubcommands,<br/> },<br/> /// Manage issues<br/> Issue {<br/> #[command(subcommand)]<br/> subcommands: IssueSubcommands,<br/> },<br/> /// Manage patches<br/> Patch {<br/> #[command(subcommand)]<br/> subcommands: PatchSubcommands,<br/> },<br/> /// Manage configuration<br/> Config {<br/> #[command(subcommand)]<br/> subcommands: ConfigSubcommands,<br/> },<br/> /// Reply to issues and patches.<br/> Reply(ReplyArgs),<br/>}<br/><br/><br/>impl CliOptions {<br/> /// Returns the signer<br/> pub async fn signer(&self) -> N34Result<Option<Arc<dyn NostrSigner + 'static>>> {<br/> if self.nip07 {<br/> self.state.browser_signer_proxy.start().await?;<br/><br/> println!(<br/> "Browser signer proxy started at: {}",<br/> self.state.browser_signer_proxy.url()<br/> );<br/><br/> // FIXME: Use `BrowserSignerProxy::is_session_active` after it release<br/> // nostr@0.44.0<br/> tokio::time::sleep(Duration::from_secs(10)).await;<br/><br/> return Ok(Some(<br/> self.state.browser_signer_proxy.clone().into_nostr_signer(),<br/> ));<br/> }<br/><br/> if let Some(sk) = &self.secret_key {<br/> return Ok(Some(Keys::new(sk.clone()).into_nostr_signer()));<br/> }<br/><br/> if let Some(ref bunker_url) = self.bunker_url {<br/> let mut nostrconnect = NostrConnect::new(<br/> bunker_url.clone(),<br/> Cli::n34_keypair()?,<br/> BUNKER_TIMEOUT,<br/> None,<br/> )<br/> .expect("It's a bunker url and not a client");<br/><br/> nostrconnect.auth_url_handler(EchoAuthUrl);<br/> return Ok(Some(nostrconnect.into_nostr_signer()));<br/> }<br/> Ok(None)<br/> }<br/><br/> /// Returns an error if there are no relays.<br/> pub fn ensure_relays(&self) -> N34Result<()> {<br/> if self.relays.is_empty() {<br/> return Err(N34Error::EmptyRelays);<br/> }<br/> Ok(())<br/> }<br/><br/> /// Returns an error if there are no signers<br/> pub fn ensure_signer(&self) -> N34Result<()> {<br/> if !self.config.keyring_secret_key && self.secret_key.is_none() && self.bunker_url.is_none()<br/> {<br/> return Err(N34Error::SignerRequired);<br/> }<br/> Ok(())<br/> }<br/>}<br/><br/>impl fmt::Debug for CliOptions {<br/> fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {<br/> f.debug_struct("CliOptions")<br/> .field("secret_key", &self.secret_key.as_ref().map(|_| "*******"))<br/> .field("bunker_url", &self.bunker_url.as_ref().map(|_| "*******"))<br/> .field("relays", &self.relays)<br/> .field("pow", &self.pow)<br/> .field("config", &self.config)<br/> .finish()<br/> }<br/>}<br/><br/>impl CommandRunner for Commands {<br/> async fn run(self, options: CliOptions) -> N34Result<()> {<br/> tracing::trace!("Options: {options:#?}");<br/> tracing::trace!("Handling: {self:#?}");<br/><br/> crate::run_command!(self, options, Repo Issue Sets Patch Config & Reply)<br/> }<br/>}<br/>
2026-10-09T01:54:13Zhttps://njump.me/nevent1qqs02fw793n0ys90cxjrysq7x2kzvvktf79hk5mq6elgs30e45rqnuszyp2xhcyfwmc3jdu98up2074n3zznz6ye259qzdm0pp7qwhqtg2z6jy3qv2v// n34 - A CLI to interact with NIP-34 and other stuff related to ...
// n34 - A CLI to interact with NIP-34 and other stuff related to codes in nostr<br/>// Copyright (C) 2025 Awiteb <a@4rs.nl><br/>//<br/>// This program is free software: you can redistribute it and/or modify<br/>// it under the terms of the GNU General Public License as published by<br/>// the Free Software Foundation, either version 3 of the License, or<br/>// (at your option) any later version.<br/>//<br/>// This program is distributed in the hope that it will be useful,<br/>// but WITHOUT ANY WARRANTY; without even the implied warranty of<br/>// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the<br/>// GNU General Public License for more details.<br/>//<br/>// You should have received a copy of the GNU General Public License<br/>// along with this program. If not, see <<a href="https://gnu.org/licenses/gpl-3.0.html>">https://gnu.org/licenses/gpl-3.0.html></a>;.<br/><br/>use clap::Args;<br/>use nostr::{event::Kind, filter::Filter};<br/><br/>use crate::{<br/> cli::{<br/> CliOptions,<br/> traits::{CommandRunner, OptionNaddrOrSetVecExt, RelayOrSetVecExt},<br/> types::{NaddrOrSet, NostrEvent},<br/> },<br/> error::{N34Error, N34Result},<br/> nostr_utils::{<br/> NostrClient,<br/> traits::{GitIssueUtils, NaddrsUtils, ReposUtils},<br/> utils,<br/> },<br/>};<br/><br/>#[derive(Debug, Args)]<br/>pub struct ViewArgs {<br/> /// Repository address in `naddr` format (`naddr1...`), NIP-05 format<br/> /// (`4rs.nl/n34` or `_@4rs.nl/n34`), or a set name like `kernel`.<br/> ///<br/> /// If omitted, looks for a `nostr-address` file.<br/> #[arg(value_name = "NADDR-NIP05-OR-SET", long = "repo")]<br/> naddrs: Option<Vec<NaddrOrSet>>,<br/> /// The issue id to view it<br/> issue_id: NostrEvent,<br/>}<br/><br/>impl CommandRunner for ViewArgs {<br/> const NEED_SIGNER: bool = false;<br/><br/> async fn run(self, options: CliOptions) -> N34Result<()> {<br/> let naddrs = utils::naddrs_or_file(<br/> self.naddrs.flat_naddrs(&options.config.sets)?,<br/> &utils::nostr_address_path()?,<br/> )?;<br/> let relays = options.relays.clone().flat_relays(&options.config.sets)?;<br/> let client = NostrClient::init(&options, &relays).await;<br/><br/> client.add_relays(&naddrs.extract_relays()).await;<br/> client.add_relays(&self.issue_id.relays).await;<br/> client<br/> .add_relays(<br/> &client<br/> .fetch_repos(&naddrs.into_coordinates())<br/> .await?<br/> .extract_relays(),<br/> )<br/> .await;<br/><br/> let issue = client<br/> .fetch_event(<br/> Filter::new()<br/> .id(self.issue_id.event_id)<br/> .kind(Kind::GitIssue),<br/> )<br/> .await?<br/> .ok_or(N34Error::CanNotFoundIssue)?;<br/><br/> let issue_subject = utils::smart_wrap(issue.extract_issue_subject(), 70);<br/> let issue_author = client.get_username(issue.pubkey).await;<br/> let mut issue_labels = utils::smart_wrap(&issue.extract_issue_labels(), 70);<br/><br/> if issue_labels.is_empty() {<br/> issue_labels = "\n".to_owned();<br/> } else {<br/> issue_labels = format!("{issue_labels}\n\n")<br/> }<br/><br/> println!(<br/> "{issue_subject} - [by {issue_author}]\n{issue_labels}{}",<br/> utils::smart_wrap(&issue.content, 80)<br/> );<br/> Ok(())<br/> }<br/>}<br/>
2026-10-09T01:54:06Zhttps://njump.me/nevent1qqsd0wt05ls5nja243q2ykn7uvhzm9cqy3h8m8nknxaaa2lhqllx89gzyp2xhcyfwmc3jdu98up2074n3zznz6ye259qzdm0pp7qwhqtg2z6jkj8rgx// n34 - A CLI to interact with NIP-34 and other stuff related to ...
// n34 - A CLI to interact with NIP-34 and other stuff related to codes in nostr<br/>// Copyright (C) 2025 Awiteb <a@4rs.nl><br/>//<br/>// This program is free software: you can redistribute it and/or modify<br/>// it under the terms of the GNU General Public License as published by<br/>// the Free Software Foundation, either version 3 of the License, or<br/>// (at your option) any later version.<br/>//<br/>// This program is distributed in the hope that it will be useful,<br/>// but WITHOUT ANY WARRANTY; without even the implied warranty of<br/>// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the<br/>// GNU General Public License for more details.<br/>//<br/>// You should have received a copy of the GNU General Public License<br/>// along with this program. If not, see <<a href="https://gnu.org/licenses/gpl-3.0.html>">https://gnu.org/licenses/gpl-3.0.html></a>;.<br/><br/>use std::net::SocketAddr;<br/><br/>use clap::{ArgGroup, Args};<br/><br/>use crate::{<br/> cli::{CliOptions, options_state::DEFAULT_NIP07_PROXY_ADDR, traits::CommandRunner},<br/> error::N34Result,<br/>};<br/><br/>#[derive(Args, Debug)]<br/>#[clap(<br/> group(<br/> ArgGroup::new("options")<br/> .required(true)<br/> )<br/>)]<br/>pub struct Nip07Args {<br/> /// Enable NIP-07 as the default signer.<br/> #[arg(long, group = "options")]<br/> enable: bool,<br/> /// Disable NIP-07 as the default signer.<br/> #[arg(long, group = "options", group = "disable_options")]<br/> disable: bool,<br/> /// Set the default `ip:port` for the browser signer proxy.<br/> #[arg(long, group = "disable_options")]<br/> addr: Option<SocketAddr>,<br/>}<br/><br/>impl CommandRunner for Nip07Args {<br/> const NEED_SIGNER: bool = false;<br/><br/> async fn run(self, mut options: CliOptions) -> N34Result<()> {<br/> if self.enable {<br/> let addr = self.addr.unwrap_or(DEFAULT_NIP07_PROXY_ADDR);<br/> options.config.nip07 = Some(addr)<br/> } else {<br/> options.config.nip07 = None<br/> }<br/><br/> options.config.dump()<br/> }<br/>}<br/>
2026-10-09T01:54:06Zhttps://njump.me/nevent1qqsdq3ya3lt8v8knfefy83j8mryv6vgxzc3c4hyuwses32z9924cjxczyp2xhcyfwmc3jdu98up2074n3zznz6ye259qzdm0pp7qwhqtg2z6jgysu6g// n34 - A CLI to interact with NIP-34 and other stuff related to ...
// n34 - A CLI to interact with NIP-34 and other stuff related to codes in nostr<br/>// Copyright (C) 2025 Awiteb <a@4rs.nl><br/>//<br/>// This program is free software: you can redistribute it and/or modify<br/>// it under the terms of the GNU General Public License as published by<br/>// the Free Software Foundation, either version 3 of the License, or<br/>// (at your option) any later version.<br/>//<br/>// This program is distributed in the hope that it will be useful,<br/>// but WITHOUT ANY WARRANTY; without even the implied warranty of<br/>// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the<br/>// GNU General Public License for more details.<br/>//<br/>// You should have received a copy of the GNU General Public License<br/>// along with this program. If not, see <<a href="https://gnu.org/licenses/gpl-3.0.html>">https://gnu.org/licenses/gpl-3.0.html></a>;.<br/><br/>use clap::Args;<br/><br/>use crate::{<br/> cli::{CliOptions, traits::CommandRunner},<br/> error::N34Result,<br/>};<br/><br/>#[derive(Args, Debug)]<br/>pub struct PowArgs {<br/> /// The new default PoW difficulty<br/> difficulty: u8,<br/>}<br/><br/>impl CommandRunner for PowArgs {<br/> const NEED_SIGNER: bool = false;<br/><br/> async fn run(self, mut options: CliOptions) -> N34Result<()> {<br/> options.config.pow = Some(self.difficulty);<br/> options.config.dump()<br/> }<br/>}<br/>
2026-10-09T01:54:06Zhttps://njump.me/nevent1qqsvcphlqlggq2tgkg5mwla2p530szeyfy7c0ep0wlnuxxp96pwx8cczyp2xhcyfwmc3jdu98up2074n3zznz6ye259qzdm0pp7qwhqtg2z6jnq283n// n34 - A CLI to interact with NIP-34 and other stuff related to ...
// n34 - A CLI to interact with NIP-34 and other stuff related to codes in nostr<br/>// Copyright (C) 2025 Awiteb <a@4rs.nl><br/>//<br/>// This program is free software: you can redistribute it and/or modify<br/>// it under the terms of the GNU General Public License as published by<br/>// the Free Software Foundation, either version 3 of the License, or<br/>// (at your option) any later version.<br/>//<br/>// This program is distributed in the hope that it will be useful,<br/>// but WITHOUT ANY WARRANTY; without even the implied warranty of<br/>// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the<br/>// GNU General Public License for more details.<br/>//<br/>// You should have received a copy of the GNU General Public License<br/>// along with this program. If not, see <<a href="https://gnu.org/licenses/gpl-3.0.html>">https://gnu.org/licenses/gpl-3.0.html></a>;.<br/><br/>/// `config bunker` subcommand<br/>mod bunker;<br/>/// `config keyring` subcommand<br/>mod keyring;<br/>/// `config nip07` subcommand<br/>mod nip07;<br/>/// `config pow` subcommand<br/>mod pow;<br/>/// `config relays` subcommand<br/>mod relays;<br/><br/>use clap::Subcommand;<br/><br/>use self::bunker::BunkerArgs;<br/>use self::keyring::KeyringArgs;<br/>use self::nip07::Nip07Args;<br/>use self::pow::PowArgs;<br/>use self::relays::RelaysArgs;<br/>use super::CliOptions;<br/>use crate::{cli::traits::CommandRunner, error::N34Result};<br/><br/><br/>#[derive(Subcommand, Debug)]<br/>pub enum ConfigSubcommands {<br/> /// Sets the default PoW difficulty (0 if not specified)<br/> Pow(PowArgs),<br/> /// Sets the default fallback relays if none provided. Use this relays for<br/> /// read and write.<br/> Relays(RelaysArgs),<br/> /// Sets a URL of NIP-46 bunker server used for signing events.<br/> Bunker(BunkerArgs),<br/> /// Managing the secret key keyring, including enabling, disabling, or<br/> /// resetting it.<br/> Keyring(KeyringArgs),<br/> /// Controls the NIP-07 browser signer proxy, turning it on or off, and<br/> /// configures the `ip:port` address.<br/> Nip07(Nip07Args),<br/>}<br/><br/>impl CommandRunner for ConfigSubcommands {<br/> async fn run(self, options: CliOptions) -> N34Result<()> {<br/> crate::run_command!(self, options, & Pow Relays Bunker Keyring Nip07)<br/> }<br/>}<br/>
2026-10-09T01:54:06Zhttps://njump.me/nevent1qqsfsgn9kvz27q2mttl68hwp8z025ya5tkffv26x8mzl7h3jqd7c5wgzyp2xhcyfwmc3jdu98up2074n3zznz6ye259qzdm0pp7qwhqtg2z6j0p32md// n34 - A CLI to interact with NIP-34 and other stuff related to ...
// n34 - A CLI to interact with NIP-34 and other stuff related to codes in nostr<br/>// Copyright (C) 2025 Awiteb <a@4rs.nl><br/>//<br/>// This program is free software: you can redistribute it and/or modify<br/>// it under the terms of the GNU General Public License as published by<br/>// the Free Software Foundation, either version 3 of the License, or<br/>// (at your option) any later version.<br/>//<br/>// This program is distributed in the hope that it will be useful,<br/>// but WITHOUT ANY WARRANTY; without even the implied warranty of<br/>// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the<br/>// GNU General Public License for more details.<br/>//<br/>// You should have received a copy of the GNU General Public License<br/>// along with this program. If not, see <<a href="https://gnu.org/licenses/gpl-3.0.html>">https://gnu.org/licenses/gpl-3.0.html></a>;.<br/><br/>use clap::Args;<br/><br/>use super::IssueStatus;<br/>use crate::{<br/> cli::{<br/> CliOptions,<br/> traits::CommandRunner,<br/> types::{NaddrOrSet, NostrEvent},<br/> },<br/> error::{N34Error, N34Result},<br/>};<br/><br/>#[derive(Debug, Args)]<br/>pub struct ResolveArgs {<br/> /// Repository address in `naddr` format (`naddr1...`), NIP-05 format<br/> /// (`4rs.nl/n34` or `_@4rs.nl/n34`), or a set name like `kernel`.<br/> ///<br/> /// If omitted, looks for a `nostr-address` file.<br/> #[arg(value_name = "NADDR-NIP05-OR-SET", long = "repo")]<br/> naddrs: Option<Vec<NaddrOrSet>>,<br/> /// The issue id to resolve it<br/> issue_id: NostrEvent,<br/>}<br/><br/>impl CommandRunner for ResolveArgs {<br/> async fn run(self, options: CliOptions) -> N34Result<()> {<br/> crate::cli::common_commands::issue_status_command(<br/> options,<br/> self.issue_id,<br/> self.naddrs,<br/> IssueStatus::Resolved,<br/> |issue_status| {<br/> if issue_status.is_resolved() {<br/> return Err(N34Error::InvalidStatus(<br/> "You can't resolve an resolved issue".to_owned(),<br/> ));<br/> }<br/> Ok(())<br/> },<br/> )<br/> .await<br/> }<br/>}<br/>
2026-10-09T01:54:06Zhttps://njump.me/nevent1qqsg3mkv6ht6ku4tq2hmnkmaqeuuhnkf5en6yz0lmqxs9a708gfrrrgzyp2xhcyfwmc3jdu98up2074n3zznz6ye259qzdm0pp7qwhqtg2z6jwxhcen// n34 - A CLI to interact with NIP-34 and other stuff related to ...
// n34 - A CLI to interact with NIP-34 and other stuff related to codes in nostr<br/>// Copyright (C) 2025 Awiteb <a@4rs.nl><br/>//<br/>// This program is free software: you can redistribute it and/or modify<br/>// it under the terms of the GNU General Public License as published by<br/>// the Free Software Foundation, either version 3 of the License, or<br/>// (at your option) any later version.<br/>//<br/>// This program is distributed in the hope that it will be useful,<br/>// but WITHOUT ANY WARRANTY; without even the implied warranty of<br/>// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the<br/>// GNU General Public License for more details.<br/>//<br/>// You should have received a copy of the GNU General Public License<br/>// along with this program. If not, see <<a href="https://gnu.org/licenses/gpl-3.0.html>">https://gnu.org/licenses/gpl-3.0.html></a>;.<br/><br/>use std::num::NonZeroUsize;<br/><br/>use clap::Args;<br/><br/>use crate::{<br/> cli::{CliOptions, common_commands, traits::CommandRunner, types::NaddrOrSet},<br/> error::N34Result,<br/>};<br/><br/>#[derive(Debug, Args)]<br/>pub struct ListArgs {<br/> /// Repository address in `naddr` format (`naddr1...`), NIP-05 format<br/> /// (`4rs.nl/n34` or `_@4rs.nl/n34`), or a set name like `kernel`.<br/> ///<br/> /// If omitted, looks for a `nostr-address` file.<br/> #[arg(value_name = "NADDR-NIP05-OR-SET")]<br/> naddrs: Option<Vec<NaddrOrSet>>,<br/> /// Maximum number of issues to list<br/> #[arg(long, default_value = "15")]<br/> limit: NonZeroUsize,<br/>}<br/><br/>impl CommandRunner for ListArgs {<br/> const NEED_SIGNER: bool = false;<br/><br/> async fn run(self, options: CliOptions) -> N34Result<()> {<br/> common_commands::list_patches_and_issues(options, self.naddrs, false, self.limit.into())<br/> .await<br/> }<br/>}<br/>
2026-10-09T01:54:06Zhttps://njump.me/nevent1qqs8ue9l0fjmjsylsxu3dvvvqaf7py8le30yvzu9ugymcrgk6sx32wszyp2xhcyfwmc3jdu98up2074n3zznz6ye259qzdm0pp7qwhqtg2z6je8uzcq// n34 - A CLI to interact with NIP-34 and other stuff related to ...
// n34 - A CLI to interact with NIP-34 and other stuff related to codes in nostr<br/>// Copyright (C) 2025 Awiteb <a@4rs.nl><br/>//<br/>// This program is free software: you can redistribute it and/or modify<br/>// it under the terms of the GNU General Public License as published by<br/>// the Free Software Foundation, either version 3 of the License, or<br/>// (at your option) any later version.<br/>//<br/>// This program is distributed in the hope that it will be useful,<br/>// but WITHOUT ANY WARRANTY; without even the implied warranty of<br/>// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the<br/>// GNU General Public License for more details.<br/>//<br/>// You should have received a copy of the GNU General Public License<br/>// along with this program. If not, see <<a href="https://gnu.org/licenses/gpl-3.0.html>">https://gnu.org/licenses/gpl-3.0.html></a>;.<br/><br/>use clap::Args;<br/>use nostr::types::RelayUrl;<br/><br/>use crate::{<br/> cli::{CliOptions, traits::CommandRunner},<br/> error::N34Result,<br/>};<br/><br/>#[derive(Args, Debug)]<br/>pub struct RelaysArgs {<br/> /// List of relay URLs to append to fallback relays. If empty, removes all<br/> /// fallback relays.<br/> relays: Vec<RelayUrl>,<br/> /// Replace existing fallback relays instead of appending new ones.<br/> #[arg(long = "override")]<br/> override_relays: bool,<br/>}<br/><br/>impl CommandRunner for RelaysArgs {<br/> const NEED_SIGNER: bool = false;<br/><br/> async fn run(self, mut options: CliOptions) -> N34Result<()> {<br/> if self.relays.is_empty() {<br/> options.config.fallback_relays = None;<br/> } else if self.override_relays {<br/> options.config.fallback_relays = Some(self.relays);<br/> } else {<br/> let mut relays = options.config.fallback_relays.clone().unwrap_or_default();<br/> relays.extend(self.relays);<br/> relays.sort_unstable();<br/> relays.dedup();<br/> options.config.fallback_relays = Some(relays);<br/> }<br/><br/> options.config.dump()<br/> }<br/>}<br/>
2026-10-09T01:54:06Zhttps://njump.me/nevent1qqs82h8tqfy5eje2xg8hh354she7xwu87lvu4cf22ayerwf9a4ec69qzyp2xhcyfwmc3jdu98up2074n3zznz6ye259qzdm0pp7qwhqtg2z6jpw9hfw// n34 - A CLI to interact with NIP-34 and other stuff related to ...
// n34 - A CLI to interact with NIP-34 and other stuff related to codes in nostr<br/>// Copyright (C) 2025 Awiteb <a@4rs.nl><br/>//<br/>// This program is free software: you can redistribute it and/or modify<br/>// it under the terms of the GNU General Public License as published by<br/>// the Free Software Foundation, either version 3 of the License, or<br/>// (at your option) any later version.<br/>//<br/>// This program is distributed in the hope that it will be useful,<br/>// but WITHOUT ANY WARRANTY; without even the implied warranty of<br/>// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the<br/>// GNU General Public License for more details.<br/>//<br/>// You should have received a copy of the GNU General Public License<br/>// along with this program. If not, see <<a href="https://gnu.org/licenses/gpl-3.0.html>">https://gnu.org/licenses/gpl-3.0.html></a>;.<br/><br/><br/>use clap::{ArgGroup, Args};<br/>use nostr::event::{EventBuilder, Tag};<br/><br/>use crate::{<br/> cli::{<br/> CliOptions,<br/> CommandRunner,<br/> traits::{OptionNaddrOrSetVecExt, RelayOrSetVecExt},<br/> types::NaddrOrSet,<br/> },<br/> error::N34Result,<br/> nostr_utils::{<br/> NostrClient,<br/> traits::{NaddrsUtils, NewGitRepositoryAnnouncement, ReposUtils},<br/> utils,<br/> },<br/>};<br/><br/><br/>/// Arguments for the `issue new` command<br/>#[derive(Args, Debug)]<br/>#[clap(<br/> group(<br/> ArgGroup::new("issue-content")<br/> .args(["content", "editor"])<br/> .required(true)<br/> ),<br/> group(<br/> ArgGroup::new("issue-subject")<br/> .args(["editor", "subject"])<br/> )<br/>)]<br/>pub struct NewArgs {<br/> /// Repository address in `naddr` format (`naddr1...`), NIP-05 format<br/> /// (`4rs.nl/n34` or `_@4rs.nl/n34`), or a set name like `kernel`.<br/> ///<br/> /// If omitted, looks for a `nostr-address` file.<br/> #[arg(value_name = "NADDR-NIP05-OR-SET", long = "repo")]<br/> naddrs: Option<Vec<NaddrOrSet>>,<br/> /// Markdown content for the issue. Cannot be used together with the<br/> /// `--editor` flag.<br/> #[arg(short, long)]<br/> content: Option<String>,<br/> /// Opens the user's default editor to write issue content. The first line<br/> /// will be used as the issue subject.<br/> #[arg(short, long)]<br/> editor: bool,<br/> /// The issue subject. Cannot be used together with the `--editor` flag.<br/> #[arg(long)]<br/> subject: Option<String>,<br/> /// Labels for the issue. Can be specified as arguments (-l bug) or hashtags<br/> /// in content (#bug).<br/> #[arg(short, long)]<br/> label: Vec<String>,<br/>}<br/><br/>impl NewArgs {<br/> /// Returns the subject and the content of the issue. (subject, content)<br/> pub fn issue_content(&self) -> N34Result<(Option<String>, String)> {<br/> if let Some(content) = self.content.as_ref() {<br/> if let Some(subject) = self.subject.as_ref() {<br/> return Ok((Some(subject.trim().to_owned()), content.trim().to_owned()));<br/> }<br/> return Ok((None, content.trim().to_owned()));<br/> }<br/> // If the `self.content` is `None` then the `self.editor` is `true`<br/> let file_content = utils::read_editor(None, ".md")?;<br/> if file_content.contains('\n') {<br/> Ok(file_content<br/> .split_once('\n')<br/> .map(|(s, c)| (Some(s.trim().to_owned()), c.trim().to_owned()))<br/> .expect("There is a new line"))<br/> } else {<br/> tracing::info!("File content contains only issue body without a subject line");<br/> Ok((None, file_content))<br/> }<br/> }<br/>}<br/><br/>impl CommandRunner for NewArgs {<br/> async fn run(self, options: CliOptions) -> N34Result<()> {<br/> let naddrs = utils::check_empty_naddrs(utils::naddrs_or_file(<br/> self.naddrs.flat_naddrs(&options.config.sets)?,<br/> &utils::nostr_address_path()?,<br/> )?)?;<br/> let relays = options.relays.clone().flat_relays(&options.config.sets)?;<br/> let client = NostrClient::init(&options, &relays).await;<br/> let user_pubk = client.pubkey().await?;<br/> let coordinates = naddrs.clone().into_coordinates();<br/> client.add_relays(&naddrs.extract_relays()).await;<br/> let repos = client.fetch_repos(coordinates.as_slice()).await?;<br/> let maintainers = repos.extract_maintainers();<br/> client.add_relays(&repos.extract_relays()).await;<br/> let relays_list = client.user_relays_list(user_pubk).await?;<br/> client<br/> .add_relays(&utils::add_read_relays(relays_list.as_ref()))<br/> .await;<br/><br/> let (subject, content) = self.issue_content()?;<br/> let content_details = client.parse_content(&content).await;<br/><br/> let event =<br/> EventBuilder::new_git_issue(coordinates.as_slice(), content, subject, self.label)?<br/> .dedup_tags()<br/> .pow(options.pow.unwrap_or_default())<br/> .tags(maintainers.iter().map(|p| Tag::public_key(*p)))<br/> .tags(content_details.clone().into_tags())<br/> .build(user_pubk);<br/> let event_id = event.id.expect("There is an id");<br/><br/> let write_relays = [<br/> relays,<br/> naddrs.extract_relays(),<br/> utils::add_write_relays(relays_list.as_ref()),<br/> client<br/> .fetch_repos(&naddrs.into_coordinates())<br/> .await?<br/> .extract_relays(),<br/> // Include read relays for each maintainer (if found)<br/> client.read_relays_from_users(&maintainers).await,<br/> content_details.write_relays.clone().into_iter().collect(),<br/> ]<br/> .concat();<br/><br/> tracing::trace!(relays = ?write_relays, "Write relays list");<br/> let success = client<br/> .send_event_to(event, relays_list.as_ref(), &write_relays)<br/> .await?;<br/><br/> let nevent = utils::new_nevent(event_id, &success)?;<br/> println!("Issue created: {nevent}");<br/><br/> Ok(())<br/> }<br/>}<br/>
2026-10-09T01:54:06Zhttps://njump.me/nevent1qqs95s4xrynyug2hc9y7uz2mrs3zxwlqh5wnhs6lzdgecct0rczrnggzyp2xhcyfwmc3jdu98up2074n3zznz6ye259qzdm0pp7qwhqtg2z6jaxs0m6// n34 - A CLI to interact with NIP-34 and other stuff related to ...
// n34 - A CLI to interact with NIP-34 and other stuff related to codes in nostr<br/>// Copyright (C) 2025 Awiteb <a@4rs.nl><br/>//<br/>// This program is free software: you can redistribute it and/or modify<br/>// it under the terms of the GNU General Public License as published by<br/>// the Free Software Foundation, either version 3 of the License, or<br/>// (at your option) any later version.<br/>//<br/>// This program is distributed in the hope that it will be useful,<br/>// but WITHOUT ANY WARRANTY; without even the implied warranty of<br/>// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the<br/>// GNU General Public License for more details.<br/>//<br/>// You should have received a copy of the GNU General Public License<br/>// along with this program. If not, see <<a href="https://gnu.org/licenses/gpl-3.0.html>">https://gnu.org/licenses/gpl-3.0.html></a>;.<br/><br/>use clap::Args;<br/><br/>use super::IssueStatus;<br/>use crate::{<br/> cli::{<br/> CliOptions,<br/> traits::CommandRunner,<br/> types::{NaddrOrSet, NostrEvent},<br/> },<br/> error::{N34Error, N34Result},<br/>};<br/><br/>#[derive(Debug, Args)]<br/>pub struct ReopenArgs {<br/> /// Repository address in `naddr` format (`naddr1...`), NIP-05 format<br/> /// (`4rs.nl/n34` or `_@4rs.nl/n34`), or a set name like `kernel`.<br/> ///<br/> /// If omitted, looks for a `nostr-address` file.<br/> #[arg(value_name = "NADDR-NIP05-OR-SET", long = "repo")]<br/> naddrs: Option<Vec<NaddrOrSet>>,<br/> /// The closed issue id to reopen it<br/> issue_id: NostrEvent,<br/>}<br/><br/>impl CommandRunner for ReopenArgs {<br/> async fn run(self, options: CliOptions) -> N34Result<()> {<br/> crate::cli::common_commands::issue_status_command(<br/> options,<br/> self.issue_id,<br/> self.naddrs,<br/> IssueStatus::Open,<br/> |issue_status| {<br/> if issue_status.is_open() {<br/> return Err(N34Error::InvalidStatus(<br/> "You can't reopen an open issue".to_owned(),<br/> ));<br/> }<br/><br/> if issue_status.is_resolved() {<br/> return Err(N34Error::InvalidStatus(<br/> "You can't open a resolved issue".to_owned(),<br/> ));<br/> }<br/> Ok(())<br/> },<br/> )<br/> .await<br/> }<br/>}<br/>
2026-10-09T01:54:06Zhttps://njump.me/nevent1qqsrz52r7sa95d9h3yklgwunhcgr70zee3dntvwfffgxtyqyzrgt45qzyp2xhcyfwmc3jdu98up2074n3zznz6ye259qzdm0pp7qwhqtg2z6jghapj8// n34 - A CLI to interact with NIP-34 and other stuff related to ...
// n34 - A CLI to interact with NIP-34 and other stuff related to codes in nostr<br/>// Copyright (C) 2025 Awiteb <a@4rs.nl><br/>//<br/>// This program is free software: you can redistribute it and/or modify<br/>// it under the terms of the GNU General Public License as published by<br/>// the Free Software Foundation, either version 3 of the License, or<br/>// (at your option) any later version.<br/>//<br/>// This program is distributed in the hope that it will be useful,<br/>// but WITHOUT ANY WARRANTY; without even the implied warranty of<br/>// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the<br/>// GNU General Public License for more details.<br/>//<br/>// You should have received a copy of the GNU General Public License<br/>// along with this program. If not, see <<a href="https://gnu.org/licenses/gpl-3.0.html>">https://gnu.org/licenses/gpl-3.0.html></a>;.<br/><br/>use clap::Args;<br/>use nostr::nips::nip46::NostrConnectURI;<br/><br/>use crate::{<br/> cli::{CliOptions, traits::CommandRunner},<br/> error::{N34Error, N34Result},<br/>};<br/><br/><br/>#[derive(Args, Debug)]<br/>pub struct BunkerArgs {<br/> /// Nostr Connect URL for the bunker. Omit this to remove the current bunker<br/> /// URL.<br/> bunker_url: Option<NostrConnectURI>,<br/>}<br/><br/><br/>impl CommandRunner for BunkerArgs {<br/> const NEED_SIGNER: bool = false;<br/><br/> async fn run(self, mut options: CliOptions) -> N34Result<()> {<br/> if let Some(ref bunker_url) = self.bunker_url<br/> && !bunker_url.is_bunker()<br/> {<br/> return Err(N34Error::NotBunkerUrl);<br/> }<br/> options.config.bunker_url = self.bunker_url;<br/> options.config.dump()<br/> }<br/>}<br/>
2026-10-09T01:54:06Zhttps://njump.me/nevent1qqsp7v77fnprvnr95mu6340mprkwclumk6vjkl3hrrk5c4k5z8tdxeszyp2xhcyfwmc3jdu98up2074n3zznz6ye259qzdm0pp7qwhqtg2z6jrpt49z// n34 - A CLI to interact with NIP-34 and other stuff related to ...
// n34 - A CLI to interact with NIP-34 and other stuff related to codes in nostr<br/>// Copyright (C) 2025 Awiteb <a@4rs.nl><br/>//<br/>// This program is free software: you can redistribute it and/or modify<br/>// it under the terms of the GNU General Public License as published by<br/>// the Free Software Foundation, either version 3 of the License, or<br/>// (at your option) any later version.<br/>//<br/>// This program is distributed in the hope that it will be useful,<br/>// but WITHOUT ANY WARRANTY; without even the implied warranty of<br/>// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the<br/>// GNU General Public License for more details.<br/>//<br/>// You should have received a copy of the GNU General Public License<br/>// along with this program. If not, see <<a href="https://gnu.org/licenses/gpl-3.0.html>">https://gnu.org/licenses/gpl-3.0.html></a>;.<br/><br/>/// `issue close` subcommand<br/>mod close;<br/>/// `issue list` subcommand<br/>mod list;<br/>/// `issue new` subcommand<br/>mod new;<br/>/// `issue reopen` subcommand<br/>mod reopen;<br/>/// `issue resolve` subcommand<br/>mod resolve;<br/>/// `issue view` subcommand<br/>mod view;<br/><br/>use std::fmt;<br/><br/>use clap::Subcommand;<br/>use nostr::event::Kind;<br/><br/>use self::close::CloseArgs;<br/>use self::list::ListArgs;<br/>use self::new::NewArgs;<br/>use self::reopen::ReopenArgs;<br/>use self::resolve::ResolveArgs;<br/>use self::view::ViewArgs;<br/>use super::{CliOptions, CommandRunner};<br/>use crate::error::{N34Error, N34Result};<br/><br/>/// Prefix used for git issue alt.<br/>pub const ISSUE_ALT_PREFIX: &str = "git issue: ";<br/><br/>#[derive(Subcommand, Debug)]<br/>pub enum IssueSubcommands {<br/> /// Create a new repository issue<br/> New(NewArgs),<br/> /// View an issue by its ID<br/> View(ViewArgs),<br/> /// Reopens a closed issue.<br/> Reopen(ReopenArgs),<br/> /// Closes an open issue.<br/> Close(CloseArgs),<br/> /// Resolves an issue.<br/> Resolve(ResolveArgs),<br/> /// List the repositories issues.<br/> List(ListArgs),<br/>}<br/><br/>/// Possible states for a Git issue<br/>#[derive(Debug)]<br/>pub enum IssueStatus {<br/> /// The issue is currently open<br/> Open,<br/> /// The issue has been resolved<br/> Resolved,<br/> /// The issue has been closed<br/> Closed,<br/>}<br/><br/>impl IssueStatus {<br/> /// Maps the issue status to its corresponding Nostr kind.<br/> #[inline]<br/> pub fn kind(&self) -> Kind {<br/> match self {<br/> Self::Open => Kind::GitStatusOpen,<br/> Self::Resolved => Kind::GitStatusApplied,<br/> Self::Closed => Kind::GitStatusClosed,<br/> }<br/> }<br/><br/> /// Returns the string representation of the issue status.<br/> pub const fn as_str(&self) -> &'static str {<br/> match self {<br/> Self::Open => "Open",<br/> Self::Resolved => "Resolved",<br/> Self::Closed => "Closed",<br/> }<br/> }<br/><br/> /// Check if the issue is open.<br/> #[inline]<br/> pub fn is_open(&self) -> bool {<br/> matches!(self, Self::Open)<br/> }<br/><br/> /// Check if the issue is resolved.<br/> #[inline]<br/> pub fn is_resolved(&self) -> bool {<br/> matches!(self, Self::Resolved)<br/> }<br/><br/> /// Check if the issue is closed.<br/> #[inline]<br/> pub fn is_closed(&self) -> bool {<br/> matches!(self, Self::Closed)<br/> }<br/>}<br/><br/>impl From<&IssueStatus> for Kind {<br/> fn from(status: &IssueStatus) -> Self {<br/> status.kind()<br/> }<br/>}<br/><br/>impl fmt::Display for IssueStatus {<br/> fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {<br/> write!(f, "{}", self.as_str())<br/> }<br/>}<br/><br/>impl TryFrom<Kind> for IssueStatus {<br/> type Error = N34Error;<br/><br/> fn try_from(kind: Kind) -> Result<Self, Self::Error> {<br/> match kind {<br/> Kind::GitStatusOpen => Ok(Self::Open),<br/> Kind::GitStatusApplied => Ok(Self::Resolved),<br/> Kind::GitStatusClosed => Ok(Self::Closed),<br/> _ => Err(N34Error::InvalidIssueStatus(kind)),<br/> }<br/> }<br/>}<br/><br/>impl CommandRunner for IssueSubcommands {<br/> async fn run(self, options: CliOptions) -> N34Result<()> {<br/> crate::run_command!(self, options, & New View Reopen Close Resolve List)<br/> }<br/>}<br/>
2026-10-09T01:54:06Zhttps://njump.me/nevent1qqspzps3g03hs6e6kpw0jqswspqa83vntyk4v4k48yv9mnmjzlrvj0gzyp2xhcyfwmc3jdu98up2074n3zznz6ye259qzdm0pp7qwhqtg2z6j4enc7w// n34 - A CLI to interact with NIP-34 and other stuff related to ...
// n34 - A CLI to interact with NIP-34 and other stuff related to codes in nostr<br/>// Copyright (C) 2025 Awiteb <a@4rs.nl><br/>//<br/>// This program is free software: you can redistribute it and/or modify<br/>// it under the terms of the GNU General Public License as published by<br/>// the Free Software Foundation, either version 3 of the License, or<br/>// (at your option) any later version.<br/>//<br/>// This program is distributed in the hope that it will be useful,<br/>// but WITHOUT ANY WARRANTY; without even the implied warranty of<br/>// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the<br/>// GNU General Public License for more details.<br/>//<br/>// You should have received a copy of the GNU General Public License<br/>// along with this program. If not, see <<a href="https://gnu.org/licenses/gpl-3.0.html>">https://gnu.org/licenses/gpl-3.0.html></a>;.<br/><br/>use clap::{ArgGroup, Args};<br/><br/>use crate::{<br/> cli::{Cli, CliOptions, traits::CommandRunner},<br/> error::N34Result,<br/>};<br/><br/>#[derive(Args, Debug)]<br/>#[clap(<br/> group(<br/> ArgGroup::new("options")<br/> .required(true)<br/> )<br/>)]<br/>pub struct KeyringArgs {<br/> /// Turns on secret key keyring. Requires entering the key once when<br/> /// enabled.<br/> #[arg(long, group = "options")]<br/> enable: bool,<br/> /// Turns off secret key keyring. Removes any existing key and prevents<br/> /// storing new ones.<br/> #[arg(long, group = "options")]<br/> disable: bool,<br/> /// Deletes current key and stores the next provided key.<br/> #[arg(long, group = "options")]<br/> reset: bool,<br/>}<br/><br/>impl CommandRunner for KeyringArgs {<br/> const NEED_SIGNER: bool = false;<br/><br/> async fn run(self, mut options: CliOptions) -> N34Result<()> {<br/> let keyring = nostr_keyring::NostrKeyring::new(Cli::N34_KEYRING_SERVICE_NAME);<br/><br/> if self.enable {<br/> options.config.keyring_secret_key = true;<br/> } else if self.disable {<br/> options.config.keyring_secret_key = false;<br/> }<br/><br/> if self.reset || self.disable {<br/> let _ = keyring.delete(Cli::USER_KEY_PAIR_ENTRY);<br/> }<br/><br/> options.config.dump()<br/> }<br/>}<br/>
2026-10-09T01:54:06Zhttps://njump.me/nevent1qqsq985xhgq9c6p8yuwvpeqhcjazphgrtw9vtlm6ffyt0608wzy36rqzyp2xhcyfwmc3jdu98up2074n3zznz6ye259qzdm0pp7qwhqtg2z6jhp83xp// n34 - A CLI to interact with NIP-34 and other stuff related to ...
// n34 - A CLI to interact with NIP-34 and other stuff related to codes in nostr<br/>// Copyright (C) 2025 Awiteb <a@4rs.nl><br/>//<br/>// This program is free software: you can redistribute it and/or modify<br/>// it under the terms of the GNU General Public License as published by<br/>// the Free Software Foundation, either version 3 of the License, or<br/>// (at your option) any later version.<br/>//<br/>// This program is distributed in the hope that it will be useful,<br/>// but WITHOUT ANY WARRANTY; without even the implied warranty of<br/>// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the<br/>// GNU General Public License for more details.<br/>//<br/>// You should have received a copy of the GNU General Public License<br/>// along with this program. If not, see <<a href="https://gnu.org/licenses/gpl-3.0.html>">https://gnu.org/licenses/gpl-3.0.html></a>;.<br/><br/>use clap::Args;<br/><br/>use super::IssueStatus;<br/>use crate::{<br/> cli::{<br/> CliOptions,<br/> traits::CommandRunner,<br/> types::{NaddrOrSet, NostrEvent},<br/> },<br/> error::{N34Error, N34Result},<br/>};<br/><br/>#[derive(Debug, Args)]<br/>pub struct CloseArgs {<br/> /// Repository address in `naddr` format (`naddr1...`), NIP-05 format<br/> /// (`4rs.nl/n34` or `_@4rs.nl/n34`), or a set name like `kernel`.<br/> ///<br/> /// If omitted, looks for a `nostr-address` file.<br/> #[arg(value_name = "NADDR-NIP05-OR-SET", long = "repo")]<br/> naddrs: Option<Vec<NaddrOrSet>>,<br/> /// The open issue id to close it<br/> issue_id: NostrEvent,<br/>}<br/><br/>impl CommandRunner for CloseArgs {<br/> async fn run(self, options: CliOptions) -> N34Result<()> {<br/> crate::cli::common_commands::issue_status_command(<br/> options,<br/> self.issue_id,<br/> self.naddrs,<br/> IssueStatus::Closed,<br/> |issue_status| {<br/> if issue_status.is_closed() {<br/> return Err(N34Error::InvalidStatus(<br/> "You can't close an already closed issue".to_owned(),<br/> ));<br/> }<br/><br/> if issue_status.is_resolved() {<br/> return Err(N34Error::InvalidStatus(<br/> "You can't close a resolved issue".to_owned(),<br/> ));<br/> }<br/> Ok(())<br/> },<br/> )<br/> .await<br/> }<br/>}<br/>
2026-10-09T01:54:06Zhttps://njump.me/nevent1qqs2krgu0aszenjmdgn24wm7nruwk5wqlujqf0sy645c0rxy88sn3eczyp2xhcyfwmc3jdu98up2074n3zznz6ye259qzdm0pp7qwhqtg2z6jyh4ke9#!/usr/bin/env sh cargo run --bin n34 -- repo view ...
#!/usr/bin/env sh<br/>cargo run --bin n34 -- repo view naddr1qqpkuve5qgsqqqqqq9g9uljgjfcyd6dm4fegk8em2yfz0c3qp3tc6mntkrrhawgrqsqqqaueqyf8wumn8ghj7mn0wd68yt35wfejumnvqyt8wumn8ghj7un9d3shjtnswf5k6ctv9ehx2aqpp4mhxue69uhkummn9ekx7mqppamhxue69uhkummnw3ezumt0d5q3gamnwvaz7tmjv4kxz7fwv3sk6atn9e5k7qg5waehxw309ahx7um5wghx77r5wghxgetkxpx8xj<br/>
2026-10-09T01:54:05Zhttps://njump.me/nevent1qqs2rgkasffk63tfyvp948a8tc2ruzp3xykf38z686tgn66d9l7gd6czyp2xhcyfwmc3jdu98up2074n3zznz6ye259qzdm0pp7qwhqtg2z6jgrtkk0unstable_features = true style_edition = "2024" ...
unstable_features = true<br/>style_edition = "2024"<br/><br/>blank_lines_upper_bound = 2<br/>combine_control_expr = false<br/>wrap_comments = true<br/>condense_wildcard_suffixes = true<br/>edition = "2024"<br/>enum_discrim_align_threshold = 20<br/>force_multiline_blocks = true<br/>format_code_in_doc_comments = true<br/>format_generated_files = false<br/>format_macro_matchers = true<br/>format_strings = true<br/>imports_layout = "HorizontalVertical"<br/>newline_style = "Unix"<br/>normalize_comments = true<br/>reorder_impl_items = true<br/>group_imports = "StdExternalCrate"<br/>single_line_let_else_max_width = 0<br/>struct_field_align_threshold = 20<br/>use_try_shorthand = true<br/>
2026-10-09T01:54:02Zhttps://njump.me/nevent1qqs9kymh3ehcejzqu8m3vutt6tsk0yksxlv0j9qv9ekdklr30m3u8kqzyp2xhcyfwmc3jdu98up2074n3zznz6ye259qzdm0pp7qwhqtg2z6jaax3vh# This file contains NIP-19 `naddr` entities for repositories ...
# This file contains NIP-19 `naddr` entities for repositories that accept this<br/># project's issues and patches.<br/>#<br/># The file acts as a **read-only reference** for retrieving repository relays<br/># when embedded in an `naddr` and mentions those repositories when opening<br/># patches or issues. Modifications here will not affect in the relays, as the<br/># file is **explicitly untracked**. Its goal is to simplify contributions by<br/># removing the need for manual address entry.<br/>#<br/># Each entry must start with "naddr". Embedded relays are **strongly recommended**<br/># to assist client-side discovery.<br/>#<br/># Empty lines are ignored. Lines starting with "#" are treated as comments.<br/><br/>naddr1qqpkuve5qgsqqqqqq9g9uljgjfcyd6dm4fegk8em2yfz0c3qp3tc6mntkrrhawgrqsqqqaueqyf8wumn8ghj7mn0wd68yt35wfejumnvqyt8wumn8ghj7un9d3shjtnswf5k6ctv9ehx2aqpp4mhxue69uhkummn9ekx7mqppamhxue69uhkummnw3ezumt0d5q3gamnwvaz7tmjv4kxz7fwv3sk6atn9e5k7qg5waehxw309ahx7um5wghx77r5wghxgetkxpx8xj<br/>
2026-10-09T01:54:02Zhttps://njump.me/nevent1qqsdj4e0pmk9hcjldpupxc38542pay4t766z4fhhuhr2rg5k52j9xuqzyp2xhcyfwmc3jdu98up2074n3zznz6ye259qzdm0pp7qwhqtg2z6jd6c0es# This justfile is for the contrbutors of this project, not for ...
# This justfile is for the contrbutors of this project, not for the end user.<br/>#<br/># Requirements for this justfile:<br/># - Linux distribution<br/># - just (Of course) <<a href="https://github.com/casey/just>">https://github.com/casey/just></a>;<br/># - cargo (For the build and tests) <<a href="https://doc.rust-lang.org/cargo/getting-started/installation.html>">https://doc.rust-lang.org/cargo/getting-started/installation.html></a>;<br/># - mdbook (<<a href="https://rust-lang.github.io/mdBook>">https://rust-lang.github.io/mdBook></a>;)<br/># - git-cliff (<<a href="https://git-cliff.org>">https://git-cliff.org></a>;)<br/># - taplo (<<a href="https://taplo.tamasfe.dev/>">https://taplo.tamasfe.dev/></a>;)<br/># - cargo-msrv (<<a href="https://github.com/foresterre/cargo-msrv>">https://github.com/foresterre/cargo-msrv></a>;)<br/># - nushell (<<a href="https://nushell.sh>">https://nushell.sh></a>;)<br/><br/>set quiet<br/>set unstable<br/>set shell := ["/usr/bin/env", "bash", "-c"]<br/>set script-interpreter := ["/usr/bin/env", "nu"]<br/><br/>JUST_EXECUTABLE := "just -u -f " + justfile()<br/>header := "Available tasks:\n"<br/>BOOK_DEST_DIR := "dest"<br/>tag_change_body := '''{% for group, commits in commits | group_by(attribute="group") %}<br/><br/>{{ group | upper_first }}<br/><br/>{% for commit in commits %}<br/>- {{ commit.message | split(pat="\n") | first | split(pat=":") | slice(start=1) | join(sep=":") | upper_first | trim }} - by {{ commit.author.name}}{% endfor %}{% endfor %}<br/>'''<br/><br/>export TZ := "UTC"<br/><br/>_default:<br/> @{{JUST_EXECUTABLE}} --list-heading "{{header}}" --list<br/><br/># Run the CI<br/>ci: && msrv _done_ci<br/> echo "🔨 Building n34..."<br/> cargo build -q<br/> echo "🔍 Checking code formatting..."<br/> cargo fmt -q -- --check<br/> RUST_LOG=none taplo fmt --check --config "./.taplo.toml" || (echo "❌Toml files is not properly formatted" && exit 1)<br/> echo "🧹 Running linter checks..."<br/> cargo clippy -q -- -D warnings<br/> echo "🧪 Running tests..."<br/> cargo test -q<br/><br/># Check that the current MSRV is correct<br/>msrv:<br/> echo "🔧 Verifying MSRV..."<br/> cargo-msrv verify<br/> echo "✅ MSRV verification passed"<br/><br/>_done_ci:<br/> echo "🎉 CI pipeline completed successfully"<br/><br/># Update the changelog<br/>[script]<br/>changelog:<br/> def get_hash [] { open "./CHANGELOG.md" | hash sha256 }<br/><br/> let old_hash = get_hash<br/> git-cliff out> "CHANGELOG.md"<br/><br/> if old_hash != get_hash {<br/> git add "CHANGELOG.md"<br/> git commit -m "chore(changelog): Update the changelog"<br/> print "The changes have been added to the changelog file and committed"<br/> } else {<br/> print "No changes have been added to the changelog"<br/> }<br/><br/># Releases a new version of n34. Requires a clean file tree with no uncommitted changes.<br/>[script]<br/>release version:<br/> let tag_msg = "Version {{ version }}" + (git-cliff --strip all --unreleased --body '{{ tag_change_body }}')<br/> mut cargo_file = open "Cargo.toml"<br/><br/> $cargo_file.package.version = "{{ version }}"<br/> $cargo_file | save -f "Cargo.toml"<br/><br/> RUST_LOG=none taplo fmt --config "./.taplo.toml"<br/> {{ JUST_EXECUTABLE }} ci<br/> git-cliff -t "v{{ version }}" out> "./CHANGELOG.md"<br/> git add .<br/> git commit -m "chore: Bump the version to `v{{ version }}`"<br/> git tag -s -m $tag_msg "v{{ version }}"<br/> git push origin master --tags<br/> cargo publish<br/><br/># Deploy the book to Github Pages<br/>deploy:<br/> mdbook build --dest-dir {{ BOOK_DEST_DIR }}<br/> cd {{ BOOK_DEST_DIR }}<br/> git init .<br/> git checkout -B gh-pages<br/> touch ".nojekyll"<br/> echo "n34.dev" > "CNAME"<br/><br/> git add .<br/> git commit -m "Deploy the book to github pages"<br/> git remote add origin "git@github.com:TheAwiteb/n34-book"<br/> git push origin gh-pages -f<br/> cd ..<br/> rm -fr {{ BOOK_DEST_DIR }}<br/><br/>
2026-10-09T01:53:55Zhttps://njump.me/nevent1qqs0ly8k73l8h47jqmhuc2rplm4yklxyc4pwfqjteptlghudt3vjt5czyp2xhcyfwmc3jdu98up2074n3zznz6ye259qzdm0pp7qwhqtg2z6j8e822u{ "nodes": { "flake-utils": { "inputs": { ...
{<br/> "nodes": {<br/> "flake-utils": {<br/> "inputs": {<br/> "systems": "systems"<br/> },<br/> "locked": {<br/> "lastModified": 1731533236,<br/> "narHash": "sha256-l0KFg5HjrsfsO/JpG+r7fRrqm12kzFHyUHqHCVpMMbI=",<br/> "owner": "numtide",<br/> "repo": "flake-utils",<br/> "rev": "11707dc2f618dd54ca8739b309ec4fc024de578b",<br/> "type": "github"<br/> },<br/> "original": {<br/> "owner": "numtide",<br/> "repo": "flake-utils",<br/> "type": "github"<br/> }<br/> },<br/> "nixpkgs": {<br/> "locked": {<br/> "lastModified": 1754498491,<br/> "narHash": "sha256-erbiH2agUTD0Z30xcVSFcDHzkRvkRXOQ3lb887bcVrs=",<br/> "owner": "NixOS",<br/> "repo": "nixpkgs",<br/> "rev": "c2ae88e026f9525daf89587f3cbee584b92b6134",<br/> "type": "github"<br/> },<br/> "original": {<br/> "owner": "NixOS",<br/> "ref": "nixos-unstable",<br/> "repo": "nixpkgs",<br/> "type": "github"<br/> }<br/> },<br/> "nixpkgs_2": {<br/> "locked": {<br/> "lastModified": 1744536153,<br/> "narHash": "sha256-awS2zRgF4uTwrOKwwiJcByDzDOdo3Q1rPZbiHQg/N38=",<br/> "owner": "NixOS",<br/> "repo": "nixpkgs",<br/> "rev": "18dd725c29603f582cf1900e0d25f9f1063dbf11",<br/> "type": "github"<br/> },<br/> "original": {<br/> "owner": "NixOS",<br/> "ref": "nixpkgs-unstable",<br/> "repo": "nixpkgs",<br/> "type": "github"<br/> }<br/> },<br/> "root": {<br/> "inputs": {<br/> "flake-utils": "flake-utils",<br/> "nixpkgs": "nixpkgs",<br/> "rust-overlay": "rust-overlay"<br/> }<br/> },<br/> "rust-overlay": {<br/> "inputs": {<br/> "nixpkgs": "nixpkgs_2"<br/> },<br/> "locked": {<br/> "lastModified": 1754575663,<br/> "narHash": "sha256-afOx8AG0KYtw7mlt6s6ahBBy7eEHZwws3iCRoiuRQS4=",<br/> "owner": "oxalica",<br/> "repo": "rust-overlay",<br/> "rev": "6db0fb0e9cec2e9729dc52bf4898e6c135bb8a0f",<br/> "type": "github"<br/> },<br/> "original": {<br/> "owner": "oxalica",<br/> "repo": "rust-overlay",<br/> "type": "github"<br/> }<br/> },<br/> "systems": {<br/> "locked": {<br/> "lastModified": 1681028828,<br/> "narHash": "sha256-Vy1rq5AaRuLzOxct8nz4T6wlgyUR7zLU309k9mBC768=",<br/> "owner": "nix-systems",<br/> "repo": "default",<br/> "rev": "da67096a3b9bf56a91d16901293e51ba5b49a27e",<br/> "type": "github"<br/> },<br/> "original": {<br/> "owner": "nix-systems",<br/> "repo": "default",<br/> "type": "github"<br/> }<br/> }<br/> },<br/> "root": "root",<br/> "version": 7<br/>}<br/>
2026-10-09T01:53:54Zhttps://njump.me/nevent1qqswqh9zllmdrxe6lk2smnc4c672wl75zea9u09m8suc5g7z0psgywqzyp2xhcyfwmc3jdu98up2074n3zznz6ye259qzdm0pp7qwhqtg2z6jtjtpkc# Show a Set > `n34 sets show` command **Usage:** ``` Show a ...
# Show a Set<br/><br/>> `n34 sets show` command<br/><br/>**Usage:**<br/>```<br/>Show a single set or all the stored sets<br/><br/>Usage: n34 sets show [NAME]<br/><br/>Arguments:<br/> [NAME] Name of the set to display. If not provided, lists all available sets<br/>```<br/><br/>Prints all set names to standard output, each followed by its associated repos<br/>and relays. To view the details for a specific set, provide its name as an<br/>argument.<br/>
2026-10-09T01:53:54Zhttps://njump.me/nevent1qqs9tsghxh2vtkdetr03paspntem2r8jpg9h7n4se0xmc56x86n0g6gzyp2xhcyfwmc3jdu98up2074n3zznz6ye259qzdm0pp7qwhqtg2z6jz43t5k{ inputs = { nixpkgs.url = ...
{<br/> inputs = {<br/> nixpkgs.url = "github:NixOS/nixpkgs/nixos-unstable";<br/> rust-overlay.url = "github:oxalica/rust-overlay";<br/> flake-utils.url = "github:numtide/flake-utils";<br/> };<br/><br/> outputs =<br/> {<br/> nixpkgs,<br/> rust-overlay,<br/> flake-utils,<br/> ...<br/> }:<br/> flake-utils.lib.eachDefaultSystem (<br/> system:<br/> let<br/> overlays = [ (import rust-overlay) ];<br/> pkgs = import nixpkgs { inherit system overlays; };<br/> in<br/> with pkgs;<br/> {<br/> devShells.default = mkShell {<br/> packages = [<br/> cargo-msrv<br/> dbus<br/> git-cliff<br/> just<br/> mdbook<br/> nushell<br/> pkg-config<br/> taplo<br/> ];<br/><br/> nativeBuildInputs = [<br/> (lib.hiPrio rust-bin.nightly."2025-08-07".rustfmt)<br/> rust-bin.stable.latest.default<br/> rust-analyzer<br/> ];<br/> };<br/><br/> packages.default =<br/> let<br/> manifest = (pkgs.lib.importTOML ./Cargo.toml).package;<br/> in<br/> with pkgs;<br/> rustPlatform.buildRustPackage {<br/> pname = manifest.name;<br/> version = manifest.version;<br/> cargoLock.lockFile = ./Cargo.lock;<br/> src = lib.cleanSource ./.;<br/><br/> nativeBuildInputs = [<br/> pkg-config<br/> ];<br/><br/> buildInputs = [<br/> dbus<br/> ];<br/><br/> meta = {<br/> inherit (manifest) description homepage;<br/> license = lib.licenses.gpl3Plus;<br/> };<br/> };<br/> }<br/> );<br/>}<br/>
2026-10-09T01:53:54Zhttps://njump.me/nevent1qqszpldy9nzpg53de57wjycsmgr7nj0vmtjtk54zfyuy4yqnlx774uczyp2xhcyfwmc3jdu98up2074n3zznz6ye259qzdm0pp7qwhqtg2z6j9gg3j3# Create a Set > `n34 sets new` command **Usage:** ``` Create ...
# Create a Set<br/><br/>> `n34 sets new` command<br/><br/>**Usage:**<br/>```<br/>Create a new set<br/><br/>Usage: n34 sets new [OPTIONS] <NAME><br/><br/>Arguments:<br/> <NAME> Unique name for the set<br/><br/>Options:<br/> --set-relay <RELAYS> Optional relay to add it to the set, either as URL or set name to extract its relays. [aliases: `--sr`]<br/> --repo <NADDR-NIP05-OR-SET> Repository address in `naddr` format (`naddr1...`), NIP-05 format (`4rs.nl/n34` or `_@4rs.nl/n34`), or a set name like `kernel`<br/>```<br/><br/>Each set requires a unique name, provided as the final argument to the command.<br/>Use the `--set-relays`/`--sr` option to specify the relays for the new set;<br/>this can be a relay URL or the name of an existing set whose relays you wish to<br/>use. To add repositories, use the `--repo` option. Check [passing repositories]<br/>format.<br/><br/>[passing repositories]: /commands.html#passing-repositories<br/>
2026-10-09T01:53:54Zhttps://njump.me/nevent1qqsphcxumjlpq0yhz0k2la32jfztnc0qrff3vh6e49j6pm6sqgk5zcqzyp2xhcyfwmc3jdu98up2074n3zznz6ye259qzdm0pp7qwhqtg2z6j422lvg# Remove a Set > `n34 sets remove` command **Usage:** ``` ...
# Remove a Set<br/><br/>> `n34 sets remove` command<br/><br/>**Usage:**<br/>```<br/>Remove a set, or specific repos and relays within it<br/><br/>Usage: n34 sets remove [OPTIONS] <NAME><br/><br/>Arguments:<br/> <NAME> Set name to delete<br/><br/>Options:<br/> --set-relay <RELAYS> Specific relay to remove it from the set, either as URL or set name to extract its relays. [aliases: `--sr`]<br/> --repo <NADDR-NIP05-OR-SET> Repository address in `naddr` format (`naddr1...`), NIP-05 format (`4rs.nl/n34` or `_@4rs.nl/n34`), or a set name like `kernel`<br/>```<br/><br/>Removes an entire set, or specific repositories and relays from it.<br/>Without options, this command deletes the entire set.<br/><br/>See the [passing repositories] section for more details on supported formats.<br/><br/>[passing repositories]: /commands.html#passing-repositories<br/>
2026-10-09T01:53:54Zhttps://njump.me/nevent1qqsqmn6wndp7rfgwqggk5kka0tvyvygy8znne0l73zcaddjksknvl6gzyp2xhcyfwmc3jdu98up2074n3zznz6ye259qzdm0pp7qwhqtg2z6j0j5aan# Modify a Set > `n34 sets update` command **Usage:** ``` ...
# Modify a Set<br/><br/>> `n34 sets update` command<br/><br/>**Usage:**<br/>```<br/>Modify an existing set<br/><br/>Usage: n34 sets update [OPTIONS] <NAME><br/><br/>Arguments:<br/> <NAME> Name of the set to update<br/><br/>Options:<br/> --set-relay <RELAYS> Add relay to the set, either as URL or set name to extract its relays. [aliases: `--sr`]<br/> --repo <NADDR-NIP05-OR-SET> Repository address in `naddr` format (`naddr1...`), NIP-05 format (`4rs.nl/n34` or `_@4rs.nl/n34`), or a set name like `kernel`<br/> --override Replace existing relays/repositories instead of adding to them<br/>```<br/><br/>Use this command to update an existing set by its name. By default, providing<br/>relays via `--set-relay` or repositories via `--repo` will add them to the set's<br/>existing entries. To replace the current relays and repositories with the new<br/>values, use the `--override` flag.<br/><br/>[passing repositories]: /commands.html#passing-repositories<br/>
2026-10-09T01:53:54Zhttps://njump.me/nevent1qqsw9kxhgk3q7kx2selq84p3nz8ydaxfmn9n4z6pstxygct3sew95tszyp2xhcyfwmc3jdu98up2074n3zznz6ye259qzdm0pp7qwhqtg2z6jt3p4rf# Merge an Open Patch > `n34 patch merge` command **Usage:** ...
# Merge an Open Patch<br/><br/>> `n34 patch merge` command<br/><br/>**Usage:**<br/>```<br/>Set an open patch status to merged<br/><br/>Usage: n34 patch merge [OPTIONS] <PATCH_ID> <MERGE_COMMIT><br/><br/>Arguments:<br/> <PATCH_ID> The open patch id to merge it. Must be orignal root patch or revision root<br/> <MERGE_COMMIT> The merge commit id<br/><br/>Options:<br/> --repo <NADDR-NIP05-OR-SET> Repository address in `naddr` format (`naddr1...`), NIP-05 format (`4rs.nl/n34` or `_@4rs.nl/n34`), or a set name like `kernel`<br/> --patches <PATCH-EVENT-ID> Patches that have been merged. Use this when only some patches have been merged, not all<br/>```<br/><br/>Creates a kind `1631` event (Applied/Merged status) for the specified patch. The<br/>patch must be in open status.<br/><br/>You can specify either an original patch or revision patch ID, but the status<br/>event will only reference the original patch. Revision patches will be mentioned<br/>in the event.<br/><br/>You can get the `MERGE_COMMIT` commit using `git rev-parse HEAD` command if<br/>the merge commit in the `HEAD` or use `HEAD~n` where the `n` is the number of<br/>commits the merge commit before the HEAD<br/>
2026-10-09T01:53:53Zhttps://njump.me/nevent1qqs2ddmn9pske5hdl5l7p2wfvyqqjqlzjystcl2w865j9zwdv7s8nxczyp2xhcyfwmc3jdu98up2074n3zznz6ye259qzdm0pp7qwhqtg2z6jea6ty7# Broadcast and Update a Git Repository > `n34 repo announce` ...
# Broadcast and Update a Git Repository<br/><br/>> `n34 repo announce` command<br/><br/>**Usage:**<br/>```<br/>Broadcast and update a git repository<br/><br/>Usage: n34 repo announce [OPTIONS] --id <REPO_ID><br/><br/>Options:<br/> --id <REPO_ID> Unique identifier for the repository in kebab-case<br/> -n, --name <NAME> A name for the repository<br/> -d, --description <DESCRIPTION> A description for the repository<br/> -w, --web <WEB> Webpage URLs for the repository (if provided by the git server)<br/> -c, --clone <CLONE> URLs for cloning the repository<br/> -m, --maintainers <MAINTAINERS> Additional maintainers of the repository (besides yourself)<br/> -l, --label <LABEL> Labels to categorize the repository. Can be specified multiple times<br/> --force-id Skip kebab-case validation for the repository ID<br/> --address-file If set, creates a `nostr-address` file to enable automatic address discovery by n34<br/>```<br/><br/>This command generates an announcement event to publish your project. It can be<br/>used to announce a new repository or update an existing one.<br/><br/>When updating, you must resubmit all repository fields, not just the fields<br/>you wish to change. The command uses this information to build and publish a<br/>completely new announcement event that will replace the old one.<br/><br/>It is recommended to use the `--address-file` flag. This option creates<br/>a `nostr-address` file that enables `n34` to automatically discover the<br/>repository's address, simplifying the workflow for contributors.<br/>
2026-10-09T01:53:53Zhttps://njump.me/nevent1qqs8zmyl7zqkezw64jywx337yr9crddr6kmnkg4f0lrxxatgcsxrmmqzyp2xhcyfwmc3jdu98up2074n3zznz6ye259qzdm0pp7qwhqtg2z6jx9rcmf# Send Patches to a Repository > `n34 patch send` command ...
# Send Patches to a Repository<br/><br/>> `n34 patch send` command<br/><br/>**Usage:**<br/>```<br/>Send one or more patches to a repository<br/><br/>Usage: n34 patch send [OPTIONS] <PATCH-PATH>...<br/><br/>Arguments:<br/> <PATCH-PATH>... List of patch files to send (space separated)<br/><br/>Options:<br/> --repo <NADDR-NIP05-OR-SET> Repository address in `naddr` format (`naddr1...`), NIP-05 format (`4rs.nl/n34` or `_@4rs.nl/n34`), or a set name like `kernel`<br/> --original-patch <EVENT-ID> Original patch ID if this is a revision of it<br/>```<br/><br/>Send your generated patches to the repositories specified using the `--repo`<br/>option or retrieved from the `nostr-address` file. When submitting a revision<br/>of an existing patch, include the original patch ID to ensure it’s correctly<br/>referenced in your revision patch event.<br/>
2026-10-09T01:53:53Zhttps://njump.me/nevent1qqs99e8f9kfvchg4r24epxe883dss83gc63dqfgwzffjqlpfpu22acgzyp2xhcyfwmc3jdu98up2074n3zznz6ye259qzdm0pp7qwhqtg2z6j9rvzvw# Reply to Issues and Patches > `n34 reply` command **Usage:** ...
# Reply to Issues and Patches<br/><br/>> `n34 reply` command<br/><br/>**Usage:**<br/>```<br/>Reply to issues and patches<br/><br/>Usage: n34 reply [OPTIONS] <--comment <COMMENT>|--editor> <nevent1-or-note1><br/><br/>Arguments:<br/> <nevent1-or-note1> The issue, patch, or comment to reply to<br/><br/>Options:<br/> --quote-to Quote the replied-to event in the editor<br/> --repo <NADDR-NIP05-OR-SET> Repository address in `naddr` format (`naddr1...`), NIP-05 format (`4rs.nl/n34` or `_@4rs.nl/n34`), or a set name like `kernel`<br/> -c, --comment <COMMENT> The comment (cannot be used with --editor)<br/> -e, --editor Open editor to write comment (cannot be used with --content)<br/>```<br/><br/>Craft replies ([NIP-22] Comment) to issues, patches, or comments with ease<br/>using the `n34 reply` command. You can either input your reply directly with<br/>the `--comment` option or open an editor for a more detailed response using<br/>`--editor`. Additionally, when using `--editor`, the `--quote-to` option<br/>allows you to include the original content in your editor, enabling precise and<br/>context-aware replies.<br/><br/>[NIP-22]: <a href="https://github.com/nostr-protocol/nips/blob/master/22.md">https://github.com/nostr-protocol/nips/blob/master/22.md</a><br/>
2026-10-09T01:53:53Zhttps://njump.me/nevent1qqsrh864mt8fan6j4mgtj3s48g0m54rrm27ytkz6g4at3jdzu3d5vtszyp2xhcyfwmc3jdu98up2074n3zznz6ye259qzdm0pp7qwhqtg2z6jgc6kqs# View Git Repository Details > `n34 repo view` command ...
# View Git Repository Details<br/><br/>> `n34 repo view` command<br/><br/>**Usage:**<br/>```<br/>View details of a nostr git repository<br/><br/>Usage: n34 repo view [NADDR-NIP05-OR-SET]...<br/><br/>Arguments:<br/> [NADDR-NIP05-OR-SET]... Repository address in `naddr` format (`naddr1...`), NIP-05 format (`4rs.nl/n34` or `_@4rs.nl/n34`), or a set name like `kernel`<br/>```<br/><br/>This command prints repository details to standard output. If no arguments<br/>are provided, it looks for a `nostr-address` file in the current directory<br/>and displays the details for the address specified within it. See [passing<br/>repositories] for details on accepted formats.<br/><br/>[passing repositories]: /commands.html#passing-repositories<br/>
2026-10-09T01:53:53Zhttps://njump.me/nevent1qqsrnj78xkltasmmslpjphk8wqmnehzfn3ugyygqyzkgnpu2e502qtczyp2xhcyfwmc3jdu98up2074n3zznz6ye259qzdm0pp7qwhqtg2z6jpgvhwx# Managing Repository and Relay Sets Sets are a convenience ...
# Managing Repository and Relay Sets<br/><br/>Sets are a convenience feature for contributing to projects that do not have a<br/>`nostr-address` file. Instead of manually specifying the project's repositories<br/>and relays for every command, you can define them once as a named "set". You can<br/>then reference this set by its name in commands. This allows you to use the set<br/>as a shortcut for a list of relays (`--relays <set_name>`) or as the project's<br/>address in commands like `issue` and `patch`.<br/><br/>Sets are defined in your configuration file. To use a specific configuration<br/>file, pass its path using the `--config` option.<br/>
2026-10-09T01:53:53Zhttps://njump.me/nevent1qqspl7u45shu280tt92w75wssd057cu5wh0mtde3d9n6vkksvc4xd7czyp2xhcyfwmc3jdu98up2074n3zznz6ye259qzdm0pp7qwhqtg2z6jju2lth# Reopens a Closed or Drafted Patch > `n34 patch reopen` ...
# Reopens a Closed or Drafted Patch<br/><br/>> `n34 patch reopen` command<br/><br/>**Usage:**<br/>```<br/>Reopens a closed or drafted patch<br/><br/>Usage: n34 patch reopen [OPTIONS] <PATCH_ID><br/><br/>Arguments:<br/> <PATCH_ID> The closed/drafted patch id to reopen it. Must be orignal root patch<br/><br/>Options:<br/> --repo <NADDR-NIP05-OR-SET> Repository address in `naddr` format (`naddr1...`), NIP-05 format (`4rs.nl/n34` or `_@4rs.nl/n34`), or a set name like `kernel`<br/>```<br/><br/>Issue a kind `1632` (Close status) for the specified patch. The patch have to<br/>be closed or drafted.<br/><br/>
2026-10-09T01:53:53Zhttps://njump.me/nevent1qqsp0lplrz3je43algaenru8y3s9r7y2vgxpq7f5kz7f29dawpv5qyqzyp2xhcyfwmc3jdu98up2074n3zznz6ye259qzdm0pp7qwhqtg2z6jujnsav# Manage Repositories In `n34` you can manage your repositories. ...
# Manage Repositories<br/><br/>In `n34` you can manage your repositories. This includes announcing new ones,<br/>viewing existing ones, and announcing state updates (coming soon).<br/>
2026-10-09T01:53:53Zhttps://njump.me/nevent1qqsy96ql7x7wn0qlz4a0t78lhs6vgm28jg4lhg50y68znrs0h39fymqzyp2xhcyfwmc3jdu98up2074n3zznz6ye259qzdm0pp7qwhqtg2z6j5aazg8# List Repositories Patches > `n34 patch list` command ...
# List Repositories Patches<br/><br/>> `n34 patch list` command<br/><br/>**Usage:**<br/>```<br/>List the repositories patches<br/><br/>Usage: n34 patch list [OPTIONS] [NADDR-NIP05-OR-SET]...<br/><br/>Arguments:<br/> [NADDR-NIP05-OR-SET]... Repository address in `naddr` format (`naddr1...`), NIP-05 format (`4rs.nl/n34` or `_@4rs.nl/n34`), or a set name like `kernel`<br/><br/>Options:<br/> --limit <LIMIT> Maximum number of patches to list [default: 15]<br/>```<br/><br/>List the repositories patches. By default `n34` will look for `nostr-address`<br/>file and extract the repositories from it.<br/><br/>
2026-10-09T01:53:48Zhttps://njump.me/nevent1qqs04f3qjkvttth7328ek86h2v6xlhvjysc5pjvu9nxhpvurvzqg5cgzyp2xhcyfwmc3jdu98up2074n3zznz6ye259qzdm0pp7qwhqtg2z6jyu4ga0# Fetch a Patch By ID > `n34 patch fetch` command **Usage:** ...
# Fetch a Patch By ID<br/><br/>> `n34 patch fetch` command<br/><br/>**Usage:**<br/>```<br/>Fetches a patch by its id<br/><br/>Usage: n34 patch fetch [OPTIONS] <PATCH_ID><br/><br/>Arguments:<br/> <PATCH_ID> The patch id to fetch it<br/><br/>Options:<br/> --repo <NADDR-NIP05-OR-SET> Repository address in `naddr` format (`naddr1...`), NIP-05 format (`4rs.nl/n34` or `_@4rs.nl/n34`), or a set name like `kernel`<br/> -o, --output <PATH> Output directory for the patches. Default to the current directory<br/>```<br/><br/>Fetches patches using their original patch ID. All fetched patches will be saved<br/>to the specified output directory (current directory by default). You can then<br/>apply or merge these patches into your branch as needed.<br/>
2026-10-09T01:53:41Zhttps://njump.me/nevent1qqsw705gvzjxlh55z4u2tkjd4pfwqyf8kjf8kjeypm0v8y5lydxcscszyp2xhcyfwmc3jdu98up2074n3zznz6ye259qzdm0pp7qwhqtg2z6jv49g76# List Repositories Issues > `n34 issue list` command ...
# List Repositories Issues<br/><br/>> `n34 issue list` command<br/><br/>**Usage:**<br/>```<br/>List the repositories issues<br/><br/>Usage: n34 issue list [OPTIONS] [NADDR-NIP05-OR-SET]...<br/><br/>Arguments:<br/> [NADDR-NIP05-OR-SET]... Repository address in `naddr` format (`naddr1...`), NIP-05 format (`4rs.nl/n34` or `_@4rs.nl/n34`), or a set name like `kernel`<br/><br/>Options:<br/> --limit <LIMIT> Maximum number of issues to list [default: 15]<br/>```<br/><br/>List the repositories issues. By default `n34` will look for `nostr-address`<br/>file and extract the repositories from it.<br/>
2026-10-09T01:53:41Zhttps://njump.me/nevent1qqsdasamrwm32khsep2ep6xx2e4s520gsudrw4xxt3222crfps8w3gqzyp2xhcyfwmc3jdu98up2074n3zznz6ye259qzdm0pp7qwhqtg2z6j7a0x5r# Draft an Open Patch > `n34 patch draft` command **Usage:** ...
# Draft an Open Patch<br/><br/>> `n34 patch draft` command<br/><br/>**Usage:**<br/>```<br/>Converts an open patch to draft state<br/><br/>Usage: n34 patch draft [OPTIONS] <PATCH_ID><br/><br/>Arguments:<br/> <PATCH_ID> The open patch id to draft it. Must be orignal root patch<br/><br/>Options:<br/> --repo <NADDR-NIP05-OR-SET> Repository address in `naddr` format (`naddr1...`), NIP-05 format (`4rs.nl/n34` or `_@4rs.nl/n34`), or a set name like `kernel`<br/>```<br/><br/>Issue a kind `1633` (Draft status) for the specified patch. The patch have to<br/>be open.<br/>
2026-10-09T01:53:41Zhttps://njump.me/nevent1qqst3f8488usayjar9qwumerla0tga600544hvhletxtpqgkdkaer2qzyp2xhcyfwmc3jdu98up2074n3zznz6ye259qzdm0pp7qwhqtg2z6j05k75h# Resolves an Issue > `n34 issue resolve` command **Usage:** ...
# Resolves an Issue<br/><br/>> `n34 issue resolve` command<br/><br/>**Usage:**<br/>```<br/>Resolves an issue<br/><br/>Usage: n34 issue resolve [OPTIONS] <ISSUE_ID><br/><br/>Arguments:<br/> <ISSUE_ID> The issue id to resolve it<br/><br/>Options:<br/> --repo <NADDR-NIP05-OR-SET> Repository address in `naddr` format (`naddr1...`), NIP-05 format (`4rs.nl/n34` or `_@4rs.nl/n34`), or a set name like `kernel`<br/>```<br/><br/>Issue a kind `1631` (Resolved status) event for the specified issue.<br/>
2026-10-09T01:53:41Zhttps://njump.me/nevent1qqst8fy4r20zcvvfplvk8nguey9euhygl5f64xdlpw09lp4mu6qhczqzyp2xhcyfwmc3jdu98up2074n3zznz6ye259qzdm0pp7qwhqtg2z6j0vm863# NIP-07 Browser Signer Proxy > `n34 config nip07` **Usage:** ...
# NIP-07 Browser Signer Proxy<br/><br/>> `n34 config nip07`<br/><br/>**Usage:**<br/>```<br/>Manage the NIP-07 browser signer proxy by enabling or disabling it and configuring the `ip:port` address.<br/><br/>Usage: n34 config nip07 [OPTIONS] <--enable|--disable><br/><br/>Options:<br/> --enable Enable NIP-07 as the default signer<br/> --disable Disable NIP-07 as the default signer<br/> --addr <ADDR> Set the `ip:port` for the browser signer proxy (default: 127.0.0.1:51034)<br/>```<br/><br/>Use [NIP-07] (Browser Extension Signer) as your default signer. This is achieved<br/>by running a proxy at the specified `ADDR`, which defaults to `127.0.0.1:51034`.<br/>The proxy forwards `n34` requests to the browser signer and relays the responses<br/>back.<br/><br/>[NIP-07]: <a href="https://github.com/nostr-protocol/nips/blob/master/07.md">https://github.com/nostr-protocol/nips/blob/master/07.md</a><br/>
2026-10-09T01:53:41Zhttps://njump.me/nevent1qqsfpkhsxal5lzrv7uj59jcj78pvrx87eggce54kv30jum2kqdnq8uszyp2xhcyfwmc3jdu98up2074n3zznz6ye259qzdm0pp7qwhqtg2z6jjh8qsd# Closes an Open Issue > `n34 issue close` command **Usage:** ...
# Closes an Open Issue<br/><br/>> `n34 issue close` command<br/><br/>**Usage:**<br/>```<br/>Closes an open issue<br/><br/>Usage: n34 issue close [OPTIONS] <ISSUE_ID><br/><br/>Arguments:<br/> <ISSUE_ID> The open issue id to close it<br/><br/>Options:<br/> --repo <NADDR-NIP05-OR-SET> Repository address in `naddr` format (`naddr1...`), NIP-05 format (`4rs.nl/n34` or `_@4rs.nl/n34`), or a set name like `kernel`<br/>```<br/><br/>Issue a kind `1632` (Close status) for the specified issue. The issue have to<br/>be open.<br/>
2026-10-09T01:53:41Zhttps://njump.me/nevent1qqsgmkjvccwjkhl2an2redvrvpm9k9vak95h0y4cafvsvma6u2rxpygzyp2xhcyfwmc3jdu98up2074n3zznz6ye259qzdm0pp7qwhqtg2z6j0y9we5# View an Issue By ID > `n34 issue view` command **Usage:** ...
# View an Issue By ID<br/><br/>> `n34 issue view` command<br/><br/>**Usage:**<br/>```<br/>View an issue by its ID<br/><br/>Usage: n34 issue view [OPTIONS] <ISSUE_ID><br/><br/>Arguments:<br/> <ISSUE_ID> The issue id to view it<br/><br/>Options:<br/> --repo <NADDR-NIP05-OR-SET> Repository address in `naddr` format (`naddr1...`), NIP-05 format (`4rs.nl/n34` or `_@4rs.nl/n34`), or a set name like `kernel`<br/>```<br/><br/>Simply provide the issue ID in `note` or `nevent` format to retrieve and display<br/>the issue details.<br/>
2026-10-09T01:53:41Zhttps://njump.me/nevent1qqsxmwrezxrqd8hpdpvl5u0qjx4ezysrxqc2ff6d5dm8ylwsps65vpczyp2xhcyfwmc3jdu98up2074n3zznz6ye259qzdm0pp7qwhqtg2z6jdkcc6k# Default PoW Difficulty > `n34 config pow` **Usage:** ``` ...
# Default PoW Difficulty<br/><br/>> `n34 config pow`<br/><br/>**Usage:**<br/>```<br/>Sets the default PoW difficulty (0 if not specified)<br/><br/>Usage: n34 config pow <DIFFICULTY><br/><br/>Arguments:<br/> <DIFFICULTY> The new default PoW difficulty<br/>```<br/><br/>This command configures the default Proof of Work (PoW) difficulty for newly<br/>created events. This setting is applied to most generated events, but it<br/>intentionally skips patch events. Because patches can be numerous, calculating<br/>PoW for each one would significantly slow down operations.<br/><br/>If you want to disable the PoW just make it 0.<br/>
2026-10-09T01:53:41Zhttps://njump.me/nevent1qqsxywcaplz6r0z629putjjl5cf2e6nyguvspcrh879twngyvh549qqzyp2xhcyfwmc3jdu98up2074n3zznz6ye259qzdm0pp7qwhqtg2z6jlym0wp# Apply an Open Patch > `n34 patch apply` command **Usage:** ...
# Apply an Open Patch<br/><br/>> `n34 patch apply` command<br/><br/>**Usage:**<br/>```<br/>Set an open patch status to applied<br/><br/>Usage: n34 patch apply [OPTIONS] <PATCH_ID> [APPLIED_COMMITS]...<br/><br/>Arguments:<br/> <PATCH_ID> The open patch id to apply it. Must be orignal root patch or revision root<br/> [APPLIED_COMMITS]... The applied commits<br/><br/>Options:<br/> --repo <NADDR-NIP05-OR-SET> Repository address in `naddr` format (`naddr1...`), NIP-05 format (`4rs.nl/n34` or `_@4rs.nl/n34`), or a set name like `kernel`<br/> --patches <PATCH-EVENT-ID> Patches that have been applied. Use this when only some patches have been applied, not all<br/>```<br/><br/>Creates a kind `1631` event (Applied/Merged status) for the specified patch. The<br/>patch must be in open status.<br/><br/>You can specify either an original patch or revision patch ID, but the status<br/>event will only reference the original patch. Revision patches will be mentioned<br/>in the event.<br/><br/>The `APPLIED_COMMITS` field serves to inform clients about the status of<br/>specific commits, whether they have been applied or not. If you need to retrieve<br/>the list of commits from a specific point (such as the tip of the master branch)<br/>up to the `HEAD`, you can use the following Git command: `git log --pretty=%H<br/>'origin/master..HEAD'`.<br/>
2026-10-09T01:53:41Zhttps://njump.me/nevent1qqsyhn3f6xlk9xpefxgrw8lqa7v0udw87lw5czfc2ke37qqmffaj29szyp2xhcyfwmc3jdu98up2074n3zznz6ye259qzdm0pp7qwhqtg2z6je8fuzv# Fallback Relays > `n34 config relays` command **Usage:** ``` ...
# Fallback Relays<br/><br/>> `n34 config relays` command<br/><br/>**Usage:**<br/>```<br/>Sets the default fallback relays if none provided. Use this relays for read and write<br/><br/>Usage: n34 config relays [OPTIONS] [RELAYS]...<br/><br/>Arguments:<br/> [RELAYS]... List of relay URLs to append to fallback relays. If empty, removes all fallback relays<br/><br/>Options:<br/> --override Replace existing fallback relays instead of appending new ones<br/>```<br/><br/>This command configures the default fallback relays, which `n34` uses to read<br/>from and write to. To add relays, provide their URLs as arguments to append<br/>them to the current list. Use the `--override` flag to replace the existing list<br/>entirely. To clear all fallback relays, run the command without any arguments.<br/>
2026-10-09T01:53:41Zhttps://njump.me/nevent1qqsykd6rl23t6nkgvjz2qf9urk4nxnfjlpxy7uftul9m67asu7qutaszyp2xhcyfwmc3jdu98up2074n3zznz6ye259qzdm0pp7qwhqtg2z6j3z25aj<!DOCTYPE html> <html lang="en"> <head> ...
<!DOCTYPE html><br/><html lang="en"><br/> <head><br/> <meta charset="UTF-8" /><br/><br/> <meta property="og:title" content="n34 - CLI for NIP-34 and Nostr Code Collaboration"><br/> <meta property="og:description" content="An open source CLI for sending and receiving Git issues, patches and comments over the Nostr protocol."><br/> <meta property="og:url" content="<a href="https://n34.dev">">https://n34.dev"></a>;<br/> <meta property="og:type" content="website"><br/><br/> <meta name="twitter:card" content="summary"><br/> <meta name="twitter:title" content="n34 - CLI for NIP-34 and Nostr Code Collaboration"><br/> <meta name="twitter:description" content="An open source CLI for sending and receiving Git issues, patches and comments over the Nostr protocol."><br/><br/> <meta name="viewport" content="width=device-width, initial-scale=1.0" /><br/> <title>n34 - CLI for NIP-34 and Nostr Code Collaboration</title><br/> <style><br/> * {<br/> margin: 0;<br/> padding: 0;<br/> box-sizing: border-box;<br/> }<br/> body {<br/> font-family: "Segoe UI", Tahoma, Geneva, Verdana, sans-serif;<br/> background: radial-gradient(125% 125% at 50% 90%, #000000 40%, #072607 100%);<br/> color: #ffffff;<br/> line-height: 1.6;<br/> min-height: 100vh;<br/> }<br/> .container {<br/> max-width: 800px;<br/> margin: 0 auto;<br/> padding: 60px 20px;<br/> }<br/> .hero {<br/> text-align: center;<br/> margin-bottom: 80px;<br/> }<br/> .hero h1 {<br/> font-size: 4rem;<br/> font-weight: 300;<br/> margin-bottom: 20px;<br/> letter-spacing: 2px;<br/> background: linear-gradient(135deg, #ffffff, #cccccc);<br/> -webkit-background-clip: text;<br/> -webkit-text-fill-color: transparent;<br/> background-clip: text;<br/> }<br/> .hero p {<br/> font-size: 1.2rem;<br/> color: #cccccc;<br/> margin-bottom: 40px;<br/> max-width: 600px;<br/> margin-left: auto;<br/> margin-right: auto;<br/> }<br/> .buttons {<br/> display: flex;<br/> gap: 20px;<br/> justify-content: center;<br/> flex-wrap: wrap;<br/> }<br/> .btn {<br/> display: inline-block;<br/> padding: 14px 28px;<br/> background: transparent;<br/> border: 2px solid #ffffff;<br/> color: #ffffff;<br/> text-decoration: none;<br/> border-radius: 8px;<br/> font-weight: 500;<br/> font-size: 1rem;<br/> transition: all 0.3s ease;<br/> min-width: 120px;<br/> text-align: center;<br/> }<br/> .btn:hover {<br/> background: #ffffff;<br/> color: #0a0a0a;<br/> transform: translateY(-2px);<br/> box-shadow: 0 8px 25px rgba(255, 255, 255, 0.2);<br/> }<br/> .section {<br/> margin-bottom: 60px;<br/> }<br/> .section h2 {<br/> font-size: 2.2rem;<br/> margin-bottom: 30px;<br/> color: #ffffff;<br/> font-weight: 400;<br/> }<br/> .section p {<br/> font-size: 1.1rem;<br/> color: #e0e0e0;<br/> margin-bottom: 20px;<br/> text-align: justify;<br/> }<br/> a {<br/> color: #cccccc;<br/> text-decoration: underline;<br/> font-size: 1rem;<br/> transition: color 0.3s ease;<br/> }<br/> a:hover {<br/> color: #ffffff;<br/> }<br/> .features {<br/> display: grid;<br/> grid-template-columns: repeat(auto-fit, minmax(250px, 1fr));<br/> gap: 30px;<br/> margin-bottom: 60px;<br/> }<br/> .feature {<br/> background: #1a1a1a;<br/> padding: 30px;<br/> border-radius: 12px;<br/> border: 1px solid #333;<br/> transition: transform 0.3s ease, border-color 0.3s ease;<br/> }<br/> .feature:hover {<br/> transform: translateY(-5px);<br/> border-color: #555;<br/> }<br/> .feature h3 {<br/> font-size: 1.3rem;<br/> margin-bottom: 15px;<br/> color: #ffffff;<br/> display: flex;<br/> align-items: center;<br/> gap: 10px;<br/> }<br/> .feature-icon {<br/> font-size: 1.5rem;<br/> }<br/> .feature p {<br/> color: #cccccc;<br/> font-size: 1rem;<br/> text-align: left;<br/> }<br/> .feature-list {<br/> background: #111;<br/> padding: 40px;<br/> border-radius: 12px;<br/> border: 1px solid #333;<br/> margin-bottom: 60px;<br/> }<br/> .feature-grid {<br/> display: grid;<br/> grid-template-columns: repeat(auto-fit, minmax(300px, 1fr));<br/> gap: 20px;<br/> margin-top: 20px;<br/> }<br/> .feature-column ul {<br/> list-style: none;<br/> padding: 0;<br/> }<br/> .feature-column li {<br/> display: flex;<br/> align-items: center;<br/> margin-bottom: 12px;<br/> font-size: 1rem;<br/> padding: 8px 0;<br/> }<br/> .feature-check {<br/> display: inline-block;<br/> width: 20px;<br/> height: 20px;<br/> margin-right: 12px;<br/> border-radius: 3px;<br/> text-align: center;<br/> line-height: 20px;<br/> font-size: 12px;<br/> font-weight: bold;<br/> flex-shrink: 0;<br/> }<br/> .feature-check.completed {<br/> background: #22c55e;<br/> color: #ffffff;<br/> }<br/> .feature-check.pending {<br/> background: #374151;<br/> color: #9ca3af;<br/> border: 1px solid #4b5563;<br/> }<br/> .feature-check.completed::after {<br/> content: "✓";<br/> }<br/> .feature-check.pending::after {<br/> content: "○";<br/> }<br/> .feature-text {<br/> color: #e0e0e0;<br/> }<br/> .feature-text.pending {<br/> color: #9ca3af;<br/> }<br/> .install-section {<br/> background: #111;<br/> padding: 40px;<br/> border-radius: 12px;<br/> border: 1px solid #333;<br/> margin-bottom: 60px;<br/> }<br/> .install-section h2 {<br/> margin-bottom: 20px;<br/> text-align: center;<br/> }<br/> .code-block {<br/> background: #000;<br/> padding: 20px;<br/> border-radius: 8px;<br/> font-family: "Courier New", monospace;<br/> font-size: 1rem;<br/> border: 1px solid #333;<br/> overflow-x: auto;<br/> margin: 15px 0;<br/> }<br/> .code-block p {<br/> color: #00ff00;<br/> }<br/> .code-block p::before {<br/> content: "$ ";<br/> color: #888;<br/> }<br/> .code-block span::before {<br/> content: "$ ";<br/> color: #888;<br/> }<br/> .code-block span {<br/> color: #777;<br/> }<br/> .code-block pre {<br/> color: #00ff00;<br/> }<br/> .links {<br/> margin-top: 30px;<br/> }<br/> .links h3 {<br/> font-size: 1.3rem;<br/> margin-bottom: 15px;<br/> color: #ffffff;<br/> }<br/> .links ul {<br/> list-style: none;<br/> }<br/> .links li {<br/> margin-bottom: 8px;<br/> }<br/> .links a {<br/> color: #cccccc;<br/> text-decoration: none;<br/> font-size: 1rem;<br/> transition: color 0.3s ease;<br/> }<br/> .links a:hover {<br/> color: #ffffff;<br/> }<br/> .links a:before {<br/> content: "→ ";<br/> margin-right: 8px;<br/> }<br/> .status-badge {<br/> display: inline-block;<br/> padding: 4px 12px;<br/> background: #1a4d1a;<br/> color: #4ade80;<br/> border-radius: 16px;<br/> font-size: 0.8rem;<br/> font-weight: 500;<br/> margin-bottom: 20px;<br/> }<br/> .footer {<br/> text-align: center;<br/> padding: 40px 0;<br/> border-top: 1px solid #333;<br/> margin-top: 80px;<br/> color: #888;<br/> }<br/> @media (max-width: 768px) {<br/> .hero h1 {<br/> font-size: 2.5rem;<br/> }<br/> .hero p {<br/> font-size: 1.1rem;<br/> }<br/> .buttons {<br/> flex-direction: column;<br/> align-items: center;<br/> }<br/> .btn {<br/> width: 200px;<br/> }<br/> .section h2 {<br/> font-size: 1.8rem;<br/> }<br/> .features {<br/> grid-template-columns: 1fr;<br/> }<br/> .feature-grid {<br/> grid-template-columns: 1fr;<br/> }<br/> .install-section,<br/> .feature-list {<br/> padding: 20px;<br/> }<br/> }<br/> </style><br/> </head><br/> <body><br/> <div class="container"><br/> <div class="hero"><br/> <div class="status-badge">✨ Looking for feedback</div><br/> <h1>n34</h1><br/> <p><br/> n34 is an open source command-line interface (CLI) tool for<br/> sending and receiving Git issues, patches and comments over the<br/> Nostr protocol. It supports creating, replying to, and managing<br/> issues and patches, making Git collaboration decentralized and<br/> censorship-resistant.<br/> </p><br/> <div class="buttons"><br/> <a href="<a href="https://n34.dev/commands.html"">https://n34.dev/commands.html"</a>; class="btn">Documentation</a><br/> <a href="<a href="https://git.4rs.nl/awiteb/n34.git"">https://git.4rs.nl/awiteb/n34.git"</a>; class="btn">Git Repository</a><br/> </div><br/> </div><br/> <div class="section"><br/> <h2>Key Features</h2><br/> <div class="features"><br/> <div class="feature"><br/> <h3><span class="feature-icon">🔄</span>Complete Git Workflow</h3><br/> <p>Handle the full development lifecycle with patches, issues, replies, and status tracking, all through the decentralized Nostr protocol.</p><br/> </div><br/> <div class="feature"><br/> <h3><span class="feature-icon">🔗</span><a href="<a href="https://github.com/nostr-protocol/nips/blob/master/34.md"">https://github.com/nostr-protocol/nips/blob/master/34.md"</a>; target="_blank" rel="noreferrer">NIP-34</a> Compliant</h3><br/> <p>Fully implements the <a href="<a href="https://github.com/nostr-protocol/nips/blob/master/34.md"">https://github.com/nostr-protocol/nips/blob/master/34.md"</a>; target="_blank" rel="noreferrer">NIP-34</a> specification for Git repositories on Nostr, ensuring compatibility with the decentralized ecosystem.</p><br/> </div><br/> <div class="feature"><br/> <h3><span class="feature-icon">🛠️</span>Developer Friendly</h3><br/> <p>Intuitive CLI interface designed for developers who want to integrate Git workflows with Nostr seamlessly.</p><br/> </div><br/> <div class="feature"><br/> <h3><span class="feature-icon">🔐</span>Self-Sovereign</h3><br/> <p>No accounts, no passwords, no centralized servers. You control your identity and data through cryptographic keys.</p><br/> </div><br/> </div><br/> </div><br/> <div class="feature-list"><br/> <h2>Feature Roadmap</h2><br/> <p style="text-align: center; margin-bottom: 30px; color: #cccccc;">Current implementation status and upcoming features</p><br/> <div class="feature-grid"><br/> <div class="feature-column"><br/> <ul><br/> <li><br/> <span class="feature-check completed"></span><br/> <span class="feature-text">Repository announcements</span><br/> </li><br/> <li><br/> <span class="feature-check pending"></span><br/> <span class="feature-text pending">Repository state announcements</span><br/> </li><br/> <li><br/> <span class="feature-check completed"></span><br/> <span class="feature-text">Patches (Send, fetch and list)</span><br/> </li><br/> <li><br/> <span class="feature-check completed"></span><br/> <span class="feature-text">Issues (Send, view and list)</span><br/> </li><br/> <li><br/> <span class="feature-check completed"></span><br/> <span class="feature-text">Replies</span><br/> </li><br/> <li><br/> <span class="feature-check completed"></span><br/> <span class="feature-text">Issues and patches status</span><br/> </li><br/> <li><br/> <span class="feature-check pending"></span><br/> <span class="feature-text pending">Pull requests (<a href="<a href="https://github.com/nostr-protocol/nips/pull/1966"">https://github.com/nostr-protocol/nips/pull/1966"</a>; target="_blank" rel="noreferrer">nostr-protocol/nips#1966</a>)</span><br/> </li><br/> </ul><br/> </div><br/> <div class="feature-column"><br/> <ul><br/> <li><br/> <span class="feature-check completed"></span><br/> <span class="feature-text">Gossip Model (<a href="<a href="https://github.com/nostr-protocol/nips/blob/master/65.md"">https://github.com/nostr-protocol/nips/blob/master/65.md"</a>; target="_blank" rel="noreferrer">NIP-65</a>)</span><br/> </li><br/> <li><br/> <span class="feature-check completed"></span><br/> <span class="feature-text">Proof of Work (<a href="<a href="https://github.com/nostr-protocol/nips/blob/master/13.md"">https://github.com/nostr-protocol/nips/blob/master/13.md"</a>; target="_blank" rel="noreferrer">NIP-13</a>)</span><br/> </li><br/> <li><br/> <span class="feature-check completed"></span><br/> <span class="feature-text">nostr: URI scheme (<a href="<a href="https://github.com/nostr-protocol/nips/blob/master/21.md"">https://github.com/nostr-protocol/nips/blob/master/21.md"</a>; target="_blank" rel="noreferrer">NIP-21</a>)</span><br/> </li><br/> <li><br/> <span class="feature-check completed"></span><br/> <span class="feature-text">Signing using bunker (<a href="<a href="https://github.com/nostr-protocol/nips/blob/master/46.md"">https://github.com/nostr-protocol/nips/blob/master/46.md"</a>; target="_blank" rel="noreferrer">NIP-46</a>)</span><br/> </li><br/> <li><br/> <span class="feature-check completed"></span><br/> <span class="feature-text pending">Signing using <a href="<a href="https://github.com/nostr-protocol/nips/blob/master/07.md"">https://github.com/nostr-protocol/nips/blob/master/07.md"</a>; target="_blank" rel="noreferrer">NIP-07</a> proxy (<a href="<a href="https://crates.io/crates/nostr-browser-signer-proxy"">https://crates.io/crates/nostr-browser-signer-proxy"</a>; target="_blank" rel="noreferrer">nostr-browser-signer-proxy</a>)</span><br/> </li><br/> <li><br/> <span class="feature-check completed"></span><br/> <span class="feature-text">Secret key keyring</span><br/> </li><br/> <li><br/> <span class="feature-check pending"></span><br/> <span class="feature-text pending">Code Snippets (<a href="<a href="https://github.com/nostr-protocol/nips/blob/master/C0.md"">https://github.com/nostr-protocol/nips/blob/master/C0.md"</a>; target="_blank" rel="noreferrer">NIP-C0</a>)</span><br/> </li><br/> <li><br/> <span class="feature-check completed"></span><br/> <span class="feature-text">In device relays and repos bookmark</span><br/> </li><br/> </ul><br/> </div><br/> </div><br/> </div><br/> <div class="install-section"><br/> <h2>Quick Start</h2><br/> <p style="text-align: center; margin-bottom: 20px; color: #cccccc;">Get started with n34 in seconds</p><br/> <div class="code-block"><br/> <p>cargo install n34</p><br/> <span># The execautable will be in ~/.cargo/bin/n34</span><br/> </div><br/> <p style="text-align: center; margin: 20px 0; color: #888;">or</p><br/> <div class="code-block"><br/> <p>git clone <a href="https://git.4rs.nl/awiteb/n34.git</p>">https://git.4rs.nl/awiteb/n34.git</p></a>;<br/> <p>cd n34 && cargo build --release</p><br/> <span># The execautable will be in target/release/n34</span><br/> </div><br/> <p style="text-align: center; margin: 20px 0; color: #888;">NixOS (Version 0.4.0 or later)</p><br/> <div class="code-block"><br/> <p>git clone <a href="https://git.4rs.nl/awiteb/n34.git</p>">https://git.4rs.nl/awiteb/n34.git</p></a>;<br/> <p>cd n34 && nix build</p><br/> <span># The execautable will be in result/bin/n34</span><br/> </div><br/> <p style="text-align: center; margin: 20px 0; color: #888;">home-manager</p><br/> <p style="text-align: center; margin-bottom: 20px; color: #cccccc;">Add this to your <code>flake.nix</code> inputs<br/> <br><br/>Specify the version you want to install, or remove <code>?ref</code> for the unreleased version. You can also use any mirror; it doesn't have to be <code>git.4rs.nl</code><br/> </p><br/> <div class="code-block"><br/> <pre><br/>inputs = {<br/> n34.url = "git+<a href="https://git.4rs.nl/awiteb/n34.git?ref=refs/tags/vx.y.x"">https://git.4rs.nl/awiteb/n34.git?ref=refs/tags/vx.y.x"</a>;;<br/>};</pre><br/> </div><br/> <p style="text-align: center; margin-bottom: 20px; color: #cccccc;">And this in your home packages</p><br/> <div class="code-block"><br/> <pre>packages = [ inputs.n34.packages."${pkgs.system}".default ];</pre><br/> </div><br/> <p style="text-align: center; margin-top: 20px; color: #cccccc;">Once installed, run <code style="background: #333; padding: 2px 6px; border-radius: 4px;">n34 --help</code> to see available commands.</p><br/> </div><br/> <div class="section"><br/> <h2>Why Nostr?</h2><br/> <p><br/> Nostr is fundamentally different from traditional platforms because it's not an application or service, it's a decentralized protocol. This means any tool or app can integrate with it, enabling open, permissionless collaboration<br/> without relying on centralized gatekeepers. Unlike proprietary systems, Nostr doesn't require emails, passwords, or accounts. You interact directly through relays, whether you self-host your own or use public ones, ensuring no<br/> single point of failure or control.<br/> </p><br/> <p><br/> What makes Nostr uniquely resilient is its design, the protocol itself is just a set of rules, not a company or product that can disappear. Your Git issues, patches, and comments persist as long as relays choose to store them,<br/> immune to the whims of corporate shutdowns or policy changes. Nostr is infrastructure in its purest form, an idea that outlives any temporary implementation. n34 taps into a future-proof foundation for decentralized collaboration.<br/> </p><br/> <div class="links"><br/> <h3>More about Nostr</h3><br/> <ul><br/> <li><a href="<a href="https://nostr.com">nostr.com</a></li>">https://nostr.com">nostr.com</a></li></a>;<br/> <li><a href="<a href="https://nostr.org">nostr.org</a></li>">https://nostr.org">nostr.org</a></li></a>;<br/> <li><a href="<a href="https://nostr.how/en/what-is-nostr">nostr.how/en/what-is-nostr</a></li>">https://nostr.how/en/what-is-nostr">nostr.how/en/what-is-nostr</a></li></a>;<br/> </ul><br/> </div><br/> </div><br/> <div class="footer"><br/> <p>Built with ❤️ for the decentralized future</p><br/> </div><br/> </div><br/> </body><br/></html><br/>
2026-10-09T01:53:41Zhttps://njump.me/nevent1qqspm87lmzjun2hclppdjav36u9lyjv4zl73fkvr0xd6zwsxmac8luqzyp2xhcyfwmc3jdu98up2074n3zznz6ye259qzdm0pp7qwhqtg2z6jefmrns# Closes an Open or Drafted Patch > `n34 patch close` command ...
# Closes an Open or Drafted Patch<br/><br/>> `n34 patch close` command<br/><br/>**Usage:**<br/>```<br/>Closes an open or drafted patch<br/><br/>Usage: n34 patch close [OPTIONS] <PATCH_ID><br/><br/>Arguments:<br/> <PATCH_ID> The open/drafted patch id to close it. Must be orignal root patch<br/><br/>Options:<br/> --repo <NADDR-NIP05-OR-SET> Repository address in `naddr` format (`naddr1...`), NIP-05 format (`4rs.nl/n34` or `_@4rs.nl/n34`), or a set name like `kernel`<br/>```<br/><br/>Issue a kind `1632` (Close status) for the specified patch. The patch have to<br/>be open or drafted.<br/><br/>
2026-10-09T01:53:41Zhttps://njump.me/nevent1qqspf7wjwgdj82vflsc3ee85gjr60mzp3092u8l9s3hemsq9spkhc2czyp2xhcyfwmc3jdu98up2074n3zznz6ye259qzdm0pp7qwhqtg2z6jw8ejnn# Patch Management In `n34`, patch management is designed to give ...
# Patch Management<br/><br/>In `n34`, patch management is designed to give you complete control. You can<br/>manually generate patch files using `git-format-patch` and then broadcast them<br/>to Nostr relays. This ensures that you have full authority over the content<br/>and structure of your patches, allowing for precise customization as per your<br/>requirements.<br/><br/>Similarly, when fetching patches, `n34` provides them to you without<br/>automatically applying, merging, or checking them. This empowers you to review<br/>the patches at your own pace and decide whether to merge or apply them as<br/>needed. You retain full control over the entire process, ensuring a tailored<br/>approach to patch management.<br/><br/>## Patch Status Management<br/><br/>You can assign a status to original patches, but revision patches do not have<br/>a specific status assigned to them. Instead, they inherit the status of the<br/>original patch. However, if the original patch is marked as `Applied/Merged`,<br/>the revision patch must be explicitly tagged to claim the same status. If not<br/>tagged, the revision patch status will be `Closed`.<br/>
2026-10-09T01:53:41Zhttps://njump.me/nevent1qqspf0erpej5p6xm0q3tacnqv3jfvtrpfv5g9a7ua87n3jpnuxsgrfqzyp2xhcyfwmc3jdu98up2074n3zznz6ye259qzdm0pp7qwhqtg2z6jq34aas# Issue Management Using `n34`, you can manage Git issues stored ...
# Issue Management<br/><br/>Using `n34`, you can manage Git issues stored in Nostr relays, adhering to<br/>the [NIP-34] standard. In Nostr, events are immutable, meaning their IDs are<br/>derived from the SHA-256 hash of their timestamp, content, author, and tags.<br/>As a result, issues cannot be edited directly. However, with `n34`, you can<br/>create new issues, view existing ones, or update their status—such as closing,<br/>resolving, or reopening them.<br/><br/>[NIP-34] introduces support for drafting issues, though this feature is not<br/>currently implemented in `n34` due to the lack of a clear use case for drafting<br/>issues. The inclusion of this functionality may stem from its shared use in both<br/>issues and patches, suggesting it was primarily designed for patch management.<br/><br/>[NIP-34]: <a href="https://github.com/nostr-protocol/nips/blob/master/34.md">https://github.com/nostr-protocol/nips/blob/master/34.md</a><br/>
2026-10-09T01:53:41Zhttps://njump.me/nevent1qqsp9raedtthxexa2zrhcdn343xn08c7shehlcttyuled2tvnhcvgfszyp2xhcyfwmc3jdu98up2074n3zznz6ye259qzdm0pp7qwhqtg2z6j66vwrj# Reopen a Closed Issue > `n34 issue reopen` command ...
# Reopen a Closed Issue<br/><br/>> `n34 issue reopen` command<br/><br/>**Usage:**<br/>```<br/>Reopens a closed issue<br/><br/>Usage: n34 issue reopen [OPTIONS] <ISSUE_ID><br/><br/>Arguments:<br/> <ISSUE_ID> The ID of the closed issue to reopen<br/><br/>Options:<br/> --repo <NADDR-NIP05-OR-SET> Repository address in `naddr` format (`naddr1...`), NIP-05 format (`4rs.nl/n34` or `_@4rs.nl/n34`), or a set name like `kernel`<br/>```<br/><br/>Issue a kind `1630` (Open status) for the specified issue. The issue have to<br/>be closed.<br/>
2026-10-09T01:53:41Zhttps://njump.me/nevent1qqsqa43hp70qy5vvuwtu4w9vyx3kxj6zm0smnztazp4zs4t0n7zaqdczyp2xhcyfwmc3jdu98up2074n3zznz6ye259qzdm0pp7qwhqtg2z6j7cw0al# Create an Issue > `n34 issue new` Command **Usage:** ``` ...
# Create an Issue<br/><br/>> `n34 issue new` Command<br/><br/>**Usage:**<br/>```<br/>Create a new repository issue<br/><br/>Usage: n34 issue new [OPTIONS] <--content <CONTENT>|--editor><br/><br/>Options:<br/> --repo <NADDR-NIP05-OR-SET> Repository address in `naddr` format (`naddr1...`), NIP-05 format (`4rs.nl/n34` or `_@4rs.nl/n34`), or a set name like `kernel`<br/> -c, --content <CONTENT> Markdown content for the issue. Cannot be used together with the `--editor` flag<br/> -e, --editor Opens the user's default editor to write issue content. The first line will be used as the issue subject<br/> --subject <SUBJECT> The issue subject. Cannot be used together with the `--editor` flag<br/> -l, --label <LABEL> Labels for the issue. Can be specified as arguments (-l bug) or hashtags in content (#bug)<br/>```<br/><br/>Use the `n34 issue new` command to create a new issue in a repository. This<br/>command supports the [NIP-21] (`nostr:` URI scheme) and hashtags within the<br/>issue content. When you mention public keys in the content, they will be<br/>included in the event tags. Additionally, using hashtags like `#bug` in the<br/>issue body will automatically apply them as labels.<br/><br/>You must choose between the `--content` and `--editor` options. With<br/>`--content`, you provide the issue content directly in the command. With<br/>`--editor`, your default `$EDITOR` will open, allowing you to write the issue<br/>content. The first line of the editor's output will be used as the issue<br/>subject.<br/>
2026-10-09T01:53:41Zhttps://njump.me/nevent1qqsymjxz0ts2k7ks3c75j3j2ww382fn3sal4me3qvgt06gvdpu2ywfczyp2xhcyfwmc3jdu98up2074n3zznz6ye259qzdm0pp7qwhqtg2z6j85pmc6# Secret Key Keyring > `n34 config keyring` command **Usage:** ...
# Secret Key Keyring<br/><br/>> `n34 config keyring` command<br/><br/>**Usage:**<br/>```<br/>Manages the secret key keyring, including enabling, disabling, or resetting it.<br/><br/>Usage: n34 config keyring <--enable|--disable|--reset><br/><br/>Options:<br/> --enable Enables the secret key keyring. You will be prompted for your key one last time to store it.<br/> --disable Disables the secret key keyring. This removes the stored key and prevents new ones from being saved.<br/> --reset Resets the keyring. This deletes the current key, allowing a new one to be stored on the next use.<br/>```<br/><br/>To avoid entering your private key for every command, you can enable the keyring<br/>to store it securely. First, run `n34 config keyring --enable`. The next time<br/>you run an `n34` command that requires your private key, it will be saved<br/>to your system's keyring. You will not need to enter it again for subsequent<br/>commands.<br/><br/>To replace the stored key with a new one, use the `--reset` flag. To stop using<br/>the keyring and remove the stored key, use the `--disable` flag.<br/><br/>`n34` uses your operating system's native secret management system. For example,<br/>it uses `keyutils` on Linux and `Keychain` on macOS.<br/>
2026-10-09T01:53:21Zhttps://njump.me/nevent1qqsr6sxlhy9tm6k676sl82wvvs9kkkrmsrw52enk4aw5qrl0nhwc4uszyp2xhcyfwmc3jdu98up2074n3zznz6ye259qzdm0pp7qwhqtg2z6jug5ut6# NIP-46 Bunker > `n34 config bunker` command **Usage:** ``` ...
# NIP-46 Bunker<br/><br/>> `n34 config bunker` command<br/><br/>**Usage:**<br/>```<br/>Sets a URL of NIP-46 bunker server used for signing events<br/><br/>Usage: n34 config bunker [BUNKER_URL]<br/><br/>Arguments:<br/> [BUNKER_URL] Nostr Connect URL for the bunker. Omit this to remove the current bunker URL<br/>```<br/><br/>This command configures `n34` to use a remote signer ([NIP-46]), known as a<br/>bunker, for all cryptographic operations.<br/><br/>When `n34` communicates with the bunker, it uses a persistent, locally-generated<br/>keypair. You should add this keypair's public key to your bunker's list of<br/>authorized applications. This allows `n34` to operate securely without needing<br/>direct access to your main private key.<br/><br/>Once configured, actions such as fetching your public key or signing events are<br/>delegated to the bunker. To remove the bunker configuration, run the command<br/>again without providing a URL.<br/><br/>[NIP-46]: <a href="https://github.com/nostr-protocol/nips/blob/master/46.md">https://github.com/nostr-protocol/nips/blob/master/46.md</a><br/>
2026-10-09T01:53:18Z