Struct nostr_sdk::relay::Relay

pub struct Relay { /* private fields */ }

Relay

Implementations

impl Relay

pub fn new( url: Url, pool_sender: Sender<RelayPoolMessage>, notification_sender: Sender<RelayPoolNotification>, proxy: Option<SocketAddr>, opts: RelayOptions ) -> Self

Create new Relay

pub fn url(&self) -> Url

Get relay url

pub fn proxy(&self) -> Option<SocketAddr>

Get proxy

pub async fn status(&self) -> RelayStatus

Get RelayStatus

pub async fn document(&self) -> RelayInformationDocument

Get RelayInformationDocument

pub async fn subscription(&self) -> ActiveSubscription

Get ActiveSubscription

pub async fn update_subscription_filters(&self, filters: Vec<Filter>)

Update ActiveSubscription

pub fn opts(&self) -> RelayOptions

Get RelayOptions

pub fn stats(&self) -> RelayConnectionStats

Get RelayConnectionStats

pub async fn connect(&self, wait_for_connection: bool)

Connect to relay and keep alive connection

pub async fn terminate(&self) -> Result<(), Error>

Disconnect from relay and set status to ‘Terminated’

pub async fn send_msg( &self, msg: ClientMessage, wait: bool ) -> Result<(), Error>

Send msg to relay

if wait arg is true, this method will wait for the msg to be sent

pub async fn subscribe( &self, filters: Vec<Filter>, wait: bool ) -> Result<SubscriptionId, Error>

Subscribe

pub async fn unsubscribe(&self, wait: bool) -> Result<(), Error>

Unsubscribe

pub async fn get_events_of_with_callback<F>( &self, filters: Vec<Filter>, timeout: Option<Duration>, callback: impl Fn(Event) -> F ) -> Result<(), Error>where F: Future<Output = ()>,

Get events of filters with custom callback

pub async fn get_events_of( &self, filters: Vec<Filter>, timeout: Option<Duration> ) -> Result<Vec<Event>, Error>

Get events of filters

pub fn req_events_of(&self, filters: Vec<Filter>, timeout: Option<Duration>)

Request events of filter. All events will be sent to notification listener, until the EOSE “end of stored events” message is received from the relay.

Trait Implementations

impl Clone for Relay

fn clone(&self) -> Relay

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Relay

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl PartialEq<Relay> for Relay

fn eq(&self, other: &Self) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.