@unicitylabs/nostr-js-sdk 0.0.1

package/dist/types/client/NostrClient.d.ts

@@ -0,0 +1,154 @@
+/**
+ * NostrClient - Main entry point for Nostr protocol operations.
+ * Handles relay connections, event publishing, and subscriptions.
+ */
+import { NostrKeyManager } from '../NostrKeyManager.js';
+import { Event, UnsignedEventData } from '../protocol/Event.js';
+import { Filter } from '../protocol/Filter.js';
+import { NostrEventListener } from './NostrEventListener.js';
+/**
+ * NostrClient provides the main interface for Nostr protocol operations.
+ */
+export declare class NostrClient {
+    private keyManager;
+    private relays;
+    private subscriptions;
+    private eventQueue;
+    private pendingOks;
+    private subscriptionCounter;
+    private closed;
+    /**
+     * Create a NostrClient instance.
+     * @param keyManager Key manager with signing keys
+     */
+    constructor(keyManager: NostrKeyManager);
+    /**
+     * Get the key manager.
+     * @returns The key manager instance
+     */
+    getKeyManager(): NostrKeyManager;
+    /**
+     * Connect to one or more relay WebSocket URLs.
+     * @param relayUrls Relay URLs to connect to
+     * @returns Promise that resolves when all connections are established
+     */
+    connect(...relayUrls: string[]): Promise<void>;
+    /**
+     * Connect to a single relay.
+     */
+    private connectToRelay;
+    /**
+     * Schedule a reconnection attempt for a relay.
+     */
+    private scheduleReconnect;
+    /**
+     * Re-establish all subscriptions for a relay.
+     */
+    private resubscribeAll;
+    /**
+     * Flush queued events to connected relays.
+     */
+    private flushEventQueue;
+    /**
+     * Handle a message from a relay.
+     */
+    private handleRelayMessage;
+    /**
+     * Handle EVENT message from relay.
+     */
+    private handleEventMessage;
+    /**
+     * Handle OK message from relay.
+     */
+    private handleOkMessage;
+    /**
+     * Handle EOSE (End of Stored Events) message from relay.
+     */
+    private handleEOSEMessage;
+    /**
+     * Handle NOTICE message from relay.
+     */
+    private handleNoticeMessage;
+    /**
+     * Handle CLOSED message from relay (subscription closed by relay).
+     */
+    private handleClosedMessage;
+    /**
+     * Disconnect from all relays.
+     */
+    disconnect(): void;
+    /**
+     * Check if connected to at least one relay.
+     * @returns true if connected to at least one relay
+     */
+    isConnected(): boolean;
+    /**
+     * Get the set of connected relay URLs.
+     * @returns Set of connected relay URLs
+     */
+    getConnectedRelays(): Set<string>;
+    /**
+     * Publish an event to all connected relays.
+     * @param event Event to publish
+     * @returns Promise that resolves with the event ID
+     */
+    publishEvent(event: Event): Promise<string>;
+    /**
+     * Broadcast an event to all connected relays.
+     */
+    private broadcastEvent;
+    /**
+     * Publish an encrypted direct message (NIP-04).
+     * @param recipientPubkeyHex Recipient's public key (hex)
+     * @param message Message to send
+     * @returns Promise that resolves with the event ID
+     */
+    publishEncryptedMessage(recipientPubkeyHex: string, message: string): Promise<string>;
+    /**
+     * Send a token transfer (encrypted).
+     * @param recipientPubkeyHex Recipient's public key (hex)
+     * @param tokenJson Token JSON string
+     * @returns Promise that resolves with the event ID
+     */
+    sendTokenTransfer(recipientPubkeyHex: string, tokenJson: string): Promise<string>;
+    /**
+     * Publish a nametag binding.
+     * @param nametagId Nametag identifier
+     * @param unicityAddress Unicity address
+     * @returns Promise that resolves with success status
+     */
+    publishNametagBinding(nametagId: string, unicityAddress: string): Promise<boolean>;
+    /**
+     * Subscribe to events matching a filter.
+     * @param filter Filter for matching events
+     * @param listener Listener for received events
+     * @returns Subscription ID
+     */
+    subscribe(filter: Filter, listener: NostrEventListener): string;
+    /**
+     * Subscribe with a specific subscription ID.
+     * @param subscriptionId Custom subscription ID
+     * @param filter Filter for matching events
+     * @param listener Listener for received events
+     * @returns Subscription ID
+     */
+    subscribe(subscriptionId: string, filter: Filter, listener: NostrEventListener): string;
+    /**
+     * Unsubscribe from a subscription.
+     * @param subscriptionId Subscription ID to unsubscribe
+     */
+    unsubscribe(subscriptionId: string): void;
+    /**
+     * Query for a public key by nametag.
+     * @param nametagId Nametag identifier
+     * @returns Promise that resolves with the public key hex, or null if not found
+     */
+    queryPubkeyByNametag(nametagId: string): Promise<string | null>;
+    /**
+     * Create and publish a signed event.
+     * @param data Unsigned event data
+     * @returns Promise that resolves with the event ID
+     */
+    createAndPublishEvent(data: UnsignedEventData): Promise<string>;
+}
+//# sourceMappingURL=NostrClient.d.ts.map

