@qntx/nostr 0.0.1

package/dist/nips/nip49.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"nip49.mjs","names":[],"sources":["../../src/nips/nip49.ts"],"sourcesContent":["/**\n * NIP-49: Private Key Encryption (`ncryptsec`).\n *\n * @see https://github.com/nostr-protocol/nips/blob/master/49.md\n */\nimport { xchacha20poly1305 } from \"@noble/ciphers/chacha.js\";\nimport { scrypt } from \"@noble/hashes/scrypt.js\";\nimport { concatBytes, randomBytes } from \"@noble/hashes/utils.js\";\nimport { bech32 } from \"@scure/base\";\nimport { NostrError } from \"../core/error.ts\";\nimport { assertSecretKeyBytes } from \"../core/util.ts\";\nimport { Bech32MaxSize, encodeBytes } from \"./nip19.ts\";\n\nexport type Ncryptsec = `ncryptsec1${string}`;\nexport type KeySecurityByte = 0x00 | 0x01 | 0x02;\n\nconst VERSION = 0x02;\nconst SALT_LEN = 16;\nconst NONCE_LEN = 24;\nconst PAYLOAD_LEN = 91;\nconst LOGN_MIN = 1;\nconst LOGN_MAX = 22;\nconst SCRYPT_R = 8;\nconst SCRYPT_P = 1;\n\nexport class Nip49Error extends NostrError {}\n\nfunction assertLogn(logn: number): void {\n  if (!Number.isInteger(logn) || logn < LOGN_MIN || logn > LOGN_MAX) {\n    throw new Nip49Error(`invalid logn ${logn}, expected integer ${LOGN_MIN}..${LOGN_MAX}`);\n  }\n}\n\nfunction deriveKey(password: string, salt: Uint8Array, logn: number): Uint8Array {\n  assertLogn(logn);\n  const N = 2 ** logn;\n  return scrypt(password.normalize(\"NFKC\"), salt, {\n    N,\n    r: SCRYPT_R,\n    p: SCRYPT_P,\n    dkLen: 32,\n    // noble 2.3: V (N blocks) + p B blocks + one tmp scratch block.\n    maxmem: 128 * SCRYPT_R * (N + SCRYPT_P + 1),\n  });\n}\n\n/** Encrypt a 32-byte secret key to an `ncryptsec` bech32 string. */\nexport function encrypt(\n  secretKey: Uint8Array,\n  password: string,\n  logn: number = 16,\n  ksb: KeySecurityByte = 0x02,\n): Ncryptsec {\n  assertSecretKeyBytes(secretKey);\n  const salt = randomBytes(SALT_LEN);\n  const key = deriveKey(password, salt, logn);\n  const nonce = randomBytes(NONCE_LEN);\n  const aad = Uint8Array.from([ksb]);\n  const ciphertext = xchacha20poly1305(key, nonce, aad).encrypt(secretKey);\n  const bytes = concatBytes(\n    Uint8Array.from([VERSION]),\n    Uint8Array.from([logn]),\n    salt,\n    nonce,\n    aad,\n    ciphertext,\n  );\n  return encodeBytes(\"ncryptsec\", bytes);\n}\n\n/** Decrypt an `ncryptsec` bech32 string to a 32-byte secret key. */\nexport function decrypt(ncryptsec: string, password: string): Uint8Array {\n  let prefix: string;\n  let b: Uint8Array;\n  try {\n    const decoded = bech32.decode(ncryptsec as `${string}1${string}`, Bech32MaxSize);\n    prefix = decoded.prefix;\n    b = new Uint8Array(bech32.fromWords(decoded.words));\n  } catch (cause) {\n    throw new Nip49Error(\"invalid ncryptsec\", {\n      cause: cause instanceof Error ? cause : undefined,\n    });\n  }\n  if (prefix !== \"ncryptsec\") {\n    throw new Nip49Error(`invalid prefix ${prefix}, expected 'ncryptsec'`);\n  }\n  if (b.length !== PAYLOAD_LEN) {\n    throw new Nip49Error(\"invalid ncryptsec length\");\n  }\n  const version = b[0]!;\n  if (version !== VERSION) {\n    throw new Nip49Error(`invalid version ${version}, expected 0x02`);\n  }\n  const logn = b[1]!;\n  const salt = b.subarray(2, 2 + SALT_LEN);\n  const nonce = b.subarray(2 + SALT_LEN, 2 + SALT_LEN + NONCE_LEN);\n  const ksb = b[2 + SALT_LEN + NONCE_LEN]!;\n  const aad = Uint8Array.from([ksb]);\n  const ciphertext = b.subarray(2 + SALT_LEN + NONCE_LEN + 1);\n  try {\n    const key = deriveKey(password, salt, logn);\n    return xchacha20poly1305(key, nonce, aad).decrypt(ciphertext);\n  } catch (cause) {\n    if (cause instanceof Nip49Error) throw cause;\n    throw new Nip49Error(\"failed to decrypt\", {\n      cause: cause instanceof Error ? cause : undefined,\n    });\n  }\n}\n"],"mappings":";;;;;;;;;;;;;AAgBA,MAAM,UAAU;AAChB,MAAM,WAAW;AACjB,MAAM,YAAY;AAClB,MAAM,cAAc;AACpB,MAAM,WAAW;AACjB,MAAM,WAAW;AACjB,MAAM,WAAW;AACjB,MAAM,WAAW;AAEjB,IAAa,aAAb,cAAgC,WAAW,CAAC;AAE5C,SAAS,WAAW,MAAoB;CACtC,IAAI,CAAC,OAAO,UAAU,IAAI,KAAK,OAAO,YAAY,OAAO,UACvD,MAAM,IAAI,WAAW,gBAAgB,KAAK,qBAAqB,SAAS,IAAI,UAAU;AAE1F;AAEA,SAAS,UAAU,UAAkB,MAAkB,MAA0B;CAC/E,WAAW,IAAI;CACf,MAAM,IAAI,KAAK;CACf,OAAO,OAAO,SAAS,UAAU,MAAM,GAAG,MAAM;EAC9C;EACA,GAAG;EACH,GAAG;EACH,OAAO;EAEP,QAAQ,QAAkB,IAAI,WAAW;CAC3C,CAAC;AACH;;AAGA,SAAgB,QACd,WACA,UACA,OAAe,IACf,MAAuB,GACZ;CACX,qBAAqB,SAAS;CAC9B,MAAM,OAAO,YAAY,QAAQ;CACjC,MAAM,MAAM,UAAU,UAAU,MAAM,IAAI;CAC1C,MAAM,QAAQ,YAAY,SAAS;CACnC,MAAM,MAAM,WAAW,KAAK,CAAC,GAAG,CAAC;CACjC,MAAM,aAAa,kBAAkB,KAAK,OAAO,GAAG,CAAC,CAAC,QAAQ,SAAS;CACvE,MAAM,QAAQ,YACZ,WAAW,KAAK,CAAC,OAAO,CAAC,GACzB,WAAW,KAAK,CAAC,IAAI,CAAC,GACtB,MACA,OACA,KACA,UACF;CACA,OAAO,YAAY,aAAa,KAAK;AACvC;;AAGA,SAAgB,QAAQ,WAAmB,UAA8B;CACvE,IAAI;CACJ,IAAI;CACJ,IAAI;EACF,MAAM,UAAU,OAAO,OAAO,WAAoC,aAAa;EAC/E,SAAS,QAAQ;EACjB,IAAI,IAAI,WAAW,OAAO,UAAU,QAAQ,KAAK,CAAC;CACpD,SAAS,OAAO;EACd,MAAM,IAAI,WAAW,qBAAqB,EACxC,OAAO,iBAAiB,QAAQ,QAAQ,KAAA,EAC1C,CAAC;CACH;CACA,IAAI,WAAW,aACb,MAAM,IAAI,WAAW,kBAAkB,OAAO,uBAAuB;CAEvE,IAAI,EAAE,WAAW,aACf,MAAM,IAAI,WAAW,0BAA0B;CAEjD,MAAM,UAAU,EAAE;CAClB,IAAI,YAAY,SACd,MAAM,IAAI,WAAW,mBAAmB,QAAQ,gBAAgB;CAElE,MAAM,OAAO,EAAE;CACf,MAAM,OAAO,EAAE,SAAS,GAAG,EAAY;CACvC,MAAM,QAAQ,EAAE,SAAS,IAAc,EAAwB;CAC/D,MAAM,MAAM,EAAE;CACd,MAAM,MAAM,WAAW,KAAK,CAAC,GAAG,CAAC;CACjC,MAAM,aAAa,EAAE,SAAS,EAA4B;CAC1D,IAAI;EACF,MAAM,MAAM,UAAU,UAAU,MAAM,IAAI;EAC1C,OAAO,kBAAkB,KAAK,OAAO,GAAG,CAAC,CAAC,QAAQ,UAAU;CAC9D,SAAS,OAAO;EACd,IAAI,iBAAiB,YAAY,MAAM;EACvC,MAAM,IAAI,WAAW,qBAAqB,EACxC,OAAO,iBAAiB,QAAQ,QAAQ,KAAA,EAC1C,CAAC;CACH;AACF"}

