@twin.org/crypto 0.0.1-next.4 → 0.0.1-next.40

package/dist/cjs/index.cjs

@@ -8,11 +8,13 @@ var blake2b = require('@noble/hashes/blake2b');
 var bip32 = require('@scure/bip32');
 var slip10_js = require('micro-key-producer/slip10.js');
 var chacha = require('@noble/ciphers/chacha');
+var blake3 = require('@noble/hashes/blake3');
 var hmac = require('@noble/hashes/hmac');
 var sha1 = require('@noble/hashes/sha1');
 var sha256 = require('@noble/hashes/sha256');
 var sha512 = require('@noble/hashes/sha512');
 var pbkdf2 = require('@noble/hashes/pbkdf2');
+var sha3 = require('@noble/hashes/sha3');
 var bip39 = require('@scure/bip39');
 var english = require('@scure/bip39/wordlists/english');
 var otp = require('micro-key-producer/otp.js');
@@ -186,6 +188,27 @@ class Ed25519 {
             return false;
         }
     }
+    /**
+     * Convert a private key in PKCS8 format.
+     * @param privateKey The private key to convert.
+     * @returns The private key in PKCS8 format.
+     */
+    static async privateKeyToPKCS8(privateKey) {
+        core.Guards.uint8Array(Ed25519._CLASS_NAME, "privateKey", privateKey);
+        if (privateKey.length !== Ed25519.PRIVATE_KEY_SIZE) {
+            throw new core.GeneralError(Ed25519._CLASS_NAME, "privateKeyLength", {
+                requiredSize: Ed25519.PRIVATE_KEY_SIZE,
+                actualSize: privateKey.length
+            });
+        }
+        // crypto.subtle.importKey does not support Ed25519 keys in raw format.
+        // We need to convert the key to PKCS8 format before importing.
+        // The PKCS8 format is the raw key prefixed with the ASN.1 sequence for an Ed25519 private key.
+        // The ASN.1 sequence is 48 46 02 01 00 30 05 06 03 2b 65 70 04 20 04 20
+        const pkcs8Prefix = new Uint8Array([48, 46, 2, 1, 0, 48, 5, 6, 3, 43, 101, 112, 4, 34, 4, 32]); // 0x302e020100300506032b657004220420
+        const fullKey = core.Uint8ArrayHelper.concat([pkcs8Prefix, privateKey]);
+        return crypto.subtle.importKey("pkcs8", fullKey, "Ed25519", false, ["sign"]);
+    }
 }
 
 // Copyright 2024 IOTA Stiftung.
