@qntx/nostr 0.1.0 → 0.2.0

package/dist/index.mjs

@@ -1,23 +1,24 @@
-import { a as isHex32, c as utf8Decoder, d as PUBLIC_KEY_BYTES, f as SECRET_KEY_BYTES, i as hexToBytes, l as utf8Encoder, m as SUBSCRIPTION_ID_MAX_CHARS, o as isHex64, p as SIGNATURE_BYTES, r as bytesToHex, s as normalizeURL, u as EVENT_ID_BYTES } from "./util-6tfLQ9JF.mjs";
-import { a as NostrError, i as MessageError, n as EventValidationError, o as UrlError, r as HexError, s as WasmVerifyPoisonedError, t as CryptoError } from "./error-DZEs5OuZ.mjs";
-import { a as isRegularKind, i as isEphemeralKind, n as classifyKind, o as isReplaceableKind, r as isAddressableKind, t as Kind } from "./kind-BLl4cLOc.mjs";
-import { _ as getDTag, a as itemCompare, b as tagName, c as serializeEvent, d as sortedEvents, f as validateEvent, g as formatEventAddress, h as eventAddress, i as isReplaceableWinner, l as signedMatchesUnsigned, m as Tag, p as validateSignedEvent, r as isMarkedVerified, t as getEventHash, u as sortEvents, v as isTag, x as tagValue, y as parseEventAddress } from "./event-CzoQEFMF.mjs";
-import { a as publicKeyFromHex, i as getPublicKey, n as SecretKey, o as signEvent, r as finalizeEvent, s as verifyEvent, t as Keys } from "./key-Dn-aX4x4.mjs";
-import { t as EventBuilder } from "./builder-q0VsvnYE.mjs";
-import { a as getFilterLimit, c as mergeFilters, i as filterFingerprint, n as canonicalizeFilters, o as matchFilter, r as cloneFilter, s as matchFilters, t as canonicalizeFilter } from "./filter-BxwjEkZp.mjs";
-import { a as mergeCountHll, i as encodeRelayMessage, n as createSubscriptionId, o as parseClientMessage, r as encodeClientMessage, s as parseRelayMessage, t as assertSubscriptionId } from "./message-C_Uj-Y-c.mjs";
-import "./core.mjs";
-import { a as KeysSigner, i as isNip07Available, n as Nip07Signer, r as getWindowNostr, t as Nip46Signer } from "./signer-CZ6K6FUc.mjs";
+import { C as SUBSCRIPTION_ID_MAX_CHARS, S as SIGNATURE_BYTES, _ as UrlError, a as hexToBytes, b as PUBLIC_KEY_BYTES, f as CryptoError, g as NostrError, h as MessageError, i as bytesToHex, l as normalizeURL, m as HexError, o as isHex32, p as EventValidationError, s as isHex64, v as WasmVerifyPoisonedError, x as SECRET_KEY_BYTES, y as EVENT_ID_BYTES } from "./util-LfQirgDk.mjs";
+import { a as isRegularKind, i as isEphemeralKind, n as classifyKind, o as isReplaceableKind, r as isAddressableKind, t as Kind } from "./kind-Cxwhhkx8.mjs";
+import { S as tagValue, _ as formatEventAddress, a as isReplaceableWinner, b as parseEventAddress, d as sortEvents, f as sortedEvents, g as eventAddress, h as Tag, l as serializeEvent, m as validateSignedEvent, n as getEventHash, o as itemCompare, p as validateEvent, u as signedMatchesUnsigned, v as getDTag, x as tagName, y as isTag } from "./event-D8Nfoh4K.mjs";
+import { a as publicKeyFromHex, i as getPublicKey, n as SecretKey, o as signEvent, r as finalizeEvent, s as verifyEvent, t as Keys } from "./key-Bbtys6o7.mjs";
+import { t as EventBuilder } from "./builder-CyrGKRVP.mjs";
+import { a as matchFilter, i as getFilterLimit, n as canonicalizeFilters, o as matchFilters, r as filterFingerprint, s as mergeFilters, t as canonicalizeFilter } from "./filter-BQl3GlHt.mjs";
+import { a as mergeCountHll, i as encodeRelayMessage, n as createSubscriptionId, o as parseClientMessage, r as encodeClientMessage, s as parseRelayMessage, t as assertSubscriptionId } from "./message-DcY6Fi9o.mjs";
+import { t as NoSignerError } from "./error-B__OMBRY.mjs";
+import { a as KeysSigner, i as isNip07Available, n as Nip07Signer, r as getWindowNostr, t as Nip46Signer } from "./signer-CKR9EHce.mjs";
 import { Bech32MaxSize, Nip19Error, decode, decodeNostrURI, naddrEncode, neventEncode, noteEncode, nprofileEncode, npubEncode, nsecEncode } from "./nips/nip19.mjs";
 import { buildReplyTags, parseThreadTags, replyTo } from "./nips/nip10.mjs";
 import { isAuthRequired, makeAuthEvent } from "./nips/nip42.mjs";
 import { markerOf, parseRelayList, readRelays, relayListEventBuilder, relayListToTags, writeRelays } from "./nips/nip65.mjs";
