@pezkuwi/util-crypto 14.0.10 → 14.0.11

package/base58/bs58.d.ts

@@ -0,0 +1,26 @@
+/**
+ * @name base58Validate
+ * @summary Validates a base58 value.
+ * @description
+ * Validates that the supplied value is valid base58, throwing exceptions if not
+ */
+export declare const base58Validate: (value?: unknown, ipfsCompat?: boolean) => value is string;
+/**
+ * @name base58Decode
+ * @summary Decodes a base58 value.
+ * @description
+ * From the provided input, decode the base58 and return the result as an `Uint8Array`.
+ */
+export declare const base58Decode: (value: string, ipfsCompat?: boolean) => Uint8Array;
+/**
+* @name base58Encode
+* @summary Creates a base58 value.
+* @description
+* From the provided input, create the base58 and return the result as a string.
+*/
+export declare const base58Encode: (value: import("@pezkuwi/util/types").U8aLike, ipfsCompat?: boolean) => string;
+/**
+* @name isBase58
+* @description Checks if the input is in base58, returning true/false
+*/
+export declare const isBase58: (value?: unknown, ipfsCompat?: boolean) => value is string;

package/base58/bs58.js

@@ -0,0 +1,34 @@
+import { base58 } from '@scure/base';
+import { createDecode, createEncode, createIs, createValidate } from '../base32/helpers.js';
+const config = {
+    chars: '123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz',
+    coder: base58,
+    ipfs: 'z',
+    type: 'base58'
+};
+/**
+ * @name base58Validate
+ * @summary Validates a base58 value.
+ * @description
+ * Validates that the supplied value is valid base58, throwing exceptions if not
+ */
+export const base58Validate = /*#__PURE__*/ createValidate(config);
+/**
+ * @name base58Decode
+ * @summary Decodes a base58 value.
+ * @description
+ * From the provided input, decode the base58 and return the result as an `Uint8Array`.
+ */
+export const base58Decode = /*#__PURE__*/ createDecode(config, base58Validate);
+/**
+* @name base58Encode
+* @summary Creates a base58 value.
+* @description
+* From the provided input, create the base58 and return the result as a string.
+*/
+export const base58Encode = /*#__PURE__*/ createEncode(config);
+/**
+* @name isBase58
+* @description Checks if the input is in base58, returning true/false
+*/
+export const isBase58 = /*#__PURE__*/ createIs(base58Validate);

package/base58/index.d.ts

@@ -0,0 +1,4 @@
+/**
+ * @summary Encode and decode base58 values
+ */
+export { base58Decode, base58Encode, base58Validate, isBase58 } from './bs58.js';

package/base58/index.js

@@ -0,0 +1,4 @@
+/**
+ * @summary Encode and decode base58 values
+ */
+export { base58Decode, base58Encode, base58Validate, isBase58 } from './bs58.js';

package/base64/bs64.d.ts

@@ -0,0 +1,26 @@
+/**
+ * @name base64Validate
+ * @summary Validates a base64 value.
+ * @description
+ * Validates that the supplied value is valid base64
+ */
+export declare const base64Validate: (value?: unknown, ipfsCompat?: boolean) => value is string;
+/**
+ * @name isBase64
+ * @description Checks if the input is in base64, returning true/false
+ */
+export declare const isBase64: (value?: unknown, ipfsCompat?: boolean) => value is string;
+/**
+ * @name base64Decode
+ * @summary Decodes a base64 value.
+ * @description
+ * From the provided input, decode the base64 and return the result as an `Uint8Array`.
+ */
+export declare const base64Decode: (value: string, ipfsCompat?: boolean) => Uint8Array;
+/**
+ * @name base64Encode
+ * @summary Creates a base64 value.
+ * @description
+ * From the provided input, create the base64 and return the result as a string.
+ */
+export declare const base64Encode: (value: import("@pezkuwi/util/types").U8aLike, ipfsCompat?: boolean) => string;

package/base64/bs64.js

@@ -0,0 +1,34 @@
+import { base64 } from '@scure/base';
+import { createDecode, createEncode, createIs, createValidate } from '../base32/helpers.js';
+const config = {
+    chars: 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/',
+    coder: base64,
+    type: 'base64',
+    withPadding: true
+};
+/**
+ * @name base64Validate
+ * @summary Validates a base64 value.
+ * @description
+ * Validates that the supplied value is valid base64
+ */
+export const base64Validate = /*#__PURE__*/ createValidate(config);
+/**
+ * @name isBase64
+ * @description Checks if the input is in base64, returning true/false
+ */
+export const isBase64 = /*#__PURE__*/ createIs(base64Validate);
+/**
+ * @name base64Decode
+ * @summary Decodes a base64 value.
+ * @description
+ * From the provided input, decode the base64 and return the result as an `Uint8Array`.
+ */
+export const base64Decode = /*#__PURE__*/ createDecode(config, base64Validate);
+/**
+ * @name base64Encode
+ * @summary Creates a base64 value.
+ * @description
+ * From the provided input, create the base64 and return the result as a string.
+ */
+export const base64Encode = /*#__PURE__*/ createEncode(config);

package/base64/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @summary Encode and decode base64 values
+ */
+export { base64Decode, base64Encode, base64Validate, isBase64 } from './bs64.js';
+export { base64Pad } from './pad.js';
+export { base64Trim } from './trim.js';

package/base64/index.js

@@ -0,0 +1,6 @@
+/**
+ * @summary Encode and decode base64 values
+ */
+export { base64Decode, base64Encode, base64Validate, isBase64 } from './bs64.js';
+export { base64Pad } from './pad.js';
+export { base64Trim } from './trim.js';

package/base64/pad.d.ts

