@digitaldefiance/ecies-lib 1.0.0

package/dist/services/password-login.js

@@ -0,0 +1,96 @@
+import { Wallet } from '@ethereumjs/wallet';
+import { EciesEncryptionTypeEnum } from '../enumerations/ecies-encryption-type';
+import { Pbkdf2ProfileEnum } from '../enumerations/pbkdf2-profile';
+import { SecureString } from '../secure-string';
+import { hexToUint8Array, uint8ArrayToHex } from '../utils';
+import { AESGCMService } from './aes-gcm';
+import { Pbkdf2Service } from './pbkdf2';
+export class PasswordLoginService {
+    eciesService;
+    static privateKeyStorageKey = 'encryptedPrivateKey';
+    static saltStorageKey = 'passwordLoginSalt';
+    static encryptedMnemonicStorageKey = 'encryptedMnemonic';
+    constructor(eciesService) {
+        this.eciesService = eciesService;
+    }
+    async createPasswordLoginBundle(mnemonic, password) {
+        const { wallet } = this.eciesService.walletAndSeedFromMnemonic(mnemonic);
+        const derivedKey = await Pbkdf2Service.deriveKeyFromPasswordWithProfileAsync(password.valueAsUint8Array, Pbkdf2ProfileEnum.BROWSER_PASSWORD);
+        // Encrypt private key with derived key
+        const privateKeyBytes = wallet.getPrivateKey();
+        const { encrypted, iv, tag } = await AESGCMService.encrypt(privateKeyBytes, derivedKey.hash, true);
+        const encryptedPrivateKey = AESGCMService.combineIvTagAndEncryptedData(iv, encrypted, tag);
+        // now use the public key to encrypt the mnemonic and store it
+        const encryptedMnemonic = await this.eciesService.encrypt(EciesEncryptionTypeEnum.Simple, [{ publicKey: wallet.getPublicKey() }], mnemonic.valueAsUint8Array);
+        return {
+            salt: derivedKey.salt,
+            encryptedPrivateKey: encryptedPrivateKey,
+            encryptedMnemonic: encryptedMnemonic,
+            wallet,
+        };
+    }
+    /**
+     * Set up password login by deriving a key from the password and using it to encrypt
+     * @param mnemonic The user's mnemonic
+     * @param password The user's password
+     */
+    async setupPasswordLoginLocalStorageBundle(mnemonic, password) {
+        const { salt, encryptedPrivateKey, encryptedMnemonic, wallet } = await this.createPasswordLoginBundle(mnemonic, password);
+        // store the salt and encrypted private key in local storage
+        localStorage.setItem(PasswordLoginService.saltStorageKey, uint8ArrayToHex(salt));
+        localStorage.setItem(PasswordLoginService.privateKeyStorageKey, uint8ArrayToHex(encryptedPrivateKey));
+        localStorage.setItem(PasswordLoginService.encryptedMnemonicStorageKey, uint8ArrayToHex(encryptedMnemonic));
+        return wallet;
+    }
+    async getWalletAndMnemonicFromEncryptedPasswordBundle(salt, encryptedPrivateKey, encryptedMnemonic, password) {
+        if (!salt || !encryptedPrivateKey || !encryptedMnemonic) {
+            throw new Error('Password login not set up');
+        }
+        const derivedKey = await Pbkdf2Service.deriveKeyFromPasswordWithProfileAsync(password.valueAsUint8Array, Pbkdf2ProfileEnum.BROWSER_PASSWORD, salt);
+        // Decrypt private key with derived key
+        const { iv, encryptedDataWithTag } = AESGCMService.splitEncryptedData(encryptedPrivateKey, true);
+        const privateKeyBytes = await AESGCMService.decrypt(iv, encryptedDataWithTag, derivedKey.hash, true);
+        const wallet = Wallet.fromPrivateKey(privateKeyBytes);
+        // now decrypt the mnemonic
+        const decryptedMnemonic = await this.eciesService.decryptSimpleOrSingleWithHeader(true, wallet.getPrivateKey(), encryptedMnemonic);
+        return { wallet, mnemonic: new SecureString(decryptedMnemonic) };
+    }
+    /**
+     * Recover wallet and mnemonic from password
+     * @param password The user's password
+     * @returns The user's wallet and mnemonic
+     */
+    async getWalletAndMnemonicFromLocalStorageBundle(password) {
+        const saltHex = localStorage.getItem(PasswordLoginService.saltStorageKey);
+        const encryptedPrivateKeyHex = localStorage.getItem(PasswordLoginService.privateKeyStorageKey);
+        const encryptedMnemonicHex = localStorage.getItem(PasswordLoginService.encryptedMnemonicStorageKey);
+        if (!saltHex ||
+            !encryptedPrivateKeyHex ||
+            !encryptedMnemonicHex ||
+            saltHex === '' ||
+            encryptedPrivateKeyHex === '' ||
+            encryptedMnemonicHex === '') {
+            throw new Error('Password login not set up');
+        }
+        const salt = hexToUint8Array(saltHex);
+        const encryptedPrivateKey = hexToUint8Array(encryptedPrivateKeyHex);
+        const encryptedMnemonic = hexToUint8Array(encryptedMnemonicHex);
+        return await this.getWalletAndMnemonicFromEncryptedPasswordBundle(salt, encryptedPrivateKey, encryptedMnemonic, password);
+    }
+    /**
+     *
+     * @returns True if password login is set up (i.e. salt and encrypted private key are in local storage)
+     */
+    static isPasswordLoginSetup() {
+        const saltHex = localStorage.getItem(PasswordLoginService.saltStorageKey);
+        const encryptedPrivateKeyHex = localStorage.getItem(PasswordLoginService.privateKeyStorageKey);
+        const encryptedMnemonicHex = localStorage.getItem(PasswordLoginService.encryptedMnemonicStorageKey);
+        return !!(saltHex &&
+            encryptedPrivateKeyHex &&
+            encryptedMnemonicHex &&
+            saltHex !== '' &&
+            encryptedPrivateKeyHex !== '' &&
+            encryptedMnemonicHex !== '');
+    }
+}
+//# sourceMappingURL=password-login.js.map