-import { a as RelayStatus, c as isInsecureRelayUrl, d as RelayClosedError, f as RelayConnectionError, i as Relay, m as RelayPublishError, p as RelayError, t as Pool, u as useWebSocketImplementation } from "./pool-C_j1OmBB.mjs";
+import { a as RelayStatus, c as isInsecureRelayUrl, d as RelayClosedError, f as RelayConnectionError, h as RelayTimeoutError, i as Relay, m as RelayPublishError, p as RelayError, t as Pool, u as useWebSocketImplementation } from "./pool-XmAGaufS.mjs";
 import "./relay.mjs";
-import { t as Gossip } from "./gossip-3xkRRCm_.mjs";
-import { a as groupAuthorsByOutboxRelay, d as LoaderError, i as createOutboxFeed, m as ReplaceableCache, n as OutboxError, o as bareNostrUser, p as LoaderContext, r as OutboxFeed, t as createLoaders, u as DataLoader } from "./loaders-BNQszDAn.mjs";
-import { t as StorageError } from "./error-CwBxle6N.mjs";
-import { t as MemoryEventStore } from "./memory-BCmhZPek.mjs";
-import { i as ClientBuilder, n as ClientError, r as SyncDirection, t as Client } from "./client-Bd8B1mYm.mjs";
-import { t as IndexedDbEventStore } from "./storage-DOy0iLRE.mjs";
-export { Bech32MaxSize, Client, ClientBuilder, ClientError, CryptoError, DataLoader, EVENT_ID_BYTES, EventBuilder, EventValidationError, Gossip, HexError, IndexedDbEventStore, Keys, KeysSigner, Kind, LoaderContext, LoaderError, MemoryEventStore, MessageError, Nip07Signer, Nip19Error, Nip46Signer, NostrError, OutboxError, OutboxFeed, PUBLIC_KEY_BYTES, Pool, Relay, RelayClosedError, RelayConnectionError, RelayError, RelayPublishError, RelayStatus, ReplaceableCache, SECRET_KEY_BYTES, SIGNATURE_BYTES, SUBSCRIPTION_ID_MAX_CHARS, SecretKey, StorageError, SyncDirection, Tag, UrlError, WasmVerifyPoisonedError, assertSubscriptionId, bareNostrUser, buildReplyTags, bytesToHex, canonicalizeFilter, canonicalizeFilters, classifyKind, cloneFilter, createLoaders, createOutboxFeed, createSubscriptionId, decodeNostrURI, encodeClientMessage, encodeRelayMessage, eventAddress, filterFingerprint, finalizeEvent, formatEventAddress, getDTag, getEventHash, getFilterLimit, getPublicKey, getWindowNostr, groupAuthorsByOutboxRelay, hexToBytes, isAddressableKind, isAuthRequired, isEphemeralKind, isHex32, isHex64, isInsecureRelayUrl, isMarkedVerified, isNip07Available, isRegularKind, isReplaceableKind, isReplaceableWinner, isTag, itemCompare, makeAuthEvent, markerOf, matchFilter, matchFilters, mergeCountHll, mergeFilters, naddrEncode, neventEncode, decode as nip19Decode, normalizeURL, noteEncode, nprofileEncode, npubEncode, nsecEncode, parseClientMessage, parseEventAddress, parseRelayList, parseRelayMessage, parseThreadTags, publicKeyFromHex, readRelays, relayListEventBuilder, relayListToTags, replyTo, serializeEvent, signEvent, signedMatchesUnsigned, sortEvents, sortedEvents, tagName, tagValue, useWebSocketImplementation, utf8Decoder, utf8Encoder, validateEvent, validateSignedEvent, verifyEvent, writeRelays };
+import { t as Gossip } from "./gossip-oloDMWEj.mjs";
+import { a as groupAuthorsByOutboxRelay, i as createOutboxFeed, n as OutboxError, o as bareNostrUser, r as OutboxFeed, t as createLoaders } from "./loaders-o6YXB_Ri.mjs";
+import { t as StorageError } from "./error-DrEIM7FO.mjs";
+import { t as MemoryEventStore } from "./memory-C2EVx0_O.mjs";
+import { t as ReactiveEventStore } from "./reactive-DDlThDSZ.mjs";
+import { i as ClientBuilder, n as ClientError, r as SyncDirection, t as Client } from "./client-BWsX9Cv1.mjs";
+import { n as IndexedDbEventStore, t as SqliteEventStore } from "./storage-xXxLGCVb.mjs";
+import "./store.mjs";
+export { Bech32MaxSize, Client, ClientBuilder, ClientError, CryptoError, EVENT_ID_BYTES, EventBuilder, EventValidationError, Gossip, HexError, IndexedDbEventStore, Keys, KeysSigner, Kind, MemoryEventStore, MessageError, Nip07Signer, Nip19Error, Nip46Signer, NoSignerError, NostrError, OutboxError, OutboxFeed, PUBLIC_KEY_BYTES, Pool, ReactiveEventStore, Relay, RelayClosedError, RelayConnectionError, RelayError, RelayPublishError, RelayStatus, RelayTimeoutError, SECRET_KEY_BYTES, SIGNATURE_BYTES, SUBSCRIPTION_ID_MAX_CHARS, SecretKey, SqliteEventStore, StorageError, SyncDirection, Tag, UrlError, WasmVerifyPoisonedError, assertSubscriptionId, bareNostrUser, buildReplyTags, bytesToHex, canonicalizeFilter, canonicalizeFilters, classifyKind, createLoaders, createOutboxFeed, createSubscriptionId, decodeNostrURI, encodeClientMessage, encodeRelayMessage, eventAddress, filterFingerprint, finalizeEvent, formatEventAddress, getDTag, getEventHash, getFilterLimit, getPublicKey, getWindowNostr, groupAuthorsByOutboxRelay, hexToBytes, isAddressableKind, isAuthRequired, isEphemeralKind, isHex32, isHex64, isInsecureRelayUrl, isNip07Available, isRegularKind, isReplaceableKind, isReplaceableWinner, isTag, itemCompare, makeAuthEvent, markerOf, matchFilter, matchFilters, mergeCountHll, mergeFilters, naddrEncode, neventEncode, decode as nip19Decode, normalizeURL, noteEncode, nprofileEncode, npubEncode, nsecEncode, parseClientMessage, parseEventAddress, parseRelayList, parseRelayMessage, parseThreadTags, publicKeyFromHex, readRelays, relayListEventBuilder, relayListToTags, replyTo, serializeEvent, signEvent, signedMatchesUnsigned, sortEvents, sortedEvents, tagName, tagValue, useWebSocketImplementation, validateEvent, validateSignedEvent, verifyEvent, writeRelays };

