@pezkuwi/util 14.0.23 → 14.0.25

package/build-deno/bi/toU8a.ts

@@ -1,70 +0,0 @@
-
-import type { BN } from '../bn/bn.ts';
-import type { NumberOptions, ToBigInt, ToBn } from '../types.ts';
-
-import { BigInt } from 'https://deno.land/x/pezkuwi/x-bigint/mod.ts';
-
-import { _0n, _1n } from './consts.ts';
-import { nToBigInt } from './toBigInt.ts';
-
-const DIV = BigInt(256);
-const NEG_MASK = BigInt(0xff);
-
-function toU8a (value: bigint, isLe: boolean, isNegative: boolean): Uint8Array {
-  const arr: number[] = [];
-  const withSigned = isNegative && (value < _0n);
-
-  if (withSigned) {
-    value = (value + _1n) * -_1n;
-  }
-
-  while (value !== _0n) {
-    const mod = value % DIV;
-    const val = Number(
-      withSigned
-        ? mod ^ NEG_MASK
-        : mod
-    );
-
-    if (isLe) {
-      arr.push(val);
-    } else {
-      arr.unshift(val);
-    }
-
-    value = (value - mod) / DIV;
-  }
-
-  return Uint8Array.from(arr);
-}
-
-/**
- * @name nToU8a
- * @summary Creates a Uint8Array object from a bigint.
- */
-export function nToU8a <ExtToBn extends ToBn | ToBigInt> (value?: ExtToBn | BN | bigint | number | null, { bitLength = -1, isLe = true, isNegative = false }: NumberOptions = {}): Uint8Array {
-  const valueBi = nToBigInt(value);
-
-  if (valueBi === _0n) {
-    return bitLength === -1
-      ? new Uint8Array(1)
-      : new Uint8Array(Math.ceil((bitLength || 0) / 8));
-  }
-
-  const u8a = toU8a(valueBi, isLe, isNegative);
-
-  if (bitLength === -1) {
-    return u8a;
-  }
-
-  const byteLength = Math.ceil((bitLength || 0) / 8);
-  const output = new Uint8Array(byteLength);
-
-  if (isNegative) {
-    output.fill(0xff);
-  }
-
-  output.set(u8a, isLe ? 0 : byteLength - u8a.length);
-
-  return output;
-}

package/build-deno/bn/bn.ts

@@ -1,4 +0,0 @@
-
-import BN from 'https://esm.sh/bn.js@5.2.1';
-
-export { BN };

package/build-deno/bn/consts.ts