package/dist/types/client/NostrClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NostrClient.d.ts","sourceRoot":"","sources":["../../../src/client/NostrClient.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAChE,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAE/C,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAuD7D;;GAEG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,UAAU,CAAkB;IACpC,OAAO,CAAC,MAAM,CAA2C;IACzD,OAAO,CAAC,aAAa,CAA4C;IACjE,OAAO,CAAC,UAAU,CAAqB;IACvC,OAAO,CAAC,UAAU,CAAqC;IACvD,OAAO,CAAC,mBAAmB,CAAK;IAChC,OAAO,CAAC,MAAM,CAAS;IAEvB;;;OAGG;gBACS,UAAU,EAAE,eAAe;IAIvC;;;OAGG;IACH,aAAa,IAAI,eAAe;IAIhC;;;;OAIG;IACG,OAAO,CAAC,GAAG,SAAS,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IASpD;;OAEG;YACW,cAAc;IAoE5B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAkBzB;;OAEG;IACH,OAAO,CAAC,cAAc;IAUtB;;OAEG;IACH,OAAO,CAAC,eAAe;IAWvB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IA6B1B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAiB1B;;OAEG;IACH,OAAO,CAAC,eAAe;IAoBvB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAWzB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAM3B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAY3B;;OAEG;IACH,UAAU,IAAI,IAAI;IA0BlB;;;OAGG;IACH,WAAW,IAAI,OAAO;IAOtB;;;OAGG;IACH,kBAAkB,IAAI,GAAG,CAAC,MAAM,CAAC;IAUjC;;;;OAIG;IACG,YAAY,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC;IAoBjD;;OAEG;YACW,cAAc;IA2B5B;;;;;OAKG;IACG,uBAAuB,CAC3B,kBAAkB,EAAE,MAAM,EAC1B,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,MAAM,CAAC;IAelB;;;;;OAKG;IACG,iBAAiB,CACrB,kBAAkB,EAAE,MAAM,EAC1B,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,MAAM,CAAC;IAUlB;;;;;OAKG;IACG,qBAAqB,CACzB,SAAS,EAAE,MAAM,EACjB,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,OAAO,CAAC;IAgBnB;;;;;OAKG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,kBAAkB,GAAG,MAAM;IAC/D;;;;;;OAMG;IACH,SAAS,CACP,cAAc,EAAE,MAAM,EACtB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,kBAAkB,GAC3B,MAAM;IAiCT;;;OAGG;IACH,WAAW,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI;IAczC;;;;OAIG;IACG,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IA8BrE;;;;OAIG;IACG,qBAAqB,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC;CAItE"}

package/dist/types/client/NostrEventListener.d.ts