package/dist/{key-Dn-aX4x4.mjs → key-Bbtys6o7.mjs}

@@ -1,6 +1,5 @@
-import { i as hexToBytes, n as assertSecretKeyBytes, r as bytesToHex, t as assertHex32 } from "./util-6tfLQ9JF.mjs";
-import { t as CryptoError } from "./error-DZEs5OuZ.mjs";
-import { f as validateEvent, n as isMarkedFailed, o as markUnverified, p as validateSignedEvent, r as isMarkedVerified, s as markVerified, t as getEventHash } from "./event-CzoQEFMF.mjs";
+import { a as hexToBytes, f as CryptoError, i as bytesToHex, n as assertHex32, r as assertSecretKeyBytes } from "./util-LfQirgDk.mjs";
+import { c as markVerified, i as isMarkedVerified, m as validateSignedEvent, n as getEventHash, p as validateEvent, r as isMarkedFailed, s as markUnverified } from "./event-D8Nfoh4K.mjs";
 import { schnorr } from "@noble/curves/secp256k1.js";
 //#region src/core/key.ts
 /** 32-byte secret key held as bytes; prefer zeroize when done. */
@@ -30,13 +29,15 @@ var SecretKey = class SecretKey {
 	zeroize() {
 		if (this.#bytes) {
 			this.#bytes.fill(0);
-			this.#bytes = null;
+			this.#bytes = void 0;
 		}
 	}
 };
