@twin.org/crypto 0.0.2-next.9 → 0.0.3-next.1

package/dist/es/keys/slip0010.js

@@ -0,0 +1,83 @@
+// Copyright 2024 IOTA Stiftung.
+// SPDX-License-Identifier: Apache-2.0.
+import { HDKey as HDKeySecp256k1 } from "@scure/bip32";
+import { Converter, GeneralError } from "@twin.org/core";
+import { HDKey as HDKeyEd25519 } from "micro-key-producer/slip10.js";
+import { Ed25519 } from "../curves/ed25519.js";
+import { Secp256k1 } from "../curves/secp256k1.js";
+import { KeyType } from "../models/keyType.js";
+/**
+ * Class to help with slip0010 key derivation
+ * https://github.com/satoshilabs/slips/blob/master/slip-0010.md.
+ */
+export class Slip0010 {
+    /**
+     * Runtime name for the class.
+     */
+    static CLASS_NAME = "Slip0010";
+    /**
+     * Get the master key from the seed.
+     * @param seed The seed to generate the master key from.
+     * @param keyType The key type.
+     * @returns The key and chain code.
+     * @throws If the seed is invalid.
+     */
+    static getMasterKeyFromSeed(seed, keyType = KeyType.Ed25519) {
+        try {
+            const masterKey = keyType === KeyType.Ed25519
+                ? HDKeyEd25519.fromMasterSeed(seed)
+                : HDKeySecp256k1.fromMasterSeed(seed);
+            return {
+                privateKey: masterKey.privateKey ?? new Uint8Array(),
+                chainCode: masterKey.chainCode ?? new Uint8Array()
+            };
+        }
+        catch (error) {
+            throw new GeneralError(Slip0010.CLASS_NAME, "invalidSeed", { seed: Converter.bytesToUtf8(seed) }, error);
+        }
+    }
+    /**
+     * Derive a key from the path.
+     * @param seed The seed.
+     * @param path The path.
+     * @param keyType The key type.
+     * @returns The key and chain code.
+     */
+    static derivePath(seed, path, keyType = KeyType.Ed25519) {
+        const keyOpts = Slip0010.getMasterKeyFromSeed(seed, keyType);
+        if (keyType === KeyType.Ed25519) {
+            const hdKey = new HDKeyEd25519(keyOpts);
+            const derivedKey = hdKey.derive(path.toString());
+            return {
+                privateKey: derivedKey.privateKey,
+                chainCode: derivedKey.chainCode
+            };
+        }
+        const hdKey = new HDKeySecp256k1(keyOpts);
+        const derivedKey = hdKey.derive(path.toString());
+        return {
+            privateKey: derivedKey.privateKey ?? new Uint8Array(),
+            chainCode: derivedKey.chainCode ?? new Uint8Array()
+        };
+    }
+    /**
+     * Get the public key from the private key.
+     * @param privateKey The private key.
+     * @param keyType The key type.
+     * @param withZeroByte Include a zero bute prefix.
+     * @returns The public key.
+     */
+    static getPublicKey(privateKey, keyType = KeyType.Ed25519, withZeroByte = true) {
+        const signPk = keyType === KeyType.Ed25519
+            ? Ed25519.publicKeyFromPrivateKey(privateKey)
+            : Secp256k1.publicKeyFromPrivateKey(privateKey);
+        if (withZeroByte) {
+            const arr = new Uint8Array(1 + signPk.length);
+            arr[0] = 0;
+            arr.set(signPk, 1);
+            return arr;
+        }
+        return signPk;
+    }
+}
+//# sourceMappingURL=slip0010.js.map

