node-red-contrib-nostr 0.1.0

package/dist/types.d.ts

@@ -0,0 +1,34 @@
+import { Node, NodeDef } from 'node-red';
+export interface NostrRelayConfigNode extends Node {
+    name: string;
+    url: string;
+    proxy?: boolean;
+    proxyUrl?: string;
+}
+export interface NostrRelayConfig extends NodeDef {
+    name: string;
+    url: string;
+    proxy?: boolean;
+    proxyUrl?: string;
+}
+export interface NostrFilterConfig extends NodeDef {
+    name: string;
+    relay: string;
+    kinds?: number[];
+    authors?: string[];
+    tags?: {
+        [key: string]: string[];
+    };
+    since?: number;
+    until?: number;
+    limit?: number;
+}
+export interface NostrRelayNodeConfig extends NodeDef {
+    name: string;
+    relay: string;
+    kind?: number;
+    content?: string;
+    tags?: {
+        [key: string]: string[];
+    };
+}

package/dist/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/utils/nip19.d.ts

@@ -0,0 +1,8 @@
+export declare class NIP19 {
+    static npubEncode(pubkey: string): string;
+    static npubDecode(npub: string): string;
+    static nsecEncode(privkey: string): string;
+    static nsecDecode(nsec: string): string;
+    static noteEncode(id: string): string;
+    static noteDecode(note: string): string;
+}

package/dist/utils/nip19.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NIP19 = void 0;
+const bech32_1 = require("bech32");
+class NIP19 {
+    static npubEncode(pubkey) {
+        const words = bech32_1.bech32.toWords(Buffer.from(pubkey, 'hex'));
+        return bech32_1.bech32.encode('npub', words);
+    }
+    static npubDecode(npub) {
+        const { words } = bech32_1.bech32.decode(npub);
+        const bytes = Buffer.from(bech32_1.bech32.fromWords(words));
+        return bytes.toString('hex');
+    }
+    static nsecEncode(privkey) {
+        const words = bech32_1.bech32.toWords(Buffer.from(privkey, 'hex'));
+        return bech32_1.bech32.encode('nsec', words);
+    }
+    static nsecDecode(nsec) {
+        const { words } = bech32_1.bech32.decode(nsec);
+        const bytes = Buffer.from(bech32_1.bech32.fromWords(words));
+        return bytes.toString('hex');
+    }
+    static noteEncode(id) {
+        const words = bech32_1.bech32.toWords(Buffer.from(id, 'hex'));
+        return bech32_1.bech32.encode('note', words);
+    }
+    static noteDecode(note) {
+        const { words } = bech32_1.bech32.decode(note);
+        const bytes = Buffer.from(bech32_1.bech32.fromWords(words));
+        return bytes.toString('hex');
+    }
+}
+exports.NIP19 = NIP19;

package/dist/utils/validation.d.ts

@@ -0,0 +1,8 @@
+export declare class Validation {
+    static isValidHexString(str: string): boolean;
+    static isValidPubkey(pubkey: string): boolean;
+    static isValidEventId(id: string): boolean;
+    static isValidSignature(signature: string): boolean;
+    static isValidRelayUrl(url: string): boolean;
+    static isValidTimestamp(timestamp: number): boolean;
+}

package/dist/utils/validation.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Validation = void 0;
+class Validation {
+    static isValidHexString(str) {
+        return /^[0-9a-f]+$/i.test(str);
+    }
+    static isValidPubkey(pubkey) {
+        return this.isValidHexString(pubkey) && pubkey.length === 64;
+    }
+    static isValidEventId(id) {
+        return this.isValidHexString(id) && id.length === 64;
+    }
+    static isValidSignature(signature) {
+        return this.isValidHexString(signature) && signature.length === 128;
+    }
+    static isValidRelayUrl(url) {
+        try {
+            const parsed = new URL(url);
+            return parsed.protocol === 'wss:' || parsed.protocol === 'ws:';
+        }
+        catch {
+            return false;
+        }
+    }
+    static isValidTimestamp(timestamp) {
+        const now = Math.floor(Date.now() / 1000);
+        return timestamp > 0 && timestamp <= now;
+    }
+}
+exports.Validation = Validation;

package/examples/basic-relay.json

