@enbox/crypto 0.0.1

package/dist/esm/primitives/secp256r1.js.map

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

package/dist/esm/primitives/sha256.js

@@ -0,0 +1,55 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import { sha256 } from '@noble/hashes/sha256';
+/**
+ * The `Sha256` class provides an interface for generating SHA-256 hash digests.
+ *
+ * This class utilizes the '@noble/hashes/sha256' function to generate hash digests
+ * of the provided data. The SHA-256 algorithm is widely used in cryptographic
+ * applications to produce a fixed-size 256-bit (32-byte) hash.
+ *
+ * The methods of this class are asynchronous and return Promises. They use the Uint8Array
+ * type for input data and the resulting digest, ensuring a consistent interface
+ * for binary data processing.
+ *
+ * @example
+ * ```ts
+ * const data = new Uint8Array([...]);
+ * const hash = await Sha256.digest({ data });
+ * ```
+ */
+export class Sha256 {
+    /**
+     * Generates a SHA-256 hash digest for the given data.
+     *
+     * @remarks
+     * This method produces a hash digest using the SHA-256 algorithm. The resultant digest
+     * is deterministic, meaning the same data will always produce the same hash, but
+     * is computationally infeasible to regenerate the original data from the hash.
+     *
+     * @example
+     * ```ts
+     * const data = new Uint8Array([...]);
+     * const hash = await Sha256.digest({ data });
+     * ```
+     *
+     * @param params - The parameters for the hashing operation.
+     * @param params.data - The data to hash, represented as a Uint8Array.
+     *
+     * @returns A Promise that resolves to the SHA-256 hash digest of the provided data as a Uint8Array.
+     */
+    static digest(_a) {
+        return __awaiter(this, arguments, void 0, function* ({ data }) {
+            const hash = sha256(data);
+            return hash;
+        });
+    }
+}
+//# sourceMappingURL=sha256.js.map

package/dist/esm/primitives/sha256.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sha256.js","sourceRoot":"","sources":["../../../src/primitives/sha256.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAE9C;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,OAAO,MAAM;IACjB;;;;;;;;;;;;;;;;;;OAkBG;IACI,MAAM,CAAO,MAAM;6DAAC,EAAE,IAAI,EAEhC;YACC,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;YAE1B,OAAO,IAAI,CAAC;QACd,CAAC;KAAA;CACF"}

package/dist/esm/primitives/x25519.js

