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

package/dist/es/hashes/sha256.js

@@ -0,0 +1,75 @@
+// Copyright 2024 IOTA Stiftung.
+// SPDX-License-Identifier: Apache-2.0.
+import { sha224, sha256 } from "@noble/hashes/sha2.js";
+import { GeneralError, Guards } from "@twin.org/core";
+/**
+ * Perform a SHA-256 hash on the block.
+ */
+export class Sha256 {
+    /**
+     * Sha256 256.
+     */
+    static SIZE_256 = 256;
+    /**
+     * Sha256 224.
+     */
+    static SIZE_224 = 224;
+    /**
+     * Runtime name for the class.
+     */
+    static CLASS_NAME = "Sha256";
+    /**
+     * The instance of the hash.
+     * @internal
+     */
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    _instance;
+    /**
+     * Create a new instance of Sha256.
+     * @param bits The number of bits.
+     */
+    constructor(bits = Sha256.SIZE_256) {
+        if (bits !== Sha256.SIZE_224 && bits !== Sha256.SIZE_256) {
+            throw new GeneralError(Sha256.CLASS_NAME, "bitSize", { bitSize: bits });
+        }
+        this._instance = bits === Sha256.SIZE_256 ? sha256.create() : sha224.create();
+    }
+    /**
+     * Perform Sum 256 on the block.
+     * @param block The block to operate on.
+     * @returns The sum 256 of the block.
+     */
+    static sum256(block) {
+        const b2b = new Sha256(Sha256.SIZE_256);
+        b2b.update(block);
+        return b2b.digest();
+    }
+    /**
+     * Perform Sum 224 on the block.
+     * @param block The block to operate on.
+     * @returns The sum 224 of the block.
+     */
+    static sum224(block) {
+        const b2b = new Sha256(Sha256.SIZE_224);
+        b2b.update(block);
+        return b2b.digest();
+    }
+    /**
+     * Update the hash with the block.
+     * @param block The block to update the hash with.
+     * @returns The instance for chaining.
+     */
+    update(block) {
+        Guards.uint8Array(Sha256.CLASS_NAME, "block", block);
+        this._instance.update(block);
+        return this;
+    }
+    /**
+     * Get the digest for the hash.
+     * @returns The instance for chaining.
+     */
+    digest() {
+        return this._instance.digest();
+    }
+}
+//# sourceMappingURL=sha256.js.map

package/dist/es/hashes/sha256.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sha256.js","sourceRoot":"","sources":["../../../src/hashes/sha256.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,uCAAuC;AACvC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAEvD,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAGtD;;GAEG;AACH,MAAM,OAAO,MAAM;IAClB;;OAEG;IACI,MAAM,CAAU,QAAQ,GAAW,GAAG,CAAC;IAE9C;;OAEG;IACI,MAAM,CAAU,QAAQ,GAAW,GAAG,CAAC;IAE9C;;OAEG;IACI,MAAM,CAAU,UAAU,YAA4B;IAE7D;;;OAGG;IACH,8DAA8D;IAC7C,SAAS,CAAY;IAEtC;;;OAGG;IACH,YAAY,OAAe,MAAM,CAAC,QAAQ;QACzC,IAAI,IAAI,KAAK,MAAM,CAAC,QAAQ,IAAI,IAAI,KAAK,MAAM,CAAC,QAAQ,EAAE,CAAC;YAC1D,MAAM,IAAI,YAAY,CAAC,MAAM,CAAC,UAAU,EAAE,SAAS,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;QACzE,CAAC;QAED,IAAI,CAAC,SAAS,GAAG,IAAI,KAAK,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;IAC/E,CAAC;IAED;;;;OAIG;IACI,MAAM,CAAC,MAAM,CAAC,KAAiB;QACrC,MAAM,GAAG,GAAG,IAAI,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QACxC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAClB,OAAO,GAAG,CAAC,MAAM,EAAE,CAAC;IACrB,CAAC;IAED;;;;OAIG;IACI,MAAM,CAAC,MAAM,CAAC,KAAiB;QACrC,MAAM,GAAG,GAAG,IAAI,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QACxC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAClB,OAAO,GAAG,CAAC,MAAM,EAAE,CAAC;IACrB,CAAC;IAED;;;;OAIG;IACI,MAAM,CAAC,KAAiB;QAC9B,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,UAAU,WAAiB,KAAK,CAAC,CAAC;QAC3D,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC7B,OAAO,IAAI,CAAC;IACb,CAAC;IAED;;;OAGG;IACI,MAAM;QACZ,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC;IAChC,CAAC","sourcesContent":["// Copyright 2024 IOTA Stiftung.\n// SPDX-License-Identifier: Apache-2.0.\nimport { sha224, sha256 } from \"@noble/hashes/sha2.js\";\nimport type { Hash } from \"@noble/hashes/utils.js\";\nimport { GeneralError, Guards } from \"@twin.org/core\";\nimport { nameof } from \"@twin.org/nameof\";\n\n/**\n * Perform a SHA-256 hash on the block.\n */\nexport class Sha256 {\n\t/**\n\t * Sha256 256.\n\t */\n\tpublic static readonly SIZE_256: number = 256;\n\n\t/**\n\t * Sha256 224.\n\t */\n\tpublic static readonly SIZE_224: number = 224;\n\n\t/**\n\t * Runtime name for the class.\n\t */\n\tpublic static readonly CLASS_NAME: string = nameof<Sha256>();\n\n\t/**\n\t * The instance of the hash.\n\t * @internal\n\t */\n\t// eslint-disable-next-line @typescript-eslint/no-explicit-any\n\tprivate readonly _instance: Hash<any>;\n\n\t/**\n\t * Create a new instance of Sha256.\n\t * @param bits The number of bits.\n\t */\n\tconstructor(bits: number = Sha256.SIZE_256) {\n\t\tif (bits !== Sha256.SIZE_224 && bits !== Sha256.SIZE_256) {\n\t\t\tthrow new GeneralError(Sha256.CLASS_NAME, \"bitSize\", { bitSize: bits });\n\t\t}\n\n\t\tthis._instance = bits === Sha256.SIZE_256 ? sha256.create() : sha224.create();\n\t}\n\n\t/**\n\t * Perform Sum 256 on the block.\n\t * @param block The block to operate on.\n\t * @returns The sum 256 of the block.\n\t */\n\tpublic static sum256(block: Uint8Array): Uint8Array {\n\t\tconst b2b = new Sha256(Sha256.SIZE_256);\n\t\tb2b.update(block);\n\t\treturn b2b.digest();\n\t}\n\n\t/**\n\t * Perform Sum 224 on the block.\n\t * @param block The block to operate on.\n\t * @returns The sum 224 of the block.\n\t */\n\tpublic static sum224(block: Uint8Array): Uint8Array {\n\t\tconst b2b = new Sha256(Sha256.SIZE_224);\n\t\tb2b.update(block);\n\t\treturn b2b.digest();\n\t}\n\n\t/**\n\t * Update the hash with the block.\n\t * @param block The block to update the hash with.\n\t * @returns The instance for chaining.\n\t */\n\tpublic update(block: Uint8Array): Sha256 {\n\t\tGuards.uint8Array(Sha256.CLASS_NAME, nameof(block), block);\n\t\tthis._instance.update(block);\n\t\treturn this;\n\t}\n\n\t/**\n\t * Get the digest for the hash.\n\t * @returns The instance for chaining.\n\t */\n\tpublic digest(): Uint8Array {\n\t\treturn this._instance.digest();\n\t}\n}\n"]}