@@ -1,110 +0,0 @@
-
-import { BN } from './bn.ts';
-
-/**
- * @name BN_ZERO
- * @summary BN constant for 0.
- */
-export const BN_ZERO: BN = /*#__PURE__*/ new BN(0);
-
-/**
- * @name BN_ONE
- * @summary BN constant for 1.
- */
-export const BN_ONE: BN = /*#__PURE__*/ new BN(1);
-
-/**
- * @name BN_TWO
- * @summary BN constant for 2.
- */
-export const BN_TWO: BN = /*#__PURE__*/ new BN(2);
-
-/**
- * @name BN_THREE
- * @summary BN constant for 3.
- */
-export const BN_THREE: BN = /*#__PURE__*/ new BN(3);
-
-/**
- * @name BN_FOUR
- * @summary BN constant for 4.
- */
-export const BN_FOUR: BN = /*#__PURE__*/ new BN(4);
-
-/**
- * @name BN_FIVE
- * @summary BN constant for 5.
- */
-export const BN_FIVE: BN = /*#__PURE__*/ new BN(5);
-
-/**
- * @name BN_SIX
- * @summary BN constant for 6.
- */
-export const BN_SIX: BN = /*#__PURE__*/ new BN(6);
-
-/**
- * @name BN_SEVEN
- * @summary BN constant for 7.
- */
-export const BN_SEVEN: BN = /*#__PURE__*/ new BN(7);
-
-/**
- * @name BN_EIGHT
- * @summary BN constant for 8.
- */
-export const BN_EIGHT: BN = /*#__PURE__*/ new BN(8);
-
-/**
- * @name BN_NINE
- * @summary BN constant for 9.
- */
-export const BN_NINE: BN = /*#__PURE__*/ new BN(9);
-
-/**
- * @name BN_TEN
- * @summary BN constant for 10.
- */
-export const BN_TEN: BN = /*#__PURE__*/ new BN(10);
-
-/**
- * @name BN_HUNDRED
- * @summary BN constant for 100.
- */
-export const BN_HUNDRED: BN = /*#__PURE__*/ new BN(100);
-
-/**
- * @name BN_THOUSAND
- * @summary BN constant for 1,000.
- */
-export const BN_THOUSAND: BN = /*#__PURE__*/ new BN(1_000);
-
-/**
- * @name BN_MILLION
- * @summary BN constant for 1,000,000.
- */
-export const BN_MILLION: BN = /*#__PURE__*/ new BN(1_000_000);
-
-/**
- * @name BN_BILLION
- * @summary BN constant for 1,000,000,000.
- */
-export const BN_BILLION: BN = /*#__PURE__*/ new BN(1_000_000_000);
-
-/**
- * @name BN_QUINTILL
- * @summary BN constant for 1,000,000,000,000,000,000.
- */
-export const BN_QUINTILL: BN = BN_BILLION.mul(BN_BILLION);
-
-/**
- * @name BN_MAX_INTEGER
- * @summary BN constant for MAX_SAFE_INTEGER
- */
-export const BN_MAX_INTEGER: BN = /*#__PURE__*/ new BN(Number.MAX_SAFE_INTEGER);
-
-/**
- * @name BN_SQRT_MAX_INTEGER
- * @summary BN constant for Math.sqrt(MAX_SAFE_INTEGER)
- */
-export const BN_SQRT_MAX_INTEGER: BN = /*#__PURE__*/ new BN(94906265);

package/build-deno/bn/fromHex.ts

@@ -1,2 +0,0 @@
-
-export { hexToBn as bnFromHex } from '../hex/toBn.ts';

package/build-deno/bn/index.ts

@@ -1,14 +0,0 @@
-
-/**
- * @summary Utility methods to convert to and from `BN` objects
- */
-
-export { BN } from './bn.ts';
-export { bnFromHex } from './fromHex.ts';
-export { bnMax, bnMin } from './min.ts';
-export { bnSqrt } from './sqrt.ts';
-export { bnToBn } from './toBn.ts';
-export { bnToHex } from './toHex.ts';
-export { bnToU8a } from './toU8a.ts';
-
-export * from './consts.ts';

package/build-deno/bn/min.ts

@@ -1,34 +0,0 @@
-
-import type { BN } from './bn.ts';
-
-import { createCmp } from '../bi/helpers.ts';
-
-/**
- * @name bnMax
- * @summary Finds and returns the highest value in an array of BNs.
- * @example
- * <BR>
- *
- * ```javascript
- * import BN from 'https://esm.sh/bn.js@5.2.1';
- * import { bnMax } from 'https://deno.land/x/pezkuwi/util/mod.ts';
- *
- * bnMax([new BN(1), new BN(3), new BN(2)]).toString(); // => '3'
- * ```
- */
-export const bnMax = /*#__PURE__*/ createCmp<BN>((a, b) => a.gt(b));
-
-/**
- * @name bnMin
- * @summary Finds and returns the smallest value in an array of BNs.
- * @example
- * <BR>
- *
- * ```javascript
- * import BN from 'https://esm.sh/bn.js@5.2.1';
- * import { bnMin } from 'https://deno.land/x/pezkuwi/util/mod.ts';
- *
- * bnMin([new BN(1), new BN(3), new BN(2)]).toString(); // => '1'
- * ```
- */
-export const bnMin = /*#__PURE__*/ createCmp<BN>((a, b) => a.lt(b));

package/build-deno/bn/sqrt.ts