@@ -590,6 +613,24 @@ class Bip44 {
     static basePath(coinType) {
         return `m/44'/${coinType}'`;
     }
+    /**
+     * Generate an address from the seed and parts.
+     * @param seed The account seed.
+     * @param keyType The key type.
+     * @param coinType The coin type.
+     * @param accountIndex The account index.
+     * @param isInternal Is this an internal address.
+     * @param addressIndex The address index.
+     * @returns The generated path and the associated keypair.
+     */
+    static address(seed, keyType, coinType, accountIndex, isInternal, addressIndex) {
+        const keyPair = Bip44.keyPair(seed, keyType, coinType, accountIndex, isInternal, addressIndex);
+        const addressData = Blake2b.sum256(keyPair.publicKey);
+        return {
+            address: core.Converter.bytesToHex(addressData, true),
+            ...keyPair
+        };
+    }
     /**
      * Generate a bech32 address from the seed and parts.
      * @param seed The account seed.
@@ -727,6 +768,81 @@ class Zip215 {
     }
 }
 
+// Copyright 2024 IOTA Stiftung.
+// SPDX-License-Identifier: Apache-2.0.
+/**
+ * Class to help with Blake3 Signature scheme.
+ */
+class Blake3 {
+    /**
+     * Blake3 256.
+     */
+    static SIZE_256 = 32;
+    /**
+     * Blake3 512.
+     */
+    static SIZE_512 = 64;
+    /**
+     * Runtime name for the class.
+     * @internal
+     */
+    static _CLASS_NAME = "Blake3";
+    /**
+     * The instance of the hash.
+     * @internal
+     */
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    _instance;
+    /**
+     * Create a new instance of Blake3.
+     * @param outputLength The output length.
+     * @param key Optional key for the hash.
+     */
+    constructor(outputLength, key) {
+        this._instance = blake3.blake3.create({
+            dkLen: outputLength,
+            key
+        });
+    }
+    /**
+     * Perform Sum 256 on the block.
+     * @param block The block to operate on.
+     * @param key Optional key for the hash.
+     * @returns The sum 256 of the block.
+     */
+    static sum256(block, key) {
+        core.Guards.uint8Array(Blake3._CLASS_NAME, "block", block);
+        return new Blake3(Blake3.SIZE_256, key).update(block).digest();
+    }
+    /**
+     * Perform Sum 512 on the block.
+     * @param block The block to operate on.
+     * @param key Optional key for the hash.
+     * @returns The sum 512 of the block.
+     */
+    static sum512(block, key) {
+        core.Guards.uint8Array(Blake3._CLASS_NAME, "block", block);
+        return new Blake3(Blake3.SIZE_512, key).update(block).digest();
+    }
+    /**
+     * Update the hash with the block.
+     * @param block The block to update the hash with.
+     * @returns The instance for chaining.
+     */
+    update(block) {
+        core.Guards.uint8Array(Blake3._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();
+    }
+}
+
 // Copyright 2024 IOTA Stiftung.
 // SPDX-License-Identifier: Apache-2.0.
 /**
@@ -1160,6 +1276,127 @@ class Sha256 {
     }
 }
 
+// Copyright 2024 IOTA Stiftung.
+// SPDX-License-Identifier: Apache-2.0.
+// eslint-disable-next-line camelcase
+/**
+ * Perform a SHA-3 hash on the block.
+ */
+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.
+     * @internal
+     */
+    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 core.GeneralError(Sha3._CLASS_NAME, "bitSize", { bitSize: bits });
+        }
+        if (bits === Sha3.SIZE_224) {
+            // eslint-disable-next-line camelcase
+            this._instance = sha3.sha3_224.create();
+        }
+        else if (bits === Sha3.SIZE_256) {
+            // eslint-disable-next-line camelcase
+            this._instance = sha3.sha3_256.create();
+        }
+        else if (bits === Sha3.SIZE_384) {
+            // eslint-disable-next-line camelcase
+            this._instance = sha3.sha3_384.create();
+        }
+        else {
+            // eslint-disable-next-line camelcase
+            this._instance = sha3.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) {
+        core.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();
+    }
+}
+
 // Copyright 2024 IOTA Stiftung.
 // SPDX-License-Identifier: Apache-2.0.
 /* eslint-disable camelcase */
@@ -1552,6 +1789,7 @@ exports.Bip32Path = Bip32Path;
 exports.Bip39 = Bip39;
 exports.Bip44 = Bip44;
 exports.Blake2b = Blake2b;
+exports.Blake3 = Blake3;
 exports.ChaCha20Poly1305 = ChaCha20Poly1305;
 exports.Ed25519 = Ed25519;
 exports.HmacSha1 = HmacSha1;
@@ -1565,6 +1803,7 @@ exports.Pbkdf2 = Pbkdf2;
 exports.Secp256k1 = Secp256k1;
 exports.Sha1 = Sha1;
 exports.Sha256 = Sha256;
+exports.Sha3 = Sha3;
 exports.Sha512 = Sha512;
 exports.Slip0010 = Slip0010;
 exports.Totp = Totp;

package/dist/esm/index.mjs

@@ -1,16 +1,18 @@
 import { bech32 } from '@scure/base';
-import { Guards, BaseError, GeneralError, Is, Converter, GuardError, Base32, RandomHelper, Validation } from '@twin.org/core';
+import { Guards, BaseError, GeneralError, Is, Uint8ArrayHelper, Converter, GuardError, Base32, RandomHelper, Validation } from '@twin.org/core';
 import { ed25519, edwardsToMontgomeryPriv, edwardsToMontgomeryPub } from '@noble/curves/ed25519';
 import { secp256k1 } from '@noble/curves/secp256k1';
 import { blake2b } from '@noble/hashes/blake2b';
 import { HDKey as HDKey$1 } from '@scure/bip32';
 import { HDKey } from 'micro-key-producer/slip10.js';
 import { chacha20poly1305 } from '@noble/ciphers/chacha';
+import { blake3 } from '@noble/hashes/blake3';
 import { hmac } from '@noble/hashes/hmac';
 import { sha1 } from '@noble/hashes/sha1';
 import { sha256, sha224 } from '@noble/hashes/sha256';
 import { sha512_224, sha512_256, sha384, sha512 } from '@noble/hashes/sha512';
 import { pbkdf2 } from '@noble/hashes/pbkdf2';