@@ -0,0 +1,40 @@
+/**
+ * NostrEventListener - Callback interface for receiving events and subscription status.
+ */
+import { Event } from '../protocol/Event.js';
+/**
+ * Listener interface for Nostr event subscriptions.
+ */
+export interface NostrEventListener {
+    /**
+     * Called when an event matching the subscription filter is received.
+     * @param event The received event
+     */
+    onEvent(event: Event): void;
+    /**
+     * Called when the relay signals End-Of-Stored-Events (EOSE).
+     * This indicates that all stored events matching the filter have been sent.
+     * @param subscriptionId The subscription ID
+     */
+    onEndOfStoredEvents?(subscriptionId: string): void;
+    /**
+     * Called when a subscription error occurs.
+     * @param subscriptionId The subscription ID
+     * @param error Error message from the relay
+     */
+    onError?(subscriptionId: string, error: string): void;
+}
+/**
+ * Simple callback-based event listener.
+ * Useful for creating listeners from callback functions.
+ */
+export declare class CallbackEventListener implements NostrEventListener {
+    private eventCallback;
+    private eoseCallback?;
+    private errorCallback?;
+    constructor(onEvent: (event: Event) => void, onEndOfStoredEvents?: (subscriptionId: string) => void, onError?: (subscriptionId: string, error: string) => void);
+    onEvent(event: Event): void;
+    onEndOfStoredEvents(subscriptionId: string): void;
+    onError(subscriptionId: string, error: string): void;
+}
+//# sourceMappingURL=NostrEventListener.d.ts.map

package/dist/types/client/NostrEventListener.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NostrEventListener.d.ts","sourceRoot":"","sources":["../../../src/client/NostrEventListener.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAE7C;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;OAGG;IACH,OAAO,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAE5B;;;;OAIG;IACH,mBAAmB,CAAC,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAEnD;;;;OAIG;IACH,OAAO,CAAC,CAAC,cAAc,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACvD;AAED;;;GAGG;AACH,qBAAa,qBAAsB,YAAW,kBAAkB;IAC9D,OAAO,CAAC,aAAa,CAAyB;IAC9C,OAAO,CAAC,YAAY,CAAC,CAAmC;IACxD,OAAO,CAAC,aAAa,CAAC,CAAkD;gBAGtE,OAAO,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,EAC/B,mBAAmB,CAAC,EAAE,CAAC,cAAc,EAAE,MAAM,KAAK,IAAI,EACtD,OAAO,CAAC,EAAE,CAAC,cAAc,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI;IAO3D,OAAO,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAI3B,mBAAmB,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI;IAIjD,OAAO,CAAC,cAAc,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;CAGrD"}

package/dist/types/client/WebSocketAdapter.d.ts

@@ -0,0 +1,55 @@
+/**
+ * WebSocketAdapter - Cross-platform WebSocket implementation.
+ * Provides a unified interface for WebSocket connections in Node.js and browsers.
+ */
+/**
+ * WebSocket message event interface
+ */
+export interface WebSocketMessageEvent {
+    data: string | ArrayBuffer | Blob;
+}
+/**
+ * WebSocket close event interface
+ */
+export interface WebSocketCloseEvent {
+    code: number;
+    reason: string;
+}
+/**
+ * WebSocket error event interface
+ */
+export interface WebSocketErrorEvent {
+    message?: string;
+    error?: Error;
+}
+/**
+ * Unified WebSocket interface for cross-platform compatibility.
+ */
+export interface IWebSocket {
+    readonly readyState: number;
+    onopen: ((event: unknown) => void) | null;
+    onmessage: ((event: WebSocketMessageEvent) => void) | null;
+    onclose: ((event: WebSocketCloseEvent) => void) | null;
+    onerror: ((event: WebSocketErrorEvent) => void) | null;
+    send(data: string): void;
+    close(code?: number, reason?: string): void;
+}
+/** WebSocket ready state constants */
+export declare const CONNECTING = 0;
+export declare const OPEN = 1;
+export declare const CLOSING = 2;
+export declare const CLOSED = 3;
+/**
+ * Create a WebSocket connection that works in both Node.js and browsers.
+ * @param url WebSocket URL (ws:// or wss://)
+ * @returns WebSocket instance
+ */
+export declare function createWebSocket(url: string): Promise<IWebSocket>;
+/**
+ * Extract string data from WebSocket message event.
+ * Handles different message types across platforms.
+ * @param event WebSocket message event
+ * @returns String message data
+ */
+export declare function extractMessageData(event: WebSocketMessageEvent): string;
+//# sourceMappingURL=WebSocketAdapter.d.ts.map