@@ -1,48 +0,0 @@
-
-import type { ToBn } from '../types.ts';
-
-import { BN } from './bn.ts';
-import { BN_MAX_INTEGER, BN_ONE, BN_SQRT_MAX_INTEGER } from './consts.ts';
-import { bnToBn } from './toBn.ts';
-
-/**
- * @name bnSqrt
- * @summary Calculates the integer square root of a BN
- * @example
- * <BR>
- *
- * ```javascript
- * import BN from 'https://esm.sh/bn.js@5.2.1';
- * import { bnSqrt } from 'https://deno.land/x/pezkuwi/util/mod.ts';
- *
- * bnSqrt(new BN(16)).toString(); // => '4'
- * ```
- */
-export function bnSqrt <ExtToBn extends ToBn> (value: ExtToBn | BN | bigint | string | number | null): BN {
-  const n = bnToBn(value);
-
-  if (n.isNeg()) {
-    throw new Error('square root of negative numbers is not supported');
-  }
-
-  // https://stackoverflow.com/questions/53683995/javascript-big-integer-square-root/
-  // shortcut <= 2^53 - 1 to use the JS utils
-  if (n.lte(BN_MAX_INTEGER)) {
-    // ~~ More performant version of Math.floor
-    return new BN(~~Math.sqrt(n.toNumber()));
-  }
-
-  // Use sqrt(MAX_SAFE_INTEGER) as starting point. since we already know the
-  // output will be larger than this, we expect this to be a safe start
-  let x0 = BN_SQRT_MAX_INTEGER.clone();
-
-  while (true) {
-    const x1 = n.div(x0).iadd(x0).ishrn(1);
-
-    if (x0.eq(x1) || x0.eq(x1.sub(BN_ONE))) {
-      return x0;
-    }
-
-    x0 = x1;
-  }
-}

package/build-deno/bn/toBn.ts

@@ -1,41 +0,0 @@
-
-import type { ToBigInt, ToBn } from '../types.ts';
-
-import { hexToBn } from '../hex/toBn.ts';
-import { isBigInt } from '../is/bigInt.ts';
-import { isHex } from '../is/hex.ts';
-import { isToBigInt } from '../is/toBigInt.ts';
-import { isToBn } from '../is/toBn.ts';
-import { BN } from './bn.ts';
-
-/**
- * @name bnToBn
- * @summary Creates a BN value from a BN, bigint, string (base 10 or hex) or number input.
- * @description
- * `null` inputs returns a `0x0` result, BN values returns the value, numbers returns a BN representation.
- * @example
- * <BR>
- *
- * ```javascript
- * import BN from 'https://esm.sh/bn.js@5.2.1';
- * import { bnToBn } from 'https://deno.land/x/pezkuwi/util/mod.ts';
- *
- * bnToBn(0x1234); // => BN(0x1234)
- * bnToBn(new BN(0x1234)); // => BN(0x1234)
- * ```
- */
-export function bnToBn <ExtToBn extends ToBigInt | ToBn> (value?: ExtToBn | BN | bigint | string | number | null): BN {
-  return value
-    ? BN.isBN(value)
-      ? value
-      : isHex(value)
-        ? hexToBn(value.toString())
-        : isBigInt(value)
-          ? new BN(value.toString())
-          : isToBn(value)
-            ? value.toBn()
-            : isToBigInt(value)
-              ? new BN(value.toBigInt().toString())
-              : new BN(value)
-    : new BN(0);
-}

package/build-deno/bn/toHex.ts

@@ -1,25 +0,0 @@
-
-import type { HexString, NumberOptions, ToBn } from '../types.ts';
-import type { BN } from './bn.ts';
-
-import { u8aToHex } from '../u8a/index.ts';
-import { bnToU8a } from './toU8a.ts';
-
-/**
- * @name bnToHex
- * @summary Creates a hex value from a BN.js bignumber object.
- * @description
- * `null` inputs returns a `0x` result, BN values return the actual value as a `0x` prefixed hex value. Anything that is not a BN object throws an error. With `bitLength` set, it fixes the number to the specified length.
- * @example
- * <BR>
- *
- * ```javascript
- * import BN from 'https://esm.sh/bn.js@5.2.1';
- * import { bnToHex } from 'https://deno.land/x/pezkuwi/util/mod.ts';
- *
- * bnToHex(new BN(0x123456)); // => '0x123456'
- * ```
- */
-export function bnToHex <ExtToBn extends ToBn> (value?: ExtToBn | BN | bigint | number | null, { bitLength = -1, isLe = false, isNegative = false }: NumberOptions = {}): HexString {
-  return u8aToHex(bnToU8a(value, { bitLength, isLe, isNegative }));
-}

