nostr-websocket-utils 0.3.17 → 0.3.18

package/dist/cjs/nips/nip-44.js

@@ -0,0 +1,143 @@
+"use strict";
+/**
+ * @file NIP-44: Versioned Encrypted Payloads
+ * @module nips/nip-44
+ * @see https://github.com/nostr-protocol/nips/blob/master/44.md
+ *
+ * NIP-44 replaces NIP-04 with a modern encryption scheme using
+ * ChaCha20 + HMAC-SHA256. This module provides DM-level helpers
+ * that parallel the NIP-04 module (nip-04.ts).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ENCRYPTED_DM_KIND_44 = void 0;
+exports.getConversationKey = getConversationKey;
+exports.encryptNip44 = encryptNip44;
+exports.decryptNip44 = decryptNip44;
+exports.createEncryptedDM44 = createEncryptedDM44;
+exports.decryptDM44 = decryptDM44;
+exports.validateEncryptedDM44 = validateEncryptedDM44;
+const nostr_crypto_utils_1 = require("nostr-crypto-utils");
+/**
+ * Kind value for NIP-44 encrypted direct messages (gift-wrapped DMs use kind 14,
+ * but for parity with NIP-04 kind 4 usage, callers may choose their own kind).
+ * NIP-44 itself is a payload format, not a kind — the kind depends on the use case.
+ * We default to kind 44 as a convenience constant; callers should override as needed.
+ */
+exports.ENCRYPTED_DM_KIND_44 = 44;
+/**
+ * Creates a NIP-44 conversation key from a sender's private key and recipient's public key.
+ * This key is symmetric and reusable for all messages in the conversation.
+ * @param senderPrivkeyHex - Sender's private key in hex
+ * @param recipientPubkeyHex - Recipient's public key in hex
+ * @returns Conversation key as Uint8Array
+ */
+function getConversationKey(senderPrivkeyHex, recipientPubkeyHex) {
+    const privkeyBytes = (0, nostr_crypto_utils_1.hexToBytes)(senderPrivkeyHex);
+    return nostr_crypto_utils_1.nip44.getConversationKey(privkeyBytes, recipientPubkeyHex);
+}
+/**
+ * Encrypts a message using NIP-44
+ * @param plaintext - Message content to encrypt
+ * @param senderPrivkeyHex - Sender's private key in hex
+ * @param recipientPubkeyHex - Recipient's public key in hex
+ * @returns Encrypted payload string (base64)
+ */
+function encryptNip44(plaintext, senderPrivkeyHex, recipientPubkeyHex) {
+    const conversationKey = getConversationKey(senderPrivkeyHex, recipientPubkeyHex);
+    return nostr_crypto_utils_1.nip44.encrypt(plaintext, conversationKey);
+}
+/**
+ * Decrypts a NIP-44 encrypted payload
+ * @param payload - Encrypted payload string (base64)
+ * @param recipientPrivkeyHex - Recipient's private key in hex
+ * @param senderPubkeyHex - Sender's public key in hex
+ * @returns Decrypted plaintext
+ */
+function decryptNip44(payload, recipientPrivkeyHex, senderPubkeyHex) {
+    const conversationKey = getConversationKey(recipientPrivkeyHex, senderPubkeyHex);
+    return nostr_crypto_utils_1.nip44.decrypt(payload, conversationKey);
+}
+/**
+ * Creates an encrypted direct message event using NIP-44
+ * @param content - Message content to encrypt
+ * @param recipientPubkey - Recipient's public key (hex)
+ * @param senderPrivkey - Sender's private key (hex)
+ * @param tags - Additional tags for the event
+ * @param kind - Event kind (defaults to ENCRYPTED_DM_KIND_44)
+ * @returns Encrypted message event as NostrWSMessage
+ */
+function createEncryptedDM44(content, recipientPubkey, senderPrivkey, tags = [], kind = exports.ENCRYPTED_DM_KIND_44) {
+    try {
+        const encryptedContent = encryptNip44(content, senderPrivkey, recipientPubkey);
+        const senderPubkey = (0, nostr_crypto_utils_1.getPublicKeySync)(senderPrivkey);
+        return ['EVENT', {
+                kind,
+                pubkey: senderPubkey,
+                content: encryptedContent,
+                tags: [
+                    ['p', recipientPubkey],
+                    ...tags
+                ]
+            }];
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+        throw new Error(`Failed to create NIP-44 encrypted DM: ${errorMessage}`);
+    }
+}
+/**
+ * Decrypts a received direct message event encrypted with NIP-44
+ * @param message - Received message
+ * @param recipientPrivkey - Recipient's private key (hex)
+ * @param senderPubkey - Sender's public key (hex)
+ * @param logger - Logger instance
+ * @returns Decrypted message content
+ */
+function decryptDM44(message, recipientPrivkey, senderPubkey, logger) {
+    try {
+        if (!Array.isArray(message) || message[0] !== 'EVENT') {
+            throw new Error('Invalid message format');
+        }
+        const event = message[1];
+        return decryptNip44(event.content, recipientPrivkey, senderPubkey);
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+        logger.error('Failed to decrypt NIP-44 DM:', errorMessage);
+        throw new Error(`Failed to decrypt NIP-44 DM: ${errorMessage}`);
+    }
+}
+/**
+ * Validates a NIP-44 encrypted DM event format
+ * @param message - Message to validate
+ * @param logger - Logger instance
+ * @returns True if message follows NIP-44 encrypted DM format
+ */
+function validateEncryptedDM44(message, logger) {
+    try {
+        if (!Array.isArray(message) || message[0] !== 'EVENT') {
+            logger.debug('Invalid message format');
+            return false;
+        }
+        const event = message[1];
+        if (!event.content || typeof event.content !== 'string') {
+            logger.debug('Missing or invalid content');
+            return false;
+        }
+        if (!Array.isArray(event.tags)) {
+            logger.debug('Missing tags array');
+            return false;
+        }
+        const recipientTag = event.tags.find((tag) => Array.isArray(tag) && tag[0] === 'p' && tag[1]);
+        if (!recipientTag) {
+            logger.debug('Missing recipient tag');
+            return false;
+        }
+        return true;
+    }
+    catch (error) {
+        logger.error('Error validating NIP-44 encrypted DM:', error);
+        return false;
+    }
+}
+//# sourceMappingURL=nip-44.js.map