package/dist/types/client/WebSocketAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WebSocketAdapter.d.ts","sourceRoot":"","sources":["../../../src/client/WebSocketAdapter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,KAAK,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,MAAM,EAAE,CAAC,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC;IAC1C,SAAS,EAAE,CAAC,CAAC,KAAK,EAAE,qBAAqB,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC;IAC3D,OAAO,EAAE,CAAC,CAAC,KAAK,EAAE,mBAAmB,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC;IACvD,OAAO,EAAE,CAAC,CAAC,KAAK,EAAE,mBAAmB,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC;IACvD,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7C;AAED,sCAAsC;AACtC,eAAO,MAAM,UAAU,IAAI,CAAC;AAC5B,eAAO,MAAM,IAAI,IAAI,CAAC;AACtB,eAAO,MAAM,OAAO,IAAI,CAAC;AACzB,eAAO,MAAM,MAAM,IAAI,CAAC;AAExB;;;;GAIG;AACH,wBAAsB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAetE;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,qBAAqB,GAAG,MAAM,CAgBvE"}

package/dist/types/client/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Client module - Nostr relay client
+ */
+export { NostrClient } from './NostrClient.js';
+export { CallbackEventListener } from './NostrEventListener.js';
+export type { NostrEventListener } from './NostrEventListener.js';
+export { createWebSocket, extractMessageData, CONNECTING, OPEN, CLOSING, CLOSED, } from './WebSocketAdapter.js';
+export type { IWebSocket } from './WebSocketAdapter.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/client/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/client/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,YAAY,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,UAAU,EACV,IAAI,EACJ,OAAO,EACP,MAAM,GACP,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/types/crypto/bech32.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Bech32 encoding/decoding for NIP-19 key formats (npub, nsec).
+ * Implements the Bech32 specification for Nostr key encoding.
+ */
+/**
+ * Decoded Bech32 data structure
+ */
+export interface DecodedBech32 {
+    /** Human-readable part (e.g., "npub", "nsec") */
+    hrp: string;
+    /** Decoded data bytes */
+    data: Uint8Array;
+}
+/**
+ * Encode data with Bech32 checksum
+ * @param hrp Human-readable part (e.g., "npub", "nsec")
+ * @param data Data bytes to encode
+ * @returns Bech32-encoded string
+ */
+export declare function encode(hrp: string, data: Uint8Array): string;
+/**
+ * Decode a Bech32-encoded string
+ * @param bech32String The Bech32 string to decode
+ * @returns Decoded data with human-readable part
+ */
+export declare function decode(bech32String: string): DecodedBech32;
+/**
+ * Encode a public key as npub
+ * @param publicKey 32-byte public key
+ * @returns npub-encoded string
+ */
+export declare function encodeNpub(publicKey: Uint8Array): string;
+/**
+ * Decode an npub string to public key bytes
+ * @param npub npub-encoded string
+ * @returns 32-byte public key
+ */
+export declare function decodeNpub(npub: string): Uint8Array;
+/**
+ * Encode a private key as nsec
+ * @param privateKey 32-byte private key
+ * @returns nsec-encoded string
+ */
+export declare function encodeNsec(privateKey: Uint8Array): string;
+/**
+ * Decode an nsec string to private key bytes
+ * @param nsec nsec-encoded string
+ * @returns 32-byte private key
+ */
+export declare function decodeNsec(nsec: string): Uint8Array;
+//# sourceMappingURL=bech32.d.ts.map

package/dist/types/crypto/bech32.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bech32.d.ts","sourceRoot":"","sources":["../../../src/crypto/bech32.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,iDAAiD;IACjD,GAAG,EAAE,MAAM,CAAC;IACZ,yBAAyB;IACzB,IAAI,EAAE,UAAU,CAAC;CAClB;AA2FD;;;;;GAKG;AACH,wBAAgB,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,MAAM,CAe5D;AAED;;;;GAIG;AACH,wBAAgB,MAAM,CAAC,YAAY,EAAE,MAAM,GAAG,aAAa,CAsC1D;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,SAAS,EAAE,UAAU,GAAG,MAAM,CAKxD;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CASnD;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,UAAU,EAAE,UAAU,GAAG,MAAM,CAKzD;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CASnD"}

package/dist/types/crypto/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Crypto module - Cryptographic utilities for Nostr protocol
+ */
+export * from './bech32.js';
+export * as Bech32 from './bech32.js';
+export * from './schnorr.js';
+export * as SchnorrSigner from './schnorr.js';
+export * from './nip04.js';
+export * as NIP04 from './nip04.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/crypto/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/crypto/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,aAAa,CAAC;AAC5B,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC;AACtC,cAAc,cAAc,CAAC;AAC7B,OAAO,KAAK,aAAa,MAAM,cAAc,CAAC;AAC9C,cAAc,YAAY,CAAC;AAC3B,OAAO,KAAK,KAAK,MAAM,YAAY,CAAC"}