package/dist/nips/nip51.d.mts

@@ -0,0 +1,88 @@
+import { t as Event } from "../event-B5D2jxt_.mjs";
+import { t as EventBuilder } from "../builder-BphJa-Y-.mjs";
+//#region src/nips/nip51.d.ts
+/**
+ * Structural crypto used by NIP-51 private tags.
+ * Satisfied by NostrSigner when nip44Encrypt/nip44Decrypt are present.
+ * This module must not import src/signer/.
+ */
+type Nip51Crypto = {
+  getPublicKey(): Promise<string>;
+  nip44Encrypt(peer: string, plaintext: string): Promise<string>;
+  nip44Decrypt(peer: string, payload: string): Promise<string>;
+};
+type MuteItem = {
+  type: "pubkey";
+  value: string;
+} | {
+  type: "event";
+  value: string;
+} | {
+  type: "hashtag";
+  value: string;
+} | {
+  type: "word";
+  value: string;
+};
+/** Parse kind:10000 mute list public tags (`p` / `e` / `t` / `word`). */
+declare function parseMuteList(event: Pick<Event, "kind" | "tags">): MuteItem[];
+/** Build an unsigned kind:10000 EventBuilder from public mute items. */
+declare function muteListEventBuilder(items: readonly MuteItem[]): EventBuilder;
+/** NIP-44 ciphertext of tags, conversation peer = author's own pubkey. */
+declare function encryptPrivateTags(crypto: Nip51Crypto, tags: Event["tags"]): Promise<string>;
+/** Decrypt NIP-51 `.content`. Empty content is no private tags, not ciphertext. */
+declare function decryptPrivateTags(crypto: Nip51Crypto, event: Pick<Event, "pubkey" | "content">): Promise<Event["tags"]>;
+/** Public mute items from tags; private mute items from NIP-44 `.content`. */
+declare function parseMuteListPrivate(crypto: Nip51Crypto, event: Pick<Event, "kind" | "tags" | "pubkey" | "content">): Promise<{
+  public: MuteItem[];
+  private: MuteItem[];
+}>;
+/** Parse kind:10001 pin list public `e` tags. */
+declare function parsePinList(event: Pick<Event, "kind" | "tags">): string[];
+/** Build an unsigned kind:10001 EventBuilder from event ids. */
+declare function pinListEventBuilder(ids: readonly string[]): EventBuilder;
+/** Parse kind:10003 bookmark list public `e` and `a` tags. */
+declare function parseBookmarkList(event: Pick<Event, "kind" | "tags">): {
+  e: string[];
+  a: string[];
+};
+/** Build an unsigned kind:10003 EventBuilder from public bookmark pointers. */
+declare function bookmarkListEventBuilder(items: {
+  e?: readonly string[];
+  a?: readonly string[];
+}): EventBuilder;
+/** Parse kind:10030 user emoji list public `emoji` and `a` tags. */
+declare function parseUserEmojiList(event: Pick<Event, "kind" | "tags">): {
+  emoji: Array<{
+    shortcode: string;
+    url: string;
+  }>;
+  sets: string[];
+};
+/** Parse kind:30002 relay set public `d` and `relay` tags. */
+declare function parseRelaySet(event: Pick<Event, "kind" | "tags">): {
+  d: string;
+  relays: string[];
+};
+/** Parse kind:10012 favorite relays public `relay` tags and kind:30002 `a` tags. */
+declare function parseFavoriteRelays(event: Pick<Event, "kind" | "tags">): {
+  relays: string[];
+  sets: string[];
+};
+/** Parse kind:30030 emoji set public `d` / `title` / `emoji` tags. */
+declare function parseEmojiSet(event: Pick<Event, "kind" | "tags">): {
+  d: string;
+  title?: string;
+  emoji: Array<{
+    shortcode: string;
+    url: string;
+  }>;
+};
+/** Parse kind:39089 starter pack (follow pack) public `d` and `p` tags. */
+declare function parseFollowPack(event: Pick<Event, "kind" | "tags">): {
+  d: string;
+  pubkeys: string[];
+};
+//#endregion
+export { MuteItem, Nip51Crypto, bookmarkListEventBuilder, decryptPrivateTags, encryptPrivateTags, muteListEventBuilder, parseBookmarkList, parseEmojiSet, parseFavoriteRelays, parseFollowPack, parseMuteList, parseMuteListPrivate, parsePinList, parseRelaySet, parseUserEmojiList, pinListEventBuilder };
+//# sourceMappingURL=nip51.d.mts.map