package/dist/es/keys/slip0010.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slip0010.js","sourceRoot":"","sources":["../../../src/keys/slip0010.ts"],"names":[],"mappings":"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","sourcesContent":["// Copyright 2024 IOTA Stiftung.\n// SPDX-License-Identifier: Apache-2.0.\nimport { HDKey as HDKeySecp256k1 } from \"@scure/bip32\";\nimport { Converter, GeneralError } from \"@twin.org/core\";\nimport { nameof } from \"@twin.org/nameof\";\nimport { HDKey as HDKeyEd25519 } from \"micro-key-producer/slip10.js\";\nimport type { Bip32Path } from \"./bip32Path.js\";\nimport { Ed25519 } from \"../curves/ed25519.js\";\nimport { Secp256k1 } from \"../curves/secp256k1.js\";\nimport { KeyType } from \"../models/keyType.js\";\n\n/**\n * Class to help with slip0010 key derivation\n * https://github.com/satoshilabs/slips/blob/master/slip-0010.md.\n */\nexport class Slip0010 {\n\t/**\n\t * Runtime name for the class.\n\t */\n\tpublic static readonly CLASS_NAME: string = nameof<Slip0010>();\n\n\t/**\n\t * Get the master key from the seed.\n\t * @param seed The seed to generate the master key from.\n\t * @param keyType The key type.\n\t * @returns The key and chain code.\n\t * @throws If the seed is invalid.\n\t */\n\tpublic static getMasterKeyFromSeed(\n\t\tseed: Uint8Array,\n\t\tkeyType: KeyType = KeyType.Ed25519\n\t): {\n\t\tprivateKey: Uint8Array;\n\t\tchainCode: Uint8Array;\n\t} {\n\t\ttry {\n\t\t\tconst masterKey =\n\t\t\t\tkeyType === KeyType.Ed25519\n\t\t\t\t\t? HDKeyEd25519.fromMasterSeed(seed)\n\t\t\t\t\t: HDKeySecp256k1.fromMasterSeed(seed);\n\n\t\t\treturn {\n\t\t\t\tprivateKey: masterKey.privateKey ?? new Uint8Array(),\n\t\t\t\tchainCode: masterKey.chainCode ?? new Uint8Array()\n\t\t\t};\n\t\t} catch (error) {\n\t\t\tthrow new GeneralError(\n\t\t\t\tSlip0010.CLASS_NAME,\n\t\t\t\t\"invalidSeed\",\n\t\t\t\t{ seed: Converter.bytesToUtf8(seed) },\n\t\t\t\terror\n\t\t\t);\n\t\t}\n\t}\n\n\t/**\n\t * Derive a key from the path.\n\t * @param seed The seed.\n\t * @param path The path.\n\t * @param keyType The key type.\n\t * @returns The key and chain code.\n\t */\n\tpublic static derivePath(\n\t\tseed: Uint8Array,\n\t\tpath: Bip32Path,\n\t\tkeyType: KeyType = KeyType.Ed25519\n\t): {\n\t\tprivateKey: Uint8Array;\n\t\tchainCode: Uint8Array;\n\t} {\n\t\tconst keyOpts = Slip0010.getMasterKeyFromSeed(seed, keyType);\n\n\t\tif (keyType === KeyType.Ed25519) {\n\t\t\tconst hdKey = new HDKeyEd25519(keyOpts);\n\t\t\tconst derivedKey = hdKey.derive(path.toString());\n\t\t\treturn {\n\t\t\t\tprivateKey: derivedKey.privateKey,\n\t\t\t\tchainCode: derivedKey.chainCode\n\t\t\t};\n\t\t}\n\t\tconst hdKey = new HDKeySecp256k1(keyOpts);\n\t\tconst derivedKey = hdKey.derive(path.toString());\n\t\treturn {\n\t\t\tprivateKey: derivedKey.privateKey ?? new Uint8Array(),\n\t\t\tchainCode: derivedKey.chainCode ?? new Uint8Array()\n\t\t};\n\t}\n\n\t/**\n\t * Get the public key from the private key.\n\t * @param privateKey The private key.\n\t * @param keyType The key type.\n\t * @param withZeroByte Include a zero bute prefix.\n\t * @returns The public key.\n\t */\n\tpublic static getPublicKey(\n\t\tprivateKey: Uint8Array,\n\t\tkeyType: KeyType = KeyType.Ed25519,\n\t\twithZeroByte: boolean = true\n\t): Uint8Array {\n\t\tconst signPk =\n\t\t\tkeyType === KeyType.Ed25519\n\t\t\t\t? Ed25519.publicKeyFromPrivateKey(privateKey)\n\t\t\t\t: Secp256k1.publicKeyFromPrivateKey(privateKey);\n\t\tif (withZeroByte) {\n\t\t\tconst arr = new Uint8Array(1 + signPk.length);\n\t\t\tarr[0] = 0;\n\t\t\tarr.set(signPk, 1);\n\t\t\treturn arr;\n\t\t}\n\t\treturn signPk;\n\t}\n}\n"]}

package/dist/es/models/keyType.js

@@ -0,0 +1,17 @@
+// Copyright 2024 IOTA Stiftung.
+// SPDX-License-Identifier: Apache-2.0.
+/**
+ * The names of the key types.
+ */
+// eslint-disable-next-line @typescript-eslint/naming-convention
+export const KeyType = {
+    /**
+     * Ed25519.
+     */
+    Ed25519: 0,
+    /**
+     * Secp256k1.
+     */
+    Secp256k1: 1
+};
+//# sourceMappingURL=keyType.js.map

package/dist/es/models/keyType.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keyType.js","sourceRoot":"","sources":["../../../src/models/keyType.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,uCAAuC;AAEvC;;GAEG;AACH,gEAAgE;AAChE,MAAM,CAAC,MAAM,OAAO,GAAG;IACtB;;OAEG;IACH,OAAO,EAAE,CAAC;IAEV;;OAEG;IACH,SAAS,EAAE,CAAC;CACH,CAAC","sourcesContent":["// Copyright 2024 IOTA Stiftung.\n// SPDX-License-Identifier: Apache-2.0.\n\n/**\n * The names of the key types.\n */\n// eslint-disable-next-line @typescript-eslint/naming-convention\nexport const KeyType = {\n\t/**\n\t * Ed25519.\n\t */\n\tEd25519: 0,\n\n\t/**\n\t * Secp256k1.\n\t */\n\tSecp256k1: 1\n} as const;\n\n/**\n * Key types.\n */\nexport type KeyType = (typeof KeyType)[keyof typeof KeyType];\n"]}

package/dist/es/otp/hotp.js

@@ -0,0 +1,27 @@
+// Copyright 2024 IOTA Stiftung.
+// SPDX-License-Identifier: Apache-2.0.
+import { Guards } from "@twin.org/core";
+import * as otp from "micro-key-producer/otp.js";
+/**
+ * Perform HOTP.
+ * Implementation of https://datatracker.ietf.org/doc/html/rfc4226 .
+ */
+export class Hotp {
+    /**
+     * Runtime name for the class.
+     */
+    static CLASS_NAME = "Hotp";
+    /**
+     * Generate a counter based One Time Password.
+     * @param key Key for the one time password.
+     * @param counter This should be stored by the application,
+     * must be user specific, and be incremented for each request.
+     * @returns The one time password.
+     */
+    static generate(key, counter) {
+        Guards.uint8Array(Hotp.CLASS_NAME, "key", key);
+        Guards.number(Hotp.CLASS_NAME, "counter", counter);
+        return otp.hotp({ secret: key, digits: 6, algorithm: "sha1", interval: 30 }, counter);
+    }
+}
+//# sourceMappingURL=hotp.js.map