package/dist/types/crypto/nip04.d.ts

@@ -0,0 +1,56 @@
+/**
+ * NIP-04 Encryption implementation.
+ * AES-256-CBC encryption with ECDH key agreement and optional GZIP compression.
+ * Works in both Node.js and browser environments.
+ */
+/**
+ * Derive a shared secret using ECDH (NIP-04 compatible).
+ * Returns SHA-256(sharedPoint.x) as the shared secret.
+ * @param myPrivateKey 32-byte private key
+ * @param theirPublicKey 32-byte x-only public key
+ * @returns 32-byte shared secret
+ */
+export declare function deriveSharedSecret(myPrivateKey: Uint8Array, theirPublicKey: Uint8Array): Uint8Array;
+/**
+ * Derive a shared secret from hex-encoded keys
+ * @param myPrivateKeyHex Hex-encoded private key
+ * @param theirPublicKeyHex Hex-encoded public key
+ * @returns Hex-encoded shared secret
+ */
+export declare function deriveSharedSecretHex(myPrivateKeyHex: string, theirPublicKeyHex: string): string;
+/**
+ * Encrypt a message using NIP-04 encryption.
+ * Format: "base64(ciphertext)?iv=base64(iv)"
+ * If message > 1KB, automatically compresses with GZIP: "gz:base64(compressed)?iv=base64(iv)"
+ * @param message Message to encrypt
+ * @param myPrivateKey 32-byte private key
+ * @param theirPublicKey 32-byte x-only public key
+ * @returns Encrypted content string
+ */
+export declare function encrypt(message: string, myPrivateKey: Uint8Array, theirPublicKey: Uint8Array): Promise<string>;
+/**
+ * Encrypt a message using hex-encoded keys
+ * @param message Message to encrypt
+ * @param myPrivateKeyHex Hex-encoded private key
+ * @param theirPublicKeyHex Hex-encoded public key
+ * @returns Encrypted content string
+ */
+export declare function encryptHex(message: string, myPrivateKeyHex: string, theirPublicKeyHex: string): Promise<string>;
+/**
+ * Decrypt a NIP-04 encrypted message.
+ * Automatically decompresses if the message was compressed.
+ * @param encryptedContent Encrypted content string
+ * @param myPrivateKey 32-byte private key
+ * @param theirPublicKey 32-byte x-only public key
+ * @returns Decrypted message
+ */
+export declare function decrypt(encryptedContent: string, myPrivateKey: Uint8Array, theirPublicKey: Uint8Array): Promise<string>;
+/**
+ * Decrypt a message using hex-encoded keys
+ * @param encryptedContent Encrypted content string
+ * @param myPrivateKeyHex Hex-encoded private key
+ * @param theirPublicKeyHex Hex-encoded public key
+ * @returns Decrypted message
+ */
+export declare function decryptHex(encryptedContent: string, myPrivateKeyHex: string, theirPublicKeyHex: string): Promise<string>;
+//# sourceMappingURL=nip04.d.ts.map

package/dist/types/crypto/nip04.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nip04.d.ts","sourceRoot":"","sources":["../../../src/crypto/nip04.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AA4KH;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,YAAY,EAAE,UAAU,EACxB,cAAc,EAAE,UAAU,GACzB,UAAU,CAsBZ;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,eAAe,EAAE,MAAM,EACvB,iBAAiB,EAAE,MAAM,GACxB,MAAM,CAIR;AAED;;;;;;;;GAQG;AACH,wBAAsB,OAAO,CAC3B,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,UAAU,EACxB,cAAc,EAAE,UAAU,GACzB,OAAO,CAAC,MAAM,CAAC,CAiCjB;AAED;;;;;;GAMG;AACH,wBAAsB,UAAU,CAC9B,OAAO,EAAE,MAAM,EACf,eAAe,EAAE,MAAM,EACvB,iBAAiB,EAAE,MAAM,GACxB,OAAO,CAAC,MAAM,CAAC,CAIjB;AAED;;;;;;;GAOG;AACH,wBAAsB,OAAO,CAC3B,gBAAgB,EAAE,MAAM,EACxB,YAAY,EAAE,UAAU,EACxB,cAAc,EAAE,UAAU,GACzB,OAAO,CAAC,MAAM,CAAC,CAsCjB;AAED;;;;;;GAMG;AACH,wBAAsB,UAAU,CAC9B,gBAAgB,EAAE,MAAM,EACxB,eAAe,EAAE,MAAM,EACvB,iBAAiB,EAAE,MAAM,GACxB,OAAO,CAAC,MAAM,CAAC,CAIjB"}

