7. Publishing Events

The final step in building a Nostr app is publishing your events to relays so other users can see them. The RelayPool provides methods for publishing events and handling the responses from relays.

What is Publishing?

Publishing is the process of:

• Sending signed events to relays - Broadcasting your content to the network
• Handling relay responses - Success, errors, or rejection messages
• Managing multiple relays - Publishing to several relays for redundancy
• Providing user feedback - Showing publication status to users

Basic Event Publishing

Here's how to publish a single event to a relay using the pool.relay method to select a single relay and the publish method to publish the event.

const pool = new RelayPool();

const event: NostrEvent = {
  // ...signed nostr event
};

pool
  .relay("wss://relay.damus.io")
  .publish(event)
  .subscribe((response) => {
    if (response.ok) {
      console.log(`Event published successfully to ${response.from}`);
    } else {
      console.log(`Failed to publish event to ${response.from}: ${response.reason}`);
    }
  });

WARNING

Since the publish method returns an Observable, you must subscribe to it for the relay connection to be established and the event to be published.

Publishing to Multiple Relays

For better reach and redundancy the pool.publish method can be used with multiple relays.

const relays = ["wss://relay.damus.io", "wss://nos.lol", "wss://relay.nostr.band"];
const event: NostrEvent = {
  // ...signed nostr event
};

pool.publish(relays, event).subscribe({
  next: (response) => {
    if (response.ok) {
      console.log(`Event published successfully to ${response.from}`);
    } else {
      console.log(`Failed to publish event to ${response.from}: ${response.reason}`);
    }
  },
  complete: () => {
    console.log("Finished publishing to all relays");
  },
});

Adding Events to the EventStore

Once the event is published to relays, its good to add it to the event store so your UI can see it without needing to load it from the relay again.

pool
  .relay("wss://relay.damus.io")
  .publish(event)
  .subscribe({
    complete: () => {
      eventStore.add(event);
    },
  });

Key Concepts

• Publishing sends events to relays so others can see them
• Handle relay responses - success, errors, or rejections
• Publish to multiple relays for better reach and redundancy
• Add published events to EventStore to see them in your UI
• Provide user feedback about publishing status
• Handle errors gracefully with retry logic

Best Practices

1. Always publish to multiple relays for redundancy
2. Handle rate limiting with delays and retries
3. Provide clear user feedback about publishing status
4. Add published events to EventStore immediately
5. Don't spam relays - use reasonable delays between publishes
6. Cache failed publishes and retry later if needed