package/dist/cjs/nips/nip-44.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nip-44.js","sourceRoot":"","sources":["../../../src/nips/nip-44.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;AAqBH,gDAMC;AASD,oCAOC;AASD,oCAOC;AAWD,kDAuBC;AAUD,kCAkBC;AAQD,sDAoCC;AAnKD,2DAAyE;AAIzE;;;;;GAKG;AACU,QAAA,oBAAoB,GAAG,EAAE,CAAC;AAEvC;;;;;;GAMG;AACH,SAAgB,kBAAkB,CAChC,gBAAwB,EACxB,kBAA0B;IAE1B,MAAM,YAAY,GAAG,IAAA,+BAAU,EAAC,gBAAgB,CAAC,CAAC;IAClD,OAAO,0BAAK,CAAC,kBAAkB,CAAC,YAAY,EAAE,kBAAkB,CAAC,CAAC;AACpE,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,YAAY,CAC1B,SAAiB,EACjB,gBAAwB,EACxB,kBAA0B;IAE1B,MAAM,eAAe,GAAG,kBAAkB,CAAC,gBAAgB,EAAE,kBAAkB,CAAC,CAAC;IACjF,OAAO,0BAAK,CAAC,OAAO,CAAC,SAAS,EAAE,eAAe,CAAC,CAAC;AACnD,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,YAAY,CAC1B,OAAe,EACf,mBAA2B,EAC3B,eAAuB;IAEvB,MAAM,eAAe,GAAG,kBAAkB,CAAC,mBAAmB,EAAE,eAAe,CAAC,CAAC;IACjF,OAAO,0BAAK,CAAC,OAAO,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC;AACjD,CAAC;AAED;;;;;;;;GAQG;AACH,SAAgB,mBAAmB,CACjC,OAAe,EACf,eAAuB,EACvB,aAAqB,EACrB,OAAmB,EAAE,EACrB,OAAe,4BAAoB;IAEnC,IAAI,CAAC;QACH,MAAM,gBAAgB,GAAG,YAAY,CAAC,OAAO,EAAE,aAAa,EAAE,eAAe,CAAC,CAAC;QAC/E,MAAM,YAAY,GAAG,IAAA,qCAAgB,EAAC,aAAa,CAAC,CAAC;QACrD,OAAO,CAAC,OAAO,EAAE;gBACf,IAAI;gBACJ,MAAM,EAAE,YAAY;gBACpB,OAAO,EAAE,gBAAgB;gBACzB,IAAI,EAAE;oBACJ,CAAC,GAAG,EAAE,eAAe,CAAC;oBACtB,GAAG,IAAI;iBACR;aACF,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACxB,MAAM,YAAY,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC;QAC9E,MAAM,IAAI,KAAK,CAAC,yCAAyC,YAAY,EAAE,CAAC,CAAC;IAC3E,CAAC;AACH,CAAC;AAED;;;;;;;GAOG;AACH,SAAgB,WAAW,CACzB,OAAuB,EACvB,gBAAwB,EACxB,YAAoB,EACpB,MAAc;IAEd,IAAI,CAAC;QACH,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,CAAC,CAAC,KAAK,OAAO,EAAE,CAAC;YACtD,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;QAC5C,CAAC;QAED,MAAM,KAAK,GAAG,OAAO,CAAC,CAAC,CAAe,CAAC;QACvC,OAAO,YAAY,CAAC,KAAK,CAAC,OAAO,EAAE,gBAAgB,EAAE,YAAY,CAAC,CAAC;IACrE,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACxB,MAAM,YAAY,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC;QAC9E,MAAM,CAAC,KAAK,CAAC,8BAA8B,EAAE,YAAY,CAAC,CAAC;QAC3D,MAAM,IAAI,KAAK,CAAC,gCAAgC,YAAY,EAAE,CAAC,CAAC;IAClE,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,SAAgB,qBAAqB,CACnC,OAAuB,EACvB,MAAc;IAEd,IAAI,CAAC;QACH,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,CAAC,CAAC,KAAK,OAAO,EAAE,CAAC;YACtD,MAAM,CAAC,KAAK,CAAC,wBAAwB,CAAC,CAAC;YACvC,OAAO,KAAK,CAAC;QACf,CAAC;QAED,MAAM,KAAK,GAAG,OAAO,CAAC,CAAC,CAAe,CAAC;QAEvC,IAAI,CAAC,KAAK,CAAC,OAAO,IAAI,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;YACxD,MAAM,CAAC,KAAK,CAAC,4BAA4B,CAAC,CAAC;YAC3C,OAAO,KAAK,CAAC;QACf,CAAC;QAED,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;YAC/B,MAAM,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC;YACnC,OAAO,KAAK,CAAC;QACf,CAAC;QAED,MAAM,YAAY,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAa,EAAE,EAAE,CACrD,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,KAAK,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,CAC/C,CAAC;QAEF,IAAI,CAAC,YAAY,EAAE,CAAC;YAClB,MAAM,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAC;YACtC,OAAO,KAAK,CAAC;QACf,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,KAAK,CAAC,uCAAuC,EAAE,KAAK,CAAC,CAAC;QAC7D,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