package/dist/types/crypto/schnorr.d.ts

@@ -0,0 +1,47 @@
+/**
+ * BIP-340 Schnorr signature implementation using secp256k1.
+ * Uses @noble/curves for cryptographic operations.
+ */
+/**
+ * Get the x-only public key from a private key (BIP-340)
+ * @param privateKey 32-byte private key
+ * @returns 32-byte x-only public key
+ */
+export declare function getPublicKey(privateKey: Uint8Array): Uint8Array;
+/**
+ * Get the x-only public key from a hex-encoded private key
+ * @param privateKeyHex Hex-encoded private key
+ * @returns Hex-encoded x-only public key
+ */
+export declare function getPublicKeyHex(privateKeyHex: string): string;
+/**
+ * Sign a message using BIP-340 Schnorr signature
+ * @param message 32-byte message hash to sign
+ * @param privateKey 32-byte private key
+ * @returns 64-byte Schnorr signature (R.x || s)
+ */
+export declare function sign(message: Uint8Array, privateKey: Uint8Array): Uint8Array;
+/**
+ * Sign a message and return hex-encoded signature
+ * @param message 32-byte message hash to sign
+ * @param privateKey 32-byte private key
+ * @returns Hex-encoded 64-byte Schnorr signature
+ */
+export declare function signHex(message: Uint8Array, privateKey: Uint8Array): string;
+/**
+ * Verify a BIP-340 Schnorr signature
+ * @param signature 64-byte Schnorr signature
+ * @param message 32-byte message hash
+ * @param publicKey 32-byte x-only public key
+ * @returns true if the signature is valid
+ */
+export declare function verify(signature: Uint8Array, message: Uint8Array, publicKey: Uint8Array): boolean;
+/**
+ * Verify a hex-encoded Schnorr signature
+ * @param signatureHex Hex-encoded 64-byte signature
+ * @param message 32-byte message hash
+ * @param publicKeyHex Hex-encoded 32-byte public key
+ * @returns true if the signature is valid
+ */
+export declare function verifyHex(signatureHex: string, message: Uint8Array, publicKeyHex: string): boolean;
+//# sourceMappingURL=schnorr.d.ts.map

package/dist/types/crypto/schnorr.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schnorr.d.ts","sourceRoot":"","sources":["../../../src/crypto/schnorr.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,UAAU,EAAE,UAAU,GAAG,UAAU,CAK/D;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAI7D;AAED;;;;;GAKG;AACH,wBAAgB,IAAI,CAAC,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,GAAG,UAAU,CAQ5E;AAED;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,GAAG,MAAM,CAE3E;AAED;;;;;;GAMG;AACH,wBAAgB,MAAM,CACpB,SAAS,EAAE,UAAU,EACrB,OAAO,EAAE,UAAU,EACnB,SAAS,EAAE,UAAU,GACpB,OAAO,CAgBT;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CACvB,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,UAAU,EACnB,YAAY,EAAE,MAAM,GACnB,OAAO,CAQT"}