@@ -0,0 +1,48 @@
+{
+    "id": "basic-nostr-flow",
+    "label": "Basic Nostr Flow",
+    "nodes": [
+        {
+            "id": "relay1",
+            "type": "nostr-relay",
+            "name": "Damus Relay",
+            "relayUrl": "wss://relay.damus.io",
+            "x": 380,
+            "y": 120,
+            "wires": [["output1"]]
+        },
+        {
+            "id": "input1",
+            "type": "inject",
+            "name": "Subscribe to Events",
+            "props": [
+                {
+                    "p": "payload",
+                    "v": "[{\"kinds\":[1],\"limit\":5}]",
+                    "vt": "json"
+                },
+                {
+                    "p": "type",
+                    "v": "subscribe",
+                    "vt": "str"
+                }
+            ],
+            "repeat": "",
+            "crontab": "",
+            "once": false,
+            "x": 180,
+            "y": 120,
+            "wires": [["relay1"]]
+        },
+        {
+            "id": "output1",
+            "type": "debug",
+            "name": "Debug Output",
+            "active": true,
+            "complete": "true",
+            "x": 580,
+            "y": 120,
+            "wires": []
+        }
+    ]
+}

package/examples/jack-monitor.json

@@ -0,0 +1,69 @@
+{
+    "name": "Monitor Jack's Posts",
+    "nodes": [
+        {
+            "id": "relay-config",
+            "type": "nostr-relay-config",
+            "name": "Main Relays",
+            "relay1": "wss://relay.damus.io",
+            "relay2": "wss://nos.lol",
+            "relay3": "wss://relay.nostr.band",
+            "pingInterval": 30
+        },
+        {
+            "id": "jack-monitor",
+            "type": "nostr-relay",
+            "name": "Jack's Posts",
+            "relayConfig": "relay-config",
+            "npub": "npub1sg6plzptd64u62a878hep2kev88swjh3tw00gjsfl8yz5tc68qysh7j4xz",
+            "eventKinds": [1],
+            "x": 280,
+            "y": 120,
+            "wires": [["format-post"]]
+        },
+        {
+            "id": "format-post",
+            "type": "function",
+            "name": "Format Post",
+            "func": "const event = msg.payload;\n\n// Format the timestamp\nconst date = new Date(event.created_at * 1000);\nconst timeStr = date.toLocaleString();\n\n// Format the content (handle markdown, links, etc)\nlet content = event.content;\n\n// Extract any URLs\nconst urls = content.match(/https?:\\/\\/[^\\s]+/g) || [];\n\n// Create a nicely formatted message\nmsg.payload = {\n    time: timeStr,\n    content: content,\    urls: urls,\n    id: event.id,\n    replyTo: event.tags.find(t => t[0] === 'e')?.[1]\n};\n\n// Add a topic for easy filtering\nmsg.topic = 'jack_post';\n\nreturn msg;",
+            "outputs": 1,
+            "x": 480,
+            "y": 120,
+            "wires": [["debug", "dashboard"]]
+        },
+        {
+            "id": "debug",
+            "type": "debug",
+            "name": "Debug Output",
+            "active": true,
+            "tosidebar": true,
+            "console": false,
+            "tostatus": false,
+            "complete": "payload",
+            "targetType": "msg",
+            "statusVal": "",
+            "statusType": "auto",
+            "x": 670,
+            "y": 80,
+            "wires": []
+        },
+        {
+            "id": "dashboard",
+            "type": "ui_template",
+            "name": "Posts Dashboard",
+            "group": "Posts",
+            "order": 1,
+            "width": "12",
+            "height": "8",
+            "format": "<div ng-repeat=\"post in msg.payload\" class=\"post-card\">\n  <div class=\"post-time\">{{post.time}}</div>\n  <div class=\"post-content\">{{post.content}}</div>\n  <div class=\"post-links\" ng-if=\"post.urls.length > 0\">\n    <div ng-repeat=\"url in post.urls\">\n      <a href=\"{{url}}\" target=\"_blank\">{{url}}</a>\n    </div>\n  </div>\n</div>",
+            "storeOutMessages": true,
+            "fwdInMessages": true,
+            "resendOnRefresh": true,
+            "templateScope": "local",
+            "className": "",
+            "x": 670,
+            "y": 160,
+            "wires": [[]]
+        }
+    ]
+}

package/examples/multi-user-monitor.json

