nostr-core 0.4.0 → 0.7.0

package/dist/lnurl.js

@@ -0,0 +1,343 @@
+import { bech32 } from '@scure/base';
+import { utf8Encoder, utf8Decoder } from './utils.js';
+// ── Error ──────────────────────────────────────────────────────────────
+export class LnurlError extends Error {
+    code;
+    constructor(message, code = 'LNURL_ERROR') {
+        super(message);
+        this.name = 'LnurlError';
+        this.code = code;
+    }
+}
+// ── LUD-01: Bech32 encode/decode ───────────────────────────────────────
+/**
+ * Encode a URL as an LNURL bech32 string.
+ */
+export function encodeLnurl(url) {
+    const data = utf8Encoder.encode(url);
+    const words = bech32.toWords(data);
+    return bech32.encode('lnurl', words, 1023);
+}
+/**
+ * Decode an LNURL bech32 string back to a URL.
+ */
+export function decodeLnurl(encoded) {
+    const { prefix, words } = bech32.decode(encoded.toLowerCase(), 1023);
+    if (prefix !== 'lnurl') {
+        throw new LnurlError(`Invalid LNURL prefix: expected "lnurl", got "${prefix}"`);
+    }
+    const data = new Uint8Array(bech32.fromWords(words));
+    return utf8Decoder.decode(data);
+}
+/**
+ * Check if a string is a valid bech32-encoded LNURL.
+ */
+export function isLnurl(str) {
+    try {
+        decodeLnurl(str);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+// ── LUD-17: Scheme prefixes ────────────────────────────────────────────
+const SCHEME_MAP = {
+    'lnurlp://': 'payRequest',
+    'lnurlw://': 'withdrawRequest',
+    'lnurlc://': 'channelRequest',
+    'keyauth://': 'login',
+};
+/**
+ * Resolve an LNURL string to a plain URL.
+ * Accepts bech32-encoded LNURL, scheme-prefixed URLs (LUD-17),
+ * or plain https:// URLs (passthrough).
+ */
+export function resolveUrl(input) {
+    // LUD-17: scheme prefixes
+    for (const [scheme, tag] of Object.entries(SCHEME_MAP)) {
+        if (input.startsWith(scheme)) {
+            const rest = input.slice(scheme.length);
+            const isOnion = rest.includes('.onion');
+            const protocol = isOnion ? 'http://' : 'https://';
+            return { url: `${protocol}${rest}`, tag };
+        }
+    }
+    // Plain URL passthrough
+    if (input.startsWith('https://') || input.startsWith('http://')) {
+        return { url: input };
+    }
+    // LUD-01: bech32
+    const url = decodeLnurl(input);
+    return { url };
+}
+// ── LUD-20: Metadata parsing ───────────────────────────────────────────
+/**
+ * Parse the LNURL metadata JSON string into structured data.
+ * Metadata is a JSON-encoded array of [mime-type, content] tuples.
+ */
+export function parseLnurlMetadata(metadata) {
+    let entries;
+    try {
+        entries = JSON.parse(metadata);
+    }
+    catch {
+        throw new LnurlError('Invalid LNURL metadata: not valid JSON');
+    }
+    if (!Array.isArray(entries)) {
+        throw new LnurlError('Invalid LNURL metadata: expected array');
+    }
+    let plainText = '';
+    let longDesc;
+    let image;
+    for (const entry of entries) {
+        if (!Array.isArray(entry) || entry.length < 2)
+            continue;
+        const [mime, content] = entry;
+        if (mime === 'text/plain') {
+            plainText = content;
+        }
+        else if (mime === 'text/long-desc') {
+            longDesc = content;
+        }
+        else if (mime.startsWith('image/') && !image) {
+            image = { type: mime, data: content };
+        }
+    }
+    return { plainText, longDesc, image, entries };
+}
+// ── LUD-06: payRequest ─────────────────────────────────────────────────
+/**
+ * Fetch a pay request from an LNURL (bech32, scheme-prefixed, or plain URL).
+ */
+export async function fetchPayRequest(input) {
+    const { url } = resolveUrl(input);
+    let data;
+    try {
+        const res = await fetch(url);
+        if (!res.ok)
+            throw new LnurlError(`HTTP ${res.status} from ${url}`);
+        data = (await res.json());
+    }
+    catch (err) {
+        if (err instanceof LnurlError)
+            throw err;
+        throw new LnurlError(`Failed to fetch pay request: ${err.message}`);
+    }
+    if (data.status === 'ERROR') {
+        throw new LnurlError(`LNURL error: ${data.reason || 'Unknown'}`);
+    }
+    if (data.tag !== 'payRequest') {
+        throw new LnurlError(`Expected tag "payRequest", got "${data.tag}"`);
+    }
+    return {
+        tag: 'payRequest',
+        callback: data.callback,
+        minSendable: data.minSendable,
+        maxSendable: data.maxSendable,
+        metadata: data.metadata,
+        commentAllowed: data.commentAllowed,
+        payerData: data.payerData,
+        allowsNostr: data.allowsNostr,
+        nostrPubkey: data.nostrPubkey,
+    };
+}
+/**
+ * Request an invoice from a pay request callback (LUD-06/12/18).
+ */
+export async function requestInvoice(payRequest, amountMsats, opts) {
+    if (amountMsats < payRequest.minSendable || amountMsats > payRequest.maxSendable) {
+        throw new LnurlError(`Amount ${amountMsats} msats outside allowed range [${payRequest.minSendable}, ${payRequest.maxSendable}]`);
+    }
+    const sep = payRequest.callback.includes('?') ? '&' : '?';
+    let url = `${payRequest.callback}${sep}amount=${amountMsats}`;
+    // LUD-12: comment
+    if (opts?.comment) {
+        if (payRequest.commentAllowed && opts.comment.length > payRequest.commentAllowed) {
+            throw new LnurlError(`Comment exceeds max length of ${payRequest.commentAllowed} chars`);
+        }
+        url += `&comment=${encodeURIComponent(opts.comment)}`;
+    }
+    // LUD-18: payer data
+    if (opts?.payerData) {
+        url += `&payerdata=${encodeURIComponent(JSON.stringify(opts.payerData))}`;
+    }
+    // Nostr zap request
+    if (opts?.nostr) {
+        url += `&nostr=${encodeURIComponent(opts.nostr)}`;
+    }
+    let data;
+    try {
+        const res = await fetch(url);
+        if (!res.ok)
+            throw new LnurlError(`Callback HTTP ${res.status}`);
+        data = (await res.json());
+    }
+    catch (err) {
+        if (err instanceof LnurlError)
+            throw err;
+        throw new LnurlError(`Failed to request invoice: ${err.message}`);
+    }
+    if (data.status === 'ERROR') {
+        throw new LnurlError(`Callback error: ${data.reason || 'Unknown'}`);
+    }
+    if (!data.pr) {
+        throw new LnurlError('Invalid callback response: missing invoice (pr field)');
+    }
+    return {
+        pr: data.pr,
+        routes: data.routes || [],
+        successAction: data.successAction,
+        verify: data.verify,
+    };
+}
+// ── LUD-03: withdrawRequest ────────────────────────────────────────────
+/**
+ * Fetch a withdraw request from an LNURL.
+ */
+export async function fetchWithdrawRequest(input) {
+    const { url } = resolveUrl(input);
+    let data;
+    try {
+        const res = await fetch(url);
+        if (!res.ok)
+            throw new LnurlError(`HTTP ${res.status} from ${url}`);
+        data = (await res.json());
+    }
+    catch (err) {
+        if (err instanceof LnurlError)
+            throw err;
+        throw new LnurlError(`Failed to fetch withdraw request: ${err.message}`);
+    }
+    if (data.status === 'ERROR') {
+        throw new LnurlError(`LNURL error: ${data.reason || 'Unknown'}`);
+    }
+    if (data.tag !== 'withdrawRequest') {
+        throw new LnurlError(`Expected tag "withdrawRequest", got "${data.tag}"`);
+    }
+    return {
+        tag: 'withdrawRequest',
+        callback: data.callback,
+        k1: data.k1,
+        defaultDescription: data.defaultDescription,
+        minWithdrawable: data.minWithdrawable,
+        maxWithdrawable: data.maxWithdrawable,
+    };
+}
+/**
+ * Submit a withdraw request with a BOLT-11 invoice.
+ */
+export async function submitWithdrawRequest(withdrawRequest, invoice) {
+    const sep = withdrawRequest.callback.includes('?') ? '&' : '?';
+    const url = `${withdrawRequest.callback}${sep}k1=${withdrawRequest.k1}&pr=${invoice}`;
+    let data;
+    try {
+        const res = await fetch(url);
+        if (!res.ok)
+            throw new LnurlError(`Withdraw callback HTTP ${res.status}`);
+        data = (await res.json());
+    }
+    catch (err) {
+        if (err instanceof LnurlError)
+            throw err;
+        throw new LnurlError(`Failed to submit withdraw request: ${err.message}`);
+    }
+    if (data.status === 'ERROR') {
+        throw new LnurlError(`Withdraw error: ${data.reason || 'Unknown'}`);
+    }
+}
+// ── LUD-09/10: Success action handling ─────────────────────────────────
+/**
+ * Parse and validate a success action object.
+ */
+export function parseSuccessAction(raw) {
+    const action = raw;
+    if (!action || typeof action !== 'object' || !action.tag) {
+        throw new LnurlError('Invalid success action: missing tag');
+    }
+    switch (action.tag) {
+        case 'message':
+            return { tag: 'message', message: action.message || '' };
+        case 'url':
+            return {
+                tag: 'url',
+                description: action.description || '',
+                url: action.url || '',
+            };
+        case 'aes':
+            return {
+                tag: 'aes',
+                description: action.description || '',
+                ciphertext: action.ciphertext || '',
+                iv: action.iv || '',
+            };
+        default:
+            throw new LnurlError(`Unknown success action tag: ${action.tag}`);
+    }
+}
+/**
+ * Decrypt an AES success action using the payment preimage (LUD-10).
+ * Uses AES-256-CBC with PKCS5 padding.
+ *
+ * @param action - The AES success action from the callback response
+ * @param preimageHex - The payment preimage as a hex string (32 bytes)
+ * @returns The decrypted plaintext string
+ */
+export async function decryptAesSuccessAction(action, preimageHex) {
+    // Convert hex preimage to bytes (32 bytes = 256-bit key)
+    const key = hexToBytes(preimageHex);
+    if (key.length !== 32) {
+        throw new LnurlError('Preimage must be 32 bytes (64 hex chars)');
+    }
+    const iv = base64ToBytes(action.iv);
+    const ciphertext = base64ToBytes(action.ciphertext);
+    // Use Web Crypto API for AES-256-CBC
+    const cryptoKey = await crypto.subtle.importKey('raw', key.buffer, { name: 'AES-CBC' }, false, [
+        'decrypt',
+    ]);
+    const decrypted = await crypto.subtle.decrypt({ name: 'AES-CBC', iv: iv.buffer }, cryptoKey, ciphertext.buffer);
+    return utf8Decoder.decode(new Uint8Array(decrypted));
+}
+// ── LUD-21: Verify payments ────────────────────────────────────────────
+/**
+ * Poll a verify URL to check if a payment has been settled.
+ */
+export async function verifyPayment(verifyUrl) {
+    let data;
+    try {
+        const res = await fetch(verifyUrl);
+        if (!res.ok)
+            throw new LnurlError(`Verify HTTP ${res.status}`);
+        data = (await res.json());
+    }
+    catch (err) {
+        if (err instanceof LnurlError)
+            throw err;
+        throw new LnurlError(`Failed to verify payment: ${err.message}`);
+    }
+    if (data.status === 'ERROR') {
+        throw new LnurlError(`Verify error: ${data.reason || 'Unknown'}`);
+    }
+    return {
+        settled: data.settled,
+        preimage: data.preimage || null,
+        pr: data.pr,
+    };
+}
+// ── Helpers ────────────────────────────────────────────────────────────
+function hexToBytes(hex) {
+    const bytes = new Uint8Array(hex.length / 2);
+    for (let i = 0; i < bytes.length; i++) {
+        bytes[i] = parseInt(hex.slice(i * 2, i * 2 + 2), 16);
+    }
+    return bytes;
+}
+function base64ToBytes(b64) {
+    const binary = atob(b64);
+    const bytes = new Uint8Array(binary.length);
+    for (let i = 0; i < binary.length; i++) {
+        bytes[i] = binary.charCodeAt(i);
+    }
+    return bytes;
+}
+//# sourceMappingURL=lnurl.js.map

package/dist/lnurl.js.map

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

package/dist/nip02.d.ts

@@ -0,0 +1,27 @@
+import { type NostrEvent, type EventTemplate } from './event.js';
+export type ContactEntry = {
+    pubkey: string;
+    relay?: string;
+    petname?: string;
+};
+/**
+ * Create a kind 3 follow list (contact list) event template (unsigned).
+ */
+export declare function createFollowListEventTemplate(contacts: ContactEntry[]): EventTemplate;
+/**
+ * Create and sign a kind 3 follow list event.
+ */
+export declare function createFollowListEvent(contacts: ContactEntry[], secretKey: Uint8Array): NostrEvent;
+/**
+ * Parse a kind 3 follow list event into contact entries.
+ */
+export declare function parseFollowList(event: NostrEvent): ContactEntry[];
+/**
+ * Check if a pubkey is in a follow list event.
+ */
+export declare function isFollowing(event: NostrEvent, pubkey: string): boolean;
+/**
+ * Get all followed pubkeys from a follow list event.
+ */
+export declare function getFollowedPubkeys(event: NostrEvent): string[];
+//# sourceMappingURL=nip02.d.ts.map

package/dist/nip02.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nip02.d.ts","sourceRoot":"","sources":["../src/nip02.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,UAAU,EAAE,KAAK,aAAa,EAAE,MAAM,YAAY,CAAA;AAE/E,MAAM,MAAM,YAAY,GAAG;IACzB,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB,CAAA;AAED;;GAEG;AACH,wBAAgB,6BAA6B,CAAC,QAAQ,EAAE,YAAY,EAAE,GAAG,aAAa,CAgBrF;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,YAAY,EAAE,EAAE,SAAS,EAAE,UAAU,GAAG,UAAU,CAEjG;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,UAAU,GAAG,YAAY,EAAE,CASjE;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAEtE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,EAAE,CAE9D"}

package/dist/nip02.js

@@ -0,0 +1,55 @@
+import { finalizeEvent } from './event.js';
+/**
+ * Create a kind 3 follow list (contact list) event template (unsigned).
+ */
+export function createFollowListEventTemplate(contacts) {
+    const tags = contacts.map(c => {
+        const tag = ['p', c.pubkey];
+        tag.push(c.relay ?? '');
+        tag.push(c.petname ?? '');
+        // Trim trailing empty strings
+        while (tag.length > 1 && tag[tag.length - 1] === '')
+            tag.pop();
+        return tag;
+    });
+    return {
+        kind: 3,
+        tags,
+        content: '',
+        created_at: Math.floor(Date.now() / 1000),
+    };
+}
+/**
+ * Create and sign a kind 3 follow list event.
+ */
+export function createFollowListEvent(contacts, secretKey) {
+    return finalizeEvent(createFollowListEventTemplate(contacts), secretKey);
+}
+/**
+ * Parse a kind 3 follow list event into contact entries.
+ */
+export function parseFollowList(event) {
+    return event.tags
+        .filter(t => t[0] === 'p' && t[1])
+        .map(t => {
+        const entry = { pubkey: t[1] };
+        if (t[2])
+            entry.relay = t[2];
+        if (t[3])
+            entry.petname = t[3];
+        return entry;
+    });
+}
+/**
+ * Check if a pubkey is in a follow list event.
+ */
+export function isFollowing(event, pubkey) {
+    return event.tags.some(t => t[0] === 'p' && t[1] === pubkey);
+}
+/**
+ * Get all followed pubkeys from a follow list event.
+ */
+export function getFollowedPubkeys(event) {
+    return event.tags.filter(t => t[0] === 'p' && t[1]).map(t => t[1]);
+}
+//# sourceMappingURL=nip02.js.map

package/dist/nip02.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nip02.js","sourceRoot":"","sources":["../src/nip02.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAuC,MAAM,YAAY,CAAA;AAQ/E;;GAEG;AACH,MAAM,UAAU,6BAA6B,CAAC,QAAwB;IACpE,MAAM,IAAI,GAAe,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE;QACxC,MAAM,GAAG,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,MAAM,CAAC,CAAA;QAC3B,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC,CAAA;QACvB,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,IAAI,EAAE,CAAC,CAAA;QACzB,8BAA8B;QAC9B,OAAO,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,GAAG,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,KAAK,EAAE;YAAE,GAAG,CAAC,GAAG,EAAE,CAAA;QAC9D,OAAO,GAAG,CAAA;IACZ,CAAC,CAAC,CAAA;IAEF,OAAO;QACL,IAAI,EAAE,CAAC;QACP,IAAI;QACJ,OAAO,EAAE,EAAE;QACX,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC;KAC1C,CAAA;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB,CAAC,QAAwB,EAAE,SAAqB;IACnF,OAAO,aAAa,CAAC,6BAA6B,CAAC,QAAQ,CAAC,EAAE,SAAS,CAAC,CAAA;AAC1E,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,KAAiB;IAC/C,OAAO,KAAK,CAAC,IAAI;SACd,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;SACjC,GAAG,CAAC,CAAC,CAAC,EAAE;QACP,MAAM,KAAK,GAAiB,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;QAC5C,IAAI,CAAC,CAAC,CAAC,CAAC;YAAE,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAA;QAC5B,IAAI,CAAC,CAAC,CAAC,CAAC;YAAE,KAAK,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,CAAA;QAC9B,OAAO,KAAK,CAAA;IACd,CAAC,CAAC,CAAA;AACN,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,KAAiB,EAAE,MAAc;IAC3D,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,CAAA;AAC9D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAiB;IAClD,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;AACpE,CAAC"}

package/dist/nip05.d.ts

@@ -0,0 +1,24 @@
+export type Nip05Result = {
+    pubkey: string;
+    relays?: string[];
+};
+export declare class Nip05Error extends Error {
+    code: string;
+    constructor(message: string, code?: string);
+}
+/**
+ * Parse a NIP-05 address into name and domain parts.
+ */
+export declare function parseNip05Address(address: string): {
+    name: string;
+    domain: string;
+};
+/**
+ * Query a NIP-05 address and return the associated pubkey and relays.
+ */
+export declare function queryNip05(address: string): Promise<Nip05Result>;
+/**
+ * Verify that a NIP-05 address resolves to the expected pubkey.
+ */
+export declare function verifyNip05(address: string, expectedPubkey: string): Promise<boolean>;
+//# sourceMappingURL=nip05.d.ts.map

package/dist/nip05.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nip05.d.ts","sourceRoot":"","sources":["../src/nip05.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,WAAW,GAAG;IACxB,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;CAClB,CAAA;AAED,qBAAa,UAAW,SAAQ,KAAK;IACnC,IAAI,EAAE,MAAM,CAAA;gBACA,OAAO,EAAE,MAAM,EAAE,IAAI,SAAgB;CAKlD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAInF;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAyBtE;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAO3F"}

package/dist/nip05.js

@@ -0,0 +1,57 @@
+export class Nip05Error extends Error {
+    code;
+    constructor(message, code = 'NIP05_ERROR') {
+        super(message);
+        this.name = 'Nip05Error';
+        this.code = code;
+    }
+}
+/**
+ * Parse a NIP-05 address into name and domain parts.
+ */
+export function parseNip05Address(address) {
+    const match = address.match(/^([^@]+)@([^@]+)$/);
+    if (!match)
+        throw new Nip05Error(`Invalid NIP-05 address: ${address}`, 'INVALID_ADDRESS');
+    return { name: match[1], domain: match[2] };
+}
+/**
+ * Query a NIP-05 address and return the associated pubkey and relays.
+ */
+export async function queryNip05(address) {
+    const { name, domain } = parseNip05Address(address);
+    const url = `https://${domain}/.well-known/nostr.json?name=${encodeURIComponent(name)}`;
+    let json;
+    try {
+        const res = await fetch(url);
+        if (!res.ok)
+            throw new Nip05Error(`HTTP ${res.status} from ${domain}`, 'FETCH_ERROR');
+        json = (await res.json());
+    }
+    catch (err) {
+        if (err instanceof Nip05Error)
+            throw err;
+        throw new Nip05Error(`Failed to query ${domain}: ${err.message}`, 'FETCH_ERROR');
+    }
+    const names = json.names;
+    if (!names || !names[name]) {
+        throw new Nip05Error(`Name "${name}" not found on ${domain}`, 'NOT_FOUND');
+    }
+    const pubkey = names[name];
+    const relaysMap = json.relays;
+    const relays = relaysMap?.[pubkey];
+    return { pubkey, relays };
+}
+/**
+ * Verify that a NIP-05 address resolves to the expected pubkey.
+ */
+export async function verifyNip05(address, expectedPubkey) {
+    try {
+        const result = await queryNip05(address);
+        return result.pubkey === expectedPubkey;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=nip05.js.map

package/dist/nip05.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nip05.js","sourceRoot":"","sources":["../src/nip05.ts"],"names":[],"mappings":"AAKA,MAAM,OAAO,UAAW,SAAQ,KAAK;IACnC,IAAI,CAAQ;IACZ,YAAY,OAAe,EAAE,IAAI,GAAG,aAAa;QAC/C,KAAK,CAAC,OAAO,CAAC,CAAA;QACd,IAAI,CAAC,IAAI,GAAG,YAAY,CAAA;QACxB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;IAClB,CAAC;CACF;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAAe;IAC/C,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAA;IAChD,IAAI,CAAC,KAAK;QAAE,MAAM,IAAI,UAAU,CAAC,2BAA2B,OAAO,EAAE,EAAE,iBAAiB,CAAC,CAAA;IACzF,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,CAAA;AAC7C,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,OAAe;IAC9C,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAA;IAEnD,MAAM,GAAG,GAAG,WAAW,MAAM,gCAAgC,kBAAkB,CAAC,IAAI,CAAC,EAAE,CAAA;IACvF,IAAI,IAA6B,CAAA;IAEjC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,CAAA;QAC5B,IAAI,CAAC,GAAG,CAAC,EAAE;YAAE,MAAM,IAAI,UAAU,CAAC,QAAQ,GAAG,CAAC,MAAM,SAAS,MAAM,EAAE,EAAE,aAAa,CAAC,CAAA;QACrF,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAA4B,CAAA;IACtD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,GAAG,YAAY,UAAU;YAAE,MAAM,GAAG,CAAA;QACxC,MAAM,IAAI,UAAU,CAAC,mBAAmB,MAAM,KAAM,GAAa,CAAC,OAAO,EAAE,EAAE,aAAa,CAAC,CAAA;IAC7F,CAAC;IAED,MAAM,KAAK,GAAG,IAAI,CAAC,KAA2C,CAAA;IAC9D,IAAI,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QAC3B,MAAM,IAAI,UAAU,CAAC,SAAS,IAAI,kBAAkB,MAAM,EAAE,EAAE,WAAW,CAAC,CAAA;IAC5E,CAAC;IAED,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,CAAA;IAC1B,MAAM,SAAS,GAAG,IAAI,CAAC,MAA8C,CAAA;IACrE,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC,MAAM,CAAC,CAAA;IAElC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,CAAA;AAC3B,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,OAAe,EAAE,cAAsB;IACvE,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,OAAO,CAAC,CAAA;QACxC,OAAO,MAAM,CAAC,MAAM,KAAK,cAAc,CAAA;IACzC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAA;IACd,CAAC;AACH,CAAC"}

package/dist/nip06.d.ts

@@ -0,0 +1,26 @@
+export type DerivedKey = {
+    secretKey: Uint8Array;
+    publicKey: string;
+};
+/**
+ * Get the BIP-44 derivation path for Nostr keys.
+ * Path: m/44'/1237'/<account>'/0/0
+ */
+export declare function getDerivationPath(accountIndex: number): string;
+/**
+ * Generate a BIP-39 mnemonic phrase.
+ */
+export declare function generateMnemonic(wordCount?: 12 | 24): string;
+/**
+ * Validate a BIP-39 mnemonic phrase.
+ */
+export declare function validateMnemonic(mnemonic: string): boolean;
+/**
+ * Derive a Nostr key pair from a BIP-39 mnemonic phrase.
+ */
+export declare function mnemonicToKey(mnemonic: string, accountIndex?: number, passphrase?: string): DerivedKey;
+/**
+ * Derive a Nostr key pair from a BIP-32 seed.
+ */
+export declare function deriveKey(seed: Uint8Array, accountIndex?: number): DerivedKey;
+//# sourceMappingURL=nip06.d.ts.map

package/dist/nip06.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nip06.d.ts","sourceRoot":"","sources":["../src/nip06.ts"],"names":[],"mappings":"AAMA,MAAM,MAAM,UAAU,GAAG;IACvB,SAAS,EAAE,UAAU,CAAA;IACrB,SAAS,EAAE,MAAM,CAAA;CAClB,CAAA;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAE9D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,GAAE,EAAE,GAAG,EAAO,GAAG,MAAM,CAGhE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAE1D;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,SAAI,EAAE,UAAU,SAAK,GAAG,UAAU,CAM7F;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,UAAU,EAAE,YAAY,SAAI,GAAG,UAAU,CAWxE"}

package/dist/nip06.js

@@ -0,0 +1,49 @@
+import { HDKey } from '@scure/bip32';
+import { generateMnemonic as genMnemonic, mnemonicToSeedSync, validateMnemonic as valMnemonic } from '@scure/bip39';
+import { wordlist as english } from '@scure/bip39/wordlists/english.js';
+import { bytesToHex } from '@noble/hashes/utils';
+import { schnorr } from '@noble/curves/secp256k1';
+/**
+ * Get the BIP-44 derivation path for Nostr keys.
+ * Path: m/44'/1237'/<account>'/0/0
+ */
+export function getDerivationPath(accountIndex) {
+    return `m/44'/1237'/${accountIndex}'/0/0`;
+}
+/**
+ * Generate a BIP-39 mnemonic phrase.
+ */
+export function generateMnemonic(wordCount = 12) {
+    const strength = wordCount === 24 ? 256 : 128;
+    return genMnemonic(english, strength);
+}
+/**
+ * Validate a BIP-39 mnemonic phrase.
+ */
+export function validateMnemonic(mnemonic) {
+    return valMnemonic(mnemonic, english);
+}
+/**
+ * Derive a Nostr key pair from a BIP-39 mnemonic phrase.
+ */
+export function mnemonicToKey(mnemonic, accountIndex = 0, passphrase = '') {
+    if (!validateMnemonic(mnemonic)) {
+        throw new Error('Invalid mnemonic');
+    }
+    const seed = mnemonicToSeedSync(mnemonic, passphrase);
+    return deriveKey(seed, accountIndex);
+}
+/**
+ * Derive a Nostr key pair from a BIP-32 seed.
+ */
+export function deriveKey(seed, accountIndex = 0) {
+    const path = getDerivationPath(accountIndex);
+    const root = HDKey.fromMasterSeed(seed);
+    const child = root.derive(path);
+    if (!child.privateKey)
+        throw new Error('Failed to derive private key');
+    const secretKey = child.privateKey;
+    const publicKey = bytesToHex(schnorr.getPublicKey(secretKey));
+    return { secretKey, publicKey };
+}
+//# sourceMappingURL=nip06.js.map

package/dist/nip06.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nip06.js","sourceRoot":"","sources":["../src/nip06.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,cAAc,CAAA;AACpC,OAAO,EAAE,gBAAgB,IAAI,WAAW,EAAE,kBAAkB,EAAE,gBAAgB,IAAI,WAAW,EAAE,MAAM,cAAc,CAAA;AACnH,OAAO,EAAE,QAAQ,IAAI,OAAO,EAAE,MAAM,mCAAmC,CAAA;AACvE,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAA;AAChD,OAAO,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAA;AAOjD;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,YAAoB;IACpD,OAAO,eAAe,YAAY,OAAO,CAAA;AAC3C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,YAAqB,EAAE;IACtD,MAAM,QAAQ,GAAG,SAAS,KAAK,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAA;IAC7C,OAAO,WAAW,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAA;AACvC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,QAAgB;IAC/C,OAAO,WAAW,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAA;AACvC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,QAAgB,EAAE,YAAY,GAAG,CAAC,EAAE,UAAU,GAAG,EAAE;IAC/E,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,EAAE,CAAC;QAChC,MAAM,IAAI,KAAK,CAAC,kBAAkB,CAAC,CAAA;IACrC,CAAC;IACD,MAAM,IAAI,GAAG,kBAAkB,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAA;IACrD,OAAO,SAAS,CAAC,IAAI,EAAE,YAAY,CAAC,CAAA;AACtC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,SAAS,CAAC,IAAgB,EAAE,YAAY,GAAG,CAAC;IAC1D,MAAM,IAAI,GAAG,iBAAiB,CAAC,YAAY,CAAC,CAAA;IAC5C,MAAM,IAAI,GAAG,KAAK,CAAC,cAAc,CAAC,IAAI,CAAC,CAAA;IACvC,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;IAE/B,IAAI,CAAC,KAAK,CAAC,UAAU;QAAE,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAA;IAEtE,MAAM,SAAS,GAAG,KAAK,CAAC,UAAU,CAAA;IAClC,MAAM,SAAS,GAAG,UAAU,CAAC,OAAO,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC,CAAA;IAE7D,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,CAAA;AACjC,CAAC"}

package/dist/nip09.d.ts

@@ -0,0 +1,34 @@
+import { type NostrEvent, type EventTemplate } from './event.js';
+export type DeletionTarget = {
+    type: 'event';
+    id: string;
+} | {
+    type: 'address';
+    address: string;
+};
+export type DeletionRequest = {
+    targets: DeletionTarget[];
+    reason?: string;
+};
+/**
+ * Create a kind 5 deletion event template (unsigned).
+ */
+export declare function createDeletionEventTemplate(request: DeletionRequest): EventTemplate;
+/**
+ * Create and sign a kind 5 deletion event.
+ */
+export declare function createDeletionEvent(request: DeletionRequest, secretKey: Uint8Array): NostrEvent;
+/**
+ * Parse a kind 5 deletion event.
+ */
+export declare function parseDeletion(event: NostrEvent): {
+    eventIds: string[];
+    addresses: string[];
+    kinds: number[];
+    reason: string;
+};
+/**
+ * Check if a deletion event targets a specific event.
+ */
+export declare function isDeletionOf(deletion: NostrEvent, target: NostrEvent): boolean;
+//# sourceMappingURL=nip09.d.ts.map