package/build-deno/bn/toU8a.ts

@@ -1,43 +0,0 @@
-
-import type { NumberOptions, ToBn } from '../types.ts';
-import type { BN } from './bn.ts';
-
-import { bnToBn } from './toBn.ts';
-
-const DEFAULT_OPTS: NumberOptions = { bitLength: -1, isLe: true, isNegative: false };
-
-/**
- * @name bnToU8a
- * @summary Creates a Uint8Array object from a BN.
- * @description
- * `null`/`undefined`/`NaN` inputs returns an empty `Uint8Array` result. `BN` input values return the actual bytes value converted to a `Uint8Array`. Optionally convert using little-endian format if `isLE` is set.
- * @example
- * <BR>
- *
- * ```javascript
- * import { bnToU8a } from 'https://deno.land/x/pezkuwi/util/mod.ts';
- *
- * bnToU8a(new BN(0x1234)); // => [0x12, 0x34]
- * ```
- */
-export function bnToU8a <ExtToBn extends ToBn> (value?: ExtToBn | BN | bigint | number | null, { bitLength = -1, isLe = true, isNegative = false } = DEFAULT_OPTS): Uint8Array {
-  const valueBn = bnToBn(value);
-  const byteLength = bitLength === -1
-    ? Math.ceil(valueBn.bitLength() / 8)
-    : Math.ceil((bitLength || 0) / 8);
-
-  if (!value) {
-    return bitLength === -1
-      ? new Uint8Array(1)
-      : new Uint8Array(byteLength);
-  }
-
-  const output = new Uint8Array(byteLength);
-  const bn = isNegative
-    ? valueBn.toTwos(byteLength * 8)
-    : valueBn;
-
-  output.set(bn.toArray(isLe ? 'le' : 'be', byteLength), 0);
-
-  return output;
-}

package/build-deno/buffer/index.ts

@@ -1,8 +0,0 @@
-import { Buffer } from 'node:buffer';
-
-
-/**
- * @summary Utility methods to convert to and from `Buffer` objects
- */
-
-export { bufferToU8a } from './toU8a.ts';

package/build-deno/buffer/toU8a.ts

@@ -1,20 +0,0 @@
-import { Buffer } from 'node:buffer';
-
-
-/**
- * @name bufferToU8a
- * @summary Creates a Uint8Array value from a Buffer object.
- * @description
- * `null` inputs returns an empty result, `Buffer` values return the actual value as a `Uint8Array`. Anything that is not a `Buffer` object throws an error.
- * @example
- * <BR>
- *
- * ```javascript
- * import { bufferToU8a } from 'https://deno.land/x/pezkuwi/util/mod.ts';
- *
- * bufferToU8a(Buffer.from([1, 2, 3]));
- * ```
- */
-export function bufferToU8a (buffer?: Uint8Array | number[] | null): Uint8Array {
-  return new Uint8Array(buffer || []);
-}

package/build-deno/bundle.ts

@@ -1,31 +0,0 @@
-
-/**
- * @summary Utility methods for this package are split into groups
- */
-
-export { packageInfo } from './packageInfo.ts';
-
-export * from './array/index.ts';
-export * from './assert.ts';
-export * from './bi/index.ts';
-export * from './bn/index.ts';
-export * from './buffer/index.ts';
-export * from './compact/index.ts';
-export * from './detectPackage.ts';
-export * from './extractTime.ts';
-export * from './float/index.ts';
-export * from './format/index.ts';
-export * from './has.ts';
-export * from './hex/index.ts';
-export * from './is/index.ts';
-export * from './lazy.ts';
-export * from './logger.ts';
-export * from './memoize.ts';
-export * from './nextTick.ts';
-export * from './noop.ts';
-export * from './number/index.ts';
-export * from './object/index.ts';
-export * from './promisify.ts';
-export * from './string/index.ts';
-export * from './stringify.ts';
-export * from './u8a/index.ts';

package/build-deno/compact/addLength.ts