package/dist/services/password-login.js.map

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

package/dist/services/pbkdf2.d.ts

@@ -0,0 +1,49 @@
+import { PBKDF2_PROFILES } from '../constants';
+import { Pbkdf2ProfileEnum } from '../enumerations/pbkdf2-profile';
+import { IPbkdf2Config } from '../interfaces/pbkdf2-config';
+import { IPbkdf2Result } from '../interfaces/pbkdf2-result';
+/**
+ * Service for handling PBKDF2 (Password-Based Key Derivation Function 2) operations.
+ * This service provides functionality for:
+ * - Generating secure key derivation configurations
+ * - Deriving cryptographic keys from passwords
+ * - Managing salt and iteration parameters
+ * - Both synchronous and asynchronous key derivation
+ */
+export declare abstract class Pbkdf2Service {
+    /**
+     * Get a predefined configuration profile for common use cases
+     * @param profile The name of the profile to use
+     * @returns Configuration object for the specified profile
+     */
+    static getProfileConfig(profile: keyof typeof PBKDF2_PROFILES): IPbkdf2Config;
+    /**
+     * Generate an options object for pbkdf2
+     * @param iterations Optional number of iterations (defaults to Pbkdf2IterationsPerSecond)
+     * @param saltBytes Optional salt size in bytes (defaults to PBKDF2.SALT_BYTES)
+     * @param hashBytes Optional hash size in bytes (defaults to ECIES.SYMMETRIC.KEY_SIZE)
+     * @param algorithm Optional hash algorithm (defaults to PBKDF2.ALGORITHM)
+     * @returns Configuration object for PBKDF2
+     */
+    static getConfig(iterations?: number, saltBytes?: number, hashBytes?: number, algorithm?: string): IPbkdf2Config;
+    /**
+     * Given a password, use pbkdf2 to generate an appropriately sized key for AES encryption
+     * @param password The password to derive a key from
+     * @param salt Optional salt (will be randomly generated if not provided)
+     * @param iterations Optional number of iterations
+     * @param saltBytes Optional salt size in bytes
+     * @param keySize Optional key size in bytes
+     * @param algorithm Optional hash algorithm
+     * @returns Object containing the derived key, salt, and iteration count
+     */
+    static deriveKeyFromPasswordAsync(password: Uint8Array, salt?: Uint8Array, iterations?: number, saltBytes?: number, keySize?: number, algorithm?: string): Promise<IPbkdf2Result>;
+    /**
+     * Derive a key using a predefined configuration profile
+     * @param password The password to derive a key from
+     * @param profile The configuration profile to use
+     * @param salt Optional salt (will be randomly generated if not provided)
+     * @returns Object containing the derived key, salt, and iteration count
+     */
+    static deriveKeyFromPasswordWithProfileAsync(password: Uint8Array, profile: Pbkdf2ProfileEnum, salt?: Uint8Array): Promise<IPbkdf2Result>;
+}
+//# sourceMappingURL=pbkdf2.d.ts.map