package/dist/es/otp/hotp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hotp.js","sourceRoot":"","sources":["../../../src/otp/hotp.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,uCAAuC;AACvC,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAExC,OAAO,KAAK,GAAG,MAAM,2BAA2B,CAAC;AAEjD;;;GAGG;AACH,MAAM,OAAO,IAAI;IAChB;;OAEG;IACI,MAAM,CAAU,UAAU,UAA0B;IAE3D;;;;;;OAMG;IACI,MAAM,CAAC,QAAQ,CAAC,GAAe,EAAE,OAAe;QACtD,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,UAAU,SAAe,GAAG,CAAC,CAAC;QACrD,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,aAAmB,OAAO,CAAC,CAAC;QAEzD,OAAO,GAAG,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;IACvF,CAAC","sourcesContent":["// Copyright 2024 IOTA Stiftung.\n// SPDX-License-Identifier: Apache-2.0.\nimport { Guards } from \"@twin.org/core\";\nimport { nameof } from \"@twin.org/nameof\";\nimport * as otp from \"micro-key-producer/otp.js\";\n\n/**\n * Perform HOTP.\n * Implementation of https://datatracker.ietf.org/doc/html/rfc4226 .\n */\nexport class Hotp {\n\t/**\n\t * Runtime name for the class.\n\t */\n\tpublic static readonly CLASS_NAME: string = nameof<Hotp>();\n\n\t/**\n\t * Generate a counter based One Time Password.\n\t * @param key Key for the one time password.\n\t * @param counter This should be stored by the application,\n\t * must be user specific, and be incremented for each request.\n\t * @returns The one time password.\n\t */\n\tpublic static generate(key: Uint8Array, counter: number): string {\n\t\tGuards.uint8Array(Hotp.CLASS_NAME, nameof(key), key);\n\t\tGuards.number(Hotp.CLASS_NAME, nameof(counter), counter);\n\n\t\treturn otp.hotp({ secret: key, digits: 6, algorithm: \"sha1\", interval: 30 }, counter);\n\t}\n}\n"]}

package/dist/es/otp/totp.js

@@ -0,0 +1,75 @@
+// Copyright 2024 IOTA Stiftung.
+// SPDX-License-Identifier: Apache-2.0.
+import { Base32, RandomHelper } from "@twin.org/core";
+import * as otp from "micro-key-producer/otp.js";
+/**
+ * Perform TOTP.
+ * Implementation of https://datatracker.ietf.org/doc/html/rfc4226 .
+ */
+export class Totp {
+    /**
+     * Generate a time based One Time Password.
+     * @param key Key for the one time password.
+     * @param interval The time step of the counter.
+     * @param timestamp The timestamp.
+     * @returns The one time password.
+     */
+    static generate(key, interval = 30, timestamp = Date.now()) {
+        return otp.totp({ secret: key, digits: 6, algorithm: "sha1", interval }, timestamp);
+    }
+    /**
+     * Check a One Time Password based on a timer.
+     * @param token Passcode to validate.
+     * @param key Key for the one time password. This should be unique and secret for
+     * every user as it is the seed used to calculate the HMAC.
+     * @param window The allowable margin for the counter.
+     * @param interval The time step of the counter.
+     * @param timestamp The timestamp now.
+     * @returns Undefined if failure, delta on success
+     */
+    static verify(token, key, window = 2, interval = 30, timestamp = Date.now()) {
+        for (let i = -window; i < window; i++) {
+            const intervalWindow = i * interval * 1000;
+            if (timestamp + intervalWindow > 0) {
+                const gen = Totp.generate(key, interval, timestamp + intervalWindow);
+                if (gen === token) {
+                    // We have found a matching code
+                    return i;
+                }
+            }
+        }
+        // If we get to here then no codes have matched, return undefined
+        return undefined;
+    }
+    /**
+     * Generate a secret.
+     * @param length The length of the secret to generate.
+     * @returns The secret encoded as base32.
+     */
+    static generateSecret(length) {
+        const encodedBase32 = Base32.encode(RandomHelper.generate(length));
+        // Strip the trailing = the authenticator apps don't need them
+        return encodedBase32.replace(/=/g, "");
+    }
+    /**
+     * Convert the secret back to bytes.
+     * @param secretBase32 The secret encoded as base32.
+     * @returns The bytes of the secret.
+     */
+    static secretToBytes(secretBase32) {
+        return Base32.decode(secretBase32);
+    }
+    /**
+     * Generate a url for use with authenticator apps.
+     * See https://github.com/google/google-authenticator/wiki/Key-Uri-Format .
+     * @param issuer The issuer of the totp.
+     * @param label The label that will show in auth apps.
+     * @param secretBase32 The secret as base 32.
+     * @returns The url.
+     */
+    static generateAuthUrl(issuer, label, secretBase32) {
+        const encodedIssuer = encodeURIComponent(issuer);
+        return `otpauth://totp/${encodedIssuer}%3A${encodeURIComponent(label)}?secret=${secretBase32}&issuer=${encodedIssuer}&digits=6&algorithm=SHA1&interval=30`;
+    }
+}
+//# sourceMappingURL=totp.js.map