@@ -0,0 +1,5 @@
+/**
+ * @name base64Pad
+ * @description Adds padding characters for correct length
+ */
+export declare function base64Pad(value: string): string;

package/base64/pad.js

@@ -0,0 +1,7 @@
+/**
+ * @name base64Pad
+ * @description Adds padding characters for correct length
+ */
+export function base64Pad(value) {
+    return value.padEnd(value.length + (value.length % 4), '=');
+}

package/base64/trim.d.ts

@@ -0,0 +1,5 @@
+/**
+ * @name base64Trim
+ * @description Trims padding characters
+ */
+export declare function base64Trim(value: string): string;

package/base64/trim.js

@@ -0,0 +1,10 @@
+/**
+ * @name base64Trim
+ * @description Trims padding characters
+ */
+export function base64Trim(value) {
+    while (value.length && value.endsWith('=')) {
+        value = value.slice(0, -1);
+    }
+    return value;
+}

package/blake2/asU8a.d.ts

@@ -0,0 +1,20 @@
+/**
+ * @name blake2AsU8a
+ * @summary Creates a blake2b u8a from the input.
+ * @description
+ * From a `Uint8Array` input, create the blake2b and return the result as a u8a with the specified `bitLength`.
+ * @example
+ * <BR>
+ *
+ * ```javascript
+ * import { blake2AsU8a } from '@pezkuwi/util-crypto';
+ *
+ * blake2AsU8a('abc'); // => [0xba, 0x80, 0xa5, 0x3f, 0x98, 0x1c, 0x4d, 0x0d]
+ * ```
+ */
+export declare function blake2AsU8a(data: string | Uint8Array, bitLength?: 64 | 128 | 256 | 384 | 512, key?: Uint8Array | null, onlyJs?: boolean): Uint8Array;
+/**
+ * @name blake2AsHex
+ * @description Creates a blake2b hex from the input.
+ */
+export declare const blake2AsHex: (data: string | Uint8Array, bitLength?: 256 | 512 | 64 | 128 | 384 | undefined, key?: Uint8Array | null | undefined, onlyJs?: boolean | undefined) => import("@pezkuwi/util/types").HexString;

package/blake2/asU8a.js

@@ -0,0 +1,32 @@
+import { blake2b as blake2bJs } from '@noble/hashes/blake2b';
+import { hasBigInt, u8aToU8a } from '@pezkuwi/util';
+import { blake2b, isReady } from '@pezkuwi/wasm-crypto';
+import { createAsHex } from '../helpers.js';
+/**
+ * @name blake2AsU8a
+ * @summary Creates a blake2b u8a from the input.
+ * @description
+ * From a `Uint8Array` input, create the blake2b and return the result as a u8a with the specified `bitLength`.
+ * @example
+ * <BR>
+ *
+ * ```javascript
+ * import { blake2AsU8a } from '@pezkuwi/util-crypto';
+ *
+ * blake2AsU8a('abc'); // => [0xba, 0x80, 0xa5, 0x3f, 0x98, 0x1c, 0x4d, 0x0d]
+ * ```
+ */
+export function blake2AsU8a(data, bitLength = 256, key, onlyJs) {
+    const byteLength = Math.ceil(bitLength / 8);
+    const u8a = u8aToU8a(data);
+    return !hasBigInt || (!onlyJs && isReady())
+        ? blake2b(u8a, u8aToU8a(key), byteLength)
+        : key
+            ? blake2bJs(u8a, { dkLen: byteLength, key })
+            : blake2bJs(u8a, { dkLen: byteLength });
+}
+/**
+ * @name blake2AsHex
+ * @description Creates a blake2b hex from the input.
+ */
+export const blake2AsHex = /*#__PURE__*/ createAsHex(blake2AsU8a);

package/blake2/index.d.ts

@@ -0,0 +1,4 @@
+/**
+ * @summary Create blake2b values with specified bitlengths
+ */
+export { blake2AsHex, blake2AsU8a } from './asU8a.js';

package/blake2/index.js

@@ -0,0 +1,4 @@
+/**
+ * @summary Create blake2b values with specified bitlengths
+ */
+export { blake2AsHex, blake2AsU8a } from './asU8a.js';

package/bn.d.ts

@@ -0,0 +1,30 @@
+export declare const BN_BE_OPTS: {
+    isLe: boolean;
+};
+export declare const BN_LE_OPTS: {
+    isLe: boolean;
+};
+export declare const BN_LE_16_OPTS: {
+    bitLength: number;
+    isLe: boolean;
+};
+export declare const BN_BE_32_OPTS: {
+    bitLength: number;
+    isLe: boolean;
+};
+export declare const BN_LE_32_OPTS: {
+    bitLength: number;
+    isLe: boolean;
+};
+export declare const BN_BE_256_OPTS: {
+    bitLength: number;
+    isLe: boolean;
+};
+export declare const BN_LE_256_OPTS: {
+    bitLength: number;
+    isLe: boolean;
+};
+export declare const BN_LE_512_OPTS: {
+    bitLength: number;
+    isLe: boolean;
+};

package/bn.js

@@ -0,0 +1,8 @@
+export const BN_BE_OPTS = { isLe: false };
+export const BN_LE_OPTS = { isLe: true };
+export const BN_LE_16_OPTS = { bitLength: 16, isLe: true };
+export const BN_BE_32_OPTS = { bitLength: 32, isLe: false };
+export const BN_LE_32_OPTS = { bitLength: 32, isLe: true };
+export const BN_BE_256_OPTS = { bitLength: 256, isLe: false };
+export const BN_LE_256_OPTS = { bitLength: 256, isLe: true };
+export const BN_LE_512_OPTS = { bitLength: 512, isLe: true };