package/dist/es/hashes/sha3.js

@@ -0,0 +1,122 @@
+// Copyright 2024 IOTA Stiftung.
+// SPDX-License-Identifier: Apache-2.0.
+// eslint-disable-next-line camelcase
+import { sha3_224, sha3_256, sha3_384, sha3_512 } from "@noble/hashes/sha3.js";
+import { GeneralError, Guards } from "@twin.org/core";
+/**
+ * Perform a SHA-3 hash on the block.
+ */
+export class Sha3 {
+    /**
+     * Sha3 224.
+     */
+    static SIZE_224 = 224;
+    /**
+     * Sha3 256.
+     */
+    static SIZE_256 = 256;
+    /**
+     * Sha3 384.
+     */
+    static SIZE_384 = 384;
+    /**
+     * Sha3 512.
+     */
+    static SIZE_512 = 512;
+    /**
+     * Runtime name for the class.
+     */
+    static CLASS_NAME = "Sha3";
+    /**
+     * The instance of the hash.
+     * @internal
+     */
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    _instance;
+    /**
+     * Create a new instance of Sha3.
+     * @param bits The number of bits.
+     */
+    constructor(bits = Sha3.SIZE_256) {
+        if (bits !== Sha3.SIZE_224 &&
+            bits !== Sha3.SIZE_256 &&
+            bits !== Sha3.SIZE_384 &&
+            bits !== Sha3.SIZE_512) {
+            throw new GeneralError(Sha3.CLASS_NAME, "bitSize", { bitSize: bits });
+        }
+        if (bits === Sha3.SIZE_224) {
+            // eslint-disable-next-line camelcase
+            this._instance = sha3_224.create();
+        }
+        else if (bits === Sha3.SIZE_256) {
+            // eslint-disable-next-line camelcase
+            this._instance = sha3_256.create();
+        }
+        else if (bits === Sha3.SIZE_384) {
+            // eslint-disable-next-line camelcase
+            this._instance = sha3_384.create();
+        }
+        else {
+            // eslint-disable-next-line camelcase
+            this._instance = sha3_512.create();
+        }
+    }
+    /**
+     * Perform Sum 256 on the block.
+     * @param block The block to operate on.
+     * @returns The sum 256 of the block.
+     */
+    static sum256(block) {
+        const b2b = new Sha3(Sha3.SIZE_256);
+        b2b.update(block);
+        return b2b.digest();
+    }
+    /**
+     * Perform Sum 224 on the block.
+     * @param block The block to operate on.
+     * @returns The sum 224 of the block.
+     */
+    static sum224(block) {
+        const b2b = new Sha3(Sha3.SIZE_224);
+        b2b.update(block);
+        return b2b.digest();
+    }
+    /**
+     * Perform Sum 384 on the block.
+     * @param block The block to operate on.
+     * @returns The sum 384 of the block.
+     */
+    static sum384(block) {
+        const b2b = new Sha3(Sha3.SIZE_384);
+        b2b.update(block);
+        return b2b.digest();
+    }
+    /**
+     * Perform Sum 512 on the block.
+     * @param block The block to operate on.
+     * @returns The sum 512 of the block.
+     */
+    static sum512(block) {
+        const b2b = new Sha3(Sha3.SIZE_512);
+        b2b.update(block);
+        return b2b.digest();
+    }
+    /**
+     * Update the hash with the block.
+     * @param block The block to update the hash with.
+     * @returns The instance for chaining.
+     */
+    update(block) {
+        Guards.uint8Array(Sha3.CLASS_NAME, "block", block);
+        this._instance.update(block);
+        return this;
+    }
+    /**
+     * Get the digest for the hash.
+     * @returns The instance for chaining.
+     */
+    digest() {
+        return this._instance.digest();
+    }
+}
+//# sourceMappingURL=sha3.js.map

