export { abytes, anumber, bytesToHex, bytesToUtf8, concatBytes, hexToBytes, isBytes, randomBytes, utf8ToBytes, } from '@noble/hashes/utils.js'; export type Hex = Uint8Array | string; export type PrivKey = Hex | bigint; export type CHash = { (message: Uint8Array | string): Uint8Array; blockLen: number; outputLen: number; create(opts?: { dkLen?: number; }): any; }; export type FHash = (message: Uint8Array | string) => Uint8Array; export declare function abool(title: string, value: boolean): void; export declare function _abool2(value: boolean, title?: string): boolean; /** Asserts something is Uint8Array. */ export declare function _abytes2(value: Uint8Array, length?: number, title?: string): Uint8Array; export declare function numberToHexUnpadded(num: number | bigint): string; export declare function hexToNumber(hex: string): bigint; export declare function bytesToNumberBE(bytes: Uint8Array): bigint; export declare function bytesToNumberLE(bytes: Uint8Array): bigint; export declare function numberToBytesBE(n: number | bigint, len: number): Uint8Array; export declare function numberToBytesLE(n: number | bigint, len: number): Uint8Array; export declare function numberToVarBytesBE(n: number | bigint): Uint8Array; /** * Takes hex string or Uint8Array, converts to Uint8Array. * Validates output length. * Will throw error for other types. * @param title descriptive title for an error e.g. 'secret key' * @param hex hex string or Uint8Array * @param expectedLength optional, will compare to result array's length * @returns */ export declare function ensureBytes(title: string, hex: Hex, expectedLength?: number): Uint8Array; export declare function equalBytes(a: Uint8Array, b: Uint8Array): boolean; /** * Copies Uint8Array. We can't use u8a.slice(), because u8a can be Buffer, * and Buffer#slice creates mutable copy. Never use Buffers! */ export declare function copyBytes(bytes: Uint8Array): Uint8Array; /** * Decodes 7-bit ASCII string to Uint8Array, throws on non-ascii symbols * Should be safe to use for things expected to be ASCII. * Returns exact same result as utf8ToBytes for ASCII or throws. */ export declare function asciiToBytes(ascii: string): Uint8Array; export declare function inRange(n: bigint, min: bigint, max: bigint): boolean; /** * Asserts min <= n < max. NOTE: It's < max and not <= max. * @example * aInRange('x', x, 1n, 256n); // would assume x is in (1n..255n) */ export declare function aInRange(title: string, n: bigint, min: bigint, max: bigint): void; /** * Calculates amount of bits in a bigint. * Same as `n.toString(2).length` * TODO: merge with nLength in modular */ export declare function bitLen(n: bigint): number; /** * Gets single bit at position. * NOTE: first bit position is 0 (same as arrays) * Same as `!!+Array.from(n.toString(2)).reverse()[pos]` */ export declare function bitGet(n: bigint, pos: number): bigint; /** * Sets single bit at position. */ export declare function bitSet(n: bigint, pos: number, value: boolean): bigint; /** * Calculate mask for N bits. Not using ** operator with bigints because of old engines. * Same as BigInt(`0b${Array(i).fill('1').join('')}`) */ export declare const bitMask: (n: number) => bigint; type Pred = (v: Uint8Array) => T | undefined; /** * Minimal HMAC-DRBG from NIST 800-90 for RFC6979 sigs. * @returns function that will call DRBG until 2nd arg returns something meaningful * @example * const drbg = createHmacDRBG(32, 32, hmac); * drbg(seed, bytesToKey); // bytesToKey must return Key or undefined */ export declare function createHmacDrbg(hashLen: number, qByteLen: number, hmacFn: (key: Uint8Array, ...messages: Uint8Array[]) => Uint8Array): (seed: Uint8Array, predicate: Pred) => T; declare const validatorFns: { readonly bigint: (val: any) => boolean; readonly function: (val: any) => boolean; readonly boolean: (val: any) => boolean; readonly string: (val: any) => boolean; readonly stringOrUint8Array: (val: any) => boolean; readonly isSafeInteger: (val: any) => boolean; readonly array: (val: any) => boolean; readonly field: (val: any, object: any) => any; readonly hash: (val: any) => boolean; }; type Validator = keyof typeof validatorFns; type ValMap> = { [K in keyof T]?: Validator; }; export declare function validateObject>(object: T, validators: ValMap, optValidators?: ValMap): T; export declare function isHash(val: CHash): boolean; export declare function _validateObject(object: Record, fields: Record, optFields?: Record): void; /** * throws not implemented error */ export declare const notImplemented: () => never; /** * Memoizes (caches) computation result. * Uses WeakMap: the value is going auto-cleaned by GC after last reference is removed. */ export declare function memoized(fn: (arg: T, ...args: O) => R): (arg: T, ...args: O) => R; //# sourceMappingURL=utils.d.ts.map