+import { sha3_224, sha3_256, sha3_384, sha3_512 } from '@noble/hashes/sha3';
 import * as bip39 from '@scure/bip39';
 import { wordlist } from '@scure/bip39/wordlists/english';
 import * as otp from 'micro-key-producer/otp.js';
@@ -164,6 +166,27 @@ class Ed25519 {
             return false;
         }
     }
+    /**
+     * Convert a private key in PKCS8 format.
+     * @param privateKey The private key to convert.
+     * @returns The private key in PKCS8 format.
+     */
+    static async privateKeyToPKCS8(privateKey) {
+        Guards.uint8Array(Ed25519._CLASS_NAME, "privateKey", privateKey);
+        if (privateKey.length !== Ed25519.PRIVATE_KEY_SIZE) {
+            throw new GeneralError(Ed25519._CLASS_NAME, "privateKeyLength", {
+                requiredSize: Ed25519.PRIVATE_KEY_SIZE,
+                actualSize: privateKey.length
+            });
+        }
+        // crypto.subtle.importKey does not support Ed25519 keys in raw format.
+        // We need to convert the key to PKCS8 format before importing.
+        // The PKCS8 format is the raw key prefixed with the ASN.1 sequence for an Ed25519 private key.
+        // The ASN.1 sequence is 48 46 02 01 00 30 05 06 03 2b 65 70 04 20 04 20
+        const pkcs8Prefix = new Uint8Array([48, 46, 2, 1, 0, 48, 5, 6, 3, 43, 101, 112, 4, 34, 4, 32]); // 0x302e020100300506032b657004220420
+        const fullKey = Uint8ArrayHelper.concat([pkcs8Prefix, privateKey]);
+        return crypto.subtle.importKey("pkcs8", fullKey, "Ed25519", false, ["sign"]);
+    }
 }
 
 // Copyright 2024 IOTA Stiftung.
@@ -568,6 +591,24 @@ class Bip44 {
     static basePath(coinType) {
         return `m/44'/${coinType}'`;
     }
+    /**
+     * Generate an address from the seed and parts.
+     * @param seed The account seed.
+     * @param keyType The key type.
+     * @param coinType The coin type.
+     * @param accountIndex The account index.
+     * @param isInternal Is this an internal address.
+     * @param addressIndex The address index.
+     * @returns The generated path and the associated keypair.
+     */
+    static address(seed, keyType, coinType, accountIndex, isInternal, addressIndex) {
+        const keyPair = Bip44.keyPair(seed, keyType, coinType, accountIndex, isInternal, addressIndex);
+        const addressData = Blake2b.sum256(keyPair.publicKey);
+        return {
+            address: Converter.bytesToHex(addressData, true),
+            ...keyPair
+        };
+    }
     /**
      * Generate a bech32 address from the seed and parts.
      * @param seed The account seed.
@@ -705,6 +746,81 @@ class Zip215 {
     }
 }
 
+// Copyright 2024 IOTA Stiftung.
+// SPDX-License-Identifier: Apache-2.0.
+/**
+ * Class to help with Blake3 Signature scheme.
+ */
+class Blake3 {
+    /**
+     * Blake3 256.
+     */
+    static SIZE_256 = 32;
+    /**
+     * Blake3 512.
+     */
+    static SIZE_512 = 64;
+    /**
+     * Runtime name for the class.
+     * @internal
+     */
+    static _CLASS_NAME = "Blake3";
+    /**
+     * The instance of the hash.
+     * @internal
+     */
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    _instance;
+    /**
+     * Create a new instance of Blake3.
+     * @param outputLength The output length.
+     * @param key Optional key for the hash.
+     */
+    constructor(outputLength, key) {
+        this._instance = blake3.create({
+            dkLen: outputLength,
+            key
+        });
+    }
+    /**
+     * Perform Sum 256 on the block.
+     * @param block The block to operate on.
+     * @param key Optional key for the hash.
+     * @returns The sum 256 of the block.
+     */
+    static sum256(block, key) {
+        Guards.uint8Array(Blake3._CLASS_NAME, "block", block);
+        return new Blake3(Blake3.SIZE_256, key).update(block).digest();
+    }
+    /**
+     * Perform Sum 512 on the block.
+     * @param block The block to operate on.
+     * @param key Optional key for the hash.
+     * @returns The sum 512 of the block.
+     */
+    static sum512(block, key) {
+        Guards.uint8Array(Blake3._CLASS_NAME, "block", block);
+        return new Blake3(Blake3.SIZE_512, key).update(block).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(Blake3._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();
+    }
+}
+
 // Copyright 2024 IOTA Stiftung.
 // SPDX-License-Identifier: Apache-2.0.
 /**
@@ -1138,6 +1254,127 @@ class Sha256 {
     }
 }
 
+// Copyright 2024 IOTA Stiftung.
+// SPDX-License-Identifier: Apache-2.0.
+// eslint-disable-next-line camelcase
+/**
+ * Perform a SHA-3 hash on the block.
+ */
+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.
+     * @internal
+     */
+    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();
+    }
+}
+
 // Copyright 2024 IOTA Stiftung.
 // SPDX-License-Identifier: Apache-2.0.
 /* eslint-disable camelcase */
