@unicitylabs/nostr-js-sdk 0.0.1

package/dist/types/protocol/Event.d.ts

@@ -0,0 +1,112 @@
+/**
+ * Event - Represents a Nostr event (NIP-01).
+ * Provides serialization, signing, and verification functionality.
+ */
+import { NostrKeyManager } from '../NostrKeyManager.js';
+/**
+ * Type for event tags - arrays of strings where the first element is the tag name.
+ */
+export type EventTag = string[];
+/**
+ * Interface for unsigned event data (before signing).
+ */
+export interface UnsignedEventData {
+    kind: number;
+    tags: EventTag[];
+    content: string;
+    created_at?: number;
+}
+/**
+ * Interface for signed event data (complete event).
+ */
+export interface SignedEventData {
+    id: string;
+    pubkey: string;
+    created_at: number;
+    kind: number;
+    tags: EventTag[];
+    content: string;
+    sig: string;
+}
+/**
+ * Event class representing a Nostr event (NIP-01).
+ */
+export declare class Event implements SignedEventData {
+    /** Event ID - SHA-256 hash of the serialized event data (hex) */
+    id: string;
+    /** Creator's x-only public key (hex) */
+    pubkey: string;
+    /** Unix timestamp in seconds */
+    created_at: number;
+    /** Event kind (type) */
+    kind: number;
+    /** Event tags */
+    tags: EventTag[];
+    /** Event content */
+    content: string;
+    /** Schnorr signature (hex) */
+    sig: string;
+    /**
+     * Create an Event instance.
+     * @param data Signed event data
+     */
+    constructor(data: SignedEventData);
+    /**
+     * Create and sign a new event.
+     * @param keyManager Key manager with signing key
+     * @param data Unsigned event data
+     * @returns Signed Event instance
+     */
+    static create(keyManager: NostrKeyManager, data: UnsignedEventData): Event;
+    /**
+     * Calculate the event ID from event data.
+     * ID = SHA-256(serialized event data)
+     * Serialized format: [0, pubkey, created_at, kind, tags, content]
+     */
+    static calculateId(pubkey: string, created_at: number, kind: number, tags: EventTag[], content: string): string;
+    /**
+     * Verify the event signature.
+     * @returns true if the signature is valid
+     */
+    verify(): boolean;
+    /**
+     * Parse an event from JSON data.
+     * @param json JSON object or string
+     * @returns Event instance
+     */
+    static fromJSON(json: unknown): Event;
+    /**
+     * Check if data has valid event structure.
+     */
+    static isValidEventData(data: unknown): boolean;
+    /**
+     * Convert the event to a plain object.
+     * @returns Plain object representation
+     */
+    toJSON(): SignedEventData;
+    /**
+     * Get the first value of a tag by name.
+     * @param tagName Tag name to find
+     * @returns First value of the tag, or undefined if not found
+     */
+    getTagValue(tagName: string): string | undefined;
+    /**
+     * Get all values of a tag by name.
+     * @param tagName Tag name to find
+     * @returns Array of tag values
+     */
+    getTagValues(tagName: string): string[];
+    /**
+     * Check if a tag exists.
+     * @param tagName Tag name to check
+     * @returns true if the tag exists
+     */
+    hasTag(tagName: string): boolean;
+    /**
+     * Get all values from a single tag entry (excluding the tag name).
+     * @param tagName Tag name to find
+     * @returns Array of values from the first matching tag, or empty array
+     */
+    getTagEntryValues(tagName: string): string[];
+}
+//# sourceMappingURL=Event.d.ts.map