package/dist/es/hashes/sha3.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sha3.js","sourceRoot":"","sources":["../../../src/hashes/sha3.ts"],"names":[],"mappings":"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","sourcesContent":["// Copyright 2024 IOTA Stiftung.\n// SPDX-License-Identifier: Apache-2.0.\n// eslint-disable-next-line camelcase\nimport { sha3_224, sha3_256, sha3_384, sha3_512 } from \"@noble/hashes/sha3.js\";\nimport type { Hash } from \"@noble/hashes/utils.js\";\nimport { GeneralError, Guards } from \"@twin.org/core\";\nimport { nameof } from \"@twin.org/nameof\";\n\n/**\n * Perform a SHA-3 hash on the block.\n */\nexport class Sha3 {\n\t/**\n\t * Sha3 224.\n\t */\n\tpublic static readonly SIZE_224: number = 224;\n\n\t/**\n\t * Sha3 256.\n\t */\n\tpublic static readonly SIZE_256: number = 256;\n\n\t/**\n\t * Sha3 384.\n\t */\n\tpublic static readonly SIZE_384: number = 384;\n\n\t/**\n\t * Sha3 512.\n\t */\n\tpublic static readonly SIZE_512: number = 512;\n\n\t/**\n\t * Runtime name for the class.\n\t */\n\tpublic static readonly CLASS_NAME: string = nameof<Sha3>();\n\n\t/**\n\t * The instance of the hash.\n\t * @internal\n\t */\n\t// eslint-disable-next-line @typescript-eslint/no-explicit-any\n\tprivate readonly _instance: Hash<any>;\n\n\t/**\n\t * Create a new instance of Sha3.\n\t * @param bits The number of bits.\n\t */\n\tconstructor(bits: number = Sha3.SIZE_256) {\n\t\tif (\n\t\t\tbits !== Sha3.SIZE_224 &&\n\t\t\tbits !== Sha3.SIZE_256 &&\n\t\t\tbits !== Sha3.SIZE_384 &&\n\t\t\tbits !== Sha3.SIZE_512\n\t\t) {\n\t\t\tthrow new GeneralError(Sha3.CLASS_NAME, \"bitSize\", { bitSize: bits });\n\t\t}\n\n\t\tif (bits === Sha3.SIZE_224) {\n\t\t\t// eslint-disable-next-line camelcase\n\t\t\tthis._instance = sha3_224.create();\n\t\t} else if (bits === Sha3.SIZE_256) {\n\t\t\t// eslint-disable-next-line camelcase\n\t\t\tthis._instance = sha3_256.create();\n\t\t} else if (bits === Sha3.SIZE_384) {\n\t\t\t// eslint-disable-next-line camelcase\n\t\t\tthis._instance = sha3_384.create();\n\t\t} else {\n\t\t\t// eslint-disable-next-line camelcase\n\t\t\tthis._instance = sha3_512.create();\n\t\t}\n\t}\n\n\t/**\n\t * Perform Sum 256 on the block.\n\t * @param block The block to operate on.\n\t * @returns The sum 256 of the block.\n\t */\n\tpublic static sum256(block: Uint8Array): Uint8Array {\n\t\tconst b2b = new Sha3(Sha3.SIZE_256);\n\t\tb2b.update(block);\n\t\treturn b2b.digest();\n\t}\n\n\t/**\n\t * Perform Sum 224 on the block.\n\t * @param block The block to operate on.\n\t * @returns The sum 224 of the block.\n\t */\n\tpublic static sum224(block: Uint8Array): Uint8Array {\n\t\tconst b2b = new Sha3(Sha3.SIZE_224);\n\t\tb2b.update(block);\n\t\treturn b2b.digest();\n\t}\n\n\t/**\n\t * Perform Sum 384 on the block.\n\t * @param block The block to operate on.\n\t * @returns The sum 384 of the block.\n\t */\n\tpublic static sum384(block: Uint8Array): Uint8Array {\n\t\tconst b2b = new Sha3(Sha3.SIZE_384);\n\t\tb2b.update(block);\n\t\treturn b2b.digest();\n\t}\n\n\t/**\n\t * Perform Sum 512 on the block.\n\t * @param block The block to operate on.\n\t * @returns The sum 512 of the block.\n\t */\n\tpublic static sum512(block: Uint8Array): Uint8Array {\n\t\tconst b2b = new Sha3(Sha3.SIZE_512);\n\t\tb2b.update(block);\n\t\treturn b2b.digest();\n\t}\n\n\t/**\n\t * Update the hash with the block.\n\t * @param block The block to update the hash with.\n\t * @returns The instance for chaining.\n\t */\n\tpublic update(block: Uint8Array): Sha3 {\n\t\tGuards.uint8Array(Sha3.CLASS_NAME, nameof(block), block);\n\t\tthis._instance.update(block);\n\t\treturn this;\n\t}\n\n\t/**\n\t * Get the digest for the hash.\n\t * @returns The instance for chaining.\n\t */\n\tpublic digest(): Uint8Array {\n\t\treturn this._instance.digest();\n\t}\n}\n"]}

package/dist/es/hashes/sha512.js

@@ -0,0 +1,118 @@
+// Copyright 2024 IOTA Stiftung.
+// SPDX-License-Identifier: Apache-2.0.
+/* eslint-disable camelcase */
+import { sha384, sha512, sha512_224, sha512_256 } from "@noble/hashes/sha2.js";
+import { GeneralError, Guards } from "@twin.org/core";
+/**
+ * Perform a SHA-512 hash on the block.
+ */
+export class Sha512 {
+    /**
+     * Sha512 224.
+     */
+    static SIZE_224 = 224;
+    /**
+     * Sha512 256.
+     */
+    static SIZE_256 = 256;
+    /**
+     * Sha512 384.
+     */
+    static SIZE_384 = 384;
+    /**
+     * Sha512 512.
+     */
+    static SIZE_512 = 512;
+    /**
+     * Runtime name for the class.
+     */
+    static CLASS_NAME = "Sha512";
+    /**
+     * The instance of the hash.
+     * @internal
+     */
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    _instance;
+    /**
+     * Create a new instance of Sha512.
+     * @param bits The number of bits.
+     */
+    constructor(bits = Sha512.SIZE_512) {
+        if (bits !== Sha512.SIZE_224 &&
+            bits !== Sha512.SIZE_256 &&
+            bits !== Sha512.SIZE_384 &&
+            bits !== Sha512.SIZE_512) {
+            throw new GeneralError(Sha512.CLASS_NAME, "bitSize", { bitSize: bits });
+        }
+        if (bits === Sha512.SIZE_224) {
+            this._instance = sha512_224.create();
+        }
+        else if (bits === Sha512.SIZE_256) {
+            this._instance = sha512_256.create();
+        }
+        else if (bits === Sha512.SIZE_384) {
+            this._instance = sha384.create();
+        }
+        else {
+            this._instance = sha512.create();
+        }
+    }
+    /**
+     * Perform Sum 512 on the block.
+     * @param block The block to operate on.
+     * @returns The sum 512 of the block.
+     */
+    static sum512(block) {
+        const b2b = new Sha512(Sha512.SIZE_512);
+        b2b.update(block);
+        return b2b.digest();
+    }
+    /**
+     * Perform Sum 384 on the block.
+     * @param block The block to operate on.
+     * @returns The sum 384 of the block.
+     */
+    static sum384(block) {
+        const b2b = new Sha512(Sha512.SIZE_384);
+        b2b.update(block);
+        return b2b.digest();
+    }
+    /**
+     * Perform Sum 256 on the block.
+     * @param block The block to operate on.
+     * @returns The sum 256 of the block.
+     */
+    static sum256(block) {
+        const b2b = new Sha512(Sha512.SIZE_256);
+        b2b.update(block);
+        return b2b.digest();
+    }
+    /**
+     * Perform Sum 224 on the block.
+     * @param block The block to operate on.
+     * @returns The sum 224 of the block.
+     */
+    static sum224(block) {
+        const b2b = new Sha512(Sha512.SIZE_224);
+        b2b.update(block);
+        return b2b.digest();
+    }
+    /**
+     * Update the hash with the block.
+     * @param block The block to update the hash with.
+     * @returns The instance for chaining.
+     */
+    update(block) {
+        Guards.uint8Array(Sha512.CLASS_NAME, "block", block);
+        this._instance.update(block);
+        return this;
+    }
+    /**
+     * Get the digest for the hash.
+     * @returns The instance for chaining.
+     */
+    digest() {
+        return this._instance.digest();
+    }
+}
+//# sourceMappingURL=sha512.js.map