package/dist/services/pbkdf2.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pbkdf2.d.ts","sourceRoot":"","sources":["../../src/services/pbkdf2.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,eAAe,EAAE,MAAM,cAAc,CAAC;AAE9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AAEnE,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAE5D;;;;;;;GAOG;AACH,8BAAsB,aAAa;IACjC;;;;OAIG;WACW,gBAAgB,CAC5B,OAAO,EAAE,MAAM,OAAO,eAAe,GACpC,aAAa;IAUhB;;;;;;;OAOG;WACW,SAAS,CACrB,UAAU,CAAC,EAAE,MAAM,EACnB,SAAS,CAAC,EAAE,MAAM,EAClB,SAAS,CAAC,EAAE,MAAM,EAClB,SAAS,CAAC,EAAE,MAAM,GACjB,aAAa;IAkBhB;;;;;;;;;OASG;WACiB,0BAA0B,CAC5C,QAAQ,EAAE,UAAU,EACpB,IAAI,CAAC,EAAE,UAAU,EACjB,UAAU,CAAC,EAAE,MAAM,EACnB,SAAS,CAAC,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,MAAM,EAChB,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,aAAa,CAAC;IA8CzB;;;;;;OAMG;WACiB,qCAAqC,CACvD,QAAQ,EAAE,UAAU,EACpB,OAAO,EAAE,iBAAiB,EAC1B,IAAI,CAAC,EAAE,UAAU,GAChB,OAAO,CAAC,aAAa,CAAC;CAW1B"}

package/dist/services/pbkdf2.js