package/dist/types/protocol/Event.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Event.d.ts","sourceRoot":"","sources":["../../../src/protocol/Event.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAGxD;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,MAAM,EAAE,CAAC;AAEhC;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,QAAQ,EAAE,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,QAAQ,EAAE,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;GAEG;AACH,qBAAa,KAAM,YAAW,eAAe;IAC3C,iEAAiE;IACjE,EAAE,EAAE,MAAM,CAAC;IAEX,wCAAwC;IACxC,MAAM,EAAE,MAAM,CAAC;IAEf,gCAAgC;IAChC,UAAU,EAAE,MAAM,CAAC;IAEnB,wBAAwB;IACxB,IAAI,EAAE,MAAM,CAAC;IAEb,iBAAiB;IACjB,IAAI,EAAE,QAAQ,EAAE,CAAC;IAEjB,oBAAoB;IACpB,OAAO,EAAE,MAAM,CAAC;IAEhB,8BAA8B;IAC9B,GAAG,EAAE,MAAM,CAAC;IAEZ;;;OAGG;gBACS,IAAI,EAAE,eAAe;IAUjC;;;;;OAKG;IACH,MAAM,CAAC,MAAM,CAAC,UAAU,EAAE,eAAe,EAAE,IAAI,EAAE,iBAAiB,GAAG,KAAK;IAsB1E;;;;OAIG;IACH,MAAM,CAAC,WAAW,CAChB,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,QAAQ,EAAE,EAChB,OAAO,EAAE,MAAM,GACd,MAAM;IAMT;;;OAGG;IACH,MAAM,IAAI,OAAO;IA0BjB;;;;OAIG;IACH,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,KAAK;IAUrC;;OAEG;IACH,MAAM,CAAC,gBAAgB,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO;IAkB/C;;;OAGG;IACH,MAAM,IAAI,eAAe;IAYzB;;;;OAIG;IACH,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAKhD;;;;OAIG;IACH,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE;IAIvC;;;;OAIG;IACH,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAIhC;;;;OAIG;IACH,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE;CAI7C"}

package/dist/types/protocol/EventKinds.d.ts

@@ -0,0 +1,62 @@
+/**
+ * EventKinds - Standardized Nostr event kind definitions.
+ * Includes both standard NIP kinds and Unicity custom kinds.
+ */
+/** NIP-01: User profile metadata */
+export declare const PROFILE = 0;
+/** NIP-01: Short text note */
+export declare const TEXT_NOTE = 1;
+/** NIP-01: Recommend relay to followers */
+export declare const RECOMMEND_RELAY = 2;
+/** NIP-02: Contact list (follows) */
+export declare const CONTACTS = 3;
+/** NIP-04: Encrypted direct messages */
+export declare const ENCRYPTED_DM = 4;
+/** NIP-09: Event deletion */
+export declare const DELETION = 5;
+/** NIP-25: Reactions (likes, etc.) */
+export declare const REACTION = 7;
+/** NIP-59: Gift wrap for private events */
+export declare const GIFT_WRAP = 1059;
+/** NIP-65: Relay list metadata */
+export declare const RELAY_LIST = 10002;
+/** NIP-78: Application-specific data (parameterized replaceable) */
+export declare const APP_DATA = 30078;
+/** Unicity: Agent profile information */
+export declare const AGENT_PROFILE = 31111;
+/** Unicity: Agent GPS location */
+export declare const AGENT_LOCATION = 31112;
+/** Unicity: Token transfer event */
+export declare const TOKEN_TRANSFER = 31113;
+/** Unicity: File metadata */
+export declare const FILE_METADATA = 31114;
+/**
+ * Check if an event kind is replaceable.
+ * Replaceable events (kinds 0, 3, or 10000-19999) are replaced when a new
+ * event with the same kind and pubkey is published.
+ * @param kind Event kind number
+ * @returns true if the event kind is replaceable
+ */
+export declare function isReplaceable(kind: number): boolean;
+/**
+ * Check if an event kind is ephemeral.
+ * Ephemeral events (kinds 20000-29999) are not stored by relays.
+ * @param kind Event kind number
+ * @returns true if the event kind is ephemeral
+ */
+export declare function isEphemeral(kind: number): boolean;
+/**
+ * Check if an event kind is parameterized replaceable.
+ * Parameterized replaceable events (kinds 30000-39999) are replaced when a
+ * new event with the same kind, pubkey, and "d" tag value is published.
+ * @param kind Event kind number
+ * @returns true if the event kind is parameterized replaceable
+ */
+export declare function isParameterizedReplaceable(kind: number): boolean;
+/**
+ * Get a human-readable name for an event kind.
+ * @param kind Event kind number
+ * @returns Human-readable name for the event kind
+ */
+export declare function getName(kind: number): string;
+//# sourceMappingURL=EventKinds.d.ts.map