package/dist/cjs/nips/nip-46.d.ts

@@ -0,0 +1,112 @@
+/**
+ * @file NIP-46: Nostr Connect / Remote Signing Transport
+ * @module nips/nip-46
+ * @see https://github.com/nostr-protocol/nips/blob/master/46.md
+ *
+ * nostr-crypto-utils provides the NIP-46 protocol layer (crypto, encoding,
+ * message formatting) but has no I/O. This module adds the WebSocket relay
+ * transport on top — subscribing for kind 24133 responses, publishing
+ * wrapped requests, and correlating request/response pairs.
+ */
+import { nip46 } from 'nostr-crypto-utils';
+import type { Nip46Session, Nip46Request, Nip46Response, SignedNostrEvent, BunkerURI } from 'nostr-crypto-utils';
+import { NostrWSClient } from '../core/client.js';
+import type { NostrWSMessage } from '../types/messages.js';
+/**
+ * Options for creating a NIP-46 transport
+ */
+export interface Nip46TransportOptions {
+    /** Timeout for waiting for a response (ms). Defaults to 60000 (60s). */
+    timeout?: number;
+}
+/**
+ * Result of sending a NIP-46 request
+ */
+export interface Nip46TransportResult {
+    /** The JSON-RPC response from the remote signer */
+    response: Nip46Response;
+    /** The raw kind 24133 event that carried the response */
+    rawEvent: SignedNostrEvent;
+}
+/**
+ * A thin transport layer that bridges nostr-crypto-utils NIP-46 protocol
+ * with the WebSocket relay infrastructure in this library.
+ *
+ * Usage:
+ * ```ts
+ * const client = new NostrWSClient(['wss://relay.example.com']);
+ * await client.connect();
+ *
+ * const session = nip46.createSession(remotePubkey);
+ * const transport = new Nip46Transport(client, session);
+ *
+ * // Send a connect request
+ * const connectReq = nip46.connectRequest(remotePubkey, secret);
+ * const result = await transport.sendRequest(connectReq);
+ * ```
+ */
+export declare class Nip46Transport {
+    private client;
+    private session;
+    private timeout;
+    constructor(client: NostrWSClient, session: Nip46Session, options?: Nip46TransportOptions);
+    /**
+     * Subscribe for NIP-46 response events addressed to our ephemeral pubkey.
+     * This sends a REQ message to the relay with the appropriate filter.
+     * @param subscriptionId - Subscription ID for the REQ message
+     * @param since - Optional since timestamp for the filter
+     * @returns The subscription message that was sent
+     */
+    subscribe(subscriptionId: string, since?: number): Promise<NostrWSMessage>;
+    /**
+     * Wrap and publish a NIP-46 request as a kind 24133 event.
+     * @param request - NIP-46 JSON-RPC request
+     * @returns The signed kind 24133 event that was published
+     */
+    publishRequest(request: Nip46Request): Promise<SignedNostrEvent>;
+    /**
+     * Attempt to unwrap a kind 24133 event into a NIP-46 request or response.
+     * Returns null if the event is not kind 24133 or decryption fails.
+     * @param event - A signed Nostr event
+     * @returns Decrypted NIP-46 payload, or null on failure
+     */
+    unwrapEvent(event: SignedNostrEvent): Nip46Request | Nip46Response | null;
+    /**
+     * Get the NIP-46 response filter for this session.
+     * Useful for manual subscription management.
+     * @param since - Optional since timestamp
+     * @returns Filter object for kind 24133 events tagged to our pubkey
+     */
+    getResponseFilter(since?: number): {
+        kinds: number[];
+        '#p': string[];
+        since?: number;
+    };
+    /**
+     * Get the current session (read-only info).
+     * @returns The session's client and remote pubkeys
+     */
+    getSessionInfo(): {
+        clientPubkey: string;
+        remotePubkey: string;
+    };
+}
+/** Parse a bunker:// URI */
+export declare const parseBunkerURI: (uri: string) => BunkerURI;
+/** Create a bunker:// URI */
+export declare const createBunkerURI: (remotePubkey: string, relays: string[], secret?: string) => string;
+/** Validate a bunker:// URI */
+export declare const validateBunkerURI: typeof nip46.validateBunkerURI;
+/** Create a new NIP-46 session */
+export declare const createNip46Session: typeof nip46.createSession;
+/** Restore a NIP-46 session */
+export declare const restoreNip46Session: typeof nip46.restoreSession;
+/** Create a 'connect' request */
+export declare const connectRequest: typeof nip46.connectRequest;
+/** Create a 'ping' request */
+export declare const pingRequest: typeof nip46.pingRequest;
+/** Create a 'get_public_key' request */
+export declare const getPublicKeyRequest: typeof nip46.getPublicKeyRequest;
+/** Create a 'sign_event' request */
+export declare const signEventRequest: typeof nip46.signEventRequest;
+//# sourceMappingURL=nip-46.d.ts.map