package/dist/es/hashes/sha512.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sha512.js","sourceRoot":"","sources":["../../../src/hashes/sha512.ts"],"names":[],"mappings":"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","sourcesContent":["// Copyright 2024 IOTA Stiftung.\n// SPDX-License-Identifier: Apache-2.0.\n/* eslint-disable camelcase */\nimport { sha384, sha512, sha512_224, sha512_256 } from \"@noble/hashes/sha2.js\";\nimport type { Hash } from \"@noble/hashes/utils.js\";\nimport { GeneralError, Guards } from \"@twin.org/core\";\nimport { nameof } from \"@twin.org/nameof\";\n\n/**\n * Perform a SHA-512 hash on the block.\n */\nexport class Sha512 {\n\t/**\n\t * Sha512 224.\n\t */\n\tpublic static SIZE_224: number = 224;\n\n\t/**\n\t * Sha512 256.\n\t */\n\tpublic static SIZE_256: number = 256;\n\n\t/**\n\t * Sha512 384.\n\t */\n\tpublic static SIZE_384: number = 384;\n\n\t/**\n\t * Sha512 512.\n\t */\n\tpublic static SIZE_512: number = 512;\n\n\t/**\n\t * Runtime name for the class.\n\t */\n\tpublic static readonly CLASS_NAME: string = nameof<Sha512>();\n\n\t/**\n\t * The instance of the hash.\n\t * @internal\n\t */\n\t// eslint-disable-next-line @typescript-eslint/no-explicit-any\n\tprivate readonly _instance: Hash<any>;\n\n\t/**\n\t * Create a new instance of Sha512.\n\t * @param bits The number of bits.\n\t */\n\tconstructor(bits: number = Sha512.SIZE_512) {\n\t\tif (\n\t\t\tbits !== Sha512.SIZE_224 &&\n\t\t\tbits !== Sha512.SIZE_256 &&\n\t\t\tbits !== Sha512.SIZE_384 &&\n\t\t\tbits !== Sha512.SIZE_512\n\t\t) {\n\t\t\tthrow new GeneralError(Sha512.CLASS_NAME, \"bitSize\", { bitSize: bits });\n\t\t}\n\n\t\tif (bits === Sha512.SIZE_224) {\n\t\t\tthis._instance = sha512_224.create();\n\t\t} else if (bits === Sha512.SIZE_256) {\n\t\t\tthis._instance = sha512_256.create();\n\t\t} else if (bits === Sha512.SIZE_384) {\n\t\t\tthis._instance = sha384.create();\n\t\t} else {\n\t\t\tthis._instance = sha512.create();\n\t\t}\n\t}\n\n\t/**\n\t * Perform Sum 512 on the block.\n\t * @param block The block to operate on.\n\t * @returns The sum 512 of the block.\n\t */\n\tpublic static sum512(block: Uint8Array): Uint8Array {\n\t\tconst b2b = new Sha512(Sha512.SIZE_512);\n\t\tb2b.update(block);\n\t\treturn b2b.digest();\n\t}\n\n\t/**\n\t * Perform Sum 384 on the block.\n\t * @param block The block to operate on.\n\t * @returns The sum 384 of the block.\n\t */\n\tpublic static sum384(block: Uint8Array): Uint8Array {\n\t\tconst b2b = new Sha512(Sha512.SIZE_384);\n\t\tb2b.update(block);\n\t\treturn b2b.digest();\n\t}\n\n\t/**\n\t * Perform Sum 256 on the block.\n\t * @param block The block to operate on.\n\t * @returns The sum 256 of the block.\n\t */\n\tpublic static sum256(block: Uint8Array): Uint8Array {\n\t\tconst b2b = new Sha512(Sha512.SIZE_256);\n\t\tb2b.update(block);\n\t\treturn b2b.digest();\n\t}\n\n\t/**\n\t * Perform Sum 224 on the block.\n\t * @param block The block to operate on.\n\t * @returns The sum 224 of the block.\n\t */\n\tpublic static sum224(block: Uint8Array): Uint8Array {\n\t\tconst b2b = new Sha512(Sha512.SIZE_224);\n\t\tb2b.update(block);\n\t\treturn b2b.digest();\n\t}\n\n\t/**\n\t * Update the hash with the block.\n\t * @param block The block to update the hash with.\n\t * @returns The instance for chaining.\n\t */\n\tpublic update(block: Uint8Array): Sha512 {\n\t\tGuards.uint8Array(Sha512.CLASS_NAME, nameof(block), block);\n\t\tthis._instance.update(block);\n\t\treturn this;\n\t}\n\n\t/**\n\t * Get the digest for the hash.\n\t * @returns The instance for chaining.\n\t */\n\tpublic digest(): Uint8Array {\n\t\treturn this._instance.digest();\n\t}\n}\n"]}

package/dist/es/helpers/pemHelper.js