package/dist/types/protocol/EventKinds.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EventKinds.d.ts","sourceRoot":"","sources":["../../../src/protocol/EventKinds.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,oCAAoC;AACpC,eAAO,MAAM,OAAO,IAAI,CAAC;AAEzB,8BAA8B;AAC9B,eAAO,MAAM,SAAS,IAAI,CAAC;AAE3B,2CAA2C;AAC3C,eAAO,MAAM,eAAe,IAAI,CAAC;AAEjC,qCAAqC;AACrC,eAAO,MAAM,QAAQ,IAAI,CAAC;AAE1B,wCAAwC;AACxC,eAAO,MAAM,YAAY,IAAI,CAAC;AAE9B,6BAA6B;AAC7B,eAAO,MAAM,QAAQ,IAAI,CAAC;AAE1B,sCAAsC;AACtC,eAAO,MAAM,QAAQ,IAAI,CAAC;AAE1B,2CAA2C;AAC3C,eAAO,MAAM,SAAS,OAAO,CAAC;AAE9B,kCAAkC;AAClC,eAAO,MAAM,UAAU,QAAQ,CAAC;AAEhC,oEAAoE;AACpE,eAAO,MAAM,QAAQ,QAAQ,CAAC;AAM9B,yCAAyC;AACzC,eAAO,MAAM,aAAa,QAAQ,CAAC;AAEnC,kCAAkC;AAClC,eAAO,MAAM,cAAc,QAAQ,CAAC;AAEpC,oCAAoC;AACpC,eAAO,MAAM,cAAc,QAAQ,CAAC;AAEpC,6BAA6B;AAC7B,eAAO,MAAM,aAAa,QAAQ,CAAC;AAMnC;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEnD;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEjD;AAED;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEhE;AAED;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CA0C5C"}

package/dist/types/protocol/Filter.d.ts

@@ -0,0 +1,146 @@
+/**
+ * Filter - Nostr subscription filter (NIP-01).
+ * Provides a builder pattern for constructing filters.
+ */
+/**
+ * Filter data structure for Nostr subscriptions.
+ */
+export interface FilterData {
+    /** Event IDs to match */
+    ids?: string[];
+    /** Author public keys to match */
+    authors?: string[];
+    /** Event kinds to match */
+    kinds?: number[];
+    /** Events referenced by "e" tags */
+    '#e'?: string[];
+    /** Public keys referenced by "p" tags */
+    '#p'?: string[];
+    /** Topics/hashtags referenced by "t" tags */
+    '#t'?: string[];
+    /** Identifiers for parameterized replaceable events ("d" tags) */
+    '#d'?: string[];
+    /** Minimum timestamp (inclusive, Unix seconds) */
+    since?: number;
+    /** Maximum timestamp (inclusive, Unix seconds) */
+    until?: number;
+    /** Maximum number of events to return */
+    limit?: number;
+}
+/**
+ * Filter class for Nostr subscription queries.
+ * Use the builder pattern to construct filters.
+ */
+export declare class Filter implements FilterData {
+    ids?: string[];
+    authors?: string[];
+    kinds?: number[];
+    '#e'?: string[];
+    '#p'?: string[];
+    '#t'?: string[];
+    '#d'?: string[];
+    since?: number;
+    until?: number;
+    limit?: number;
+    /**
+     * Create a Filter instance.
+     * @param data Optional filter data
+     */
+    constructor(data?: FilterData);
+    /**
+     * Create a new Filter builder.
+     * @returns Filter builder instance
+     */
+    static builder(): FilterBuilder;
+    /**
+     * Convert the filter to a plain object for JSON serialization.
+     * Only includes defined properties.
+     * @returns Plain object representation
+     */
+    toJSON(): FilterData;
+    /**
+     * Parse a filter from JSON data.
+     * @param json JSON object or string
+     * @returns Filter instance
+     */
+    static fromJSON(json: unknown): Filter;
+}
+/**
+ * Builder class for constructing Filter instances.
+ */
+export declare class FilterBuilder {
+    private data;
+    /**
+     * Set event IDs to match.
+     * @param ids Event IDs (variadic or array)
+     * @returns This builder for chaining
+     */
+    ids(...ids: string[]): FilterBuilder;
+    ids(ids: string[]): FilterBuilder;
+    /**
+     * Set author public keys to match.
+     * @param authors Author public keys (variadic or array)
+     * @returns This builder for chaining
+     */
+    authors(...authors: string[]): FilterBuilder;
+    authors(authors: string[]): FilterBuilder;
+    /**
+     * Set event kinds to match.
+     * @param kinds Event kinds (variadic or array)
+     * @returns This builder for chaining
+     */
+    kinds(...kinds: number[]): FilterBuilder;
+    kinds(kinds: number[]): FilterBuilder;
+    /**
+     * Set "e" tags to match (event references).
+     * @param eTags Event IDs referenced by "e" tags (variadic or array)
+     * @returns This builder for chaining
+     */
+    eTags(...eTags: string[]): FilterBuilder;
+    eTags(eTags: string[]): FilterBuilder;
+    /**
+     * Set "p" tags to match (pubkey references).
+     * @param pTags Public keys referenced by "p" tags (variadic or array)
+     * @returns This builder for chaining
+     */
+    pTags(...pTags: string[]): FilterBuilder;
+    pTags(pTags: string[]): FilterBuilder;
+    /**
+     * Set "t" tags to match (topics/hashtags).
+     * @param tTags Topics referenced by "t" tags (variadic or array)
+     * @returns This builder for chaining
+     */
+    tTags(...tTags: string[]): FilterBuilder;
+    tTags(tTags: string[]): FilterBuilder;
+    /**
+     * Set "d" tags to match (parameterized replaceable identifiers).
+     * @param dTags Identifiers referenced by "d" tags (variadic or array)
+     * @returns This builder for chaining
+     */
+    dTags(...dTags: string[]): FilterBuilder;
+    dTags(dTags: string[]): FilterBuilder;
+    /**
+     * Set minimum timestamp (inclusive).
+     * @param since Unix timestamp in seconds
+     * @returns This builder for chaining
+     */
+    since(since: number): FilterBuilder;
+    /**
+     * Set maximum timestamp (inclusive).
+     * @param until Unix timestamp in seconds
+     * @returns This builder for chaining
+     */
+    until(until: number): FilterBuilder;
+    /**
+     * Set maximum number of events to return.
+     * @param limit Maximum number of events
+     * @returns This builder for chaining
+     */
+    limit(limit: number): FilterBuilder;
+    /**
+     * Build the Filter instance.
+     * @returns Filter instance
+     */
+    build(): Filter;
+}
+//# sourceMappingURL=Filter.d.ts.map