package/dist/cjs/nips/nip-46.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nip-46.d.ts","sourceRoot":"","sources":["../../../src/nips/nip-46.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,OAAO,KAAK,EACV,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,gBAAgB,EAChB,SAAS,EACV,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAK3D;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,wEAAwE;IACxE,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,mDAAmD;IACnD,QAAQ,EAAE,aAAa,CAAC;IACxB,yDAAyD;IACzD,QAAQ,EAAE,gBAAgB,CAAC;CAC5B;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,OAAO,CAAe;IAC9B,OAAO,CAAC,OAAO,CAAS;gBAGtB,MAAM,EAAE,aAAa,EACrB,OAAO,EAAE,YAAY,EACrB,OAAO,GAAE,qBAA0B;IAOrC;;;;;;OAMG;IACG,SAAS,CAAC,cAAc,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAWhF;;;;OAIG;IACG,cAAc,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAatE;;;;;OAKG;IACH,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,YAAY,GAAG,aAAa,GAAG,IAAI;IAUzE;;;;;OAKG;IACH,iBAAiB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG;QAAE,KAAK,EAAE,MAAM,EAAE,CAAC;QAAC,IAAI,EAAE,MAAM,EAAE,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE;IAItF;;;OAGG;IACH,cAAc,IAAI;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE;CAGjE;AAKD,4BAA4B;AAC5B,eAAO,MAAM,cAAc,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,SAAgC,CAAC;AAE/E,6BAA6B;AAC7B,eAAO,MAAM,eAAe,EAAE,CAAC,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,MAAM,CAAC,EAAE,MAAM,KAAK,MAA8B,CAAC;AAE1H,+BAA+B;AAC/B,eAAO,MAAM,iBAAiB,EAAE,OAAO,KAAK,CAAC,iBAA2C,CAAC;AAEzF,kCAAkC;AAClC,eAAO,MAAM,kBAAkB,EAAE,OAAO,KAAK,CAAC,aAAmC,CAAC;AAElF,+BAA+B;AAC/B,eAAO,MAAM,mBAAmB,EAAE,OAAO,KAAK,CAAC,cAAqC,CAAC;AAErF,iCAAiC;AACjC,eAAO,MAAM,cAAc,EAAE,OAAO,KAAK,CAAC,cAAqC,CAAC;AAEhF,8BAA8B;AAC9B,eAAO,MAAM,WAAW,EAAE,OAAO,KAAK,CAAC,WAA+B,CAAC;AAEvE,wCAAwC;AACxC,eAAO,MAAM,mBAAmB,EAAE,OAAO,KAAK,CAAC,mBAA+C,CAAC;AAE/F,oCAAoC;AACpC,eAAO,MAAM,gBAAgB,EAAE,OAAO,KAAK,CAAC,gBAAyC,CAAC"}

package/dist/cjs/nips/nip-46.js