@@ -0,0 +1,97 @@
+import { ECIES, PBKDF2, PBKDF2_PROFILES } from '../constants';
+import { Pbkdf2ErrorType } from '../enumerations/pbkdf2-error-type';
+import { Pbkdf2Error } from '../errors/pbkdf2';
+/**
+ * Service for handling PBKDF2 (Password-Based Key Derivation Function 2) operations.
+ * This service provides functionality for:
+ * - Generating secure key derivation configurations
+ * - Deriving cryptographic keys from passwords
+ * - Managing salt and iteration parameters
+ * - Both synchronous and asynchronous key derivation
+ */
+export class Pbkdf2Service {
+    /**
+     * Get a predefined configuration profile for common use cases
+     * @param profile The name of the profile to use
+     * @returns Configuration object for the specified profile
+     */
+    static getProfileConfig(profile) {
+        const profileConfig = PBKDF2_PROFILES[profile];
+        return {
+            hashBytes: profileConfig.hashBytes,
+            saltBytes: profileConfig.saltBytes,
+            iterations: profileConfig.iterations,
+            algorithm: profileConfig.algorithm,
+        };
+    }
+    /**
+     * Generate an options object for pbkdf2
+     * @param iterations Optional number of iterations (defaults to Pbkdf2IterationsPerSecond)
+     * @param saltBytes Optional salt size in bytes (defaults to PBKDF2.SALT_BYTES)
+     * @param hashBytes Optional hash size in bytes (defaults to ECIES.SYMMETRIC.KEY_SIZE)
+     * @param algorithm Optional hash algorithm (defaults to PBKDF2.ALGORITHM)
+     * @returns Configuration object for PBKDF2
+     */
+    static getConfig(iterations, saltBytes, hashBytes, algorithm) {
+        // larger numbers mean better security, less
+        return {
+            // size of the generated hash
+            hashBytes: hashBytes ?? ECIES.SYMMETRIC.KEY_SIZE,
+            // larger salt means hashed passwords are more resistant to rainbow table, but
+            // you get diminishing returns pretty fast
+            saltBytes: saltBytes ?? PBKDF2.SALT_BYTES,
+            // more iterations means an attacker has to take longer to brute force an
+            // individual password, so larger is better. however, larger also means longer
+            // to hash the password. tune so that hashing the password takes about a
+            // second
+            iterations: iterations ?? PBKDF2.ITERATIONS_PER_SECOND,
+            // hash algorithm
+            algorithm: algorithm ?? PBKDF2.ALGORITHM,
+        };
+    }
+    /**
+     * Given a password, use pbkdf2 to generate an appropriately sized key for AES encryption
+     * @param password The password to derive a key from
+     * @param salt Optional salt (will be randomly generated if not provided)
+     * @param iterations Optional number of iterations
+     * @param saltBytes Optional salt size in bytes
+     * @param keySize Optional key size in bytes
+     * @param algorithm Optional hash algorithm
+     * @returns Object containing the derived key, salt, and iteration count
+     */
+    static async deriveKeyFromPasswordAsync(password, salt, iterations, saltBytes, keySize, algorithm) {
+        const config = Pbkdf2Service.getConfig(iterations, saltBytes, keySize, algorithm);
+        const saltBytes_ = salt ?? crypto.getRandomValues(new Uint8Array(config.saltBytes));
+        if (saltBytes_.length !== config.saltBytes) {
+            throw new Pbkdf2Error(Pbkdf2ErrorType.InvalidSaltLength);
+        }
+        const keyMaterial = await crypto.subtle.importKey('raw', new Uint8Array(password), 'PBKDF2', false, ['deriveBits']);
+        const keyArray = await crypto.subtle.deriveBits({
+            name: 'PBKDF2',
+            salt: new Uint8Array(saltBytes_),
+            iterations: config.iterations,
+            hash: config.algorithm,
+        }, keyMaterial, config.hashBytes * 8);
+        const keyBytes = new Uint8Array(keyArray);
+        if (keyBytes.length !== config.hashBytes) {
+            throw new Pbkdf2Error(Pbkdf2ErrorType.InvalidHashLength);
+        }
+        return {
+            salt: saltBytes_,
+            hash: keyBytes,
+            iterations: config.iterations,
+        };
+    }
+    /**
+     * Derive a key using a predefined configuration profile
+     * @param password The password to derive a key from
+     * @param profile The configuration profile to use
+     * @param salt Optional salt (will be randomly generated if not provided)
+     * @returns Object containing the derived key, salt, and iteration count
+     */
+    static async deriveKeyFromPasswordWithProfileAsync(password, profile, salt) {
+        const config = Pbkdf2Service.getProfileConfig(profile);
+        return await Pbkdf2Service.deriveKeyFromPasswordAsync(password, salt, config.iterations, config.saltBytes, config.hashBytes, config.algorithm);
+    }
+}
+//# sourceMappingURL=pbkdf2.js.map

package/dist/services/pbkdf2.js.map

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

package/dist/services/xor.d.ts

