Struct BaseTransport 

pub struct BaseTransport {
    pub relay_pool: Arc<dyn RelayPoolTrait>,
    pub encryption_mode: EncryptionMode,
    pub is_connected: bool,
}

Shared transport logic for both client and server.

Handles relay connectivity, event signing/publishing, encryption decisions, and MCP message validation. Used internally by NostrClientTransport and NostrServerTransport.

Fields

relay_pool: Arc<dyn RelayPoolTrait>

The relay pool for publishing and subscribing to Nostr events.

encryption_mode: EncryptionMode

The encryption policy for outgoing messages.

is_connected: bool

Whether the transport is currently connected to relays.

Implementations

impl BaseTransport

pub async fn connect(&mut self, relay_urls: &[String]) -> Result<()>

Connect to relays.

pub async fn disconnect(&mut self) -> Result<()>

Disconnect from relays.

pub async fn get_public_key(&self) -> Result<PublicKey>

Get the public key of the signer.

pub async fn subscribe_for_pubkey(&self, pubkey: &PublicKey) -> Result<()>

Subscribe to events targeting a pubkey (both regular and encrypted).

Uses three filters: one for ephemeral ContextVM messages (kind 25910) and two for NIP-59 gift wraps (kinds 1059 and 21059).

pub fn convert_event_to_mcp(&self, content: &str) -> Option<JsonRpcMessage>

Convert a Nostr event to an MCP message with validation.

pub async fn create_signed_event( &self, message: &JsonRpcMessage, kind: u16, tags: Vec<Tag>, ) -> Result<Event>

Create a signed Nostr event for an MCP message.

pub async fn prepare_mcp_message( &self, message: &JsonRpcMessage, recipient: &PublicKey, kind: u16, tags: Vec<Tag>, is_encrypted: Option<bool>, gift_wrap_kind: Option<u16>, ) -> Result<(EventId, Event)>

Prepare an MCP message for publishing without actually publishing it.

Signs (and optionally gift-wraps) the event, returning the inner signed event ID together with the final event that should be published to relays.

pub async fn send_mcp_message( &self, message: &JsonRpcMessage, recipient: &PublicKey, kind: u16, tags: Vec<Tag>, is_encrypted: Option<bool>, gift_wrap_kind: Option<u16>, ) -> Result<EventId>

Send an MCP message to a recipient, optionally encrypting.

Returns the signed MCP event ID. When encrypted, this is the inner signed event ID.

pub fn should_encrypt(&self, kind: u16, is_encrypted: Option<bool>) -> bool

Determine whether a message should be encrypted.

pub fn create_recipient_tags(pubkey: &PublicKey) -> Vec<Tag>

Create recipient tags for targeting a specific pubkey.

pub fn create_response_tags(pubkey: &PublicKey, event_id: &EventId) -> Vec<Tag>

Create response tags (recipient + correlated event).

pub fn compose_outbound_tags( base_tags: &[Tag], discovery_tags: &[Tag], negotiation_tags: &[Tag], ) -> Vec<Tag>

Compose outbound event tags in canonical order: routing (p, e) -> discovery (one-shot caps) -> negotiation (pmi, persistent).