@@ -1,22 +0,0 @@
-
-import { u8aConcatStrict } from '../u8a/index.ts';
-import { compactToU8a } from './toU8a.ts';
-
-/**
- * @name compactAddLength
- * @description Adds a length prefix to the input value
- * @example
- * <BR>
- *
- * ```javascript
- * import { compactAddLength } from 'https://deno.land/x/pezkuwi/util/mod.ts';
- *
- * console.log(compactAddLength(new Uint8Array([0xde, 0xad, 0xbe, 0xef]))); // Uint8Array([4 << 2, 0xde, 0xad, 0xbe, 0xef])
- * ```
- */
-export function compactAddLength (input: Uint8Array): Uint8Array {
-  return u8aConcatStrict([
-    compactToU8a(input.length),
-    input
-  ]);
-}

package/build-deno/compact/defaults.ts

@@ -1,5 +0,0 @@
-
-import type { BitLength } from './types.ts';
-
-/** @internal */
-export const DEFAULT_BITLENGTH: BitLength = 32;

package/build-deno/compact/fromU8a.ts

@@ -1,107 +0,0 @@
-
-import type { U8aLike } from '../types.ts';
-
-import { BN } from '../bn/index.ts';
-import { u8aToBn, u8aToU8a } from '../u8a/index.ts';
-
-/**
- * @name compactFromU8a
- * @description Retrives the offset and encoded length from a compact-prefixed value
- * @example
- * <BR>
- *
- * ```javascript
- * import { compactFromU8a } from 'https://deno.land/x/pezkuwi/util/mod.ts';
- *
- * const [offset, length] = compactFromU8a(new Uint8Array([254, 255, 3, 0]));
- *
- * console.log('value offset=', offset, 'length=', length); // 4, 0xffff
- * ```
- */
-export function compactFromU8a (input: U8aLike): [number, BN] {
-  const u8a = u8aToU8a(input);
-
-  // The u8a is manually converted here for 1, 2 & 4 lengths, it is 2x faster
-  // than doing an additional call to u8aToBn (as with variable length)
-  switch (u8a[0] & 0b11) {
-    case 0b00:
-      return [1, new BN(u8a[0] >>> 2)];
-
-    case 0b01:
-      return [2, new BN((u8a[0] + (u8a[1] << 8)) >>> 2)];
-
-    case 0b10:
-      // for the 3rd byte, we don't << 24 - since JS converts all bitwise operators to
-      // 32-bit, in the case where the top-most bit is set this yields a negative value
-      return [4, new BN((u8a[0] + (u8a[1] << 8) + (u8a[2] << 16) + (u8a[3] * 0x1_00_00_00)) >>> 2)];
-
-    // 0b11
-    default: {
-      // add 5 to shifted (4 for base length, 1 for this byte)
-      const offset = (u8a[0] >>> 2) + 5;
-
-      // we unroll the loop
-      switch (offset) {
-        // there still could be 4 bytes data, similar to 0b10 above (with offsets)
-        case 5:
-          // for the 3rd byte, we don't << 24 - since JS converts all bitwise operators to
-          // 32-bit, in the case where the top-most bit is set this yields a negative value
-          return [5, new BN(u8a[1] + (u8a[2] << 8) + (u8a[3] << 16) + (u8a[4] * 0x1_00_00_00))];
-
-        case 6:
-          return [6, new BN(u8a[1] + (u8a[2] << 8) + (u8a[3] << 16) + ((u8a[4] + (u8a[5] << 8)) * 0x1_00_00_00))];
-
-        // 6 bytes data is the maximum, 48 bits (56 would overflow)
-        case 7:
-          return [7, new BN(u8a[1] + (u8a[2] << 8) + (u8a[3] << 16) + ((u8a[4] + (u8a[5] << 8) + (u8a[6] << 16)) * 0x1_00_00_00))];
-
-        // for anything else, use the non-unrolled version
-        default:
-          return [offset, u8aToBn(u8a.subarray(1, offset))];
-      }
-    }
-  }
-}
-
-/**
- * @name compactFromU8aLim
- * @description A limited version of [[compactFromU8a]], accepting only Uint8Array inputs for values <= 48 bits
- */
-export function compactFromU8aLim (u8a: Uint8Array): [number, number] {
-  // The u8a is manually converted here for 1, 2 & 4 lengths, it is 2x faster
-  // than doing an additional call to u8aToBn (as with variable length)
-  switch (u8a[0] & 0b11) {
-    case 0b00:
-      return [1, u8a[0] >>> 2];
-
-    case 0b01:
-      return [2, (u8a[0] + (u8a[1] << 8)) >>> 2];
-
-    case 0b10:
-      // for the 3rd byte, we don't << 24 - since JS converts all bitwise operators to
-      // 32-bit, in the case where the top-most bit is set this yields a negative value
-      return [4, (u8a[0] + (u8a[1] << 8) + (u8a[2] << 16) + (u8a[3] * 0x1_00_00_00)) >>> 2];
-
-    // 0b11
-    default: {
-      // add 5 to shifted (4 for base length, 1 for this byte)
-      // we unroll the loop
-      switch ((u8a[0] >>> 2) + 5) {
-        // there still could be 4 bytes data, similar to 0b10 above (with offsets)
-        case 5:
-          return [5, u8a[1] + (u8a[2] << 8) + (u8a[3] << 16) + (u8a[4] * 0x1_00_00_00)];
-
-        case 6:
-          return [6, u8a[1] + (u8a[2] << 8) + (u8a[3] << 16) + ((u8a[4] + (u8a[5] << 8)) * 0x1_00_00_00)];
-
-        // 6 bytes data is the maximum, 48 bits (56 would overflow)
-        case 7:
-          return [7, u8a[1] + (u8a[2] << 8) + (u8a[3] << 16) + ((u8a[4] + (u8a[5] << 8) + (u8a[6] << 16)) * 0x1_00_00_00)];
-
-        // for anything else, we are above the actual MAX_SAFE_INTEGER - bail out
-        default:
-          throw new Error('Compact input is > Number.MAX_SAFE_INTEGER');
-      }
-    }
-  }
-}

