nostr-direct-messages

Implement Nostr direct messaging with NIP-04 and NIP-17 encryption.

Updated Jan 25, 2026
One-click install
npx skills add https://github.com/feelancer21/nodestr --skill nostr-direct-messages-feelancer21
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: nostr-direct-messages
Source: https://github.com/feelancer21/nodestr/tree/main/.claude/skills/nostr-direct-messages
Command: npx skills add https://github.com/feelancer21/nodestr --skill nostr-direct-messages-feelancer21

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

This Skill enables secure, end-to-end encrypted direct messaging on the Nostr protocol, facilitating private peer-to-peer communication.

Core Features & Use Cases

  • NIP-04 & NIP-17 Support: Implements both legacy (NIP-04) and modern, private (NIP-17) encryption standards.
  • Real-time Chat: Provides real-time message updates and subscriptions.
  • Cache-First UI: Ensures instant message loading from local storage.
  • File Sending: Allows users to send encrypted files along with messages.
  • Use Case: Build a fully functional chat application within a Nostr client, allowing users to exchange private messages and files securely.

Quick Start

Configure the DMProvider in your App.tsx with enabled: true and your desired protocolMode.

Frequently Asked Questions about nostr-direct-messages

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I implement end-to-end encrypted Nostr direct messaging in my chat application?

To implement Nostr direct messaging, configure the DMProvider in your App.tsx with enabled set to true and your desired protocolMode. This enables secure peer-to-peer communication using NIP-04 and NIP-17 encryption standards.

What is the difference between NIP-04 and NIP-17 for Nostr private messaging?

NIP-04 is the legacy encryption standard for Nostr private messaging, while NIP-17 represents the modern approach. This Skill supports both protocols, allowing you to select your preferred protocolMode during DMProvider configuration.

Can I send encrypted files through Nostr peer-to-peer chat?

Yes, you can send encrypted files through Nostr peer-to-peer chat. The Skill provides specific hooks that allow users to send encrypted file attachments alongside their direct messages.

How do I handle real-time message subscriptions and optimistic UI updates for a Nostr client?

You handle real-time message subscriptions and optimistic UI updates using the Skill's dedicated hooks. These hooks manage real-time message delivery while utilizing a cache-first local storage approach to ensure instant UI loading.

Does Nostr direct messaging work offline or require a constant connection to load conversations?

Nostr direct messaging does not require a constant connection to load conversations because it uses a cache-first local storage system. This persistent cache ensures instant message loading from local storage before fetching real-time updates.