package/dist/es/otp/totp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"totp.js","sourceRoot":"","sources":["../../../src/otp/totp.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,uCAAuC;AACvC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,KAAK,GAAG,MAAM,2BAA2B,CAAC;AAEjD;;;GAGG;AACH,MAAM,OAAO,IAAI;IAChB;;;;;;OAMG;IACI,MAAM,CAAC,QAAQ,CACrB,GAAe,EACf,WAAmB,EAAE,EACrB,YAAoB,IAAI,CAAC,GAAG,EAAE;QAE9B,OAAO,GAAG,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,SAAS,CAAC,CAAC;IACrF,CAAC;IAED;;;;;;;;;OASG;IACI,MAAM,CAAC,MAAM,CACnB,KAAa,EACb,GAAe,EACf,SAAiB,CAAC,EAClB,WAAmB,EAAE,EACrB,YAAoB,IAAI,CAAC,GAAG,EAAE;QAE9B,KAAK,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,GAAG,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACvC,MAAM,cAAc,GAAG,CAAC,GAAG,QAAQ,GAAG,IAAI,CAAC;YAC3C,IAAI,SAAS,GAAG,cAAc,GAAG,CAAC,EAAE,CAAC;gBACpC,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,QAAQ,EAAE,SAAS,GAAG,cAAc,CAAC,CAAC;gBACrE,IAAI,GAAG,KAAK,KAAK,EAAE,CAAC;oBACnB,gCAAgC;oBAChC,OAAO,CAAC,CAAC;gBACV,CAAC;YACF,CAAC;QACF,CAAC;QAED,iEAAiE;QACjE,OAAO,SAAS,CAAC;IAClB,CAAC;IAED;;;;OAIG;IACI,MAAM,CAAC,cAAc,CAAC,MAAc;QAC1C,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;QAEnE,8DAA8D;QAC9D,OAAO,aAAa,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IACxC,CAAC;IAED;;;;OAIG;IACI,MAAM,CAAC,aAAa,CAAC,YAAoB;QAC/C,OAAO,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;IACpC,CAAC;IAED;;;;;;;OAOG;IACI,MAAM,CAAC,eAAe,CAAC,MAAc,EAAE,KAAa,EAAE,YAAoB;QAChF,MAAM,aAAa,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAC;QACjD,OAAO,kBAAkB,aAAa,MAAM,kBAAkB,CAC7D,KAAK,CACL,WAAW,YAAY,WAAW,aAAa,sCAAsC,CAAC;IACxF,CAAC;CACD","sourcesContent":["// Copyright 2024 IOTA Stiftung.\n// SPDX-License-Identifier: Apache-2.0.\nimport { Base32, RandomHelper } from \"@twin.org/core\";\nimport * as otp from \"micro-key-producer/otp.js\";\n\n/**\n * Perform TOTP.\n * Implementation of https://datatracker.ietf.org/doc/html/rfc4226 .\n */\nexport class Totp {\n\t/**\n\t * Generate a time based One Time Password.\n\t * @param key Key for the one time password.\n\t * @param interval The time step of the counter.\n\t * @param timestamp The timestamp.\n\t * @returns The one time password.\n\t */\n\tpublic static generate(\n\t\tkey: Uint8Array,\n\t\tinterval: number = 30,\n\t\ttimestamp: number = Date.now()\n\t): string {\n\t\treturn otp.totp({ secret: key, digits: 6, algorithm: \"sha1\", interval }, timestamp);\n\t}\n\n\t/**\n\t * Check a One Time Password based on a timer.\n\t * @param token Passcode to validate.\n\t * @param key Key for the one time password. This should be unique and secret for\n\t * every user as it is the seed used to calculate the HMAC.\n\t * @param window The allowable margin for the counter.\n\t * @param interval The time step of the counter.\n\t * @param timestamp The timestamp now.\n\t * @returns Undefined if failure, delta on success\n\t */\n\tpublic static verify(\n\t\ttoken: string,\n\t\tkey: Uint8Array,\n\t\twindow: number = 2,\n\t\tinterval: number = 30,\n\t\ttimestamp: number = Date.now()\n\t): number | undefined {\n\t\tfor (let i = -window; i < window; i++) {\n\t\t\tconst intervalWindow = i * interval * 1000;\n\t\t\tif (timestamp + intervalWindow > 0) {\n\t\t\t\tconst gen = Totp.generate(key, interval, timestamp + intervalWindow);\n\t\t\t\tif (gen === token) {\n\t\t\t\t\t// We have found a matching code\n\t\t\t\t\treturn i;\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\t// If we get to here then no codes have matched, return undefined\n\t\treturn undefined;\n\t}\n\n\t/**\n\t * Generate a secret.\n\t * @param length The length of the secret to generate.\n\t * @returns The secret encoded as base32.\n\t */\n\tpublic static generateSecret(length: number): string {\n\t\tconst encodedBase32 = Base32.encode(RandomHelper.generate(length));\n\n\t\t// Strip the trailing = the authenticator apps don't need them\n\t\treturn encodedBase32.replace(/=/g, \"\");\n\t}\n\n\t/**\n\t * Convert the secret back to bytes.\n\t * @param secretBase32 The secret encoded as base32.\n\t * @returns The bytes of the secret.\n\t */\n\tpublic static secretToBytes(secretBase32: string): Uint8Array {\n\t\treturn Base32.decode(secretBase32);\n\t}\n\n\t/**\n\t * Generate a url for use with authenticator apps.\n\t * See https://github.com/google/google-authenticator/wiki/Key-Uri-Format .\n\t * @param issuer The issuer of the totp.\n\t * @param label The label that will show in auth apps.\n\t * @param secretBase32 The secret as base 32.\n\t * @returns The url.\n\t */\n\tpublic static generateAuthUrl(issuer: string, label: string, secretBase32: string): string {\n\t\tconst encodedIssuer = encodeURIComponent(issuer);\n\t\treturn `otpauth://totp/${encodedIssuer}%3A${encodeURIComponent(\n\t\t\tlabel\n\t\t)}?secret=${secretBase32}&issuer=${encodedIssuer}&digits=6&algorithm=SHA1&interval=30`;\n\t}\n}\n"]}

package/dist/es/passwords/passwordGenerator.js