package/build-deno/compact/index.ts

@@ -1,26 +0,0 @@
-
-/**
- * @description
- * Encoding and decoding of parity-codec compact numbers. The codec is created
- * to take up the least amount of space for a specific number. It performs the
- * same function as Length, however differs in that it uses a variable number of
- * bytes to do the actual encoding. From the Rust implementation for compact
- * encoding:
- *
- *     0b00 00 00 00 / 00 00 00 00 / 00 00 00 00 / 00 00 00 00
- * (0 ... 2**6 - 1)    (u8)
- *     xx xx xx 00
- * (2**6 ... 2**14 - 1)  (u8, u16)  low LH high
- *     yL yL yL 01 / yH yH yH yL
- * (2**14 ... 2**30 - 1)  (u16, u32)  low LMMH high
- *     zL zL zL 10 / zM zM zM zL / zM zM zM zM / zH zH zH zM
- * (2**30 ... 2**536 - 1)  (u32, u64, u128, U256, U512, U520) straight LE-encoded
- *     nn nn nn 11 [ / zz zz zz zz ]{4 + n}
- *
- * Note: we use *LOW BITS* of the LSB in LE encoding to encode the 2 bit key.
- */
-
-export { compactAddLength } from './addLength.ts';
-export { compactFromU8a, compactFromU8aLim } from './fromU8a.ts';
-export { compactStripLength } from './stripLength.ts';
-export { compactToU8a } from './toU8a.ts';

package/build-deno/compact/stripLength.ts

@@ -1,24 +0,0 @@
-
-import { compactFromU8a } from './fromU8a.ts';
-
-/**
- * @name compactStripLength
- * @description Removes the length prefix, returning both the total length (including the value + compact encoding) and the decoded value with the correct length
- * @example
- * <BR>
- *
- * ```javascript
- * import { compactStripLength } from 'https://deno.land/x/pezkuwi/util/mod.ts';
- *
- * console.log(compactStripLength(new Uint8Array([2 << 2, 0xde, 0xad]))); // [2, Uint8Array[0xde, 0xad]]
- * ```
- */
-export function compactStripLength (input: Uint8Array): [number, Uint8Array] {
-  const [offset, length] = compactFromU8a(input);
-  const total = offset + length.toNumber();
-
-  return [
-    total,
-    input.subarray(offset, total)
-  ];
-}