@@ -0,0 +1,123 @@
+"use strict";
+/**
+ * @file NIP-46: Nostr Connect / Remote Signing Transport
+ * @module nips/nip-46
+ * @see https://github.com/nostr-protocol/nips/blob/master/46.md
+ *
+ * nostr-crypto-utils provides the NIP-46 protocol layer (crypto, encoding,
+ * message formatting) but has no I/O. This module adds the WebSocket relay
+ * transport on top — subscribing for kind 24133 responses, publishing
+ * wrapped requests, and correlating request/response pairs.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.signEventRequest = exports.getPublicKeyRequest = exports.pingRequest = exports.connectRequest = exports.restoreNip46Session = exports.createNip46Session = exports.validateBunkerURI = exports.createBunkerURI = exports.parseBunkerURI = exports.Nip46Transport = void 0;
+const nostr_crypto_utils_1 = require("nostr-crypto-utils");
+const logger_js_1 = require("../utils/logger.js");
+const logger = (0, logger_js_1.getLogger)('NIP-46');
+/**
+ * A thin transport layer that bridges nostr-crypto-utils NIP-46 protocol
+ * with the WebSocket relay infrastructure in this library.
+ *
+ * Usage:
+ * ```ts
+ * const client = new NostrWSClient(['wss://relay.example.com']);
+ * await client.connect();
+ *
+ * const session = nip46.createSession(remotePubkey);
+ * const transport = new Nip46Transport(client, session);
+ *
+ * // Send a connect request
+ * const connectReq = nip46.connectRequest(remotePubkey, secret);
+ * const result = await transport.sendRequest(connectReq);
+ * ```
+ */
+class Nip46Transport {
+    constructor(client, session, options = {}) {
+        this.client = client;
+        this.session = session;
+        this.timeout = options.timeout ?? 60000;
+    }
+    /**
+     * Subscribe for NIP-46 response events addressed to our ephemeral pubkey.
+     * This sends a REQ message to the relay with the appropriate filter.
+     * @param subscriptionId - Subscription ID for the REQ message
+     * @param since - Optional since timestamp for the filter
+     * @returns The subscription message that was sent
+     */
+    async subscribe(subscriptionId, since) {
+        const filter = nostr_crypto_utils_1.nip46.createResponseFilter(this.session.clientPubkey, since);
+        const message = ['REQ', {
+                subscription_id: subscriptionId,
+                filters: [filter]
+            }];
+        await this.client.sendMessage(message);
+        logger.debug({ subscriptionId, filter }, 'Subscribed for NIP-46 responses');
+        return message;
+    }
+    /**
+     * Wrap and publish a NIP-46 request as a kind 24133 event.
+     * @param request - NIP-46 JSON-RPC request
+     * @returns The signed kind 24133 event that was published
+     */
+    async publishRequest(request) {
+        const event = await nostr_crypto_utils_1.nip46.wrapEvent(request, this.session, this.session.remotePubkey);
+        const message = ['EVENT', event];
+        await this.client.sendMessage(message);
+        logger.debug({ requestId: request.id, method: request.method }, 'Published NIP-46 request');
+        return event;
+    }
+    /**
+     * Attempt to unwrap a kind 24133 event into a NIP-46 request or response.
+     * Returns null if the event is not kind 24133 or decryption fails.
+     * @param event - A signed Nostr event
+     * @returns Decrypted NIP-46 payload, or null on failure
+     */
+    unwrapEvent(event) {
+        try {
+            return nostr_crypto_utils_1.nip46.unwrapEvent(event, this.session);
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+            logger.debug({ error: errorMessage }, 'Failed to unwrap NIP-46 event');
+            return null;
+        }
+    }
+    /**
+     * Get the NIP-46 response filter for this session.
+     * Useful for manual subscription management.
+     * @param since - Optional since timestamp
+     * @returns Filter object for kind 24133 events tagged to our pubkey
+     */
+    getResponseFilter(since) {
+        return nostr_crypto_utils_1.nip46.createResponseFilter(this.session.clientPubkey, since);
+    }
+    /**
+     * Get the current session (read-only info).
+     * @returns The session's client and remote pubkeys
+     */
+    getSessionInfo() {
+        return nostr_crypto_utils_1.nip46.getSessionInfo(this.session);
+    }
+}
+exports.Nip46Transport = Nip46Transport;
+// ─── Convenience re-exports from nostr-crypto-utils ─────────────────────────
+// These let consumers access NIP-46 protocol helpers without a separate import.
+/** Parse a bunker:// URI */
+exports.parseBunkerURI = nostr_crypto_utils_1.nip46.parseBunkerURI;
+/** Create a bunker:// URI */
+exports.createBunkerURI = nostr_crypto_utils_1.nip46.createBunkerURI;
+/** Validate a bunker:// URI */
+exports.validateBunkerURI = nostr_crypto_utils_1.nip46.validateBunkerURI;
+/** Create a new NIP-46 session */
+exports.createNip46Session = nostr_crypto_utils_1.nip46.createSession;
+/** Restore a NIP-46 session */
+exports.restoreNip46Session = nostr_crypto_utils_1.nip46.restoreSession;
+/** Create a 'connect' request */
+exports.connectRequest = nostr_crypto_utils_1.nip46.connectRequest;
+/** Create a 'ping' request */
+exports.pingRequest = nostr_crypto_utils_1.nip46.pingRequest;
+/** Create a 'get_public_key' request */
+exports.getPublicKeyRequest = nostr_crypto_utils_1.nip46.getPublicKeyRequest;
+/** Create a 'sign_event' request */
+exports.signEventRequest = nostr_crypto_utils_1.nip46.signEventRequest;
+//# sourceMappingURL=nip-46.js.map