@@ -0,0 +1,37 @@
+/**
+ * A simple and fast XOR cipher for obfuscating data in memory for browser environments.
+ * This is not a substitute for strong cryptography but provides a lightweight way
+ * to prevent sensitive data from being stored in plaintext in memory.
+ */
+export declare class XorService {
+    /**
+     * Encrypts or decrypts data using a simple XOR cipher.
+     * The key is XORed with the data. The same function is used for
+     * both encryption and decryption.
+     *
+     * @param data The data to process.
+     * @param key The key to use for the XOR operation.
+     * @returns A new Uint8Array containing the result of the XOR operation.
+     */
+    static xor(data: Uint8Array, key: Uint8Array): Uint8Array;
+    /**
+     * Generates a random key of a specified length.
+     * @param length The length of the key in bytes.
+     * @returns A Uint8Array containing the random key.
+     * @throws Error if crypto API is not available.
+     */
+    static generateKey(length: number): Uint8Array;
+    /**
+     * Helper method to convert a string to a Uint8Array.
+     * @param str The string to convert.
+     * @returns A Uint8Array representation of the string.
+     */
+    static stringToBytes(str: string): Uint8Array;
+    /**
+     * Helper method to convert a Uint8Array to a string.
+     * @param bytes The Uint8Array to convert.
+     * @returns A string representation of the Uint8Array.
+     */
+    static bytesToString(bytes: Uint8Array): string;
+}
+//# sourceMappingURL=xor.d.ts.map

package/dist/services/xor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"xor.d.ts","sourceRoot":"","sources":["../../src/services/xor.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,qBAAa,UAAU;IACrB;;;;;;;;OAQG;WACW,GAAG,CAAC,IAAI,EAAE,UAAU,EAAE,GAAG,EAAE,UAAU,GAAG,UAAU;IAQhE;;;;;OAKG;WACW,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU;IAgBrD;;;;OAIG;WACW,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU;IAKpD;;;;OAIG;WACW,aAAa,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM;CAIvD"}

package/dist/services/xor.js

@@ -0,0 +1,63 @@
+/**
+ * A simple and fast XOR cipher for obfuscating data in memory for browser environments.
+ * This is not a substitute for strong cryptography but provides a lightweight way
+ * to prevent sensitive data from being stored in plaintext in memory.
+ */
+export class XorService {
+    /**
+     * Encrypts or decrypts data using a simple XOR cipher.
+     * The key is XORed with the data. The same function is used for
+     * both encryption and decryption.
+     *
+     * @param data The data to process.
+     * @param key The key to use for the XOR operation.
+     * @returns A new Uint8Array containing the result of the XOR operation.
+     */
+    static xor(data, key) {
+        const result = new Uint8Array(data.length);
+        for (let i = 0; i < data.length; i++) {
+            result[i] = data[i] ^ key[i % key.length];
+        }
+        return result;
+    }
+    /**
+     * Generates a random key of a specified length.
+     * @param length The length of the key in bytes.
+     * @returns A Uint8Array containing the random key.
+     * @throws Error if crypto API is not available.
+     */
+    static generateKey(length) {
+        const randomBytes = new Uint8Array(length);
+        // Check if running in a browser with crypto support
+        if (typeof window !== 'undefined' && window.crypto) {
+            window.crypto.getRandomValues(randomBytes);
+        }
+        else if (typeof crypto !== 'undefined') {
+            // For environments where crypto is global (some newer JS runtimes)
+            crypto.getRandomValues(randomBytes);
+        }
+        else {
+            throw new Error('Crypto API not available in this environment');
+        }
+        return randomBytes;
+    }
+    /**
+     * Helper method to convert a string to a Uint8Array.
+     * @param str The string to convert.
+     * @returns A Uint8Array representation of the string.
+     */
+    static stringToBytes(str) {
+        const encoder = new TextEncoder();
+        return encoder.encode(str);
+    }
+    /**
+     * Helper method to convert a Uint8Array to a string.
+     * @param bytes The Uint8Array to convert.
+     * @returns A string representation of the Uint8Array.
+     */
+    static bytesToString(bytes) {
+        const decoder = new TextDecoder();
+        return decoder.decode(bytes);
+    }
+}
+//# sourceMappingURL=xor.js.map

