Nostr.Connection (nostr_access v0.3.3)

WebSocket connection to a Nostr relay with subscription management.

Summary

Closes a subscription.

Checks if the connection has free slots.

Publishes a Nostr event to the relay. The caller will receive {:pub_ack, conn_pid, event_id, success?, message}.

Sends a filter to the relay.

Starts a new connection to a relay.

@spec close_subscription(pid(), String.t()) :: :ok

Closes a subscription.

@spec has_free_slot?(pid()) :: boolean()

Checks if the connection has free slots.

@spec publish_event(pid(), pid(), map()) :: :ok

Publishes a Nostr event to the relay. The caller will receive {:pub_ack, conn_pid, event_id, success?, message}.

@spec send_filter(pid(), pid(), String.t(), map()) :: :ok | {:error, :no_slots}

Sends a filter to the relay.

@spec start_link(String.t(), pid()) :: {:ok, pid()} | {:error, term()}

Starts a new connection to a relay.