package/dist/types/index.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Unicity Nostr SDK
+ *
+ * A TypeScript SDK for Nostr protocol with Unicity extensions.
+ * Works in both Node.js and browser environments.
+ *
+ * Features:
+ * - BIP-340 Schnorr signatures
+ * - NIP-04 encrypted direct messages with GZIP compression
+ * - Multi-relay WebSocket connections with auto-reconnection
+ * - Token transfers over Nostr
+ * - Privacy-preserving nametag bindings
+ *
+ * @packageDocumentation
+ */
+export { NostrKeyManager } from './NostrKeyManager.js';
+export * from './crypto/index.js';
+export { Bech32, SchnorrSigner, NIP04, } from './crypto/index.js';
+export * from './protocol/index.js';
+export { EventKinds } from './protocol/index.js';
+export * from './client/index.js';
+export * from './nametag/index.js';
+export { NametagUtils, NametagBinding } from './nametag/index.js';
+export * from './token/index.js';
+export { TokenTransferProtocol } from './token/index.js';
+export type { DecodedBech32, } from './crypto/bech32.js';
+export type { EventTag, UnsignedEventData, SignedEventData, } from './protocol/Event.js';
+export type { FilterData, } from './protocol/Filter.js';
+export type { NostrEventListener, } from './client/NostrEventListener.js';
+export type { IWebSocket, WebSocketMessageEvent, WebSocketCloseEvent, WebSocketErrorEvent, } from './client/WebSocketAdapter.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAGvD,cAAc,mBAAmB,CAAC;AAClC,OAAO,EACL,MAAM,EACN,aAAa,EACb,KAAK,GACN,MAAM,mBAAmB,CAAC;AAG3B,cAAc,qBAAqB,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAGjD,cAAc,mBAAmB,CAAC;AAGlC,cAAc,oBAAoB,CAAC;AACnC,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAGlE,cAAc,kBAAkB,CAAC;AACjC,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAGzD,YAAY,EACV,aAAa,GACd,MAAM,oBAAoB,CAAC;AAE5B,YAAY,EACV,QAAQ,EACR,iBAAiB,EACjB,eAAe,GAChB,MAAM,qBAAqB,CAAC;AAE7B,YAAY,EACV,UAAU,GACX,MAAM,sBAAsB,CAAC;AAE9B,YAAY,EACV,kBAAkB,GACnB,MAAM,gCAAgC,CAAC;AAExC,YAAY,EACV,UAAU,EACV,qBAAqB,EACrB,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,8BAA8B,CAAC"}

package/dist/types/nametag/NametagBinding.d.ts

@@ -0,0 +1,68 @@
+/**
+ * NametagBinding - Create and parse nametag binding events.
+ * Uses kind 30078 (APP_DATA) for parameterized replaceable events.
+ */
+import { NostrKeyManager } from '../NostrKeyManager.js';
+import { Event } from '../protocol/Event.js';
+import { Filter } from '../protocol/Filter.js';
+/**
+ * Create a nametag binding event.
+ *
+ * Event structure:
+ * - Kind: 30078 (APP_DATA - parameterized replaceable)
+ * - Tags:
+ *   - ["d", "<hashed_nametag>"] - Required for parameterized replaceable
+ *   - ["nametag", "<hashed_nametag>"] - Hashed for privacy
+ *   - ["t", "<hashed_nametag>"] - Indexed tag for relay search
+ *   - ["address", "<unicity_addr>"] - Unicity blockchain address
+ * - Content: JSON with nametag_hash, address, verified timestamp
+ *
+ * @param keyManager Key manager with signing keys
+ * @param nametagId Nametag identifier (phone number or username)
+ * @param unicityAddress Unicity blockchain address
+ * @param defaultCountry Default country code for phone normalization
+ * @returns Signed event
+ */
+export declare function createBindingEvent(keyManager: NostrKeyManager, nametagId: string, unicityAddress: string, defaultCountry?: string): Promise<Event>;
+/**
+ * Create a filter to query pubkey by nametag.
+ * Query direction: nametag → pubkey
+ *
+ * @param nametagId Nametag identifier
+ * @param defaultCountry Default country code for phone normalization
+ * @returns Filter for nametag binding events
+ */
+export declare function createNametagToPubkeyFilter(nametagId: string, defaultCountry?: string): Filter;
+/**
+ * Create a filter to query nametags by pubkey.
+ * Query direction: pubkey → nametags
+ *
+ * @param nostrPubkey Nostr public key (hex)
+ * @returns Filter for nametag binding events
+ */
+export declare function createPubkeyToNametagFilter(nostrPubkey: string): Filter;
+/**
+ * Parse the hashed nametag from a binding event.
+ * Tries tags first, then content JSON.
+ *
+ * @param event Binding event
+ * @returns Hashed nametag, or undefined if not found
+ */
+export declare function parseNametagHashFromEvent(event: Event): string | undefined;
+/**
+ * Parse the Unicity address from a binding event.
+ * Tries tags first, then content JSON.
+ *
+ * @param event Binding event
+ * @returns Unicity address, or undefined if not found
+ */
+export declare function parseAddressFromEvent(event: Event): string | undefined;
+/**
+ * Verify that a binding event is valid.
+ * Checks signature and structure.
+ *
+ * @param event Event to verify
+ * @returns true if the binding event is valid
+ */
+export declare function isValidBindingEvent(event: Event): boolean;
+//# sourceMappingURL=NametagBinding.d.ts.map