package/dist/nips/nip51.mjs

@@ -0,0 +1,246 @@
+import { a as isHex32, s as normalizeURL, t as assertHex32 } from "../util-6tfLQ9JF.mjs";
+import { n as EventValidationError } from "../error-DZEs5OuZ.mjs";
+import { t as Kind } from "../kind-BLl4cLOc.mjs";
+import { _ as getDTag, m as Tag, v as isTag } from "../event-CzoQEFMF.mjs";
+import { t as EventBuilder } from "../builder-q0VsvnYE.mjs";
+//#region src/nips/nip51.ts
+/**
+* NIP-51: Lists
+* Public tags plus NIP-44 private `.content` (author encrypts to self).
+* Crypto is injected; this module does not import signer. No NIP-04 sniff.
+* Kind 10063 Blossom servers live in blossom.ts.
+*
+* @see https://github.com/nostr-protocol/nips/blob/master/51.md
+*/
+function requireKind(event, kind) {
+	if (event.kind !== kind) throw new EventValidationError(`expected kind ${kind}, got ${event.kind}`);
+}
+function collectRelays(tags) {
+	const out = [];
+	const seen = /* @__PURE__ */ new Set();
+	for (const tag of tags) {
+		if (tag[0] !== "relay" || !tag[1]) continue;
+		let url;
+		try {
+			url = normalizeURL(tag[1]);
+		} catch {
+			continue;
+		}
+		if (seen.has(url)) continue;
+		seen.add(url);
+		out.push(url);
+	}
+	return out;
+}
+function collectEmoji(tags) {
+	const out = [];
+	for (const tag of tags) {
+		if (tag[0] !== "emoji") continue;
+		const shortcode = tag[1];
+		const url = tag[2];
+		if (!shortcode || !url) continue;
+		out.push({
+			shortcode,
+			url
+		});
+	}
+	return out;
+}
+function firstTagValue(tags, name) {
+	for (const tag of tags) if (tag[0] === name && tag[1]) return tag[1];
+}
+function identifier(tags) {
+	return getDTag(tags) ?? "";
+}
+/** NIP-51 a-tag: `30002:<64-hex-pubkey>:<d>` with `d` possibly containing `:`. */
+function isRelaySetAddress(value) {
+	const kindSep = value.indexOf(":");
+	if (kindSep < 0) return false;
+	if (value.slice(0, kindSep) !== String(Kind.RelaySets)) return false;
+	const pkSep = value.indexOf(":", kindSep + 1);
+	if (pkSep < 0) return false;
+	const pubkey = value.slice(kindSep + 1, pkSep);
+	const d = value.slice(pkSep + 1);
+	return isHex32(pubkey) && d.length > 0;
+}
+/** Parse kind:10000 mute list public tags (`p` / `e` / `t` / `word`). */
+function parseMuteList(event) {
+	requireKind(event, Kind.MuteList);
+	const items = [];
+	for (const tag of event.tags) {
+		const value = tag[1];
+		if (!value) continue;
+		switch (tag[0]) {
+			case "p":
+				if (isHex32(value)) items.push({
+					type: "pubkey",
+					value: value.toLowerCase()
+				});
+				break;
+			case "e":
+				if (isHex32(value)) items.push({
+					type: "event",
+					value: value.toLowerCase()
+				});
+				break;
+			case "t":
+				items.push({
+					type: "hashtag",
+					value
+				});
+				break;
+			case "word": items.push({
+				type: "word",
+				value: value.toLowerCase()
+			});
+		}
+	}
+	return items;
+}
+/** Build an unsigned kind:10000 EventBuilder from public mute items. */
+function muteListEventBuilder(items) {
+	const b = new EventBuilder(Kind.MuteList, "");
+	for (const item of items) switch (item.type) {
+		case "pubkey":
+			b.tag(Tag.p(assertHex32(item.value, "public key")));
+			break;
+		case "event":
+			b.tag(Tag.e(assertHex32(item.value, "event id")));
+			break;
+		case "hashtag":
+			if (item.value) b.tag(Tag.t(item.value));
+			break;
+		case "word": if (item.value) b.tag(["word", item.value.toLowerCase()]);
+	}
+	return b;
+}
+/** NIP-44 ciphertext of tags, conversation peer = author's own pubkey. */
+async function encryptPrivateTags(crypto, tags) {
+	const self = await crypto.getPublicKey();
+	return crypto.nip44Encrypt(self, JSON.stringify(tags));
+}
+/** Decrypt NIP-51 `.content`. Empty content is no private tags, not ciphertext. */
+async function decryptPrivateTags(crypto, event) {
+	if (event.content === "") return [];
+	const self = await crypto.getPublicKey();
+	if (self.toLowerCase() !== event.pubkey.toLowerCase()) throw new EventValidationError("NIP-51 private content is only for the author");
+	const plaintext = await crypto.nip44Decrypt(self, event.content);
+	let parsed;
+	try {
+		parsed = JSON.parse(plaintext);
+	} catch (cause) {
+		throw new EventValidationError("invalid NIP-51 private tags", { cause });
+	}
+	if (!Array.isArray(parsed) || !parsed.every(isTag)) throw new EventValidationError("invalid NIP-51 private tags");
+	return parsed;
+}
+/** Public mute items from tags; private mute items from NIP-44 `.content`. */
+async function parseMuteListPrivate(crypto, event) {
+	const pub = parseMuteList(event);
+	const decrypted = await decryptPrivateTags(crypto, event);
+	return {
+		public: pub,
+		private: parseMuteList({
+			kind: event.kind,
+			tags: decrypted
+		})
+	};
+}
+/** Parse kind:10001 pin list public `e` tags. */
+function parsePinList(event) {
+	requireKind(event, Kind.PinList);
+	const ids = [];
+	for (const tag of event.tags) {
+		if (tag[0] !== "e" || !tag[1] || !isHex32(tag[1])) continue;
+		ids.push(tag[1].toLowerCase());
+	}
+	return ids;
+}
+/** Build an unsigned kind:10001 EventBuilder from event ids. */
+function pinListEventBuilder(ids) {
+	const b = new EventBuilder(Kind.PinList, "");
+	for (const id of ids) b.tag(Tag.e(assertHex32(id, "event id")));
+	return b;
+}
+/** Parse kind:10003 bookmark list public `e` and `a` tags. */
+function parseBookmarkList(event) {
+	requireKind(event, Kind.BookmarkList);
+	const e = [];
+	const a = [];
+	for (const tag of event.tags) {
+		if (!tag[1]) continue;
+		if (tag[0] === "e") {
+			if (isHex32(tag[1])) e.push(tag[1].toLowerCase());
+		} else if (tag[0] === "a") a.push(tag[1]);
+	}
+	return {
+		e,
+		a
+	};
+}
+/** Build an unsigned kind:10003 EventBuilder from public bookmark pointers. */
+function bookmarkListEventBuilder(items) {
+	const b = new EventBuilder(Kind.BookmarkList, "");
+	if (items.e) for (const id of items.e) b.tag(Tag.e(assertHex32(id, "event id")));
+	if (items.a) {
+		for (const coord of items.a) if (coord) b.tag(Tag.a(coord));
+	}
+	return b;
+}
+/** Parse kind:10030 user emoji list public `emoji` and `a` tags. */
+function parseUserEmojiList(event) {
+	requireKind(event, Kind.UserEmojiList);
+	const sets = [];
+	for (const tag of event.tags) if (tag[0] === "a" && tag[1]) sets.push(tag[1]);
+	return {
+		emoji: collectEmoji(event.tags),
+		sets
+	};
+}
+/** Parse kind:30002 relay set public `d` and `relay` tags. */
+function parseRelaySet(event) {
+	requireKind(event, Kind.RelaySets);
+	return {
+		d: identifier(event.tags),
+		relays: collectRelays(event.tags)
+	};
+}
+/** Parse kind:10012 favorite relays public `relay` tags and kind:30002 `a` tags. */
+function parseFavoriteRelays(event) {
+	requireKind(event, Kind.FavoriteRelays);
+	const sets = [];
+	for (const tag of event.tags) {
+		if (tag[0] !== "a" || !tag[1] || !isRelaySetAddress(tag[1])) continue;
+		sets.push(tag[1]);
+	}
+	return {
+		relays: collectRelays(event.tags),
+		sets
+	};
+}
+/** Parse kind:30030 emoji set public `d` / `title` / `emoji` tags. */
+function parseEmojiSet(event) {
+	requireKind(event, Kind.EmojiSet);
+	return {
+		d: identifier(event.tags),
+		title: firstTagValue(event.tags, "title"),
+		emoji: collectEmoji(event.tags)
+	};
+}
+/** Parse kind:39089 starter pack (follow pack) public `d` and `p` tags. */
+function parseFollowPack(event) {
+	requireKind(event, Kind.StarterPack);
+	const pubkeys = [];
+	for (const tag of event.tags) {
+		if (tag[0] !== "p" || !tag[1] || !isHex32(tag[1])) continue;
+		pubkeys.push(tag[1].toLowerCase());
+	}
+	return {
+		d: identifier(event.tags),
+		pubkeys
+	};
+}
+//#endregion
+export { bookmarkListEventBuilder, decryptPrivateTags, encryptPrivateTags, muteListEventBuilder, parseBookmarkList, parseEmojiSet, parseFavoriteRelays, parseFollowPack, parseMuteList, parseMuteListPrivate, parsePinList, parseRelaySet, parseUserEmojiList, pinListEventBuilder };
+
+//# sourceMappingURL=nip51.mjs.map