@@ -0,0 +1,42 @@
+// Copyright 2024 IOTA Stiftung.
+// SPDX-License-Identifier: Apache-2.0.
+import { Guards } from "@twin.org/core";
+/**
+ * Helper class for working with PEM (Privacy-Enhanced Mail) formatted data.
+ */
+export class PemHelper {
+    /**
+     * Runtime name for the class.
+     */
+    static CLASS_NAME = "PemHelper";
+    /**
+     * Strip the PEM content of its headers, footers, and newlines.
+     * @param pemContent The PEM content to strip.
+     * @returns The stripped PEM content in bas64 format.
+     */
+    static stripPemMarkers(pemContent) {
+        Guards.string(PemHelper.CLASS_NAME, "pemContent", pemContent);
+        return pemContent
+            .replace(/-----BEGIN.*-----/, "")
+            .replace(/-----END.*-----/, "")
+            .replace(/\n/g, "")
+            .trim();
+    }
+    /**
+     * Format the PEM content to have a specific line length.
+     * @param marker The marker for the PEM content, e.g. RSA PRIVATE KEY
+     * @param base64Content The base64 content to format.
+     * @param lineLength The length of each line in the PEM content, default is 64 characters.
+     * @returns The formatted PEM content.
+     */
+    static formatPem(marker, base64Content, lineLength = 64) {
+        Guards.stringValue(PemHelper.CLASS_NAME, "marker", marker);
+        Guards.stringBase64(PemHelper.CLASS_NAME, "base64Content", base64Content);
+        const lines = [];
+        for (let i = 0; i < base64Content.length; i += lineLength) {
+            lines.push(base64Content.slice(i, i + lineLength));
+        }
+        return [`-----BEGIN ${marker}-----`, ...lines, `-----END ${marker}-----`].join("\n");
+    }
+}
+//# sourceMappingURL=pemHelper.js.map

package/dist/es/helpers/pemHelper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pemHelper.js","sourceRoot":"","sources":["../../../src/helpers/pemHelper.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,uCAAuC;AACvC,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAGxC;;GAEG;AACH,MAAM,OAAO,SAAS;IACrB;;OAEG;IACI,MAAM,CAAU,UAAU,eAA+B;IAEhE;;;;OAIG;IACI,MAAM,CAAC,eAAe,CAAC,UAAkB;QAC/C,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,UAAU,gBAAsB,UAAU,CAAC,CAAC;QACpE,OAAO,UAAU;aACf,OAAO,CAAC,mBAAmB,EAAE,EAAE,CAAC;aAChC,OAAO,CAAC,iBAAiB,EAAE,EAAE,CAAC;aAC9B,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC;aAClB,IAAI,EAAE,CAAC;IACV,CAAC;IAED;;;;;;OAMG;IACI,MAAM,CAAC,SAAS,CAAC,MAAc,EAAE,aAAqB,EAAE,aAAqB,EAAE;QACrF,MAAM,CAAC,WAAW,CAAC,SAAS,CAAC,UAAU,YAAkB,MAAM,CAAC,CAAC;QACjE,MAAM,CAAC,YAAY,CAAC,SAAS,CAAC,UAAU,mBAAyB,aAAa,CAAC,CAAC;QAChF,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,aAAa,CAAC,MAAM,EAAE,CAAC,IAAI,UAAU,EAAE,CAAC;YAC3D,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC;QACpD,CAAC;QACD,OAAO,CAAC,cAAc,MAAM,OAAO,EAAE,GAAG,KAAK,EAAE,YAAY,MAAM,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACtF,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\";\n\n/**\n * Helper class for working with PEM (Privacy-Enhanced Mail) formatted data.\n */\nexport class PemHelper {\n\t/**\n\t * Runtime name for the class.\n\t */\n\tpublic static readonly CLASS_NAME: string = nameof<PemHelper>();\n\n\t/**\n\t * Strip the PEM content of its headers, footers, and newlines.\n\t * @param pemContent The PEM content to strip.\n\t * @returns The stripped PEM content in bas64 format.\n\t */\n\tpublic static stripPemMarkers(pemContent: string): string {\n\t\tGuards.string(PemHelper.CLASS_NAME, nameof(pemContent), pemContent);\n\t\treturn pemContent\n\t\t\t.replace(/-----BEGIN.*-----/, \"\")\n\t\t\t.replace(/-----END.*-----/, \"\")\n\t\t\t.replace(/\\n/g, \"\")\n\t\t\t.trim();\n\t}\n\n\t/**\n\t * Format the PEM content to have a specific line length.\n\t * @param marker The marker for the PEM content, e.g. RSA PRIVATE KEY\n\t * @param base64Content The base64 content to format.\n\t * @param lineLength The length of each line in the PEM content, default is 64 characters.\n\t * @returns The formatted PEM content.\n\t */\n\tpublic static formatPem(marker: string, base64Content: string, lineLength: number = 64): string {\n\t\tGuards.stringValue(PemHelper.CLASS_NAME, nameof(marker), marker);\n\t\tGuards.stringBase64(PemHelper.CLASS_NAME, nameof(base64Content), base64Content);\n\t\tconst lines: string[] = [];\n\t\tfor (let i = 0; i < base64Content.length; i += lineLength) {\n\t\t\tlines.push(base64Content.slice(i, i + lineLength));\n\t\t}\n\t\treturn [`-----BEGIN ${marker}-----`, ...lines, `-----END ${marker}-----`].join(\"\\n\");\n\t}\n}\n"]}

package/dist/es/index.js

@@ -0,0 +1,29 @@
+// Copyright 2024 IOTA Stiftung.
+// SPDX-License-Identifier: Apache-2.0.
+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";
+//# sourceMappingURL=index.js.map

package/dist/es/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,uCAAuC;AACvC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,kCAAkC,CAAC;AACjD,cAAc,kCAAkC,CAAC","sourcesContent":["// Copyright 2024 IOTA Stiftung.\n// SPDX-License-Identifier: Apache-2.0.\nexport * from \"./address/bech32.js\";\nexport * from \"./address/bip44.js\";\nexport * from \"./ciphers/chaCha20Poly1305.js\";\nexport * from \"./curves/ed25519.js\";\nexport * from \"./curves/secp256k1.js\";\nexport * from \"./curves/x25519.js\";\nexport * from \"./curves/zip215.js\";\nexport * from \"./hashes/blake2b.js\";\nexport * from \"./hashes/blake3.js\";\nexport * from \"./hashes/hmacSha1.js\";\nexport * from \"./hashes/hmacSha256.js\";\nexport * from \"./hashes/hmacSha512.js\";\nexport * from \"./hashes/pbkdf2.js\";\nexport * from \"./hashes/sha1.js\";\nexport * from \"./hashes/sha256.js\";\nexport * from \"./hashes/sha3.js\";\nexport * from \"./hashes/sha512.js\";\nexport * from \"./helpers/pemHelper.js\";\nexport * from \"./keys/bip32Path.js\";\nexport * from \"./keys/bip39.js\";\nexport * from \"./keys/slip0010.js\";\nexport * from \"./models/keyType.js\";\nexport * from \"./otp/hotp.js\";\nexport * from \"./otp/totp.js\";\nexport * from \"./passwords/passwordGenerator.js\";\nexport * from \"./passwords/passwordValidator.js\";\n"]}

