Struct NostrClient 

pub struct NostrClient { /* private fields */ }

Nostr client for git operations

Implementations

impl NostrClient

pub fn new( pubkey: &str, secret_key: Option<String>, url_secret: Option<[u8; 32]>, is_private: bool, config: &Config, ) -> Result<Self>

Create a new client with pubkey, optional secret key, url secret, is_private flag, and config

pub fn can_sign(&self) -> bool

Check if we can sign (have secret key for this pubkey)

pub fn list_repos(&self) -> Result<Vec<String>>

pub async fn list_repos_async(&self) -> Result<Vec<String>>

pub fn fetch_refs(&mut self, repo_name: &str) -> Result<HashMap<String, String>>

Fetch refs for a repository from nostr Returns refs parsed from the hashtree at the root hash

pub fn fetch_refs_quick( &mut self, repo_name: &str, ) -> Result<HashMap<String, String>>

Fetch refs with a quick timeout (3s) for push operations Returns empty if timeout - allows push to proceed

pub fn fetch_refs_with_root( &mut self, repo_name: &str, ) -> Result<(HashMap<String, String>, Option<String>, Option<[u8; 32]>)>

Fetch refs and root hash info from nostr Returns (refs, root_hash, encryption_key)

pub fn update_ref( &mut self, repo_name: &str, ref_name: &str, sha: &str, ) -> Result<()>

Update a ref in local cache (will be published with publish_repo)

pub fn delete_ref(&mut self, repo_name: &str, ref_name: &str) -> Result<()>

Delete a ref from local cache

pub fn get_cached_root_hash(&self, repo_name: &str) -> Option<&String>

Get cached root hash for a repository

pub fn get_cached_encryption_key(&self, repo_name: &str) -> Option<&[u8; 32]>

Get cached encryption key for a repository

pub fn blossom(&self) -> &BlossomClient

Get the Blossom client for direct downloads

pub fn relay_urls(&self) -> Vec<String>

Get the configured relay URLs

pub fn pubkey(&self) -> &str

Get the public key (hex)

pub fn npub(&self) -> String

Get the public key as npub bech32

pub fn publish_repo( &self, repo_name: &str, root_hash: &str, encryption_key: Option<(&[u8; 32], bool, bool)>, ) -> Result<(String, RelayResult)>

Publish repository to nostr as kind 30078 event Format: kind: 30078 tags: [[“d”, repo_name], [“l”, “hashtree”], [“hash”, root_hash], [“key”|“encryptedKey”, encryption_key]] content: Returns: (npub URL, relay result with connected/failed details) If is_private is true, uses “encryptedKey” tag (XOR masked); otherwise uses “key” tag (plaintext CHK)

pub fn fetch_prs( &self, repo_name: &str, state_filter: PullRequestStateFilter, ) -> Result<Vec<PullRequestListItem>>

Fetch pull requests targeting this repo, filtered by state.

pub async fn fetch_prs_async( &self, repo_name: &str, state_filter: PullRequestStateFilter, ) -> Result<Vec<PullRequestListItem>>

pub fn publish_pr_merged_status( &self, pr_event_id: &str, pr_author_pubkey: &str, ) -> Result<()>

Publish a kind 1631 (STATUS_APPLIED) event to mark a PR as merged

pub async fn upload_blob(&self, _hash: &str, data: &[u8]) -> Result<String>

Upload blob to blossom server

pub async fn upload_blob_if_missing( &self, data: &[u8], ) -> Result<(String, bool)>

Upload blob only if it doesn’t exist

pub async fn download_blob(&self, hash: &str) -> Result<Vec<u8>>

Download blob from blossom server

pub async fn try_download_blob(&self, hash: &str) -> Option<Vec<u8>>

Try to download blob, returns None if not found