package/dist/services/xor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"xor.js","sourceRoot":"","sources":["../../src/services/xor.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,OAAO,UAAU;IACrB;;;;;;;;OAQG;IACI,MAAM,CAAC,GAAG,CAAC,IAAgB,EAAE,GAAe;QACjD,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC3C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACrC,MAAM,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC;QAC5C,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;;;;OAKG;IACI,MAAM,CAAC,WAAW,CAAC,MAAc;QACtC,MAAM,WAAW,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC;QAE3C,oDAAoD;QACpD,IAAI,OAAO,MAAM,KAAK,WAAW,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;YACnD,MAAM,CAAC,MAAM,CAAC,eAAe,CAAC,WAAW,CAAC,CAAC;QAC7C,CAAC;aAAM,IAAI,OAAO,MAAM,KAAK,WAAW,EAAE,CAAC;YACzC,mEAAmE;YACnE,MAAM,CAAC,eAAe,CAAC,WAAW,CAAC,CAAC;QACtC,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;QAClE,CAAC;QAED,OAAO,WAAW,CAAC;IACrB,CAAC;IAED;;;;OAIG;IACI,MAAM,CAAC,aAAa,CAAC,GAAW;QACrC,MAAM,OAAO,GAAG,IAAI,WAAW,EAAE,CAAC;QAClC,OAAO,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC7B,CAAC;IAED;;;;OAIG;IACI,MAAM,CAAC,aAAa,CAAC,KAAiB;QAC3C,MAAM,OAAO,GAAG,IAAI,WAAW,EAAE,CAAC;QAClC,OAAO,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC/B,CAAC;CACF"}

package/dist/types.d.ts

@@ -0,0 +1,29 @@
+import { Brand } from 'ts-brand';
+import { GuidBrandType } from './enumerations';
+/**
+ * GUID stored as a BigInt
+ */
+export type BigIntGuid = Brand<bigint, 'GuidV4', GuidBrandType.BigIntGuid>;
+/**
+ * GUID stored as a hex string with dashes
+ */
+export type FullHexGuid = Brand<string, 'GuidV4', GuidBrandType.FullHexGuid>;
+/**
+ * GUID stored as a hex string without dashes
+ */
+export type ShortHexGuid = Brand<string, 'GuidV4', GuidBrandType.ShortHexGuid>;
+/**
+ * GUID stored as a base64 string
+ */
+export type Base64Guid = Brand<string, 'GuidV4', GuidBrandType.Base64Guid>;
+/**
+ * GUID stored as a raw buffer
+ */
+export type RawGuidUint8Array = Uint8Array & Brand<Uint8Array, 'GuidV4', GuidBrandType.RawGuidUint8Array>;
+export type BinaryGuid = Uint8Array;
+export type HexGuid = string;
+export type ShortGuid = string;
+export type SignatureUint8Array = Uint8Array & Brand<Uint8Array, 'SignatureArray'>;
+export type ChecksumUint8Array = Uint8Array & Brand<Uint8Array, 'Sha3Checksum', 'ChecksumArray'>;
+export type SignatureString = string & Brand<string, 'SignatureString'>;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AACjC,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAE/C;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,KAAK,CAAC,MAAM,EAAE,QAAQ,EAAE,aAAa,CAAC,UAAU,CAAC,CAAC;AAC3E;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,KAAK,CAAC,MAAM,EAAE,QAAQ,EAAE,aAAa,CAAC,WAAW,CAAC,CAAC;AAC7E;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,KAAK,CAAC,MAAM,EAAE,QAAQ,EAAE,aAAa,CAAC,YAAY,CAAC,CAAC;AAC/E;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,KAAK,CAAC,MAAM,EAAE,QAAQ,EAAE,aAAa,CAAC,UAAU,CAAC,CAAC;AAC3E;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,UAAU,GACxC,KAAK,CAAC,UAAU,EAAE,QAAQ,EAAE,aAAa,CAAC,iBAAiB,CAAC,CAAC;AAG/D,MAAM,MAAM,UAAU,GAAG,UAAU,CAAC;AACpC,MAAM,MAAM,OAAO,GAAG,MAAM,CAAC;AAC7B,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC;AAE/B,MAAM,MAAM,mBAAmB,GAAG,UAAU,GAC1C,KAAK,CAAC,UAAU,EAAE,gBAAgB,CAAC,CAAC;AACtC,MAAM,MAAM,kBAAkB,GAAG,UAAU,GACzC,KAAK,CAAC,UAAU,EAAE,cAAc,EAAE,eAAe,CAAC,CAAC;AACrD,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,KAAK,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/utils.d.ts