@@ -0,0 +1,28 @@
+// Copyright 2024 IOTA Stiftung.
+// SPDX-License-Identifier: Apache-2.0.
+import { RandomHelper } from "@twin.org/core";
+/**
+ * Generate random passwords.
+ */
+export class PasswordGenerator {
+    /**
+     * Generate a password of given length.
+     * @param length The length of the password to generate.
+     * @returns The random password.
+     */
+    static generate(length) {
+        const alphabet = "abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ";
+        const alphabet2 = `${alphabet}0123456789!#$£%^&*+=@~?}`;
+        const chars = [];
+        while (chars.length < length) {
+            const charSet = chars.length === 0 ? alphabet : alphabet2;
+            let b = 0;
+            do {
+                b = RandomHelper.generate(1)[0];
+            } while (b >= charSet.length);
+            chars.push(charSet[b]);
+        }
+        return chars.join("");
+    }
+}
+//# sourceMappingURL=passwordGenerator.js.map

package/dist/es/passwords/passwordGenerator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"passwordGenerator.js","sourceRoot":"","sources":["../../../src/passwords/passwordGenerator.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,uCAAuC;AACvC,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C;;GAEG;AACH,MAAM,OAAO,iBAAiB;IAC7B;;;;OAIG;IACI,MAAM,CAAC,QAAQ,CAAC,MAAc;QACpC,MAAM,QAAQ,GAAG,sDAAsD,CAAC;QACxE,MAAM,SAAS,GAAG,GAAG,QAAQ,0BAA0B,CAAC;QAExD,MAAM,KAAK,GAAa,EAAE,CAAC;QAE3B,OAAO,KAAK,CAAC,MAAM,GAAG,MAAM,EAAE,CAAC;YAC9B,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC;YAC1D,IAAI,CAAC,GAAG,CAAC,CAAC;YACV,GAAG,CAAC;gBACH,CAAC,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACjC,CAAC,QAAQ,CAAC,IAAI,OAAO,CAAC,MAAM,EAAE;YAC9B,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;QACxB,CAAC;QAED,OAAO,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACvB,CAAC;CACD","sourcesContent":["// Copyright 2024 IOTA Stiftung.\n// SPDX-License-Identifier: Apache-2.0.\nimport { RandomHelper } from \"@twin.org/core\";\n\n/**\n * Generate random passwords.\n */\nexport class PasswordGenerator {\n\t/**\n\t * Generate a password of given length.\n\t * @param length The length of the password to generate.\n\t * @returns The random password.\n\t */\n\tpublic static generate(length: number): string {\n\t\tconst alphabet = \"abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ\";\n\t\tconst alphabet2 = `${alphabet}0123456789!#$£%^&*+=@~?}`;\n\n\t\tconst chars: string[] = [];\n\n\t\twhile (chars.length < length) {\n\t\t\tconst charSet = chars.length === 0 ? alphabet : alphabet2;\n\t\t\tlet b = 0;\n\t\t\tdo {\n\t\t\t\tb = RandomHelper.generate(1)[0];\n\t\t\t} while (b >= charSet.length);\n\t\t\tchars.push(charSet[b]);\n\t\t}\n\n\t\treturn chars.join(\"\");\n\t}\n}\n"]}

package/dist/es/passwords/passwordValidator.js

@@ -0,0 +1,81 @@
+// Copyright 2024 IOTA Stiftung.
+// SPDX-License-Identifier: Apache-2.0.
+import { Validation } from "@twin.org/core";
+/**
+ * Test password strength.
+ * Ref https://www.owasp.org/index.php/Authentication_Cheat_Sheet#Implement_Proper_Password_Strength_Controls .
+ */
+export class PasswordValidator {
+    /**
+     * Test the strength of the password.
+     * @param property The name of the property.
+     * @param password The password to test.
+     * @param failures The list of failures to add to.
+     * @param options Options to configure the testing.
+     * @param options.minLength The minimum length of the password, defaults to 8.
+     * @param options.maxLength The minimum length of the password, defaults to 128.
+     * @param options.minPhraseLength The minimum length of the password for it to be considered a pass phrase.
+     */
+    static validate(property, password, failures, options) {
+        const isString = Validation.stringValue(property, password, failures);
+        if (isString) {
+            const minLength = options?.minLength ?? 8;
+            if (password.length < minLength) {
+                failures.push({
+                    property,
+                    reason: "validation.minLengthRequired",
+                    properties: {
+                        minLength,
+                        actualLength: password.length
+                    }
+                });
+            }
+            const maxLength = options?.maxLength ?? 128;
+            if (password.length > maxLength) {
+                failures.push({
+                    property,
+                    reason: "validation.maxLengthRequired",
+                    properties: {
+                        maxLength,
+                        actualLength: password.length
+                    }
+                });
+            }
+            if (/(.)\1{2,}/.test(password)) {
+                failures.push({
+                    property,
+                    reason: "validation.repeatedCharacters"
+                });
+            }
+            // If this looks like a phrase then apply additional rules
+            const minPhraseLength = options?.minPhraseLength ?? 20;
+            if (password.length < minPhraseLength || !password.includes(" ")) {
+                if (!/[a-z]/.test(password)) {
+                    failures.push({
+                        property,
+                        reason: "validation.atLeastOneLowerCase"
+                    });
+                }
+                if (!/[A-Z]/.test(password)) {
+                    failures.push({
+                        property,
+                        reason: "validation.atLeastOneUpperCase"
+                    });
+                }
+                if (!/\d/.test(password)) {
+                    failures.push({
+                        property,
+                        reason: "validation.atLeastOneNumber"
+                    });
+                }
+                if (!/[^\dA-Za-z]/.test(password)) {
+                    failures.push({
+                        property,
+                        reason: "validation.atLeastOneSpecialChar"
+                    });
+                }
+            }
+        }
+    }
+}
+//# sourceMappingURL=passwordValidator.js.map