package/dist/cjs/nips/nip-46.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nip-46.js","sourceRoot":"","sources":["../../../src/nips/nip-46.ts"],"names":[],"mappings":"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"}

package/dist/nips/index.d.ts

@@ -5,6 +5,7 @@
 export * from './nip-01.js';
 export * from './nip-02.js';
 export * from './nip-04.js';
+export * from './nip-44.js';
 export * from './nip-05.js';
 export * from './nip-09.js';
 export * from './nip-19.js';
@@ -17,4 +18,5 @@ export * from './nip-15.js';
 export * from './nip-22.js';
 export * from './nip-28.js';
 export * from './nip-33.js';
+export * from './nip-46.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/nips/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/nips/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,cAAc,aAAa,CAAC;AAG5B,cAAc,aAAa,CAAC;AAG5B,cAAc,aAAa,CAAC;AAG5B,cAAc,aAAa,CAAC;AAG5B,cAAc,aAAa,CAAC;AAG5B,cAAc,aAAa,CAAC;AAG5B,cAAc,aAAa,CAAC;AAG5B,cAAc,aAAa,CAAC;AAG5B,cAAc,aAAa,CAAC;AAG5B,cAAc,aAAa,CAAC;AAG5B,cAAc,aAAa,CAAC;AAG5B,cAAc,aAAa,CAAC;AAG5B,cAAc,aAAa,CAAC;AAG5B,cAAc,aAAa,CAAC;AAG5B,cAAc,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/nips/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,cAAc,aAAa,CAAC;AAG5B,cAAc,aAAa,CAAC;AAG5B,cAAc,aAAa,CAAC;AAG5B,cAAc,aAAa,CAAC;AAG5B,cAAc,aAAa,CAAC;AAG5B,cAAc,aAAa,CAAC;AAG5B,cAAc,aAAa,CAAC;AAG5B,cAAc,aAAa,CAAC;AAG5B,cAAc,aAAa,CAAC;AAG5B,cAAc,aAAa,CAAC;AAG5B,cAAc,aAAa,CAAC;AAG5B,cAAc,aAAa,CAAC;AAG5B,cAAc,aAAa,CAAC;AAG5B,cAAc,aAAa,CAAC;AAG5B,cAAc,aAAa,CAAC;AAG5B,cAAc,aAAa,CAAC;AAG5B,cAAc,aAAa,CAAC"}

package/dist/nips/index.js

@@ -6,8 +6,10 @@
 export * from './nip-01.js';
 // Contact List and Petnames
 export * from './nip-02.js';
-// Encrypted Direct Messages
+// Encrypted Direct Messages (NIP-04)
 export * from './nip-04.js';
+// Versioned Encrypted Payloads (NIP-44)
+export * from './nip-44.js';
 // DNS Identity Verification
 export * from './nip-05.js';
 // Event Deletion
@@ -32,4 +34,6 @@ export * from './nip-22.js';
 export * from './nip-28.js';
 // Parameterized Replaceable Events
 export * from './nip-33.js';
+// Nostr Connect / Remote Signing Transport (NIP-46)
+export * from './nip-46.js';
 //# sourceMappingURL=index.js.map