@@ -0,0 +1,62 @@
+import { LengthEncodingType } from './enumerations/length-encoding-type';
+/**
+ * Encodes the length of the data in the buffer
+ * @param buffer The buffer to encode
+ * @returns The encoded buffer
+ */
+export declare function lengthEncodeData(buffer: Buffer): Buffer;
+export declare function decodeLengthEncodedData(buffer: Buffer): {
+    data: Buffer;
+    totalLength: number;
+};
+export declare function uint8ArrayToBase64(uint8Array: Uint8Array): string;
+export declare function base64ToUint8Array(base64String: string): Uint8Array;
+export declare function uint8ArrayToHex(uint8Array: Uint8Array): string;
+export declare function hexToUint8Array(hexString: string): Uint8Array;
+/**
+ * Utility functions for browser ECIES implementation
+ */
+/**
+ * CRC16-CCITT implementation for data integrity checking
+ * Uses CRC16-CCITT-FALSE variant (init 0xFFFF)
+ */
+export declare function crc16(data: Uint8Array): Uint8Array;
+/**
+ * Convert string to Uint8Array (UTF-8 encoding)
+ */
+export declare function stringToUint8Array(str: string): Uint8Array;
+/**
+ * Convert Uint8Array to string (UTF-8 decoding)
+ */
+export declare function uint8ArrayToString(array: Uint8Array): string;
+/**
+ * Secure random bytes generation
+ */
+export declare function randomBytes(length: number): Uint8Array;
+/**
+ * Compare two Uint8Arrays for equality
+ */
+export declare function arraysEqual(a: Uint8Array, b: Uint8Array): boolean;
+/**
+ * Concatenate multiple Uint8Arrays
+ */
+export declare function concatUint8Arrays(...arrays: Uint8Array[]): Uint8Array;
+/**
+ * Get the length encoding type for a given length
+ * @param length The length to evaluate
+ * @returns The corresponding LengthEncodingType
+ */
+export declare function getLengthEncodingTypeForLength(length: number | BigInt): LengthEncodingType;
+/**
+ * Get the length encoding type for a given value
+ * @param value The value to evaluate
+ * @returns The corresponding LengthEncodingType
+ */
+export declare function getLengthEncodingTypeFromValue(value: number): LengthEncodingType;
+/**
+ * Get the length in bytes for a given LengthEncodingType
+ * @param type The LengthEncodingType to evaluate
+ * @returns The length in bytes
+ */
+export declare function getLengthForLengthType(type: LengthEncodingType): number;
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AAIzE;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAuBvD;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM,GAAG;IACvD,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACrB,CAyDA;AAED,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,UAAU,GAAG,MAAM,CAMjE;AAED,wBAAgB,kBAAkB,CAAC,YAAY,EAAE,MAAM,GAAG,UAAU,CAQnE;AAED,wBAAgB,eAAe,CAAC,UAAU,EAAE,UAAU,GAAG,MAAM,CAI9D;AAED,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,UAAU,CAO7D;AAED;;GAEG;AAEH;;;GAGG;AACH,wBAAgB,KAAK,CAAC,IAAI,EAAE,UAAU,GAAG,UAAU,CAoBlD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,CAE1D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAE5D;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,CAEtD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,UAAU,GAAG,OAAO,CAMjE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,MAAM,EAAE,UAAU,EAAE,GAAG,UAAU,CASrE;AAED;;;;GAIG;AACH,wBAAgB,8BAA8B,CAC5C,MAAM,EAAE,MAAM,GAAG,MAAM,GACtB,kBAAkB,CAqCpB;AAED;;;;GAIG;AACH,wBAAgB,8BAA8B,CAC5C,KAAK,EAAE,MAAM,GACZ,kBAAkB,CAUpB;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,kBAAkB,GAAG,MAAM,CAgBvE"}