package/dist/nips/nip51.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"nip51.mjs","names":[],"sources":["../../src/nips/nip51.ts"],"sourcesContent":["/**\n * NIP-51: Lists\n * Public tags plus NIP-44 private `.content` (author encrypts to self).\n * Crypto is injected; this module does not import signer. No NIP-04 sniff.\n * Kind 10063 Blossom servers live in blossom.ts.\n *\n * @see https://github.com/nostr-protocol/nips/blob/master/51.md\n */\nimport { EventBuilder } from \"../core/builder.ts\";\nimport { EventValidationError } from \"../core/error.ts\";\nimport type { Event } from \"../core/event.ts\";\nimport { Kind } from \"../core/kind.ts\";\nimport { getDTag, isTag, Tag } from \"../core/tag.ts\";\nimport { assertHex32, isHex32, normalizeURL } from \"../core/util.ts\";\n\n/**\n * Structural crypto used by NIP-51 private tags.\n * Satisfied by NostrSigner when nip44Encrypt/nip44Decrypt are present.\n * This module must not import src/signer/.\n */\nexport type Nip51Crypto = {\n  getPublicKey(): Promise<string>;\n  nip44Encrypt(peer: string, plaintext: string): Promise<string>;\n  nip44Decrypt(peer: string, payload: string): Promise<string>;\n};\n\nexport type MuteItem =\n  | { type: \"pubkey\"; value: string }\n  | { type: \"event\"; value: string }\n  | { type: \"hashtag\"; value: string }\n  | { type: \"word\"; value: string };\n\nfunction requireKind(event: Pick<Event, \"kind\">, kind: number): void {\n  if (event.kind !== kind) {\n    throw new EventValidationError(`expected kind ${kind}, got ${event.kind}`);\n  }\n}\n\nfunction collectRelays(tags: Event[\"tags\"]): string[] {\n  const out: string[] = [];\n  const seen = new Set<string>();\n  for (const tag of tags) {\n    if (tag[0] !== \"relay\" || !tag[1]) continue;\n    let url: string;\n    try {\n      url = normalizeURL(tag[1]);\n    } catch {\n      continue;\n    }\n    if (seen.has(url)) continue;\n    seen.add(url);\n    out.push(url);\n  }\n  return out;\n}\n\nfunction collectEmoji(tags: Event[\"tags\"]): Array<{ shortcode: string; url: string }> {\n  const out: Array<{ shortcode: string; url: string }> = [];\n  for (const tag of tags) {\n    if (tag[0] !== \"emoji\") continue;\n    const shortcode = tag[1];\n    const url = tag[2];\n    if (!shortcode || !url) continue;\n    out.push({ shortcode, url });\n  }\n  return out;\n}\n\nfunction firstTagValue(tags: Event[\"tags\"], name: string): string | undefined {\n  for (const tag of tags) {\n    if (tag[0] === name && tag[1]) return tag[1];\n  }\n  return undefined;\n}\n\nfunction identifier(tags: Event[\"tags\"]): string {\n  return getDTag(tags) ?? \"\";\n}\n\n/** NIP-51 a-tag: `30002:<64-hex-pubkey>:<d>` with `d` possibly containing `:`. */\nfunction isRelaySetAddress(value: string): boolean {\n  const kindSep = value.indexOf(\":\");\n  if (kindSep < 0) return false;\n  if (value.slice(0, kindSep) !== String(Kind.RelaySets)) return false;\n  const pkSep = value.indexOf(\":\", kindSep + 1);\n  if (pkSep < 0) return false;\n  const pubkey = value.slice(kindSep + 1, pkSep);\n  const d = value.slice(pkSep + 1);\n  return isHex32(pubkey) && d.length > 0;\n}\n\n/** Parse kind:10000 mute list public tags (`p` / `e` / `t` / `word`). */\nexport function parseMuteList(event: Pick<Event, \"kind\" | \"tags\">): MuteItem[] {\n  requireKind(event, Kind.MuteList);\n  const items: MuteItem[] = [];\n  for (const tag of event.tags) {\n    const value = tag[1];\n    if (!value) continue;\n    switch (tag[0]) {\n      case \"p\":\n        if (isHex32(value)) items.push({ type: \"pubkey\", value: value.toLowerCase() });\n        break;\n      case \"e\":\n        if (isHex32(value)) items.push({ type: \"event\", value: value.toLowerCase() });\n        break;\n      case \"t\":\n        // NIP-51 does not require hashtag case-folding.\n        items.push({ type: \"hashtag\", value });\n        break;\n      case \"word\":\n        items.push({ type: \"word\", value: value.toLowerCase() });\n        break;\n    }\n  }\n  return items;\n}\n\n/** Build an unsigned kind:10000 EventBuilder from public mute items. */\nexport function muteListEventBuilder(items: readonly MuteItem[]): EventBuilder {\n  const b = new EventBuilder(Kind.MuteList, \"\");\n  for (const item of items) {\n    switch (item.type) {\n      case \"pubkey\":\n        b.tag(Tag.p(assertHex32(item.value, \"public key\")));\n        break;\n      case \"event\":\n        b.tag(Tag.e(assertHex32(item.value, \"event id\")));\n        break;\n      case \"hashtag\":\n        if (item.value) b.tag(Tag.t(item.value));\n        break;\n      case \"word\":\n        if (item.value) b.tag([\"word\", item.value.toLowerCase()]);\n        break;\n    }\n  }\n  return b;\n}\n\n/** NIP-44 ciphertext of tags, conversation peer = author's own pubkey. */\nexport async function encryptPrivateTags(\n  crypto: Nip51Crypto,\n  tags: Event[\"tags\"],\n): Promise<string> {\n  const self = await crypto.getPublicKey();\n  return crypto.nip44Encrypt(self, JSON.stringify(tags));\n}\n\n/** Decrypt NIP-51 `.content`. Empty content is no private tags, not ciphertext. */\nexport async function decryptPrivateTags(\n  crypto: Nip51Crypto,\n  event: Pick<Event, \"pubkey\" | \"content\">,\n): Promise<Event[\"tags\"]> {\n  // NIP-44 rejects empty plaintext; empty `.content` means no private items.\n  if (event.content === \"\") return [];\n  const self = await crypto.getPublicKey();\n  if (self.toLowerCase() !== event.pubkey.toLowerCase()) {\n    throw new EventValidationError(\"NIP-51 private content is only for the author\");\n  }\n  const plaintext = await crypto.nip44Decrypt(self, event.content);\n  let parsed: unknown;\n  try {\n    parsed = JSON.parse(plaintext);\n  } catch (cause) {\n    throw new EventValidationError(\"invalid NIP-51 private tags\", { cause });\n  }\n  if (!Array.isArray(parsed) || !parsed.every(isTag)) {\n    throw new EventValidationError(\"invalid NIP-51 private tags\");\n  }\n  return parsed;\n}\n\n/** Public mute items from tags; private mute items from NIP-44 `.content`. */\nexport async function parseMuteListPrivate(\n  crypto: Nip51Crypto,\n  event: Pick<Event, \"kind\" | \"tags\" | \"pubkey\" | \"content\">,\n): Promise<{ public: MuteItem[]; private: MuteItem[] }> {\n  const pub = parseMuteList(event);\n  const decrypted = await decryptPrivateTags(crypto, event);\n  return {\n    public: pub,\n    private: parseMuteList({ kind: event.kind, tags: decrypted }),\n  };\n}\n\n/** Parse kind:10001 pin list public `e` tags. */\nexport function parsePinList(event: Pick<Event, \"kind\" | \"tags\">): string[] {\n  requireKind(event, Kind.PinList);\n  const ids: string[] = [];\n  for (const tag of event.tags) {\n    if (tag[0] !== \"e\" || !tag[1] || !isHex32(tag[1])) continue;\n    ids.push(tag[1].toLowerCase());\n  }\n  return ids;\n}\n\n/** Build an unsigned kind:10001 EventBuilder from event ids. */\nexport function pinListEventBuilder(ids: readonly string[]): EventBuilder {\n  const b = new EventBuilder(Kind.PinList, \"\");\n  for (const id of ids) b.tag(Tag.e(assertHex32(id, \"event id\")));\n  return b;\n}\n\n/** Parse kind:10003 bookmark list public `e` and `a` tags. */\nexport function parseBookmarkList(event: Pick<Event, \"kind\" | \"tags\">): {\n  e: string[];\n  a: string[];\n} {\n  requireKind(event, Kind.BookmarkList);\n  const e: string[] = [];\n  const a: string[] = [];\n  for (const tag of event.tags) {\n    if (!tag[1]) continue;\n    if (tag[0] === \"e\") {\n      if (isHex32(tag[1])) e.push(tag[1].toLowerCase());\n    } else if (tag[0] === \"a\") {\n      a.push(tag[1]);\n    }\n  }\n  return { e, a };\n}\n\n/** Build an unsigned kind:10003 EventBuilder from public bookmark pointers. */\nexport function bookmarkListEventBuilder(items: {\n  e?: readonly string[];\n  a?: readonly string[];\n}): EventBuilder {\n  const b = new EventBuilder(Kind.BookmarkList, \"\");\n  if (items.e) {\n    for (const id of items.e) b.tag(Tag.e(assertHex32(id, \"event id\")));\n  }\n  if (items.a) {\n    for (const coord of items.a) {\n      if (coord) b.tag(Tag.a(coord));\n    }\n  }\n  return b;\n}\n\n/** Parse kind:10030 user emoji list public `emoji` and `a` tags. */\nexport function parseUserEmojiList(event: Pick<Event, \"kind\" | \"tags\">): {\n  emoji: Array<{ shortcode: string; url: string }>;\n  sets: string[];\n} {\n  requireKind(event, Kind.UserEmojiList);\n  const sets: string[] = [];\n  for (const tag of event.tags) {\n    if (tag[0] === \"a\" && tag[1]) sets.push(tag[1]);\n  }\n  return { emoji: collectEmoji(event.tags), sets };\n}\n\n/** Parse kind:30002 relay set public `d` and `relay` tags. */\nexport function parseRelaySet(event: Pick<Event, \"kind\" | \"tags\">): {\n  d: string;\n  relays: string[];\n} {\n  requireKind(event, Kind.RelaySets);\n  return { d: identifier(event.tags), relays: collectRelays(event.tags) };\n}\n\n/** Parse kind:10012 favorite relays public `relay` tags and kind:30002 `a` tags. */\nexport function parseFavoriteRelays(event: Pick<Event, \"kind\" | \"tags\">): {\n  relays: string[];\n  sets: string[];\n} {\n  requireKind(event, Kind.FavoriteRelays);\n  const sets: string[] = [];\n  for (const tag of event.tags) {\n    if (tag[0] !== \"a\" || !tag[1] || !isRelaySetAddress(tag[1])) continue;\n    sets.push(tag[1]);\n  }\n  return { relays: collectRelays(event.tags), sets };\n}\n\n/** Parse kind:30030 emoji set public `d` / `title` / `emoji` tags. */\nexport function parseEmojiSet(event: Pick<Event, \"kind\" | \"tags\">): {\n  d: string;\n  title?: string;\n  emoji: Array<{ shortcode: string; url: string }>;\n} {\n  requireKind(event, Kind.EmojiSet);\n  return {\n    d: identifier(event.tags),\n    title: firstTagValue(event.tags, \"title\"),\n    emoji: collectEmoji(event.tags),\n  };\n}\n\n/** Parse kind:39089 starter pack (follow pack) public `d` and `p` tags. */\nexport function parseFollowPack(event: Pick<Event, \"kind\" | \"tags\">): {\n  d: string;\n  pubkeys: string[];\n} {\n  requireKind(event, Kind.StarterPack);\n  const pubkeys: string[] = [];\n  for (const tag of event.tags) {\n    if (tag[0] !== \"p\" || !tag[1] || !isHex32(tag[1])) continue;\n    pubkeys.push(tag[1].toLowerCase());\n  }\n  return { d: identifier(event.tags), pubkeys };\n}\n"],"mappings":"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"}

