nostr-client-patterns

What problem does it solve?

This skill provides a complete blueprint and implementation patterns for building a robust Nostr client, including relay pool management, subscription lifecycles, event deduplication, optimistic publishing, and resilient reconnection.

Core Features & Use Cases

• Relay pool management across multiple relays with per-relay state tracking, backoff and jitter, and per-connection lifecycle.
• Multi-relay subscription lifecycle with per-relay EOSE coordination, replacement of subscriptions, and reconnect-aware resubscription using a since timestamp.
• Deduplication and replacement handling for regular and replaceable events to ensure consistent UI state.
• Optimistic publishing with per-relay OK handling, retry strategies, and timeout fallbacks, plus local cache for fast loads.
• Reconnection handling that preserves state and ensures gap-free event delivery across relaunches.
• Optional local caching strategies to speed up initial loads and reduce network usage.

Quick Start

Ask your agent to implement a Nostr client using the nostr-client-patterns blueprint, wiring in relay management, subscription lifecycles, and optimistic publishing.