package/dist/es/keys/bip32Path.js

@@ -0,0 +1,72 @@
+// Copyright 2024 IOTA Stiftung.
+// SPDX-License-Identifier: Apache-2.0.
+/**
+ * Class to help with bip32 paths.
+ */
+export class Bip32Path {
+    /**
+     * The path.
+     * @internal
+     */
+    _path;
+    /**
+     * Create a new instance of Bip32Path.
+     * @param initialPath Initial path to create.
+     */
+    constructor(initialPath) {
+        if (initialPath) {
+            this._path = initialPath.split("/");
+            if (this._path[0] === "m") {
+                this._path.shift();
+            }
+        }
+        else {
+            this._path = [];
+        }
+    }
+    /**
+     * Construct a new path by cloning an existing one.
+     * @param bip32Path The path to clone.
+     * @returns A new instance of Bip32Path.
+     */
+    static fromPath(bip32Path) {
+        const p = new Bip32Path();
+        p._path = bip32Path._path.slice();
+        return p;
+    }
+    /**
+     * Converts the path to a string.
+     * @returns The path as a string.
+     */
+    toString() {
+        return this._path.length > 0 ? `m/${this._path.join("/")}` : "m";
+    }
+    /**
+     * Push a new index on to the path.
+     * @param index The index to add to the path.
+     */
+    push(index) {
+        this._path.push(`${index}`);
+    }
+    /**
+     * Push a new hardened index on to the path.
+     * @param index The index to add to the path.
+     */
+    pushHardened(index) {
+        this._path.push(`${index}'`);
+    }
+    /**
+     * Pop an index from the path.
+     */
+    pop() {
+        this._path.pop();
+    }
+    /**
+     * Get the segments.
+     * @returns The segments as numbers.
+     */
+    numberSegments() {
+        return this._path.map(p => Number.parseInt(p, 10));
+    }
+}
+//# sourceMappingURL=bip32Path.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"bip32Path.js","sourceRoot":"","sources":["../../../src/keys/bip32Path.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,uCAAuC;AAEvC;;GAEG;AACH,MAAM,OAAO,SAAS;IACrB;;;OAGG;IACK,KAAK,CAAW;IAExB;;;OAGG;IACH,YAAY,WAAoB;QAC/B,IAAI,WAAW,EAAE,CAAC;YACjB,IAAI,CAAC,KAAK,GAAG,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YAEpC,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,GAAG,EAAE,CAAC;gBAC3B,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;YACpB,CAAC;QACF,CAAC;aAAM,CAAC;YACP,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC;QACjB,CAAC;IACF,CAAC;IAED;;;;OAIG;IACI,MAAM,CAAC,QAAQ,CAAC,SAAoB;QAC1C,MAAM,CAAC,GAAG,IAAI,SAAS,EAAE,CAAC;QAC1B,CAAC,CAAC,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QAClC,OAAO,CAAC,CAAC;IACV,CAAC;IAED;;;OAGG;IACI,QAAQ;QACd,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;IAClE,CAAC;IAED;;;OAGG;IACI,IAAI,CAAC,KAAa;QACxB,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,EAAE,CAAC,CAAC;IAC7B,CAAC;IAED;;;OAGG;IACI,YAAY,CAAC,KAAa;QAChC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,GAAG,CAAC,CAAC;IAC9B,CAAC;IAED;;OAEG;IACI,GAAG;QACT,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;IAClB,CAAC;IAED;;;OAGG;IACI,cAAc;QACpB,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;IACpD,CAAC;CACD","sourcesContent":["// Copyright 2024 IOTA Stiftung.\n// SPDX-License-Identifier: Apache-2.0.\n\n/**\n * Class to help with bip32 paths.\n */\nexport class Bip32Path {\n\t/**\n\t * The path.\n\t * @internal\n\t */\n\tprivate _path: string[];\n\n\t/**\n\t * Create a new instance of Bip32Path.\n\t * @param initialPath Initial path to create.\n\t */\n\tconstructor(initialPath?: string) {\n\t\tif (initialPath) {\n\t\t\tthis._path = initialPath.split(\"/\");\n\n\t\t\tif (this._path[0] === \"m\") {\n\t\t\t\tthis._path.shift();\n\t\t\t}\n\t\t} else {\n\t\t\tthis._path = [];\n\t\t}\n\t}\n\n\t/**\n\t * Construct a new path by cloning an existing one.\n\t * @param bip32Path The path to clone.\n\t * @returns A new instance of Bip32Path.\n\t */\n\tpublic static fromPath(bip32Path: Bip32Path): Bip32Path {\n\t\tconst p = new Bip32Path();\n\t\tp._path = bip32Path._path.slice();\n\t\treturn p;\n\t}\n\n\t/**\n\t * Converts the path to a string.\n\t * @returns The path as a string.\n\t */\n\tpublic toString(): string {\n\t\treturn this._path.length > 0 ? `m/${this._path.join(\"/\")}` : \"m\";\n\t}\n\n\t/**\n\t * Push a new index on to the path.\n\t * @param index The index to add to the path.\n\t */\n\tpublic push(index: number): void {\n\t\tthis._path.push(`${index}`);\n\t}\n\n\t/**\n\t * Push a new hardened index on to the path.\n\t * @param index The index to add to the path.\n\t */\n\tpublic pushHardened(index: number): void {\n\t\tthis._path.push(`${index}'`);\n\t}\n\n\t/**\n\t * Pop an index from the path.\n\t */\n\tpublic pop(): void {\n\t\tthis._path.pop();\n\t}\n\n\t/**\n\t * Get the segments.\n\t * @returns The segments as numbers.\n\t */\n\tpublic numberSegments(): number[] {\n\t\treturn this._path.map(p => Number.parseInt(p, 10));\n\t}\n}\n"]}