package/dist/nips/nip57.d.mts

@@ -0,0 +1,43 @@
+import { n as EventTemplate, t as Event } from "../event-B5D2jxt_.mjs";
+//#region src/nips/nip57.d.ts
+type ProfileZapRequest = {
+  pubkey: string;
+  /** Amount in millisats. */
+  amount: number;
+  relays: readonly string[];
+  comment?: string;
+  lnurl?: string;
+};
+type EventZapRequest = {
+  event: Event;
+  /** Amount in millisats. */
+  amount: number;
+  relays: readonly string[];
+  comment?: string;
+  lnurl?: string;
+};
+declare function makeZapRequest(params: ProfileZapRequest | EventZapRequest): EventTemplate;
+type ZapReceiptContext = {
+  nostrPubkey: string;
+  lnurl?: string;
+};
+type ZapReceiptValidation = {
+  valid: boolean;
+  reason?: string;
+  request?: Event;
+  amountMsats?: number;
+};
+type Bolt11Fields = {
+  amountMsats?: number;
+  descriptionHash?: Uint8Array;
+  paymentHash?: Uint8Array;
+};
+/** Decode a BOLT11 invoice. Never throws. Requires a 32-byte payment hash (type 1). */
+declare function parseBolt11(pr: string): Bolt11Fields | undefined;
+/** Parse the `description` tag of a kind 9735 receipt as a signed kind 9734. Never throws. */
+declare function parseZapRequestFromReceipt(receipt: Event): Event | undefined;
+/** Validate a kind 9735 zap receipt. Never throws. */
+declare function validateZapReceipt(receipt: Event, ctx: ZapReceiptContext): ZapReceiptValidation;
+//#endregion
+export { Bolt11Fields, EventZapRequest, ProfileZapRequest, ZapReceiptContext, ZapReceiptValidation, makeZapRequest, parseBolt11, parseZapRequestFromReceipt, validateZapReceipt };
+//# sourceMappingURL=nip57.d.mts.map