+/** Validate and normalize a hex public key; throws {@link HexError} on bad input. */
 function publicKeyFromHex(hex) {
 	return assertHex32(hex, "public key");
 }
+/** Derive the public key for a secret key given as SecretKey, bytes, or hex. */
 function getPublicKey(secretKey) {
 	const bytes = secretKey instanceof SecretKey ? secretKey.bytes : typeof secretKey === "string" ? hexToBytes(assertHex32(secretKey, "secret key")) : (assertSecretKeyBytes(secretKey), secretKey);
 	return bytesToHex(schnorr.getPublicKey(bytes));
@@ -63,10 +64,17 @@ function resolveSecretKeyBytes(secretKey) {
 	assertSecretKeyBytes(secretKey);
 	return secretKey;
 }
+function resolveSigningKey(secretKey) {
+	if (secretKey instanceof Keys) return {
+		bytes: secretKey.secretKey.bytes,
+		publicKey: secretKey.publicKey
+	};
+	return { bytes: resolveSecretKeyBytes(secretKey) };
+}
 /** Fill pubkey/id/sig on a template and return a signed event. */
 function finalizeEvent(template, secretKey) {
-	const sk = resolveSecretKeyBytes(secretKey);
-	const pubkey = bytesToHex(schnorr.getPublicKey(sk));
+	const { bytes: sk, publicKey } = resolveSigningKey(secretKey);
+	const pubkey = publicKey ?? bytesToHex(schnorr.getPublicKey(sk));
 	return signEvent({
 		kind: template.kind,
 		tags: template.tags,
@@ -76,14 +84,14 @@ function finalizeEvent(template, secretKey) {
 	}, sk);
 }
 /**
-* Sign an already-assembled unsigned event.
-* Rejects when `unsigned.pubkey` does not match the secret key.
+* Sign an already-assembled unsigned event. Rejects when `unsigned.pubkey` does not match the
+* secret key.
 */
 function signEvent(unsigned, secretKey) {
-	const sk = resolveSecretKeyBytes(secretKey);
+	const { bytes: sk, publicKey } = resolveSigningKey(secretKey);
 	if (!validateEvent(unsigned)) throw new CryptoError("cannot sign invalid unsigned event");
-	const expected = bytesToHex(schnorr.getPublicKey(sk));
-	if (unsigned.pubkey.toLowerCase() !== expected) throw new CryptoError("unsigned event pubkey does not match secret key");
+	const expected = publicKey ?? bytesToHex(schnorr.getPublicKey(sk));
+	if (unsigned.pubkey !== expected) throw new CryptoError("unsigned event pubkey does not match secret key");
 	const normalized = {
 		kind: unsigned.kind,
 		tags: unsigned.tags,
@@ -111,11 +119,11 @@ function verifyEvent(event) {
 	}
 	try {
 		const hash = getEventHash(event);
-		if (hash !== event.id.toLowerCase()) {
+		if (hash !== event.id) {
 			markUnverified(event);
 			return false;
 		}
-		const ok = schnorr.verify(hexToBytes(event.sig.toLowerCase()), hexToBytes(hash), hexToBytes(event.pubkey.toLowerCase()));
+		const ok = schnorr.verify(hexToBytes(event.sig), hexToBytes(hash), hexToBytes(event.pubkey));
 		if (ok) markVerified(event);
 		else markUnverified(event);
 		return ok;
@@ -127,4 +135,4 @@ function verifyEvent(event) {
 //#endregion
 export { publicKeyFromHex as a, getPublicKey as i, SecretKey as n, signEvent as o, finalizeEvent as r, verifyEvent as s, Keys as t };
 
-//# sourceMappingURL=key-Dn-aX4x4.mjs.map
+//# sourceMappingURL=key-Bbtys6o7.mjs.map

package/dist/key-Bbtys6o7.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"key-Bbtys6o7.mjs","names":[],"sources":["../src/core/key.ts"],"sourcesContent":["import { schnorr } from \"@noble/curves/secp256k1.js\";\n\nimport { CryptoError } from \"./error.ts\";\nimport {\n  getEventHash,\n  isMarkedFailed,\n  isMarkedVerified,\n  markUnverified,\n  markVerified,\n  validateEvent,\n  validateSignedEvent,\n} from \"./event.ts\";\nimport type { Event, EventTemplate, UnsignedEvent } from \"./event.ts\";\nimport { assertHex32, assertSecretKeyBytes, bytesToHex, hexToBytes } from \"./util.ts\";\n\n/** 32-byte secret key held as bytes; prefer zeroize when done. */\nexport class SecretKey {\n  #bytes: Uint8Array | undefined;\n\n  private constructor(bytes: Uint8Array) {\n    assertSecretKeyBytes(bytes);\n    this.#bytes = new Uint8Array(bytes);\n  }\n\n  static generate(): SecretKey {\n    return new SecretKey(schnorr.utils.randomSecretKey());\n  }\n\n  static fromBytes(bytes: Uint8Array): SecretKey {\n    return new SecretKey(bytes);\n  }\n\n  static fromHex(hex: string): SecretKey {\n    return new SecretKey(hexToBytes(assertHex32(hex, \"secret key\")));\n  }\n\n  get bytes(): Uint8Array {\n    if (!this.#bytes) {\n      throw new CryptoError(\"secret key has been zeroized\");\n    }\n    return new Uint8Array(this.#bytes);\n  }\n\n  toHex(): string {\n    return bytesToHex(this.bytes);\n  }\n\n  /** Best-effort wipe of the internal buffer. */\n  zeroize(): void {\n    if (this.#bytes) {\n      this.#bytes.fill(0);\n      this.#bytes = undefined;\n    }\n  }\n}\n\n/** Lowercase hex-encoded secp256k1 public key (x-only, 64 chars). */\nexport type PublicKey = string;\n\n/** Validate and normalize a hex public key; throws {@link HexError} on bad input. */\nexport function publicKeyFromHex(hex: string): PublicKey {\n  return assertHex32(hex, \"public key\");\n}\n\n/** Derive the public key for a secret key given as SecretKey, bytes, or hex. */\nexport function getPublicKey(secretKey: SecretKey | Uint8Array | string): PublicKey {\n  const bytes =\n    secretKey instanceof SecretKey\n      ? secretKey.bytes\n      : typeof secretKey === \"string\"\n        ? hexToBytes(assertHex32(secretKey, \"secret key\"))\n        : (assertSecretKeyBytes(secretKey), secretKey);\n  return bytesToHex(schnorr.getPublicKey(bytes));\n}\n\n/** Keypair convenience wrapper. */\nexport class Keys {\n  readonly secretKey: SecretKey;\n  readonly publicKey: PublicKey;\n\n  private constructor(secretKey: SecretKey) {\n    this.secretKey = secretKey;\n    this.publicKey = getPublicKey(secretKey);\n  }\n\n  static generate(): Keys {\n    return new Keys(SecretKey.generate());\n  }\n\n  static fromSecretKey(secretKey: SecretKey | Uint8Array | string): Keys {\n    const sk =\n      secretKey instanceof SecretKey\n        ? secretKey\n        : typeof secretKey === \"string\"\n          ? SecretKey.fromHex(secretKey)\n          : SecretKey.fromBytes(secretKey);\n    return new Keys(sk);\n  }\n}\n\nfunction resolveSecretKeyBytes(secretKey: SecretKey | Uint8Array | string): Uint8Array {\n  if (secretKey instanceof SecretKey) {\n    return secretKey.bytes;\n  }\n  if (typeof secretKey === \"string\") {\n    return hexToBytes(assertHex32(secretKey, \"secret key\"));\n  }\n  assertSecretKeyBytes(secretKey);\n  return secretKey;\n}\n\nfunction resolveSigningKey(secretKey: SecretKey | Uint8Array | string | Keys): {\n  bytes: Uint8Array;\n  publicKey?: PublicKey;\n} {\n  if (secretKey instanceof Keys) {\n    return { bytes: secretKey.secretKey.bytes, publicKey: secretKey.publicKey };\n  }\n  return { bytes: resolveSecretKeyBytes(secretKey) };\n}\n\n/** Fill pubkey/id/sig on a template and return a signed event. */\nexport function finalizeEvent(\n  template: EventTemplate,\n  secretKey: SecretKey | Uint8Array | string | Keys,\n): Event {\n  const { bytes: sk, publicKey } = resolveSigningKey(secretKey);\n  const pubkey = publicKey ?? bytesToHex(schnorr.getPublicKey(sk));\n  const unsigned: UnsignedEvent = {\n    kind: template.kind,\n    tags: template.tags,\n    content: template.content,\n    created_at: template.created_at,\n    pubkey,\n  };\n  return signEvent(unsigned, sk);\n}\n\n/**\n * Sign an already-assembled unsigned event. Rejects when `unsigned.pubkey` does not match the\n * secret key.\n */\nexport function signEvent(\n  unsigned: UnsignedEvent,\n  secretKey: SecretKey | Uint8Array | string | Keys,\n): Event {\n  const { bytes: sk, publicKey } = resolveSigningKey(secretKey);\n  if (!validateEvent(unsigned)) {\n    throw new CryptoError(\"cannot sign invalid unsigned event\");\n  }\n\n  const expected = publicKey ?? bytesToHex(schnorr.getPublicKey(sk));\n  if (unsigned.pubkey !== expected) {\n    throw new CryptoError(\"unsigned event pubkey does not match secret key\");\n  }\n\n  const normalized: UnsignedEvent = {\n    kind: unsigned.kind,\n    tags: unsigned.tags,\n    content: unsigned.content,\n    created_at: unsigned.created_at,\n    pubkey: expected,\n  };\n\n  const id = getEventHash(normalized);\n  const sig = bytesToHex(schnorr.sign(hexToBytes(id), sk));\n  const event: Event = { ...normalized, id, sig };\n  markVerified(event);\n  return event;\n}\n\n/** Verify event id and BIP-340 signature. Uses WeakSet cache (does not mutate the event). */\nexport function verifyEvent(event: Event): boolean {\n  if (isMarkedVerified(event)) {\n    return true;\n  }\n  if (isMarkedFailed(event)) {\n    return false;\n  }\n\n  if (!validateSignedEvent(event)) {\n    markUnverified(event);\n    return false;\n  }\n\n  try {\n    const hash = getEventHash(event);\n    if (hash !== event.id) {\n      markUnverified(event);\n      return false;\n    }\n    const ok = schnorr.verify(hexToBytes(event.sig), hexToBytes(hash), hexToBytes(event.pubkey));\n    if (ok) {\n      markVerified(event);\n    } else {\n      markUnverified(event);\n    }\n    return ok;\n  } catch {\n    markUnverified(event);\n    return false;\n  }\n}\n"],"mappings":"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"}

package/dist/{key-BiGxGLhg.d.mts → key-BlsYhN1V.d.mts}

@@ -1,4 +1,4 @@
-import { n as EventTemplate, r as UnsignedEvent, t as Event } from "./event-B5D2jxt_.mjs";
+import { n as EventTemplate, r as UnsignedEvent, t as Event } from "./event-fU3Y01PR.mjs";
 //#region src/core/key.d.ts
 /** 32-byte secret key held as bytes; prefer zeroize when done. */
 declare class SecretKey {
@@ -12,8 +12,11 @@ declare class SecretKey {
   /** Best-effort wipe of the internal buffer. */
   zeroize(): void;
 }
+/** Lowercase hex-encoded secp256k1 public key (x-only, 64 chars). */
 type PublicKey = string;
+/** Validate and normalize a hex public key; throws {@link HexError} on bad input. */
 declare function publicKeyFromHex(hex: string): PublicKey;
+/** Derive the public key for a secret key given as SecretKey, bytes, or hex. */
 declare function getPublicKey(secretKey: SecretKey | Uint8Array | string): PublicKey;
 /** Keypair convenience wrapper. */
 declare class Keys {
@@ -24,14 +27,14 @@ declare class Keys {
   static fromSecretKey(secretKey: SecretKey | Uint8Array | string): Keys;
 }
 /** Fill pubkey/id/sig on a template and return a signed event. */
-declare function finalizeEvent(template: EventTemplate, secretKey: SecretKey | Uint8Array | string): Event;
+declare function finalizeEvent(template: EventTemplate, secretKey: SecretKey | Uint8Array | string | Keys): Event;
 /**
- * Sign an already-assembled unsigned event.
- * Rejects when `unsigned.pubkey` does not match the secret key.
+ * Sign an already-assembled unsigned event. Rejects when `unsigned.pubkey` does not match the
+ * secret key.
  */
-declare function signEvent(unsigned: UnsignedEvent, secretKey: SecretKey | Uint8Array | string): Event;
+declare function signEvent(unsigned: UnsignedEvent, secretKey: SecretKey | Uint8Array | string | Keys): Event;
 /** Verify event id and BIP-340 signature. Uses WeakSet cache (does not mutate the event). */
 declare function verifyEvent(event: Event): boolean;
 //#endregion
 export { getPublicKey as a, verifyEvent as c, finalizeEvent as i, PublicKey as n, publicKeyFromHex as o, SecretKey as r, signEvent as s, Keys as t };
-//# sourceMappingURL=key-BiGxGLhg.d.mts.map
+//# sourceMappingURL=key-BlsYhN1V.d.mts.map

package/dist/{kind-BLl4cLOc.mjs → kind-Cxwhhkx8.mjs}

@@ -15,6 +15,7 @@ function isEphemeralKind(kind) {
 function isAddressableKind(kind) {
 	return kind >= 3e4 && kind < 4e4;
 }
+/** Classify a kind number into its NIP-01 storage class (`"unknown"` outside all ranges). */
 function classifyKind(kind) {
 	if (isRegularKind(kind)) return "regular";
 	if (isReplaceableKind(kind)) return "replaceable";
@@ -56,4 +57,4 @@ const Kind = {
 //#endregion
 export { isRegularKind as a, isEphemeralKind as i, classifyKind as n, isReplaceableKind as o, isAddressableKind as r, Kind as t };
 
-//# sourceMappingURL=kind-BLl4cLOc.mjs.map
+//# sourceMappingURL=kind-Cxwhhkx8.mjs.map

package/dist/kind-Cxwhhkx8.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"kind-Cxwhhkx8.mjs","names":[],"sources":["../src/core/kind.ts"],"sourcesContent":["/** NIP-01 regular: stored by relays. */\nexport function isRegularKind(kind: number): boolean {\n  return kind === 1 || kind === 2 || (kind >= 4 && kind < 45) || (kind >= 1000 && kind < 10000);\n}\n\n/** Replaceable: latest per (pubkey, kind) wins. */\nexport function isReplaceableKind(kind: number): boolean {\n  return kind === 0 || kind === 3 || (kind >= 10000 && kind < 20000);\n}\n\n/** Ephemeral: not expected to be stored. */\nexport function isEphemeralKind(kind: number): boolean {\n  return kind >= 20000 && kind < 30000;\n}\n\n/** Addressable (parameterized replaceable): latest per (pubkey, kind, d-tag) wins. */\nexport function isAddressableKind(kind: number): boolean {\n  return kind >= 30000 && kind < 40000;\n}\n\n/** NIP-01 kind classes: regular / replaceable / ephemeral / addressable. */\nexport type KindClassification =\n  | \"regular\"\n  | \"replaceable\"\n  | \"ephemeral\"\n  | \"addressable\"\n  | \"unknown\";\n\n/** Classify a kind number into its NIP-01 storage class (`\"unknown\"` outside all ranges). */\nexport function classifyKind(kind: number): KindClassification {\n  if (isRegularKind(kind)) {\n    return \"regular\";\n  }\n  if (isReplaceableKind(kind)) {\n    return \"replaceable\";\n  }\n  if (isEphemeralKind(kind)) {\n    return \"ephemeral\";\n  }\n  if (isAddressableKind(kind)) {\n    return \"addressable\";\n  }\n  return \"unknown\";\n}\n\n/** Kind numbers used by this package. */\nexport const Kind = {\n  Metadata: 0,\n  TextNote: 1,\n  Contacts: 3,\n  EventDeletion: 5,\n  Repost: 6,\n  Reaction: 7,\n  Seal: 13,\n  PrivateDirectMessage: 14,\n  GenericRepost: 16,\n  GiftWrap: 1059,\n  ZapRequest: 9734,\n  Zap: 9735,\n  MuteList: 10000,\n  PinList: 10001,\n  RelayList: 10002,\n  BookmarkList: 10003,\n  FavoriteRelays: 10012,\n  UserEmojiList: 10030,\n  DirectMessageRelaysList: 10050,\n  BlossomServerList: 10063,\n  GiftWrapEphemeral: 21059,\n  ClientAuth: 22242,\n  NostrConnect: 24133,\n  BlobsAuth: 24242,\n  HttpAuth: 27235,\n  RelaySets: 30002,\n  EmojiSet: 30030,\n  StarterPack: 39089,\n} as const;\n\n/** Name of a kind constant on {@link Kind}. */\nexport type KindName = keyof typeof Kind;\n/** Union of the numeric kind values on {@link Kind}. */\nexport type KnownKind = (typeof Kind)[KindName];\n"],"mappings":";;AACA,SAAgB,cAAc,MAAuB;CACnD,OAAO,SAAS,KAAK,SAAS,KAAM,QAAQ,KAAK,OAAO,MAAQ,QAAQ,OAAQ,OAAO;AACzF;;AAGA,SAAgB,kBAAkB,MAAuB;CACvD,OAAO,SAAS,KAAK,SAAS,KAAM,QAAQ,OAAS,OAAO;AAC9D;;AAGA,SAAgB,gBAAgB,MAAuB;CACrD,OAAO,QAAQ,OAAS,OAAO;AACjC;;AAGA,SAAgB,kBAAkB,MAAuB;CACvD,OAAO,QAAQ,OAAS,OAAO;AACjC;;AAWA,SAAgB,aAAa,MAAkC;CAC7D,IAAI,cAAc,IAAI,GACpB,OAAO;CAET,IAAI,kBAAkB,IAAI,GACxB,OAAO;CAET,IAAI,gBAAgB,IAAI,GACtB,OAAO;CAET,IAAI,kBAAkB,IAAI,GACxB,OAAO;CAET,OAAO;AACT;;AAGA,MAAa,OAAO;CAClB,UAAU;CACV,UAAU;CACV,UAAU;CACV,eAAe;CACf,QAAQ;CACR,UAAU;CACV,MAAM;CACN,sBAAsB;CACtB,eAAe;CACf,UAAU;CACV,YAAY;CACZ,KAAK;CACL,UAAU;CACV,SAAS;CACT,WAAW;CACX,cAAc;CACd,gBAAgB;CAChB,eAAe;CACf,yBAAyB;CACzB,mBAAmB;CACnB,mBAAmB;CACnB,YAAY;CACZ,cAAc;CACd,WAAW;CACX,UAAU;CACV,WAAW;CACX,UAAU;CACV,aAAa;AACf"}