package/dist/nips/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/nips/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,sBAAsB;AACtB,cAAc,aAAa,CAAC;AAE5B,4BAA4B;AAC5B,cAAc,aAAa,CAAC;AAE5B,4BAA4B;AAC5B,cAAc,aAAa,CAAC;AAE5B,4BAA4B;AAC5B,cAAc,aAAa,CAAC;AAE5B,iBAAiB;AACjB,cAAc,aAAa,CAAC;AAE5B,0BAA0B;AAC1B,cAAc,aAAa,CAAC;AAE5B,0BAA0B;AAC1B,cAAc,aAAa,CAAC;AAE5B,6BAA6B;AAC7B,cAAc,aAAa,CAAC;AAE5B,kBAAkB;AAClB,cAAc,aAAa,CAAC;AAE5B,gBAAgB;AAChB,cAAc,aAAa,CAAC;AAE5B,kBAAkB;AAClB,cAAc,aAAa,CAAC;AAE5B,8BAA8B;AAC9B,cAAc,aAAa,CAAC;AAE5B,0BAA0B;AAC1B,cAAc,aAAa,CAAC;AAE5B,cAAc;AACd,cAAc,aAAa,CAAC;AAE5B,mCAAmC;AACnC,cAAc,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/nips/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,sBAAsB;AACtB,cAAc,aAAa,CAAC;AAE5B,4BAA4B;AAC5B,cAAc,aAAa,CAAC;AAE5B,qCAAqC;AACrC,cAAc,aAAa,CAAC;AAE5B,wCAAwC;AACxC,cAAc,aAAa,CAAC;AAE5B,4BAA4B;AAC5B,cAAc,aAAa,CAAC;AAE5B,iBAAiB;AACjB,cAAc,aAAa,CAAC;AAE5B,0BAA0B;AAC1B,cAAc,aAAa,CAAC;AAE5B,0BAA0B;AAC1B,cAAc,aAAa,CAAC;AAE5B,6BAA6B;AAC7B,cAAc,aAAa,CAAC;AAE5B,kBAAkB;AAClB,cAAc,aAAa,CAAC;AAE5B,gBAAgB;AAChB,cAAc,aAAa,CAAC;AAE5B,kBAAkB;AAClB,cAAc,aAAa,CAAC;AAE5B,8BAA8B;AAC9B,cAAc,aAAa,CAAC;AAE5B,0BAA0B;AAC1B,cAAc,aAAa,CAAC;AAE5B,cAAc;AACd,cAAc,aAAa,CAAC;AAE5B,mCAAmC;AACnC,cAAc,aAAa,CAAC;AAE5B,oDAAoD;AACpD,cAAc,aAAa,CAAC"}