package/dist/nips/nip57.mjs

@@ -0,0 +1,230 @@
+import { i as hexToBytes, l as utf8Encoder } from "../util-6tfLQ9JF.mjs";
+import { n as EventValidationError } from "../error-DZEs5OuZ.mjs";
+import { r as isAddressableKind, t as Kind } from "../kind-BLl4cLOc.mjs";
+import { _ as getDTag, h as eventAddress, m as Tag, p as validateSignedEvent, y as parseEventAddress } from "../event-CzoQEFMF.mjs";
+import { s as verifyEvent } from "../key-Dn-aX4x4.mjs";
+import { sha256 } from "@noble/hashes/sha2.js";
+import { bech32 } from "@scure/base";
+//#region src/nips/nip57.ts
+/**
+* NIP-57 Lightning Zaps — zap request template (kind 9734) and receipt validation (kind 9735).
+* Does not fetch LNURL. Receipt checks never throw.
+*
+* @see https://github.com/nostr-protocol/nips/blob/master/57.md
+*/
+function makeZapRequest(params) {
+	if (params.relays.length === 0) throw new EventValidationError("relays tag requires one or more URLs");
+	const recipient = "event" in params ? params.event.pubkey : params.pubkey;
+	const tags = [
+		Tag.p(recipient),
+		["amount", params.amount.toString()],
+		["relays", ...params.relays]
+	];
+	if ("event" in params) {
+		const { event } = params;
+		tags.push(Tag.e(event.id));
+		if (isAddressableKind(event.kind)) {
+			if (getDTag(event.tags) === void 0) throw new EventValidationError("d tag not found");
+			const addr = eventAddress(event);
+			if (addr) tags.push(["a", addr]);
+		}
+		tags.push(["k", event.kind.toString()]);
+	}
+	if (params.lnurl) tags.push(["lnurl", params.lnurl]);
+	return {
+		kind: Kind.ZapRequest,
+		created_at: Math.floor(Date.now() / 1e3),
+		content: params.comment ?? "",
+		tags
+	};
+}
+function firstTagValue(tags, name) {
+	for (const tag of tags) if (tag[0] === name && tag[1] !== void 0) return tag[1];
+}
+function bytesEq(a, b) {
+	if (a.length !== b.length) return false;
+	let x = 0;
+	for (let i = 0; i < a.length; i++) x |= a[i] ^ b[i];
+	return x === 0;
+}
+function fail(reason) {
+	return {
+		valid: false,
+		reason
+	};
+}
+const MSATS_PER_BTC = 1e11;
+const MSATS_PER_MILLI = 1e8;
+const MSATS_PER_MICRO = 1e5;
+const MSATS_PER_NANO = 100;
+/** Amount is digits after `ln` + currency letters, optional m/u/n/p. Non-integer pico is omitted. */
+function amountMsatsFromHrp(hrp) {
+	if (!hrp.startsWith("ln")) return void 0;
+	let i = 2;
+	while (i < hrp.length) {
+		const c = hrp.charCodeAt(i);
+		if (c < 97 || c > 122) break;
+		i++;
+	}
+	if (i === hrp.length) return void 0;
+	const rest = hrp.slice(i);
+	const m = /^([0-9]+)([munp])?$/.exec(rest);
+	if (!m) return void 0;
+	const n = Number(m[1]);
+	if (!Number.isSafeInteger(n)) return void 0;
+	const mul = m[2];
+	if (mul === void 0) return n * MSATS_PER_BTC;
+	if (mul === "m") return n * MSATS_PER_MILLI;
+	if (mul === "u") return n * MSATS_PER_MICRO;
+	if (mul === "n") return n * MSATS_PER_NANO;
+	if (n % 10 !== 0) return void 0;
+	return n / 10;
+}
+function parseMsatsTag(value) {
+	if (!/^[0-9]+$/.test(value)) return void 0;
+	const n = Number(value);
+	return Number.isSafeInteger(n) ? n : void 0;
+}
+function countTags(tags, name) {
+	let n = 0;
+	for (const tag of tags) if (tag[0] === name) n++;
+	return n;
+}
+function hasHexTagValue(tags, name, value) {
+	const needle = value.toLowerCase();
+	for (const tag of tags) if (tag[0] === name && tag[1] !== void 0 && tag[1].toLowerCase() === needle) return true;
+	return false;
+}
+function hasAddressTag(tags, value) {
+	const want = parseEventAddress(value);
+	if (!want) return false;
+	for (const tag of tags) {
+		if (tag[0] !== "a" || tag[1] === void 0) continue;
+		const got = parseEventAddress(tag[1]);
+		if (got && got.kind === want.kind && got.pubkey === want.pubkey && got.identifier === want.identifier) return true;
+	}
+	return false;
+}
+const BOLT11_TIMESTAMP_WORDS = 7;
+const BOLT11_SIGNATURE_WORDS = 104;
+const BOLT11_HASH_WORDS = 52;
+const HASH_BYTES = 32;
+/** Decode a BOLT11 invoice. Never throws. Requires a 32-byte payment hash (type 1). */
+function parseBolt11(pr) {
+	try {
+		const { prefix, words } = bech32.decode(pr.toLowerCase(), false);
+		if (!prefix.startsWith("ln")) return void 0;
+		if (words.length < 111) return void 0;
+		const fields = {};
+		const amountMsats = amountMsatsFromHrp(prefix);
+		if (amountMsats !== void 0) fields.amountMsats = amountMsats;
+		const tlvEnd = words.length - BOLT11_SIGNATURE_WORDS;
+		let i = BOLT11_TIMESTAMP_WORDS;
+		while (i + 3 <= tlvEnd) {
+			const type = words[i];
+			const dataLen = words[i + 1] << 5 | words[i + 2];
+			i += 3;
+			if (i + dataLen > tlvEnd) break;
+			const data = words.slice(i, i + dataLen);
+			i += dataLen;
+			if (type !== 1 && type !== 23 || dataLen !== BOLT11_HASH_WORDS) continue;
+			const bytes = bech32.fromWordsUnsafe(data);
+			if (!bytes || bytes.length !== HASH_BYTES) continue;
+			if (type === 1) fields.paymentHash ??= bytes;
+			else fields.descriptionHash ??= bytes;
+		}
+		if (!fields.paymentHash) return void 0;
+		return fields;
+	} catch {
+		return;
+	}
+}
+/** Parse the `description` tag of a kind 9735 receipt as a signed kind 9734. Never throws. */
+function parseZapRequestFromReceipt(receipt) {
+	try {
+		const raw = firstTagValue(receipt.tags, "description");
+		if (raw === void 0) return void 0;
+		const parsed = JSON.parse(raw);
+		if (!validateSignedEvent(parsed) || parsed.kind !== Kind.ZapRequest) return void 0;
+		if (!verifyEvent(parsed)) return void 0;
+		return parsed;
+	} catch {
+		return;
+	}
+}
+/** Validate a kind 9735 zap receipt. Never throws. */
+function validateZapReceipt(receipt, ctx) {
+	try {
+		if (receipt.kind !== Kind.Zap || !verifyEvent(receipt)) return fail("invalid receipt");
+		if (receipt.pubkey.toLowerCase() !== ctx.nostrPubkey.toLowerCase()) return fail("pubkey mismatch");
+		const descriptionRaw = firstTagValue(receipt.tags, "description");
+		const request = parseZapRequestFromReceipt(receipt);
+		if (descriptionRaw === void 0 || !request) return fail("invalid zap request");
+		if (countTags(request.tags, "p") !== 1) return fail("invalid p count");
+		if (countTags(request.tags, "e") > 1) return fail("too many e tags");
+		if (!firstTagValue(request.tags, "relays")) return fail("missing relays");
+		for (const tag of request.tags) {
+			if (tag[0] !== "a") continue;
+			if (tag[1] === void 0) return fail("invalid a");
+			const parsed = parseEventAddress(tag[1]);
+			if (!parsed || !isAddressableKind(parsed.kind)) return fail("invalid a");
+		}
+		const requestPCount = countTags(request.tags, "P");
+		if (requestPCount > 1) return fail("too many P tags");
+		if (requestPCount === 1) {
+			const requestP = firstTagValue(request.tags, "P");
+			if (requestP === void 0 || requestP.toLowerCase() !== receipt.pubkey.toLowerCase()) return fail("request P mismatch");
+		}
+		const bolt11Tag = firstTagValue(receipt.tags, "bolt11");
+		if (bolt11Tag === void 0) return fail("missing bolt11");
+		const bolt11 = parseBolt11(bolt11Tag);
+		if (!bolt11 || !bolt11.descriptionHash) return fail("invalid bolt11");
+		const requestAmount = firstTagValue(request.tags, "amount");
+		if (requestAmount !== void 0) {
+			const msats = parseMsatsTag(requestAmount);
+			if (msats === void 0 || bolt11.amountMsats !== msats) return fail("amount mismatch");
+		}
+		if (!bytesEq(sha256(utf8Encoder.encode(descriptionRaw)), bolt11.descriptionHash)) return fail("description hash mismatch");
+		const requestLnurl = firstTagValue(request.tags, "lnurl");
+		if (requestLnurl !== void 0 && ctx.lnurl !== void 0) {
+			if (requestLnurl.toLowerCase() !== ctx.lnurl.toLowerCase()) return fail("lnurl mismatch");
+		}
+		const preimageHex = firstTagValue(receipt.tags, "preimage");
+		if (preimageHex !== void 0 && bolt11.paymentHash) {
+			let preimage;
+			try {
+				preimage = hexToBytes(preimageHex);
+			} catch {
+				return fail("preimage mismatch");
+			}
+			if (!bytesEq(sha256(preimage), bolt11.paymentHash)) return fail("preimage mismatch");
+		}
+		const recipient = firstTagValue(request.tags, "p");
+		if (recipient === void 0 || !hasHexTagValue(receipt.tags, "p", recipient)) return fail("missing p");
+		const requestE = firstTagValue(request.tags, "e");
+		if (requestE !== void 0 && !hasHexTagValue(receipt.tags, "e", requestE)) return fail("missing e");
+		for (const tag of request.tags) {
+			if (tag[0] !== "a" || tag[1] === void 0) continue;
+			if (!hasAddressTag(receipt.tags, tag[1])) return fail("missing a");
+		}
+		for (const tag of receipt.tags) {
+			if (tag[0] !== "P") continue;
+			if (tag[1] === void 0 || tag[1].toLowerCase() !== request.pubkey.toLowerCase()) return fail("receipt P mismatch");
+		}
+		const amountMsats = bolt11.amountMsats ?? (requestAmount !== void 0 ? parseMsatsTag(requestAmount) : void 0);
+		return amountMsats === void 0 ? {
+			valid: true,
+			request
+		} : {
+			valid: true,
+			request,
+			amountMsats
+		};
+	} catch {
+		return fail("invalid receipt");
+	}
+}
+//#endregion
+export { makeZapRequest, parseBolt11, parseZapRequestFromReceipt, validateZapReceipt };
+
+//# sourceMappingURL=nip57.mjs.map