@@ -0,0 +1,129 @@
+{
+    "name": "Multi-User Nostr Monitor",
+    "nodes": [
+        {
+            "id": "relay-config",
+            "type": "nostr-relay-config",
+            "name": "Main Relays",
+            "relay1": "wss://relay.damus.io",
+            "relay2": "wss://nos.lol",
+            "relay3": "wss://relay.nostr.band",
+            "pingInterval": 30
+        },
+        {
+            "id": "npub-list",
+            "type": "function",
+            "name": "NPub List",
+            "func": "// List of NPubs to monitor (example list - replace with actual NPubs)\nconst npubs = [\n    'npub1sg6plzptd64u62a878hep2kev88swjh3tw00gjsfl8yz5tc68qysh7j4xz', // Jack\n    'npub1qny3tkh0acurzla8x3zy4nhrjz5zd8l9sy9jys09umwng00manysew95gx', // Snowden\n    'npub1xtscya34g58tk0z605fvr788k263gsu6cy9x0mhnm87echrgufzsevkk5s'  // Saylor\n];\n\n// Send each NPub to a different output\nnpubs.forEach((npub, index) => {\n    node.send({ payload: npub, topic: `user_${index}` });\n});\n",
+            "outputs": 21,
+            "x": 130,
+            "y": 120,
+            "wires": [
+                ["monitor-1"], ["monitor-2"], ["monitor-3"],
+                ["monitor-4"], ["monitor-5"], ["monitor-6"],
+                ["monitor-7"], ["monitor-8"], ["monitor-9"],
+                ["monitor-10"], ["monitor-11"], ["monitor-12"],
+                ["monitor-13"], ["monitor-14"], ["monitor-15"],
+                ["monitor-16"], ["monitor-17"], ["monitor-18"],
+                ["monitor-19"], ["monitor-20"], ["monitor-21"]
+            ]
+        },
+        {
+            "id": "monitor-1",
+            "type": "nostr-relay",
+            "name": "User 1",
+            "relayConfig": "relay-config",
+            "x": 280,
+            "y": 120,
+            "wires": [["event-router"]]
+        },
+        {
+            "id": "event-router",
+            "type": "function",
+            "name": "Event Router",
+            "func": "// Route events based on kind\nconst event = msg.payload;\n\nswitch(event.kind) {\n    case 1:  // Text notes\n        return [msg, null, null];\n    case 6:  // Reposts\n        return [null, msg, null];\n    case 7:  // Reactions\n        return [null, null, msg];\n    default:\n        return [null, null, null];\n}",
+            "outputs": 3,
+            "x": 480,
+            "y": 120,
+            "wires": [
+                ["text-filter"],
+                ["repost-filter"],
+                ["reaction-filter"]
+            ]
+        },
+        {
+            "id": "text-filter",
+            "type": "nostr-filter",
+            "name": "Text Notes",
+            "filterType": "kind",
+            "eventKinds": [1],
+            "x": 680,
+            "y": 80,
+            "wires": [["format-text"]]
+        },
+        {
+            "id": "repost-filter",
+            "type": "nostr-filter",
+            "name": "Reposts",
+            "filterType": "kind",
+            "eventKinds": [6],
+            "x": 680,
+            "y": 120,
+            "wires": [["format-repost"]]
+        },
+        {
+            "id": "reaction-filter",
+            "type": "nostr-filter",
+            "name": "Reactions",
+            "filterType": "kind",
+            "eventKinds": [7],
+            "x": 680,
+            "y": 160,
+            "wires": [["format-reaction"]]
+        },
+        {
+            "id": "format-text",
+            "type": "function",
+            "name": "Format Text Note",
+            "func": "const event = msg.payload;\n\nconst formatted = {\n    type: 'text',\n    time: new Date(event.created_at * 1000).toLocaleString(),\n    content: event.content,\n    author: event.pubkey,\n    id: event.id,\n    urls: event.content.match(/https?:\\/\\/[^\\s]+/g) || [],\n    tags: event.tags\n};\n\nmsg.payload = formatted;\nreturn msg;",
+            "x": 880,
+            "y": 80,
+            "wires": [["dashboard"]]
+        },
+        {
+            "id": "format-repost",
+            "type": "function",
+            "name": "Format Repost",
+            "func": "const event = msg.payload;\n\nconst formatted = {\n    type: 'repost',\n    time: new Date(event.created_at * 1000).toLocaleString(),\n    content: event.content,\n    author: event.pubkey,\n    originalPost: event.tags.find(t => t[0] === 'e')?.[1],\n    id: event.id\n};\n\nmsg.payload = formatted;\nreturn msg;",
+            "x": 880,
+            "y": 120,
+            "wires": [["dashboard"]]
+        },
+        {
+            "id": "format-reaction",
+            "type": "function",
+            "name": "Format Reaction",
+            "func": "const event = msg.payload;\n\nconst formatted = {\n    type: 'reaction',\n    time: new Date(event.created_at * 1000).toLocaleString(),\n    content: event.content,\n    author: event.pubkey,\n    targetPost: event.tags.find(t => t[0] === 'e')?.[1],\n    id: event.id\n};\n\nmsg.payload = formatted;\nreturn msg;",
+            "x": 880,
+            "y": 160,
+            "wires": [["dashboard"]]
+        },
+        {
+            "id": "dashboard",
+            "type": "ui_template",
+            "name": "Interactive Dashboard",
+            "group": "Nostr Monitor",
+            "order": 1,
+            "width": "24",
+            "height": "12",
+            "format": "<div class=\"nostr-feed\">\n  <div ng-repeat=\"event in msg.payload | limitTo:50\" \n       class=\"event-card\" \n       ng-class=\"event.type\">\n    <div class=\"event-header\">\n      <span class=\"event-time\">{{event.time}}</span>\n      <span class=\"event-type\">{{event.type}}</span>\n    </div>\n    \n    <div class=\"event-content\" ng-if=\"event.type === 'text'\">\n      {{event.content}}\n      <div class=\"event-urls\" ng-if=\"event.urls.length > 0\">\n        <a ng-repeat=\"url in event.urls\" \n           href=\"{{url}}\" \n           target=\"_blank\">{{url}}</a>\n      </div>\n    </div>\n    \n    <div class=\"event-content\" ng-if=\"event.type === 'repost'\">\n      Reposted: {{event.originalPost}}\n      <div ng-if=\"event.content\">\n        Comment: {{event.content}}\n      </div>\n    </div>\n    \n    <div class=\"event-content\" ng-if=\"event.type === 'reaction'\">\n      Reacted to: {{event.targetPost}}\n      <div class=\"reaction-content\">\n        {{event.content}}\n      </div>\n    </div>\n    \n    <div class=\"event-footer\">\n      <span class=\"event-id\">{{event.id}}</span>\n    </div>\n  </div>\n</div>\n\n<style>\n.nostr-feed {\n  display: flex;\n  flex-direction: column;\n  gap: 1rem;\n  padding: 1rem;\n}\n\n.event-card {\n  border: 1px solid #ddd;\n  border-radius: 8px;\n  padding: 1rem;\n  background: white;\n  box-shadow: 0 2px 4px rgba(0,0,0,0.1);\n}\n\n.event-card.text { border-left: 4px solid #2196F3; }\n.event-card.repost { border-left: 4px solid #4CAF50; }\n.event-card.reaction { border-left: 4px solid #FF9800; }\n\n.event-header {\n  display: flex;\n  justify-content: space-between;\n  margin-bottom: 0.5rem;\n  color: #666;\n}\n\n.event-content {\n  margin: 1rem 0;\n  white-space: pre-wrap;\n}\n\n.event-urls {\n  margin-top: 0.5rem;\n}\n\n.event-urls a {\n  display: block;\n  color: #2196F3;\n  margin: 0.25rem 0;\n}\n\n.event-footer {\n  font-size: 0.8rem;\n  color: #999;\n  margin-top: 0.5rem;\n}\n</style>",
+            "storeOutMessages": true,
+            "fwdInMessages": true,
+            "resendOnRefresh": true,
+            "templateScope": "local",
+            "x": 1080,
+            "y": 120,
+            "wires": [[]]
+        }
+    ]
+}

