Struct PaygressClient 

pub struct PaygressClient { /* private fields */ }

Builder for a Paygress consumer SDK client. Wraps the existing DiscoveryClient with typed write-side operations.

Implementations

impl PaygressClient

pub async fn new(relays: Vec<String>, private_key: String) -> Result<Self>

Construct against the given relays and a Nostr private key (nsec1... or hex). The key is required for any operation that sends a DM (spawn / topup / status); read-only queries would also work without one but this constructor unifies the path so callers don’t need two clients.

pub fn with_response_timeout_secs(self, secs: u64) -> Self

Override how long each round-trip waits for a provider response. Defaults to 60s.

pub fn with_message_type(self, message_type: impl Into<String>) -> Self

Override the encryption mode used for outbound DMs ("nip04" or "nip17"). Defaults to nip04. NIP-17 gift-wrap is sender-anonymous but supported by fewer relays.

pub fn npub(&self) -> String

Consumer’s npub (handy for receipts).

pub fn discovery(&self) -> &DiscoveryClient

Underlying discovery client for read-only queries.

pub async fn list_offers( &self, filter: Option<ProviderFilter>, ) -> Result<Vec<ProviderInfo>>

Discover providers matching an optional filter.

pub async fn spawn( &self, provider_npub: &str, request: SpawnRequest, ) -> Result<SpawnOutcome>

Send a spawn request and wait for the provider’s response.

pub async fn topup( &self, provider_npub: &str, request: TopupRequest, ) -> Result<TopupOutcome>

Send a top-up request and wait for the provider’s response.

pub async fn status( &self, provider_npub: &str, pod_id: String, ) -> Result<StatusOutcome>

Send a status query and wait for the provider’s response.