package/dist/es/passwords/passwordValidator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"passwordValidator.js","sourceRoot":"","sources":["../../../src/passwords/passwordValidator.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,uCAAuC;AACvC,OAAO,EAA2B,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAErE;;;GAGG;AACH,MAAM,OAAO,iBAAiB;IAC7B;;;;;;;;;OASG;IACI,MAAM,CAAC,QAAQ,CACrB,QAAgB,EAChB,QAAgB,EAChB,QAA8B,EAC9B,OAIC;QAED,MAAM,QAAQ,GAAG,UAAU,CAAC,WAAW,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;QAEtE,IAAI,QAAQ,EAAE,CAAC;YACd,MAAM,SAAS,GAAG,OAAO,EAAE,SAAS,IAAI,CAAC,CAAC;YAC1C,IAAI,QAAQ,CAAC,MAAM,GAAG,SAAS,EAAE,CAAC;gBACjC,QAAQ,CAAC,IAAI,CAAC;oBACb,QAAQ;oBACR,MAAM,EAAE,8BAA8B;oBACtC,UAAU,EAAE;wBACX,SAAS;wBACT,YAAY,EAAE,QAAQ,CAAC,MAAM;qBAC7B;iBACD,CAAC,CAAC;YACJ,CAAC;YAED,MAAM,SAAS,GAAG,OAAO,EAAE,SAAS,IAAI,GAAG,CAAC;YAC5C,IAAI,QAAQ,CAAC,MAAM,GAAG,SAAS,EAAE,CAAC;gBACjC,QAAQ,CAAC,IAAI,CAAC;oBACb,QAAQ;oBACR,MAAM,EAAE,8BAA8B;oBACtC,UAAU,EAAE;wBACX,SAAS;wBACT,YAAY,EAAE,QAAQ,CAAC,MAAM;qBAC7B;iBACD,CAAC,CAAC;YACJ,CAAC;YAED,IAAI,WAAW,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAChC,QAAQ,CAAC,IAAI,CAAC;oBACb,QAAQ;oBACR,MAAM,EAAE,+BAA+B;iBACvC,CAAC,CAAC;YACJ,CAAC;YAED,0DAA0D;YAC1D,MAAM,eAAe,GAAG,OAAO,EAAE,eAAe,IAAI,EAAE,CAAC;YAEvD,IAAI,QAAQ,CAAC,MAAM,GAAG,eAAe,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;gBAClE,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;oBAC7B,QAAQ,CAAC,IAAI,CAAC;wBACb,QAAQ;wBACR,MAAM,EAAE,gCAAgC;qBACxC,CAAC,CAAC;gBACJ,CAAC;gBAED,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;oBAC7B,QAAQ,CAAC,IAAI,CAAC;wBACb,QAAQ;wBACR,MAAM,EAAE,gCAAgC;qBACxC,CAAC,CAAC;gBACJ,CAAC;gBAED,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;oBAC1B,QAAQ,CAAC,IAAI,CAAC;wBACb,QAAQ;wBACR,MAAM,EAAE,6BAA6B;qBACrC,CAAC,CAAC;gBACJ,CAAC;gBAED,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;oBACnC,QAAQ,CAAC,IAAI,CAAC;wBACb,QAAQ;wBACR,MAAM,EAAE,kCAAkC;qBAC1C,CAAC,CAAC;gBACJ,CAAC;YACF,CAAC;QACF,CAAC;IACF,CAAC;CACD","sourcesContent":["// Copyright 2024 IOTA Stiftung.\n// SPDX-License-Identifier: Apache-2.0.\nimport { type IValidationFailure, Validation } from \"@twin.org/core\";\n\n/**\n * Test password strength.\n * Ref https://www.owasp.org/index.php/Authentication_Cheat_Sheet#Implement_Proper_Password_Strength_Controls .\n */\nexport class PasswordValidator {\n\t/**\n\t * Test the strength of the password.\n\t * @param property The name of the property.\n\t * @param password The password to test.\n\t * @param failures The list of failures to add to.\n\t * @param options Options to configure the testing.\n\t * @param options.minLength The minimum length of the password, defaults to 8.\n\t * @param options.maxLength The minimum length of the password, defaults to 128.\n\t * @param options.minPhraseLength The minimum length of the password for it to be considered a pass phrase.\n\t */\n\tpublic static validate(\n\t\tproperty: string,\n\t\tpassword: string,\n\t\tfailures: IValidationFailure[],\n\t\toptions?: {\n\t\t\tminLength?: number;\n\t\t\tmaxLength?: number;\n\t\t\tminPhraseLength?: number;\n\t\t}\n\t): void {\n\t\tconst isString = Validation.stringValue(property, password, failures);\n\n\t\tif (isString) {\n\t\t\tconst minLength = options?.minLength ?? 8;\n\t\t\tif (password.length < minLength) {\n\t\t\t\tfailures.push({\n\t\t\t\t\tproperty,\n\t\t\t\t\treason: \"validation.minLengthRequired\",\n\t\t\t\t\tproperties: {\n\t\t\t\t\t\tminLength,\n\t\t\t\t\t\tactualLength: password.length\n\t\t\t\t\t}\n\t\t\t\t});\n\t\t\t}\n\n\t\t\tconst maxLength = options?.maxLength ?? 128;\n\t\t\tif (password.length > maxLength) {\n\t\t\t\tfailures.push({\n\t\t\t\t\tproperty,\n\t\t\t\t\treason: \"validation.maxLengthRequired\",\n\t\t\t\t\tproperties: {\n\t\t\t\t\t\tmaxLength,\n\t\t\t\t\t\tactualLength: password.length\n\t\t\t\t\t}\n\t\t\t\t});\n\t\t\t}\n\n\t\t\tif (/(.)\\1{2,}/.test(password)) {\n\t\t\t\tfailures.push({\n\t\t\t\t\tproperty,\n\t\t\t\t\treason: \"validation.repeatedCharacters\"\n\t\t\t\t});\n\t\t\t}\n\n\t\t\t// If this looks like a phrase then apply additional rules\n\t\t\tconst minPhraseLength = options?.minPhraseLength ?? 20;\n\n\t\t\tif (password.length < minPhraseLength || !password.includes(\" \")) {\n\t\t\t\tif (!/[a-z]/.test(password)) {\n\t\t\t\t\tfailures.push({\n\t\t\t\t\t\tproperty,\n\t\t\t\t\t\treason: \"validation.atLeastOneLowerCase\"\n\t\t\t\t\t});\n\t\t\t\t}\n\n\t\t\t\tif (!/[A-Z]/.test(password)) {\n\t\t\t\t\tfailures.push({\n\t\t\t\t\t\tproperty,\n\t\t\t\t\t\treason: \"validation.atLeastOneUpperCase\"\n\t\t\t\t\t});\n\t\t\t\t}\n\n\t\t\t\tif (!/\\d/.test(password)) {\n\t\t\t\t\tfailures.push({\n\t\t\t\t\t\tproperty,\n\t\t\t\t\t\treason: \"validation.atLeastOneNumber\"\n\t\t\t\t\t});\n\t\t\t\t}\n\n\t\t\t\tif (!/[^\\dA-Za-z]/.test(password)) {\n\t\t\t\t\tfailures.push({\n\t\t\t\t\t\tproperty,\n\t\t\t\t\t\treason: \"validation.atLeastOneSpecialChar\"\n\t\t\t\t\t});\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t}\n}\n"]}