package/locales/en-US/messages.json

@@ -0,0 +1,63 @@
+{
+    "nostr": {
+        "relay-config": {
+            "label": {
+                "name": "Name",
+                "relay": "Relay URL",
+                "privateKey": "Private Key"
+            },
+            "placeholder": {
+                "name": "My Nostr Relay",
+                "relay": "wss://relay.damus.io",
+                "privateKey": "Enter your private key (hex format)"
+            },
+            "errors": {
+                "invalid-private-key": "Invalid private key format",
+                "connection-failed": "Failed to connect to relay",
+                "websocket-error": "WebSocket error occurred"
+            },
+            "status": {
+                "connected": "Connected to relay",
+                "disconnected": "Disconnected from relay",
+                "connecting": "Connecting to relay..."
+            }
+        },
+        "relay": {
+            "label": {
+                "name": "Name",
+                "config": "Relay Config",
+                "filter": "Event Filter"
+            },
+            "placeholder": {
+                "name": "My Nostr Node",
+                "filter": "Event filter (JSON)"
+            },
+            "errors": {
+                "invalid-filter": "Invalid filter format",
+                "subscription-error": "Subscription error"
+            },
+            "status": {
+                "subscribed": "Subscribed to events",
+                "unsubscribed": "Unsubscribed from events"
+            }
+        },
+        "filter": {
+            "label": {
+                "name": "Name",
+                "authors": "Authors",
+                "kinds": "Event Kinds",
+                "since": "Since",
+                "until": "Until",
+                "limit": "Limit"
+            },
+            "placeholder": {
+                "name": "My Filter",
+                "authors": "Comma-separated list of pubkeys",
+                "kinds": "Comma-separated list of event kinds",
+                "since": "Unix timestamp",
+                "until": "Unix timestamp",
+                "limit": "Maximum number of events"
+            }
+        }
+    }
+}