@@ -1525,4 +1762,4 @@ class PasswordValidator {
     }
 }
 
-export { Bech32, Bip32Path, Bip39, Bip44, Blake2b, ChaCha20Poly1305, Ed25519, HmacSha1, HmacSha256, HmacSha512, Hotp, KeyType, PasswordGenerator, PasswordValidator, Pbkdf2, Secp256k1, Sha1, Sha256, Sha512, Slip0010, Totp, X25519, Zip215 };
+export { Bech32, Bip32Path, Bip39, Bip44, Blake2b, Blake3, ChaCha20Poly1305, Ed25519, HmacSha1, HmacSha256, HmacSha512, Hotp, KeyType, PasswordGenerator, PasswordValidator, Pbkdf2, Secp256k1, Sha1, Sha256, Sha3, Sha512, Slip0010, Totp, X25519, Zip215 };

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

@@ -34,6 +34,21 @@ export declare class Bip44 {
      * @returns The bip44 address base path.
      */
     static basePath(coinType: number): string;
+    /**
+     * Generate an address from the seed and parts.
+     * @param seed The account seed.
+     * @param keyType The key type.
+     * @param coinType The coin type.
+     * @param accountIndex The account index.
+     * @param isInternal Is this an internal address.
+     * @param addressIndex The address index.
+     * @returns The generated path and the associated keypair.
+     */
+    static address(seed: Uint8Array, keyType: KeyType, coinType: number, accountIndex: number, isInternal: boolean, addressIndex: number): {
+        address: string;
+        privateKey: Uint8Array;
+        publicKey: Uint8Array;
+    };
     /**
      * Generate a bech32 address from the seed and parts.
      * @param seed The account seed.

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

@@ -34,4 +34,10 @@ export declare class Ed25519 {
      * @throws Error if the public key is not the correct length.
      */
     static verify(publicKey: Uint8Array, block: Uint8Array, signature: Uint8Array): boolean;
+    /**
+     * Convert a private key in PKCS8 format.
+     * @param privateKey The private key to convert.
+     * @returns The private key in PKCS8 format.
+     */
+    static privateKeyToPKCS8(privateKey: Uint8Array): Promise<CryptoKey>;
 }

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

@@ -0,0 +1,44 @@
+/**
+ * Class to help with Blake3 Signature scheme.
+ */
+export declare class Blake3 {
+    /**
+     * Blake3 256.
+     */
+    static SIZE_256: number;
+    /**
+     * Blake3 512.
+     */
+    static SIZE_512: number;
+    /**
+     * Create a new instance of Blake3.
+     * @param outputLength The output length.
+     * @param key Optional key for the hash.
+     */
+    constructor(outputLength: number, key?: Uint8Array);
+    /**
+     * Perform Sum 256 on the block.
+     * @param block The block to operate on.
+     * @param key Optional key for the hash.
+     * @returns The sum 256 of the block.
+     */
+    static sum256(block: Uint8Array, key?: Uint8Array): Uint8Array;
+    /**
+     * Perform Sum 512 on the block.
+     * @param block The block to operate on.
+     * @param key Optional key for the hash.
+     * @returns The sum 512 of the block.
+     */
+    static sum512(block: Uint8Array, key?: Uint8Array): Uint8Array;
+    /**
+     * Update the hash with the block.
+     * @param block The block to update the hash with.
+     * @returns The instance for chaining.
+     */
+    update(block: Uint8Array): Blake3;
+    /**
+     * Get the digest for the hash.
+     * @returns The instance for chaining.
+     */
+    digest(): Uint8Array;
+}