package/dist/types/address/bech32.d.ts

@@ -2,6 +2,10 @@
  * Bech32 encoding and decoding.
  */
 export declare class Bech32 {
+    /**
+     * Runtime name for the class.
+     */
+    static readonly CLASS_NAME: string;
     /**
      * Encode the buffer.
      * @param humanReadablePart The header.

package/dist/types/address/bip44.d.ts

@@ -1,9 +1,13 @@
-import { Bip32Path } from "../keys/bip32Path";
-import { KeyType } from "../models/keyType";
+import { Bip32Path } from "../keys/bip32Path.js";
+import { KeyType } from "../models/keyType.js";
 /**
  * Implementation of Bip44 for address generation.
  */
 export declare class Bip44 {
+    /**
+     * Runtime name for the class.
+     */
+    static readonly CLASS_NAME: string;
     /**
      * Generate a bip44 key pair from the seed and parts.
      * @param seed The account seed.

package/dist/types/ciphers/chaCha20Poly1305.d.ts

@@ -2,6 +2,10 @@
  * Implementation of the ChaCha20Poly1305 cipher.
  */
 export declare class ChaCha20Poly1305 {
+    /**
+     * Runtime name for the class.
+     */
+    static readonly CLASS_NAME: string;
     /**
      * Create a new instance of ChaCha20Poly1305.
      * @param key The key.

package/dist/types/curves/ed25519.d.ts

@@ -10,6 +10,10 @@ export declare class Ed25519 {
      * Public Key Size is the size, in bytes, of public keys as used in this package.
      */
     static PUBLIC_KEY_SIZE: number;
+    /**
+     * Runtime name for the class.
+     */
+    static readonly CLASS_NAME: string;
     /**
      * Public returns the PublicKey corresponding to private.
      * @param privateKey The private key to get the corresponding public key.

package/dist/types/curves/secp256k1.d.ts

@@ -10,6 +10,10 @@ export declare class Secp256k1 {
      * Public Key Size is the size, in bytes, of public keys as used in this package.
      */
     static PUBLIC_KEY_SIZE: number;
+    /**
+     * Runtime name for the class.
+     */
+    static readonly CLASS_NAME: string;
     /**
      * Public returns the PublicKey corresponding to private.
      * @param privateKey The private key to get the corresponding public key.

package/dist/types/curves/x25519.d.ts

@@ -2,6 +2,10 @@
  * Implementation of X25519.
  */
 export declare class X25519 {
+    /**
+     * Runtime name for the class.
+     */
+    static readonly CLASS_NAME: string;
     /**
      * Convert Ed25519 private key to X25519 private key.
      * @param ed25519PrivateKey The ed25519 private key to convert.

package/dist/types/curves/zip215.d.ts

@@ -2,6 +2,10 @@
  * Implementation of Zip215.
  */
 export declare class Zip215 {
+    /**
+     * Runtime name for the class.
+     */
+    static readonly CLASS_NAME: string;
     /**
      * Verify reports whether sig is a valid signature of block by
      * publicKey, using precisely-specified validation criteria (ZIP 215) suitable

package/dist/types/hashes/blake2b.d.ts

@@ -14,6 +14,10 @@ export declare class Blake2b {
      * Blake2b 512.
      */
     static SIZE_512: number;
+    /**
+     * Runtime name for the class.
+     */
+    static readonly CLASS_NAME: string;
     /**
      * Create a new instance of Blake2b.
      * @param outputLength The output length.

package/dist/types/hashes/blake3.d.ts

@@ -10,6 +10,10 @@ export declare class Blake3 {
      * Blake3 512.
      */
     static SIZE_512: number;
+    /**
+     * Runtime name for the class.
+     */
+    static readonly CLASS_NAME: string;
     /**
      * Create a new instance of Blake3.
      * @param outputLength The output length.

package/dist/types/hashes/hmacSha1.d.ts

@@ -2,6 +2,10 @@
  * Class to help with HmacSha1 scheme.
  */
 export declare class HmacSha1 {
+    /**
+     * Runtime name for the class.
+     */
+    static readonly CLASS_NAME: string;
     /**
      * Create a new instance of HmacSha1.
      * @param key The key for the hmac.

package/dist/types/hashes/hmacSha256.d.ts

@@ -10,6 +10,10 @@ export declare class HmacSha256 {
      * Sha256 224.
      */
     static readonly SIZE_224: number;
+    /**
+     * Runtime name for the class.
+     */
+    static readonly CLASS_NAME: string;
     /**
      * Create a new instance of HmacSha256.
      * @param key The key for the hmac.

package/dist/types/hashes/hmacSha512.d.ts

@@ -18,6 +18,10 @@ export declare class HmacSha512 {
      * Sha512 512.
      */
     static SIZE_512: number;
+    /**
+     * Runtime name for the class.
+     */
+    static readonly CLASS_NAME: string;
     /**
      * Create a new instance of HmacSha512.
      * @param key The key for the hmac.

package/dist/types/hashes/pbkdf2.d.ts

@@ -2,6 +2,10 @@
  * Implementation of the password based key derivation function 2.
  */
 export declare class Pbkdf2 {
+    /**
+     * Runtime name for the class.
+     */
+    static readonly CLASS_NAME: string;
     /**
      * Derive a key from the parameters using Sha256.
      * @param password The password to derive the key from.

package/dist/types/hashes/sha1.d.ts

@@ -2,6 +2,10 @@
  * Perform a SHA-1 hash on the block.
  */
 export declare class Sha1 {
+    /**
+     * Runtime name for the class.
+     */
+    static readonly CLASS_NAME: string;
     /**
      * Create a new instance of Sha1.
      */

package/dist/types/hashes/sha256.d.ts

@@ -10,6 +10,10 @@ export declare class Sha256 {
      * Sha256 224.
      */
     static readonly SIZE_224: number;
+    /**
+     * Runtime name for the class.
+     */
+    static readonly CLASS_NAME: string;
     /**
      * Create a new instance of Sha256.
      * @param bits The number of bits.

package/dist/types/hashes/sha3.d.ts

@@ -18,6 +18,10 @@ export declare class Sha3 {
      * Sha3 512.
      */
     static readonly SIZE_512: number;
+    /**
+     * Runtime name for the class.
+     */
+    static readonly CLASS_NAME: string;
     /**
      * Create a new instance of Sha3.
      * @param bits The number of bits.

package/dist/types/hashes/sha512.d.ts

@@ -18,6 +18,10 @@ export declare class Sha512 {
      * Sha512 512.
      */
     static SIZE_512: number;
+    /**
+     * Runtime name for the class.
+     */
+    static readonly CLASS_NAME: string;
     /**
      * Create a new instance of Sha512.
      * @param bits The number of bits.

package/dist/types/helpers/pemHelper.d.ts

@@ -2,6 +2,10 @@
  * Helper class for working with PEM (Privacy-Enhanced Mail) formatted data.
  */
 export declare class PemHelper {
+    /**
+     * Runtime name for the class.
+     */
+    static readonly CLASS_NAME: string;
     /**
      * Strip the PEM content of its headers, footers, and newlines.
      * @param pemContent The PEM content to strip.

package/dist/types/index.d.ts

@@ -1,26 +1,26 @@
-export * from "./address/bech32";
-export * from "./address/bip44";
-export * from "./ciphers/chaCha20Poly1305";
-export * from "./curves/ed25519";
-export * from "./curves/secp256k1";
-export * from "./curves/x25519";
-export * from "./curves/zip215";
-export * from "./hashes/blake2b";
-export * from "./hashes/blake3";
-export * from "./hashes/hmacSha1";
-export * from "./hashes/hmacSha256";
-export * from "./hashes/hmacSha512";
-export * from "./hashes/pbkdf2";
-export * from "./hashes/sha1";
-export * from "./hashes/sha256";
-export * from "./hashes/sha3";
-export * from "./hashes/sha512";
-export * from "./helpers/pemHelper";
-export * from "./keys/bip32Path";
-export * from "./keys/bip39";
-export * from "./keys/slip0010";
-export * from "./models/keyType";
-export * from "./otp/hotp";
-export * from "./otp/totp";
-export * from "./passwords/passwordGenerator";
-export * from "./passwords/passwordValidator";
+export * from "./address/bech32.js";
+export * from "./address/bip44.js";
+export * from "./ciphers/chaCha20Poly1305.js";
+export * from "./curves/ed25519.js";
+export * from "./curves/secp256k1.js";
+export * from "./curves/x25519.js";
+export * from "./curves/zip215.js";
+export * from "./hashes/blake2b.js";
+export * from "./hashes/blake3.js";
+export * from "./hashes/hmacSha1.js";
+export * from "./hashes/hmacSha256.js";
+export * from "./hashes/hmacSha512.js";
+export * from "./hashes/pbkdf2.js";
+export * from "./hashes/sha1.js";
+export * from "./hashes/sha256.js";
+export * from "./hashes/sha3.js";
+export * from "./hashes/sha512.js";
+export * from "./helpers/pemHelper.js";
+export * from "./keys/bip32Path.js";
+export * from "./keys/bip39.js";
+export * from "./keys/slip0010.js";
+export * from "./models/keyType.js";
+export * from "./otp/hotp.js";
+export * from "./otp/totp.js";
+export * from "./passwords/passwordGenerator.js";
+export * from "./passwords/passwordValidator.js";