@@ -0,0 +1,392 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __rest = (this && this.__rest) || function (s, e) {
+    var t = {};
+    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
+        t[p] = s[p];
+    if (s != null && typeof Object.getOwnPropertySymbols === "function")
+        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
+            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
+                t[p[i]] = s[p[i]];
+        }
+    return t;
+};
+import { Convert } from '@enbox/common';
+import { x25519 } from '@noble/curves/ed25519';
+import { computeJwkThumbprint, isOkpPrivateJwk, isOkpPublicJwk } from '../jose/jwk.js';
+/**
+ * The `X25519` class provides a comprehensive suite of utilities for working with the X25519
+ * elliptic curve, widely used for key agreement protocols and cryptographic applications. It
+ * provides methods for key generation, conversion, and Elliptic Curve Diffie-Hellman (ECDH)
+ * key agreement,  all aligned with standard cryptographic practices.
+ *
+ * The class supports conversions between raw byte formats and JSON Web Key (JWK) formats,
+ * making it versatile for various cryptographic tasks. It adheres to RFC6090 for ECDH, ensuring
+ * secure and effective handling of keys and cryptographic operations.
+ *
+ * Key Features:
+ * - Key Generation: Generate X25519 private keys in JWK format.
+ * - Key Conversion: Transform keys between raw byte arrays and JWK formats.
+ * - Public Key Derivation: Derive public keys from private keys.
+ * - ECDH Shared Secret Computation: Securely derive shared secrets using private and public keys.
+ *
+ * The methods in this class are asynchronous, returning Promises to accommodate various
+ * JavaScript environments.
+ *
+ * @example
+ * ```ts
+ * // Key Generation
+ * const privateKey = await X25519.generateKey();
+ *
+ * // Public Key Derivation
+ * const publicKey = await X25519.computePublicKey({ key: privateKey });
+ * console.log(publicKey === await X25519.getPublicKey({ key: privateKey })); // Output: true
+ *
+ * // ECDH Shared Secret Computation
+ * const sharedSecret = await X25519.sharedSecret({
+ *   privateKeyA: privateKey,
+ *   publicKeyB: anotherPublicKey
+ * });
+ *
+ * // Key Conversion
+ * const publicKeyBytes = await X25519.publicKeyToBytes({ publicKey });
+ * const privateKeyBytes = await X25519.privateKeyToBytes({ privateKey });
+ * ```
+ */
+export class X25519 {
+    /**
+     * Converts a raw private key in bytes to its corresponding JSON Web Key (JWK) format.
+     *
+     * @remarks
+     * This method accepts a private key as a byte array (Uint8Array) for the X25519 elliptic curve
+     * and transforms it into a JWK object. The process involves first deriving the public key from
+     * the private key, then encoding both the private and public keys into base64url format.
+     *
+     * The resulting JWK object includes the following properties:
+     * - `kty`: Key Type, set to 'OKP' for Octet Key Pair.
+     * - `crv`: Curve Name, set to 'X25519'.
+     * - `d`: The private key component, base64url-encoded.
+     * - `x`: The derived public key, base64url-encoded.
+     *
+     * This method is useful for converting raw public keys into a standardized
+     * JSON format, facilitating their use in cryptographic operations and making
+     * them easy to share and store.
+     *
+     * @example
+     * ```ts
+     * const privateKeyBytes = new Uint8Array([...]); // Replace with actual private key bytes
+     * const privateKey = await X25519.bytesToPrivateKey({ privateKeyBytes });
+     * ```
+     *
+     * @param params - The parameters for the private key conversion.
+     * @param params.privateKeyBytes - The raw private key as a Uint8Array.
+     *
+     * @returns A Promise that resolves to the private key in JWK format.
+     */
+    static bytesToPrivateKey(_a) {
+        return __awaiter(this, arguments, void 0, function* ({ privateKeyBytes }) {
+            // Derive the public key from the private key.
+            const publicKeyBytes = x25519.getPublicKey(privateKeyBytes);
+            // Construct the private key in JWK format.
+            const privateKey = {
+                kty: 'OKP',
+                crv: 'X25519',
+                d: Convert.uint8Array(privateKeyBytes).toBase64Url(),
+                x: Convert.uint8Array(publicKeyBytes).toBase64Url(),
+            };
+            // Compute the JWK thumbprint and set as the key ID.
+            privateKey.kid = yield computeJwkThumbprint({ jwk: privateKey });
+            return privateKey;
+        });
+    }
+    /**
+     * Converts a raw public key in bytes to its corresponding JSON Web Key (JWK) format.
+     *
+     * @remarks
+     * This method accepts a public key as a byte array (Uint8Array) for the X25519 elliptic curve
+     * and transforms it into a JWK object. The conversion process involves encoding the public
+     * key bytes into base64url format.
+     *
+     * The resulting JWK object includes the following properties:
+     * - `kty`: Key Type, set to 'OKP' for Octet Key Pair.
+     * - `crv`: Curve Name, set to 'X25519'.
+     * - `x`: The public key, base64url-encoded.
+     *
+     * This method is useful for converting raw public keys into a standardized
+     * JSON format, facilitating their use in cryptographic operations and making
+     * them easy to share and store.
+     *
+     * @example
+     * ```ts
+     * const publicKeyBytes = new Uint8Array([...]); // Replace with actual public key bytes
+     * const publicKey = await X25519.bytesToPublicKey({ publicKeyBytes });
+     * ```
+     *
+     * @param params - The parameters for the public key conversion.
+     * @param params.publicKeyBytes - The raw public key as a Uint8Array.
+     *
+     * @returns A Promise that resolves to the public key in JWK format.
+     */
+    static bytesToPublicKey(_a) {
+        return __awaiter(this, arguments, void 0, function* ({ publicKeyBytes }) {
+            // Construct the public key in JWK format.
+            const publicKey = {
+                kty: 'OKP',
+                crv: 'X25519',
+                x: Convert.uint8Array(publicKeyBytes).toBase64Url(),
+            };
+            // Compute the JWK thumbprint and set as the key ID.
+            publicKey.kid = yield computeJwkThumbprint({ jwk: publicKey });
+            return publicKey;
+        });
+    }
+    /**
+     * Derives the public key in JWK format from a given X25519 private key.
+     *
+     * @remarks
+     * This method takes a private key in JWK format and derives its corresponding public key,
+     * also in JWK format.  The derivation process involves converting the private key to a
+     * raw byte array and then computing the corresponding public key on the Curve25519 curve.
+     * The public key is then encoded into base64url format to construct a JWK representation.
+     *
+     * The process ensures that the derived public key correctly corresponds to the given private key,
+     * adhering to the Curve25519 elliptic curve in Twisted Edwards form standards. This method is
+     * useful in cryptographic operations where a public key is needed for operations like signature
+     * verification, but only the private key is available.
+     *
+     * @example
+     * ```ts
+     * const privateKey = { ... }; // A Jwk object representing an X25519 private key
+     * const publicKey = await X25519.computePublicKey({ key: privateKey });
+     * ```
+     *
+     * @param params - The parameters for the public key derivation.
+     * @param params.key - The private key in JWK format from which to derive the public key.
+     *
+     * @returns A Promise that resolves to the derived public key in JWK format.
+     */
+    static computePublicKey(_a) {
+        return __awaiter(this, arguments, void 0, function* ({ key }) {
+            // Convert the provided private key to a byte array.
+            const privateKeyBytes = yield X25519.privateKeyToBytes({ privateKey: key });
+            // Derive the public key from the private key.
+            const publicKeyBytes = x25519.getPublicKey(privateKeyBytes);
+            // Construct the public key in JWK format.
+            const publicKey = {
+                kty: 'OKP',
+                crv: 'X25519',
+                x: Convert.uint8Array(publicKeyBytes).toBase64Url()
+            };
+            // Compute the JWK thumbprint and set as the key ID.
+            publicKey.kid = yield computeJwkThumbprint({ jwk: publicKey });
+            return publicKey;
+        });
+    }
+    /**
+     * Generates an X25519 private key in JSON Web Key (JWK) format.
+     *
+     * @remarks
+     * This method creates a new private key suitable for use with the X25519 elliptic curve.
+     * The key generation process involves using cryptographically secure random number generation
+     * to ensure the uniqueness and security of the key. The resulting private key adheres to the
+     * JWK format making it compatible with common cryptographic standards and easy to use in various
+     * cryptographic processes.
+     *
+     * The generated private key in JWK format includes the following components:
+     * - `kty`: Key Type, set to 'OKP' for Octet Key Pair.
+     * - `crv`: Curve Name, set to 'X25519'.
+     * - `d`: The private key component, base64url-encoded.
+     * - `x`: The derived public key, base64url-encoded.
+     *
+     * The key is returned in a format suitable for direct use in key agreement operations.
+     *
+     * @example
+     * ```ts
+     * const privateKey = await X25519.generateKey();
+     * ```
+     *
+     * @returns A Promise that resolves to the generated private key in JWK format.
+     */
+    static generateKey() {
+        return __awaiter(this, void 0, void 0, function* () {
+            // Generate a random private key.
+            const privateKeyBytes = x25519.utils.randomPrivateKey();
+            // Convert private key from bytes to JWK format.
+            const privateKey = yield X25519.bytesToPrivateKey({ privateKeyBytes });
+            // Compute the JWK thumbprint and set as the key ID.
+            privateKey.kid = yield computeJwkThumbprint({ jwk: privateKey });
+            return privateKey;
+        });
+    }
+    /**
+     * Retrieves the public key properties from a given private key in JWK format.
+     *
+     * @remarks
+     * This method extracts the public key portion from an X25519 private key in JWK format. It does
+     * so by removing the private key property 'd' and making a shallow copy, effectively yielding the
+     * public key. The method sets the 'kid' (key ID) property using the JWK thumbprint if it is not
+     * already defined. This approach is used under the assumption that a private key in JWK format
+     * always contains the corresponding public key properties.
+     *
+     * Note: This method offers a significant performance advantage, being about 500 times faster
+     * than `computePublicKey()`. However, it does not mathematically validate the private key, nor
+     * does it derive the public key from the private key. It simply extracts existing public key
+     * properties from the private key object. This makes it suitable for scenarios where speed is
+     * critical and the private key's integrity is already assured.
+     *
+     * @example
+     * ```ts
+     * const privateKey = { ... }; // A Jwk object representing an X25519 private key
+     * const publicKey = await X25519.getPublicKey({ key: privateKey });
+     * ```
+     *
+     * @param params - The parameters for retrieving the public key properties.
+     * @param params.key - The private key in JWK format.
+     *
+     * @returns A Promise that resolves to the public key in JWK format.
+     */
+    static getPublicKey(_a) {
+        return __awaiter(this, arguments, void 0, function* ({ key }) {
+            var _b;
+            // Verify the provided JWK represents an octet key pair (OKP) X25519 private key.
+            if (!(isOkpPrivateJwk(key) && key.crv === 'X25519')) {
+                throw new Error(`X25519: The provided key is not an X25519 private JWK.`);
+            }
+            // Remove the private key property ('d') and make a shallow copy of the provided key.
+            let { d } = key, publicKey = __rest(key, ["d"]);
+            // If the key ID is undefined, set it to the JWK thumbprint.
+            (_b = publicKey.kid) !== null && _b !== void 0 ? _b : (publicKey.kid = yield computeJwkThumbprint({ jwk: publicKey }));
+            return publicKey;
+        });
+    }
+    /**
+     * Converts a private key from JSON Web Key (JWK) format to a raw byte array (Uint8Array).
+     *
+     * @remarks
+     * This method accepts a private key in JWK format and extracts its raw byte representation.
+     *
+     * This method accepts a public key in JWK format and converts it into its raw binary
+     * form. The conversion process involves decoding the 'd' parameter of the JWK
+     * from base64url format into a byte array.
+     *
+     * This conversion is essential for operations that require the private key in its raw
+     * binary form, such as certain low-level cryptographic operations or when interfacing
+     * with systems and libraries that expect keys in a byte array format.
+     *
+     * @example
+     * ```ts
+     * const privateKey = { ... }; // An X25519 private key in JWK format
+     * const privateKeyBytes = await X25519.privateKeyToBytes({ privateKey });
+     * ```
+     *
+     * @param params - The parameters for the private key conversion.
+     * @param params.privateKey - The private key in JWK format.
+     *
+     * @returns A Promise that resolves to the private key as a Uint8Array.
+     */
+    static privateKeyToBytes(_a) {
+        return __awaiter(this, arguments, void 0, function* ({ privateKey }) {
+            // Verify the provided JWK represents a valid OKP private key.
+            if (!isOkpPrivateJwk(privateKey)) {
+                throw new Error(`X25519: The provided key is not a valid OKP private key.`);
+            }
+            // Decode the provided private key to bytes.
+            const privateKeyBytes = Convert.base64Url(privateKey.d).toUint8Array();
+            return privateKeyBytes;
+        });
+    }
+    /**
+     * Converts a public key from JSON Web Key (JWK) format to a raw byte array (Uint8Array).
+     *
+     * @remarks
+     * This method accepts a public key in JWK format and converts it into its raw binary form.
+     * The conversion process involves decoding the 'x' parameter of the JWK (which represent the
+     * x coordinate of the elliptic curve point) from base64url format into a byte array.
+     *
+     * This conversion is essential for operations that require the public key in its raw
+     * binary form, such as certain low-level cryptographic operations or when interfacing
+     * with systems and libraries that expect keys in a byte array format.
+     *
+     * @example
+     * ```ts
+     * const publicKey = { ... }; // An X25519 public key in JWK format
+     * const publicKeyBytes = await X25519.publicKeyToBytes({ publicKey });
+     * ```
+     *
+     * @param params - The parameters for the public key conversion.
+     * @param params.publicKey - The public key in JWK format.
+     *
+     * @returns A Promise that resolves to the public key as a Uint8Array.
+     */
+    static publicKeyToBytes(_a) {
+        return __awaiter(this, arguments, void 0, function* ({ publicKey }) {
+            // Verify the provided JWK represents a valid OKP public key.
+            if (!isOkpPublicJwk(publicKey)) {
+                throw new Error(`X25519: The provided key is not a valid OKP public key.`);
+            }
+            // Decode the provided public key to bytes.
+            const publicKeyBytes = Convert.base64Url(publicKey.x).toUint8Array();
+            return publicKeyBytes;
+        });
+    }
+    /**
+     * Computes an RFC6090-compliant Elliptic Curve Diffie-Hellman (ECDH) shared secret
+     * using secp256k1 private and public keys in JSON Web Key (JWK) format.
+     *
+     * @remarks
+     * This method facilitates the ECDH key agreement protocol, which is a method of securely
+     * deriving a shared secret between two parties based on their private and public keys.
+     * It takes the private key of one party (privateKeyA) and the public key of another
+     * party (publicKeyB) to compute a shared secret. The shared secret is derived from the
+     * x-coordinate of the elliptic curve point resulting from the multiplication of the
+     * public key with the private key.
+     *
+     * Note: When performing Elliptic Curve Diffie-Hellman (ECDH) key agreement,
+     * the resulting shared secret is a point on the elliptic curve, which
+     * consists of an x-coordinate and a y-coordinate. With a 256-bit curve like
+     * secp256k1, each of these coordinates is 32 bytes (256 bits) long. However,
+     * in the ECDH process, it's standard practice to use only the x-coordinate
+     * of the shared secret point as the resulting shared key. This is because
+     * the y-coordinate does not add to the entropy of the key, and both parties
+     * can independently compute the x-coordinate.  Consquently, this implementation
+     * omits the y-coordinate for simplicity and standard compliance.
+     *
+     * @example
+     * ```ts
+     * const privateKeyA = { ... }; // A Jwk object for party A
+     * const publicKeyB = { ... }; // A PublicKeyJwk object for party B
+     * const sharedSecret = await Secp256k1.sharedSecret({
+     *   privateKeyA,
+     *   publicKeyB
+     * });
+     * ```
+     *
+     * @param params - The parameters for the shared secret computation.
+     * @param params.privateKeyA - The private key in JWK format of one party.
+     * @param params.publicKeyB - The public key in JWK format of the other party.
+     *
+     * @returns A Promise that resolves to the computed shared secret as a Uint8Array.
+     */
+    static sharedSecret(_a) {
+        return __awaiter(this, arguments, void 0, function* ({ privateKeyA, publicKeyB }) {
+            // Ensure that keys from the same key pair are not specified.
+            if ('x' in privateKeyA && 'x' in publicKeyB && privateKeyA.x === publicKeyB.x) {
+                throw new Error(`X25519: ECDH shared secret cannot be computed from a single key pair's public and private keys.`);
+            }
+            // Convert the provided private and public keys to bytes.
+            const privateKeyABytes = yield X25519.privateKeyToBytes({ privateKey: privateKeyA });
+            const publicKeyBBytes = yield X25519.publicKeyToBytes({ publicKey: publicKeyB });
+            // Compute the shared secret between the public and private keys.
+            const sharedSecret = x25519.getSharedSecret(privateKeyABytes, publicKeyBBytes);
+            return sharedSecret;
+        });
+    }
+}
+//# sourceMappingURL=x25519.js.map

package/dist/esm/primitives/x25519.js.map

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