package/dist/types/nametag/NametagBinding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NametagBinding.d.ts","sourceRoot":"","sources":["../../../src/nametag/NametagBinding.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAC7C,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAgB/C;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,kBAAkB,CACtC,UAAU,EAAE,eAAe,EAC3B,SAAS,EAAE,MAAM,EACjB,cAAc,EAAE,MAAM,EACtB,cAAc,GAAE,MAAwB,GACvC,OAAO,CAAC,KAAK,CAAC,CAqBhB;AAED;;;;;;;GAOG;AACH,wBAAgB,2BAA2B,CACzC,SAAS,EAAE,MAAM,EACjB,cAAc,GAAE,MAAwB,GACvC,MAAM,CAOR;AAED;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAMvE;AAED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,GAAG,SAAS,CAoB1E;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,GAAG,SAAS,CActE;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAuBzD"}

package/dist/types/nametag/NametagUtils.d.ts

@@ -0,0 +1,44 @@
+/**
+ * NametagUtils - Privacy-preserving nametag normalization and hashing.
+ * Supports phone number normalization to E.164 format.
+ */
+/**
+ * Normalize a nametag for hashing.
+ * - If it looks like a phone number, normalize to E.164
+ * - Otherwise, lowercase and remove @unicity suffix
+ * @param nametag Nametag to normalize
+ * @param defaultCountry Default country code for phone normalization
+ * @returns Normalized nametag
+ */
+export declare function normalizeNametag(nametag: string, defaultCountry?: string): string;
+/**
+ * Hash a nametag with the standard salt.
+ * @param nametag Nametag to hash
+ * @param defaultCountry Default country code for phone normalization
+ * @returns Hex-encoded SHA-256 hash
+ */
+export declare function hashNametag(nametag: string, defaultCountry?: string): string;
+/**
+ * Compare two nametags for equality (handling format variations).
+ * @param tag1 First nametag
+ * @param tag2 Second nametag
+ * @param defaultCountry Default country code for phone normalization
+ * @returns true if the nametags represent the same identity
+ */
+export declare function areSameNametag(tag1: string, tag2: string, defaultCountry?: string): boolean;
+/**
+ * Format a nametag for display (privacy-preserving).
+ * For phone numbers, hides middle digits.
+ * @param nametag Nametag to format
+ * @param defaultCountry Default country code for phone normalization
+ * @returns Display-safe formatted nametag
+ */
+export declare function formatForDisplay(nametag: string, defaultCountry?: string): string;
+/**
+ * Check if a string is a valid phone number.
+ * @param str String to check
+ * @param defaultCountry Default country code
+ * @returns true if the string is a valid phone number
+ */
+export declare function isPhoneNumber(str: string, defaultCountry?: string): boolean;
+//# sourceMappingURL=NametagUtils.d.ts.map

package/dist/types/nametag/NametagUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NametagUtils.d.ts","sourceRoot":"","sources":["../../../src/nametag/NametagUtils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA4EH;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,EACf,cAAc,GAAE,MAAwB,GACvC,MAAM,CAkBR;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CACzB,OAAO,EAAE,MAAM,EACf,cAAc,GAAE,MAAwB,GACvC,MAAM,CAGR;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,cAAc,GAAE,MAAwB,GACvC,OAAO,CAIT;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,EACf,cAAc,GAAE,MAAwB,GACvC,MAAM,CAiBR;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAC3B,GAAG,EAAE,MAAM,EACX,cAAc,GAAE,MAAwB,GACvC,OAAO,CAOT"}

package/dist/types/nametag/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Nametag module - Privacy-preserving identity bindings
+ */
+export * as NametagUtils from './NametagUtils.js';
+export * from './NametagUtils.js';
+export * as NametagBinding from './NametagBinding.js';
+export * from './NametagBinding.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/nametag/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/nametag/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,YAAY,MAAM,mBAAmB,CAAC;AAClD,cAAc,mBAAmB,CAAC;AAClC,OAAO,KAAK,cAAc,MAAM,qBAAqB,CAAC;AACtD,cAAc,qBAAqB,CAAC"}