package/package.json

@@ -0,0 +1,86 @@
+{
+    "name": "node-red-contrib-nostr",
+    "version": "0.1.0",
+    "description": "Node-RED nodes for seamless Nostr protocol integration. Features robust WebSocket handling, event filtering, and NPUB-based routing. Built with TypeScript for type safety and extensive testing. Perfect for Nostr automation flows.",
+    "author": {
+        "name": "vveerrgg",
+        "url": "https://github.com/vveerrgg"
+    },
+    "type": "commonjs",
+    "scripts": {
+        "build": "tsc -p tsconfig.json",
+        "postbuild": "for dir in nostr-filter nostr-relay nostr-relay-config nostr-npub-filter; do mkdir -p dist/nodes/$dir && cp src/nodes/$dir/$dir.html dist/nodes/$dir/; done && cp -r src/nodes/*/icons dist/nodes/ && cp -r locales dist/ && cp -r examples dist/ && cp package.json dist/",
+        "prepare": "npm run build",
+        "test": "vitest run",
+        "test:watch": "vitest watch",
+        "test:coverage": "vitest run --coverage",
+        "test:ui": "vitest --ui",
+        "dev": "tsc -w",
+        "lint": "eslint . --ext .ts",
+        "lint:fix": "eslint . --ext .ts --fix"
+    },
+    "main": "dist/nodes/index.js",
+    "files": [
+        "dist/**/*.js",
+        "dist/**/*.d.ts",
+        "dist/**/*.html",
+        "dist/**/icons/*",
+        "locales/**/*",
+        "examples/**/*"
+    ],
+    "keywords": [
+        "node-red",
+        "nostr",
+        "websocket",
+        "relay",
+        "filter",
+        "npub",
+        "network",
+        "protocol"
+    ],
+    "node-red": {
+        "version": ">=2.0.0",
+        "nodes": {
+            "nostr-relay-config": "dist/nodes/nostr-relay-config/nostr-relay-config.js",
+            "nostr-filter": "dist/nodes/nostr-filter/nostr-filter.js",
+            "nostr-npub-filter": "dist/nodes/nostr-npub-filter/nostr-npub-filter.js"
+        },
+        "examples": {
+            "Monitor Jack's Posts": "examples/jack-monitor.json",
+            "Track Multiple Users": "examples/multi-user-track.json"
+        }
+    },
+    "dependencies": {
+        "@noble/hashes": "^1.3.2",
+        "@noble/secp256k1": "^2.0.0",
+        "bech32": "^2.0.0",
+        "nostr-tools": "^1.17.0",
+        "nostr-websocket-utils": "^0.2.5",
+        "ws": "^8.16.0"
+    },
+    "devDependencies": {
+        "@types/node": "^20.4.5",
+        "@types/node-red": "^1.3.1",
+        "@types/ws": "^8.5.5",
+        "@typescript-eslint/eslint-plugin": "^6.2.0",
+        "@typescript-eslint/parser": "^6.2.0",
+        "@vitest/coverage-v8": "^1.1.3",
+        "@vitest/ui": "^1.1.3",
+        "eslint": "^8.45.0",
+        "node-red": "^4.0.8",
+        "node-red-node-test-helper": "^0.3.3",
+        "typescript": "^5.1.6",
+        "vitest": "^1.1.3"
+    },
+    "engines": {
+        "node": ">=14.0.0"
+    },
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/HumanJavaEnterprise/node-red-contrib-nostr.git"
+    },
+    "bugs": {
+        "url": "https://github.com/HumanJavaEnterprise/node-red-contrib-nostr/issues"
+    },
+    "homepage": "https://github.com/HumanJavaEnterprise/node-red-contrib-nostr#readme"
+}