package/dist/types/protocol/Filter.d.ts.map

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

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

@@ -0,0 +1,10 @@
+/**
+ * Protocol module - Nostr protocol types and classes
+ */
+export { Event } from './Event.js';
+export type { EventTag, UnsignedEventData, SignedEventData } from './Event.js';
+export { Filter, FilterBuilder } from './Filter.js';
+export type { FilterData } from './Filter.js';
+export * as EventKinds from './EventKinds.js';
+export * from './EventKinds.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/protocol/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,YAAY,EAAE,QAAQ,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC/E,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACpD,YAAY,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,UAAU,MAAM,iBAAiB,CAAC;AAC9C,cAAc,iBAAiB,CAAC"}

package/dist/types/token/TokenTransferProtocol.d.ts

@@ -0,0 +1,67 @@
+/**
+ * TokenTransferProtocol - Encapsulate Unicity token transfers over Nostr.
+ * Uses NIP-04 encryption with optional GZIP compression.
+ */
+import { NostrKeyManager } from '../NostrKeyManager.js';
+import { Event } from '../protocol/Event.js';
+/**
+ * Create a token transfer event.
+ *
+ * Event structure:
+ * - Kind: 31113 (TOKEN_TRANSFER - Unicity custom)
+ * - Tags:
+ *   - ["p", "<recipient_pubkey_hex>"] - Recipient
+ *   - ["type", "token_transfer"] - Event type
+ *   - ["amount", "<amount>"] - Optional amount
+ *   - ["symbol", "<symbol>"] - Optional token symbol
+ * - Content: NIP-04 encrypted "token_transfer:{tokenJson}"
+ *
+ * @param keyManager Key manager with signing keys
+ * @param recipientPubkeyHex Recipient's public key (hex)
+ * @param tokenJson Token JSON string
+ * @param amount Optional amount for metadata
+ * @param symbol Optional token symbol for metadata
+ * @returns Signed event
+ */
+export declare function createTokenTransferEvent(keyManager: NostrKeyManager, recipientPubkeyHex: string, tokenJson: string, amount?: number | bigint, symbol?: string): Promise<Event>;
+/**
+ * Parse a token transfer event.
+ * Decrypts and decompresses the token data.
+ *
+ * @param event Token transfer event
+ * @param keyManager Key manager for decryption
+ * @returns Token JSON string
+ * @throws Error if the event is not a valid token transfer
+ */
+export declare function parseTokenTransfer(event: Event, keyManager: NostrKeyManager): Promise<string>;
+/**
+ * Get the amount from a token transfer event.
+ * @param event Token transfer event
+ * @returns Amount, or undefined if not specified
+ */
+export declare function getAmount(event: Event): bigint | undefined;
+/**
+ * Get the symbol from a token transfer event.
+ * @param event Token transfer event
+ * @returns Symbol, or undefined if not specified
+ */
+export declare function getSymbol(event: Event): string | undefined;
+/**
+ * Check if an event is a token transfer.
+ * @param event Event to check
+ * @returns true if the event is a token transfer
+ */
+export declare function isTokenTransfer(event: Event): boolean;
+/**
+ * Get the recipient public key from a token transfer event.
+ * @param event Token transfer event
+ * @returns Recipient public key (hex), or undefined if not found
+ */
+export declare function getRecipient(event: Event): string | undefined;
+/**
+ * Get the sender public key from a token transfer event.
+ * @param event Token transfer event
+ * @returns Sender public key (hex)
+ */
+export declare function getSender(event: Event): string;
+//# sourceMappingURL=TokenTransferProtocol.d.ts.map

