@unicitylabs/nostr-js-sdk 0.0.1

package/dist/cjs/NostrKeyManager.js

@@ -0,0 +1,265 @@
+"use strict";
+/**
+ * NostrKeyManager - High-level cryptographic operations manager for Nostr.
+ * Manages key pairs, signing, and NIP-04 encryption/decryption.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NostrKeyManager = void 0;
+const utils_1 = require("@noble/hashes/utils");
+const Bech32 = __importStar(require("./crypto/bech32.js"));
+const Schnorr = __importStar(require("./crypto/schnorr.js"));
+const NIP04 = __importStar(require("./crypto/nip04.js"));
+/**
+ * NostrKeyManager provides a high-level interface for cryptographic operations.
+ * It manages a Nostr key pair and provides methods for signing, verification,
+ * and NIP-04 encryption/decryption.
+ */
+class NostrKeyManager {
+    privateKey;
+    publicKey;
+    cleared = false;
+    /**
+     * Private constructor - use static factory methods instead.
+     */
+    constructor(privateKey) {
+        if (privateKey.length !== 32) {
+            throw new Error('Private key must be 32 bytes');
+        }
+        // Make a copy to prevent external modification
+        this.privateKey = new Uint8Array(privateKey);
+        this.publicKey = Schnorr.getPublicKey(this.privateKey);
+    }
+    /**
+     * Create a NostrKeyManager from a 32-byte private key.
+     * @param privateKey 32-byte private key
+     * @returns NostrKeyManager instance
+     */
+    static fromPrivateKey(privateKey) {
+        return new NostrKeyManager(privateKey);
+    }
+    /**
+     * Create a NostrKeyManager from a hex-encoded private key.
+     * @param privateKeyHex Hex-encoded private key (64 characters)
+     * @returns NostrKeyManager instance
+     */
+    static fromPrivateKeyHex(privateKeyHex) {
+        const privateKey = (0, utils_1.hexToBytes)(privateKeyHex);
+        return new NostrKeyManager(privateKey);
+    }
+    /**
+     * Create a NostrKeyManager from a Bech32-encoded nsec string.
+     * @param nsec nsec-encoded private key
+     * @returns NostrKeyManager instance
+     */
+    static fromNsec(nsec) {
+        const privateKey = Bech32.decodeNsec(nsec);
+        return new NostrKeyManager(privateKey);
+    }
+    /**
+     * Generate a new random key pair.
+     * @returns NostrKeyManager instance with a new random key pair
+     */
+    static generate() {
+        const privateKey = (0, utils_1.randomBytes)(32);
+        return new NostrKeyManager(privateKey);
+    }
+    /**
+     * Check if the key manager has been cleared.
+     * @throws Error if the key manager has been cleared
+     */
+    ensureNotCleared() {
+        if (this.cleared) {
+            throw new Error('KeyManager has been cleared');
+        }
+    }
+    /**
+     * Get a copy of the private key bytes.
+     * @returns 32-byte private key (copy)
+     */
+    getPrivateKey() {
+        this.ensureNotCleared();
+        return new Uint8Array(this.privateKey);
+    }
+    /**
+     * Get the hex-encoded private key.
+     * @returns Hex-encoded private key (64 characters)
+     */
+    getPrivateKeyHex() {
+        this.ensureNotCleared();
+        return (0, utils_1.bytesToHex)(this.privateKey);
+    }
+    /**
+     * Get the Bech32-encoded nsec private key.
+     * @returns nsec-encoded private key
+     */
+    getNsec() {
+        this.ensureNotCleared();
+        return Bech32.encodeNsec(this.privateKey);
+    }
+    /**
+     * Get a copy of the x-only public key bytes.
+     * @returns 32-byte x-only public key (copy)
+     */
+    getPublicKey() {
+        this.ensureNotCleared();
+        return new Uint8Array(this.publicKey);
+    }
+    /**
+     * Get the hex-encoded public key.
+     * @returns Hex-encoded public key (64 characters)
+     */
+    getPublicKeyHex() {
+        this.ensureNotCleared();
+        return (0, utils_1.bytesToHex)(this.publicKey);
+    }
+    /**
+     * Get the Bech32-encoded npub public key.
+     * @returns npub-encoded public key
+     */
+    getNpub() {
+        this.ensureNotCleared();
+        return Bech32.encodeNpub(this.publicKey);
+    }
+    /**
+     * Sign a 32-byte message hash using BIP-340 Schnorr signature.
+     * @param messageHash 32-byte message hash
+     * @returns 64-byte Schnorr signature
+     */
+    sign(messageHash) {
+        this.ensureNotCleared();
+        return Schnorr.sign(messageHash, this.privateKey);
+    }
+    /**
+     * Sign a message hash and return hex-encoded signature.
+     * @param messageHash 32-byte message hash
+     * @returns Hex-encoded 64-byte Schnorr signature
+     */
+    signHex(messageHash) {
+        this.ensureNotCleared();
+        return Schnorr.signHex(messageHash, this.privateKey);
+    }
+    /**
+     * Verify a Schnorr signature (static method).
+     * @param signature 64-byte Schnorr signature
+     * @param messageHash 32-byte message hash
+     * @param publicKey 32-byte x-only public key
+     * @returns true if the signature is valid
+     */
+    static verify(signature, messageHash, publicKey) {
+        return Schnorr.verify(signature, messageHash, publicKey);
+    }
+    /**
+     * Verify a hex-encoded Schnorr signature (static method).
+     * @param signatureHex Hex-encoded 64-byte signature
+     * @param messageHash 32-byte message hash
+     * @param publicKeyHex Hex-encoded 32-byte public key
+     * @returns true if the signature is valid
+     */
+    static verifyHex(signatureHex, messageHash, publicKeyHex) {
+        return Schnorr.verifyHex(signatureHex, messageHash, publicKeyHex);
+    }
+    /**
+     * Encrypt a message using NIP-04 encryption.
+     * @param message Message to encrypt
+     * @param recipientPublicKey 32-byte x-only public key of recipient
+     * @returns Encrypted content string
+     */
+    async encrypt(message, recipientPublicKey) {
+        this.ensureNotCleared();
+        return NIP04.encrypt(message, this.privateKey, recipientPublicKey);
+    }
+    /**
+     * Encrypt a message using hex-encoded recipient public key.
+     * @param message Message to encrypt
+     * @param recipientPublicKeyHex Hex-encoded recipient public key
+     * @returns Encrypted content string
+     */
+    async encryptHex(message, recipientPublicKeyHex) {
+        this.ensureNotCleared();
+        const recipientPublicKey = (0, utils_1.hexToBytes)(recipientPublicKeyHex);
+        return NIP04.encrypt(message, this.privateKey, recipientPublicKey);
+    }
+    /**
+     * Decrypt a NIP-04 encrypted message.
+     * @param encryptedContent Encrypted content string
+     * @param senderPublicKey 32-byte x-only public key of sender
+     * @returns Decrypted message
+     */
+    async decrypt(encryptedContent, senderPublicKey) {
+        this.ensureNotCleared();
+        return NIP04.decrypt(encryptedContent, this.privateKey, senderPublicKey);
+    }
+    /**
+     * Decrypt a message using hex-encoded sender public key.
+     * @param encryptedContent Encrypted content string
+     * @param senderPublicKeyHex Hex-encoded sender public key
+     * @returns Decrypted message
+     */
+    async decryptHex(encryptedContent, senderPublicKeyHex) {
+        this.ensureNotCleared();
+        const senderPublicKey = (0, utils_1.hexToBytes)(senderPublicKeyHex);
+        return NIP04.decrypt(encryptedContent, this.privateKey, senderPublicKey);
+    }
+    /**
+     * Derive a shared secret using ECDH.
+     * @param theirPublicKey 32-byte x-only public key
+     * @returns 32-byte shared secret
+     */
+    deriveSharedSecret(theirPublicKey) {
+        this.ensureNotCleared();
+        return NIP04.deriveSharedSecret(this.privateKey, theirPublicKey);
+    }
+    /**
+     * Check if a public key matches this key manager's public key.
+     * @param publicKeyHex Hex-encoded public key to check
+     * @returns true if the public key matches
+     */
+    isMyPublicKey(publicKeyHex) {
+        this.ensureNotCleared();
+        return this.getPublicKeyHex() === publicKeyHex.toLowerCase();
+    }
+    /**
+     * Clear the private key from memory.
+     * After calling this method, the key manager cannot be used for signing or decryption.
+     */
+    clear() {
+        // Overwrite private key with zeros
+        this.privateKey.fill(0);
+        this.cleared = true;
+    }
+}
+exports.NostrKeyManager = NostrKeyManager;
+//# sourceMappingURL=NostrKeyManager.js.map

package/dist/cjs/NostrKeyManager.js.map

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