package/dist/nips/nip-26.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"nip-26.d.ts","sourceRoot":"","sources":["../../src/nips/nip-26.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAIrD;;;;;;;GAOG;AACH,UAAU,oBAAoB;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;;;;;GAMG;AACH,UAAU,UAAU;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,oBAAoB,CAAC;IACjC,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,gBAAgB,EAAE,MAAM,EACxB,eAAe,EAAE,MAAM,EACvB,UAAU,EAAE,oBAAoB,GAC/B,OAAO,CAAC,MAAM,CAAC,CA2BjB;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,eAAe,EAAE,MAAM,EACvB,eAAe,EAAE,MAAM,EACvB,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,oBAAoB,GAC/B,OAAO,CAAC,OAAO,CAAC,CAuBlB;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,GAAG,UAAU,CAYtF;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,UAAU,GAAG,UAAU,GAAG,IAAI,CAyBtE;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,CAuChF"}
+{"version":3,"file":"nip-26.d.ts","sourceRoot":"","sources":["../../src/nips/nip-26.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAIrD;;;;;;;GAOG;AACH,UAAU,oBAAoB;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;;;;;GAMG;AACH,UAAU,UAAU;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,oBAAoB,CAAC;IACjC,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,gBAAgB,EAAE,MAAM,EACxB,eAAe,EAAE,MAAM,EACvB,UAAU,EAAE,oBAAoB,GAC/B,OAAO,CAAC,MAAM,CAAC,CAuBjB;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,eAAe,EAAE,MAAM,EACvB,eAAe,EAAE,MAAM,EACvB,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,oBAAoB,GAC/B,OAAO,CAAC,OAAO,CAAC,CAuBlB;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,GAAG,UAAU,CAYtF;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,UAAU,GAAG,UAAU,GAAG,IAAI,CAyBtE;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,CAuChF"}

package/dist/nips/nip-26.js

@@ -3,7 +3,7 @@
  * @module nips/nip-26
  */
 import { getLogger } from '../utils/logger.js';
-import { signEvent, verifySignature } from 'nostr-crypto-utils';
+import { finalizeEvent, verifySignature } from 'nostr-crypto-utils';
 const logger = getLogger('NIP-26');
 /**
  * Create a delegation token
@@ -15,17 +15,13 @@ export async function createDelegation(delegatorPrivkey, delegateePubkey, condit
             .sort()
             .join('&');
         const message = `nostr:delegation:${delegateePubkey}:${conditionsString}`;
-        // Create a NostrEvent object for signing
-        const event = {
-            id: '', // This will be set by signEvent
+        // Use finalizeEvent for one-step create+sign
+        const signedEvent = await finalizeEvent({
             pubkey: delegateePubkey,
-            created_at: Math.floor(Date.now() / 1000),
             kind: 0, // Using kind 0 for delegation events
             tags: [],
             content: message,
-            sig: '' // This will be set by signEvent
-        };
-        const signedEvent = await signEvent(event, delegatorPrivkey);
+        }, delegatorPrivkey);
         return signedEvent.sig;
     }
     catch (error) {

package/dist/nips/nip-26.js.map

@@ -1 +1 @@
-{"version":3,"file":"nip-26.js","sourceRoot":"","sources":["../../src/nips/nip-26.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"nip-26.js","sourceRoot":"","sources":["../../src/nips/nip-26.ts"],"names":[],"mappings":"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"}

package/dist/nips/nip-44.d.ts

@@ -0,0 +1,69 @@
+/**
+ * @file NIP-44: Versioned Encrypted Payloads
+ * @module nips/nip-44
+ * @see https://github.com/nostr-protocol/nips/blob/master/44.md
+ *
+ * NIP-44 replaces NIP-04 with a modern encryption scheme using
+ * ChaCha20 + HMAC-SHA256. This module provides DM-level helpers
+ * that parallel the NIP-04 module (nip-04.ts).
+ */
+import type { NostrWSMessage } from '../types/messages.js';
+import type { Logger } from '../types/logger.js';
+/**
+ * Kind value for NIP-44 encrypted direct messages (gift-wrapped DMs use kind 14,
+ * but for parity with NIP-04 kind 4 usage, callers may choose their own kind).
+ * NIP-44 itself is a payload format, not a kind — the kind depends on the use case.
+ * We default to kind 44 as a convenience constant; callers should override as needed.
+ */
+export declare const ENCRYPTED_DM_KIND_44 = 44;
+/**
+ * Creates a NIP-44 conversation key from a sender's private key and recipient's public key.
+ * This key is symmetric and reusable for all messages in the conversation.
+ * @param senderPrivkeyHex - Sender's private key in hex
+ * @param recipientPubkeyHex - Recipient's public key in hex
+ * @returns Conversation key as Uint8Array
+ */
+export declare function getConversationKey(senderPrivkeyHex: string, recipientPubkeyHex: string): Uint8Array;
+/**
+ * Encrypts a message using NIP-44
+ * @param plaintext - Message content to encrypt
+ * @param senderPrivkeyHex - Sender's private key in hex
+ * @param recipientPubkeyHex - Recipient's public key in hex
+ * @returns Encrypted payload string (base64)
+ */
+export declare function encryptNip44(plaintext: string, senderPrivkeyHex: string, recipientPubkeyHex: string): string;
+/**
+ * Decrypts a NIP-44 encrypted payload
+ * @param payload - Encrypted payload string (base64)
+ * @param recipientPrivkeyHex - Recipient's private key in hex
+ * @param senderPubkeyHex - Sender's public key in hex
+ * @returns Decrypted plaintext
+ */
+export declare function decryptNip44(payload: string, recipientPrivkeyHex: string, senderPubkeyHex: string): string;
+/**
+ * Creates an encrypted direct message event using NIP-44
+ * @param content - Message content to encrypt
+ * @param recipientPubkey - Recipient's public key (hex)
+ * @param senderPrivkey - Sender's private key (hex)
+ * @param tags - Additional tags for the event
+ * @param kind - Event kind (defaults to ENCRYPTED_DM_KIND_44)
+ * @returns Encrypted message event as NostrWSMessage
+ */
+export declare function createEncryptedDM44(content: string, recipientPubkey: string, senderPrivkey: string, tags?: string[][], kind?: number): NostrWSMessage;
+/**
+ * Decrypts a received direct message event encrypted with NIP-44
+ * @param message - Received message
+ * @param recipientPrivkey - Recipient's private key (hex)
+ * @param senderPubkey - Sender's public key (hex)
+ * @param logger - Logger instance
+ * @returns Decrypted message content
+ */
+export declare function decryptDM44(message: NostrWSMessage, recipientPrivkey: string, senderPubkey: string, logger: Logger): string;
+/**
+ * Validates a NIP-44 encrypted DM event format
+ * @param message - Message to validate
+ * @param logger - Logger instance
+ * @returns True if message follows NIP-44 encrypted DM format
+ */
+export declare function validateEncryptedDM44(message: NostrWSMessage, logger: Logger): boolean;
+//# sourceMappingURL=nip-44.d.ts.map

package/dist/nips/nip-44.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nip-44.d.ts","sourceRoot":"","sources":["../../src/nips/nip-44.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAc,MAAM,sBAAsB,CAAC;AACvE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAEjD;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,KAAK,CAAC;AAEvC;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,gBAAgB,EAAE,MAAM,EACxB,kBAAkB,EAAE,MAAM,GACzB,UAAU,CAGZ;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAC1B,SAAS,EAAE,MAAM,EACjB,gBAAgB,EAAE,MAAM,EACxB,kBAAkB,EAAE,MAAM,GACzB,MAAM,CAGR;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAC1B,OAAO,EAAE,MAAM,EACf,mBAAmB,EAAE,MAAM,EAC3B,eAAe,EAAE,MAAM,GACtB,MAAM,CAGR;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,MAAM,EACf,eAAe,EAAE,MAAM,EACvB,aAAa,EAAE,MAAM,EACrB,IAAI,GAAE,MAAM,EAAE,EAAO,EACrB,IAAI,GAAE,MAA6B,GAClC,cAAc,CAiBhB;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CACzB,OAAO,EAAE,cAAc,EACvB,gBAAgB,EAAE,MAAM,EACxB,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,MAAM,GACb,MAAM,CAaR;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,cAAc,EACvB,MAAM,EAAE,MAAM,GACb,OAAO,CAiCT"}