package/dist/types/token/TokenTransferProtocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TokenTransferProtocol.d.ts","sourceRoot":"","sources":["../../../src/token/TokenTransferProtocol.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAM7C;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,wBAAwB,CAC5C,UAAU,EAAE,eAAe,EAC3B,kBAAkB,EAAE,MAAM,EAC1B,SAAS,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,EACxB,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,KAAK,CAAC,CA0BhB;AAED;;;;;;;;GAQG;AACH,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,KAAK,EACZ,UAAU,EAAE,eAAe,GAC1B,OAAO,CAAC,MAAM,CAAC,CA8CjB;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,GAAG,SAAS,CAU1D;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,GAAG,SAAS,CAE1D;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAKrD;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,GAAG,SAAS,CAE7D;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAE9C"}

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

@@ -0,0 +1,6 @@
+/**
+ * Token module - Unicity token transfers over Nostr
+ */
+export * as TokenTransferProtocol from './TokenTransferProtocol.js';
+export * from './TokenTransferProtocol.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/token/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,qBAAqB,MAAM,4BAA4B,CAAC;AACpE,cAAc,4BAA4B,CAAC"}

package/package.json

@@ -0,0 +1,89 @@
+{
+  "name": "@unicitylabs/nostr-js-sdk",
+  "version": "0.0.1",
+  "description": "Unicity Nostr SDK - Token transfers and nametag bindings over Nostr protocol",
+  "license": "MIT",
+  "author": "Unicity Labs",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/unicitylabs/unicity-nostr-js-sdk"
+  },
+  "keywords": [
+    "nostr",
+    "unicity",
+    "token",
+    "blockchain",
+    "cryptocurrency",
+    "websocket",
+    "schnorr",
+    "bip340"
+  ],
+  "type": "module",
+  "main": "./dist/cjs/index.js",
+  "module": "./dist/esm/index.js",
+  "browser": "./dist/browser/index.js",
+  "types": "./dist/types/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/types/index.d.ts",
+        "default": "./dist/esm/index.js"
+      },
+      "require": {
+        "types": "./dist/types/index.d.ts",
+        "default": "./dist/cjs/index.js"
+      },
+      "browser": {
+        "types": "./dist/types/index.d.ts",
+        "default": "./dist/browser/index.js"
+      }
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "npm run build:esm && npm run build:cjs && npm run build:browser && npm run build:types",
+    "build:esm": "tsc -p tsconfig.esm.json",
+    "build:cjs": "tsc -p tsconfig.cjs.json",
+    "build:browser": "rollup -c rollup.config.js",
+    "build:types": "tsc -p tsconfig.types.json",
+    "build:check": "tsc --noEmit",
+    "clean": "rm -rf dist",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:unit": "vitest run --testPathPattern=unit",
+    "test:integration": "vitest run --testPathPattern=integration",
+    "test:coverage": "vitest run --coverage",
+    "lint": "eslint src --ext .ts",
+    "lint:fix": "eslint src --ext .ts --fix",
+    "prepublishOnly": "npm run clean && npm run build && npm test"
+  },
+  "dependencies": {
+    "@noble/curves": "^1.6.0",
+    "@noble/hashes": "^1.5.0",
+    "@scure/base": "^1.1.9",
+    "libphonenumber-js": "^1.11.14"
+  },
+  "devDependencies": {
+    "@rollup/plugin-commonjs": "^28.0.1",
+    "@rollup/plugin-node-resolve": "^15.3.0",
+    "@rollup/plugin-terser": "^0.4.4",
+    "@rollup/plugin-typescript": "^12.1.1",
+    "@types/node": "^22.9.0",
+    "@types/ws": "^8.18.1",
+    "@typescript-eslint/eslint-plugin": "^8.14.0",
+    "@typescript-eslint/parser": "^8.14.0",
+    "eslint": "^9.14.0",
+    "rollup": "^4.27.2",
+    "tslib": "^2.8.1",
+    "typescript": "^5.6.3",
+    "vitest": "^2.1.5",
+    "ws": "^8.18.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}