package/dist/es/keys/bip39.js

@@ -0,0 +1,83 @@
+// Copyright 2024 IOTA Stiftung.
+// SPDX-License-Identifier: Apache-2.0.
+import * as bip39 from "@scure/bip39";
+import { wordlist } from "@scure/bip39/wordlists/english.js";
+import { GuardError, Guards } from "@twin.org/core";
+/**
+ * Implementation of Bip39 for mnemonic generation.
+ */
+export class Bip39 {
+    /**
+     * Runtime name for the class.
+     */
+    static CLASS_NAME = "Bip39";
+    /**
+     * Generate a random mnemonic.
+     * @param strength The strength of the mnemonic to generate, defaults to 256.
+     * @param words The wordlist to use, defaults to the English wordlist.
+     * @returns The random mnemonic.
+     * @throws Error if the length is not a multiple of 32.
+     */
+    static randomMnemonic(strength = 256, words = wordlist) {
+        Guards.number(Bip39.CLASS_NAME, "strength", strength);
+        Guards.arrayValue(Bip39.CLASS_NAME, "words", words);
+        if (strength % 32 !== 0) {
+            throw new GuardError(Bip39.CLASS_NAME, "guard.length32Multiple", "strength", strength);
+        }
+        return bip39.generateMnemonic(words, strength);
+    }
+    /**
+     * Generate a mnemonic from the entropy.
+     * @param entropy The entropy to generate.
+     * @param words The wordlist to use, defaults to the English wordlist.
+     * @returns The mnemonic.
+     * @throws Error if the length of the entropy is not a multiple of 4, or is less than 16 or greater than 32.
+     */
+    static entropyToMnemonic(entropy, words = wordlist) {
+        Guards.uint8Array(Bip39.CLASS_NAME, "entropy", entropy);
+        Guards.arrayValue(Bip39.CLASS_NAME, "words", words);
+        if (entropy.length % 4 !== 0 || entropy.length < 16 || entropy.length > 32) {
+            throw new GuardError(Bip39.CLASS_NAME, "guard.lengthEntropy", "entropy", entropy.length);
+        }
+        return bip39.entropyToMnemonic(entropy, words);
+    }
+    /**
+     * Convert a mnemonic to a seed.
+     * @param mnemonic The mnemonic to convert.
+     * @param password The password to apply to the seed generation.
+     * @returns The seed.
+     */
+    static mnemonicToSeed(mnemonic, password) {
+        Guards.stringValue(Bip39.CLASS_NAME, "mnemonic", mnemonic);
+        return bip39.mnemonicToSeedSync(mnemonic, password);
+    }
+    /**
+     * Convert the mnemonic back to entropy.
+     * @param mnemonic The mnemonic to convert.
+     * @param words The wordlist to use, defaults to the English wordlist.
+     * @returns The entropy.
+     * @throws Error if the number of words is not a multiple of 3.
+     */
+    static mnemonicToEntropy(mnemonic, words = wordlist) {
+        Guards.stringValue(Bip39.CLASS_NAME, "mnemonic", mnemonic);
+        Guards.arrayValue(Bip39.CLASS_NAME, "words", words);
+        return bip39.mnemonicToEntropy(mnemonic, words);
+    }
+    /**
+     * Validate the mnemonic.
+     * @param mnemonic The mnemonic to validate.
+     * @param wordCount The expected number of words in the mnemonic, defaults to 24.
+     * @param words The wordlist to use, defaults to the English wordlist.
+     * @returns True if the mnemonic is valid.
+     */
+    static validateMnemonic(mnemonic, wordCount = 24, words = wordlist) {
+        Guards.string(Bip39.CLASS_NAME, "mnemonic", mnemonic);
+        Guards.integer(Bip39.CLASS_NAME, "wordCount", wordCount);
+        const mnemonicSplit = mnemonic.split(/\s+/);
+        if (mnemonicSplit.length !== wordCount) {
+            return false;
+        }
+        return bip39.validateMnemonic(mnemonic, words);
+    }
+}
+//# sourceMappingURL=bip39.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"bip39.js","sourceRoot":"","sources":["../../../src/keys/bip39.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,uCAAuC;AACvC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AACtC,OAAO,EAAE,QAAQ,EAAE,MAAM,mCAAmC,CAAC;AAC7D,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAGpD;;GAEG;AACH,MAAM,OAAO,KAAK;IACjB;;OAEG;IACI,MAAM,CAAU,UAAU,WAA2B;IAE5D;;;;;;OAMG;IACI,MAAM,CAAC,cAAc,CAAC,WAAmB,GAAG,EAAE,QAAkB,QAAQ;QAC9E,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,cAAoB,QAAQ,CAAC,CAAC;QAC5D,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,UAAU,WAAiB,KAAK,CAAC,CAAC;QAE1D,IAAI,QAAQ,GAAG,EAAE,KAAK,CAAC,EAAE,CAAC;YACzB,MAAM,IAAI,UAAU,CAAC,KAAK,CAAC,UAAU,EAAE,wBAAwB,cAAoB,QAAQ,CAAC,CAAC;QAC9F,CAAC;QACD,OAAO,KAAK,CAAC,gBAAgB,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IAChD,CAAC;IAED;;;;;;OAMG;IACI,MAAM,CAAC,iBAAiB,CAAC,OAAmB,EAAE,QAAkB,QAAQ;QAC9E,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,UAAU,aAAmB,OAAO,CAAC,CAAC;QAC9D,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,UAAU,WAAiB,KAAK,CAAC,CAAC;QAE1D,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,KAAK,CAAC,IAAI,OAAO,CAAC,MAAM,GAAG,EAAE,IAAI,OAAO,CAAC,MAAM,GAAG,EAAE,EAAE,CAAC;YAC5E,MAAM,IAAI,UAAU,CACnB,KAAK,CAAC,UAAU,EAChB,qBAAqB,aAErB,OAAO,CAAC,MAAM,CACd,CAAC;QACH,CAAC;QAED,OAAO,KAAK,CAAC,iBAAiB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAChD,CAAC;IAED;;;;;OAKG;IACI,MAAM,CAAC,cAAc,CAAC,QAAgB,EAAE,QAAiB;QAC/D,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,UAAU,cAAoB,QAAQ,CAAC,CAAC;QAEjE,OAAO,KAAK,CAAC,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IACrD,CAAC;IAED;;;;;;OAMG;IACI,MAAM,CAAC,iBAAiB,CAAC,QAAgB,EAAE,QAAkB,QAAQ;QAC3E,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,UAAU,cAAoB,QAAQ,CAAC,CAAC;QACjE,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,UAAU,WAAiB,KAAK,CAAC,CAAC;QAE1D,OAAO,KAAK,CAAC,iBAAiB,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IACjD,CAAC;IAED;;;;;;OAMG;IACI,MAAM,CAAC,gBAAgB,CAC7B,QAAgB,EAChB,YAAoB,EAAE,EACtB,QAAkB,QAAQ;QAE1B,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,cAAoB,QAAQ,CAAC,CAAC;QAC5D,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,UAAU,eAAqB,SAAS,CAAC,CAAC;QAE/D,MAAM,aAAa,GAAG,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC5C,IAAI,aAAa,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YACxC,OAAO,KAAK,CAAC;QACd,CAAC;QAED,OAAO,KAAK,CAAC,gBAAgB,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IAChD,CAAC","sourcesContent":["// Copyright 2024 IOTA Stiftung.\n// SPDX-License-Identifier: Apache-2.0.\nimport * as bip39 from \"@scure/bip39\";\nimport { wordlist } from \"@scure/bip39/wordlists/english.js\";\nimport { GuardError, Guards } from \"@twin.org/core\";\nimport { nameof } from \"@twin.org/nameof\";\n\n/**\n * Implementation of Bip39 for mnemonic generation.\n */\nexport class Bip39 {\n\t/**\n\t * Runtime name for the class.\n\t */\n\tpublic static readonly CLASS_NAME: string = nameof<Bip39>();\n\n\t/**\n\t * Generate a random mnemonic.\n\t * @param strength The strength of the mnemonic to generate, defaults to 256.\n\t * @param words The wordlist to use, defaults to the English wordlist.\n\t * @returns The random mnemonic.\n\t * @throws Error if the length is not a multiple of 32.\n\t */\n\tpublic static randomMnemonic(strength: number = 256, words: string[] = wordlist): string {\n\t\tGuards.number(Bip39.CLASS_NAME, nameof(strength), strength);\n\t\tGuards.arrayValue(Bip39.CLASS_NAME, nameof(words), words);\n\n\t\tif (strength % 32 !== 0) {\n\t\t\tthrow new GuardError(Bip39.CLASS_NAME, \"guard.length32Multiple\", nameof(strength), strength);\n\t\t}\n\t\treturn bip39.generateMnemonic(words, strength);\n\t}\n\n\t/**\n\t * Generate a mnemonic from the entropy.\n\t * @param entropy The entropy to generate.\n\t * @param words The wordlist to use, defaults to the English wordlist.\n\t * @returns The mnemonic.\n\t * @throws Error if the length of the entropy is not a multiple of 4, or is less than 16 or greater than 32.\n\t */\n\tpublic static entropyToMnemonic(entropy: Uint8Array, words: string[] = wordlist): string {\n\t\tGuards.uint8Array(Bip39.CLASS_NAME, nameof(entropy), entropy);\n\t\tGuards.arrayValue(Bip39.CLASS_NAME, nameof(words), words);\n\n\t\tif (entropy.length % 4 !== 0 || entropy.length < 16 || entropy.length > 32) {\n\t\t\tthrow new GuardError(\n\t\t\t\tBip39.CLASS_NAME,\n\t\t\t\t\"guard.lengthEntropy\",\n\t\t\t\tnameof(entropy),\n\t\t\t\tentropy.length\n\t\t\t);\n\t\t}\n\n\t\treturn bip39.entropyToMnemonic(entropy, words);\n\t}\n\n\t/**\n\t * Convert a mnemonic to a seed.\n\t * @param mnemonic The mnemonic to convert.\n\t * @param password The password to apply to the seed generation.\n\t * @returns The seed.\n\t */\n\tpublic static mnemonicToSeed(mnemonic: string, password?: string): Uint8Array {\n\t\tGuards.stringValue(Bip39.CLASS_NAME, nameof(mnemonic), mnemonic);\n\n\t\treturn bip39.mnemonicToSeedSync(mnemonic, password);\n\t}\n\n\t/**\n\t * Convert the mnemonic back to entropy.\n\t * @param mnemonic The mnemonic to convert.\n\t * @param words The wordlist to use, defaults to the English wordlist.\n\t * @returns The entropy.\n\t * @throws Error if the number of words is not a multiple of 3.\n\t */\n\tpublic static mnemonicToEntropy(mnemonic: string, words: string[] = wordlist): Uint8Array {\n\t\tGuards.stringValue(Bip39.CLASS_NAME, nameof(mnemonic), mnemonic);\n\t\tGuards.arrayValue(Bip39.CLASS_NAME, nameof(words), words);\n\n\t\treturn bip39.mnemonicToEntropy(mnemonic, words);\n\t}\n\n\t/**\n\t * Validate the mnemonic.\n\t * @param mnemonic The mnemonic to validate.\n\t * @param wordCount The expected number of words in the mnemonic, defaults to 24.\n\t * @param words The wordlist to use, defaults to the English wordlist.\n\t * @returns True if the mnemonic is valid.\n\t */\n\tpublic static validateMnemonic(\n\t\tmnemonic: string,\n\t\twordCount: number = 24,\n\t\twords: string[] = wordlist\n\t): boolean {\n\t\tGuards.string(Bip39.CLASS_NAME, nameof(mnemonic), mnemonic);\n\t\tGuards.integer(Bip39.CLASS_NAME, nameof(wordCount), wordCount);\n\n\t\tconst mnemonicSplit = mnemonic.split(/\\s+/);\n\t\tif (mnemonicSplit.length !== wordCount) {\n\t\t\treturn false;\n\t\t}\n\n\t\treturn bip39.validateMnemonic(mnemonic, words);\n\t}\n}\n"]}