using-nostr

NOSTR Posting Skill

Using nostr-sdk library

Source: https://github.com/besoeasy/nostr-sdk

Overview

Post messages, send encrypted DMs, and interact with the Nostr decentralized social protocol using minimal direct exports from the nostr-sdk module.

Installation:

npm install nostr-sdk

Key Concepts:

• nsec: Private key in bech32 format (starts with nsec1)
• npub: Public key in bech32 format (starts with npub1)
• Relays: WebSocket servers that propagate Nostr events
• Events: Signed JSON objects representing posts, DMs, etc.
• POW: Proof of Work (mining) to reduce spam

Default Relays:

• wss://relay.damus.io
• wss://nos.lol
• wss://relay.snort.social
• wss://nostr-pub.wellorder.net
• wss://nostr.oxtr.dev
• And 9+ more for maximum reach

---

Skills

post_public_note

Post a public text note to Nostr.

Usage:

const { posttoNostr } = require("nostr-sdk");

const result = await posttoNostr("Hello Nostr! #introduction", {
  nsec: "nsec1...your-private-key",
  tags: [],
  relays: null,
  powDifficulty: 4
});
console.log(result);

Parameters:

• message: Text content to post
• tags: Optional array of tags (e.g., [['t', 'topic']])
• relays: Optional custom relay list (uses defaults if null)
• powDifficulty: Proof of work difficulty (default: 4, 0 to disable)

Auto-extracted Tags:

• Hashtags: #nostr → ["t", "nostr"]
• Mentions: @npub1... → ["p", <pubkey>]
• Links: URLs automatically preserved
• Notes: note1... references → ["e", <event-id>]

Response:

{
  success: true,
  eventId: "abc123...",
  published: 12,      // Successfully published to 12 relays
  failed: 2,          // Failed on 2 relays
  totalRelays: 14,
  powDifficulty: 4,
  errors: []
}

When to use:

• User wants to post a public message
• Sharing content with hashtags
• Broadcasting announcements

---

reply_to_post

Reply to an existing Nostr post.

Usage:

const { replyToPost } = require("nostr-sdk");

const result = await replyToPost(
  "note1...event-id",           // Event ID (note or hex format)
  "Great post! @npub1...author", // Reply message
  "npub1...author-pubkey",      // Author's public key
  [],                           // Additional tags
  null,                         // Use default relays
  4                             // POW difficulty
);