@pezkuwi/util 14.0.10 → 14.0.11

package/u8a/toU8a.js

@@ -0,0 +1,39 @@
+import { hexToU8a } from '../hex/toU8a.js';
+import { isBuffer } from '../is/buffer.js';
+import { isHex } from '../is/hex.js';
+import { isU8a } from '../is/u8a.js';
+import { stringToU8a } from '../string/toU8a.js';
+/**
+ * @name u8aToU8a
+ * @summary Creates a Uint8Array value from a Uint8Array, Buffer, string or hex input.
+ * @description
+ * `null` or `undefined` inputs returns a `[]` result, Uint8Array values returns the value, hex strings returns a Uint8Array representation.
+ * If `strict` is true, `null` or `undefined` will throw an error instead of returning an empty array.
+ * Supports input types: Uint8Array, Buffer, hex string, string, or number array.
+ * @example
+ * <BR>
+ *
+ * ```javascript
+ * import { u8aToU8a } from '@pezkuwi/util';
+ *
+ * u8aToU8a(new Uint8Array([0x12, 0x34]); // => Uint8Array([0x12, 0x34])
+ * u8aToU8a(0x1234); // => Uint8Array([0x12, 0x34])
+ * ```
+ */
+export function u8aToU8a(value, strict = false) {
+    if (strict && (value === null || value === undefined)) {
+        throw new Error('u8aToU8a: Expected non-null, non-undefined value');
+    }
+    return isU8a(value)
+        // NOTE isBuffer needs to go here since it actually extends
+        // Uint8Array on Node.js environments, so all Buffer are Uint8Array,
+        // but Uint8Array is not Buffer
+        ? isBuffer(value)
+            ? new Uint8Array(value)
+            : value
+        : isHex(value)
+            ? hexToU8a(value)
+            : Array.isArray(value)
+                ? new Uint8Array(value)
+                : stringToU8a(value);
+}

package/u8a/wrap.d.ts

@@ -0,0 +1,22 @@
+import type { U8aLike } from '../types.js';
+/** @internal */
+export declare const U8A_WRAP_ETHEREUM: Uint8Array;
+/** @internal */
+export declare const U8A_WRAP_PREFIX: Uint8Array;
+/** @internal */
+export declare const U8A_WRAP_POSTFIX: Uint8Array;
+/** @internal */
+export declare function u8aIsWrapped(u8a: Uint8Array, withEthereum: boolean): boolean;
+/**
+ * @name u8aUnwrapBytes
+ * @description Removes all <Bytes>...</Bytes> wrappers from the supplied value
+ */
+export declare function u8aUnwrapBytes(bytes: U8aLike): Uint8Array;
+/**
+ * @name u8aWrapBytes
+ * @description
+ * Adds a <Bytes>...</Bytes> wrapper to the supplied value, if
+ * - We don't already have a Bytes wrapper
+ * - The message is not an Ethereum-style message
+ */
+export declare function u8aWrapBytes(bytes: U8aLike): Uint8Array;

package/u8a/wrap.js

@@ -0,0 +1,43 @@
+import { u8aConcatStrict } from './concat.js';
+import { u8aEq } from './eq.js';
+import { u8aToU8a } from './toU8a.js';
+/** @internal */
+export const U8A_WRAP_ETHEREUM = /*#__PURE__*/ u8aToU8a('\x19Ethereum Signed Message:\n');
+/** @internal */
+export const U8A_WRAP_PREFIX = /*#__PURE__*/ u8aToU8a('<Bytes>');
+/** @internal */
+export const U8A_WRAP_POSTFIX = /*#__PURE__*/ u8aToU8a('</Bytes>');
+const WRAP_LEN = U8A_WRAP_PREFIX.length + U8A_WRAP_POSTFIX.length;
+/** @internal */
+export function u8aIsWrapped(u8a, withEthereum) {
+    return ((u8a.length >= WRAP_LEN &&
+        u8aEq(u8a.subarray(0, U8A_WRAP_PREFIX.length), U8A_WRAP_PREFIX) &&
+        u8aEq(u8a.slice(-U8A_WRAP_POSTFIX.length), U8A_WRAP_POSTFIX)) ||
+        (withEthereum &&
+            u8a.length >= U8A_WRAP_ETHEREUM.length &&
+            u8aEq(u8a.subarray(0, U8A_WRAP_ETHEREUM.length), U8A_WRAP_ETHEREUM)));
+}
+/**
+ * @name u8aUnwrapBytes
+ * @description Removes all <Bytes>...</Bytes> wrappers from the supplied value
+ */
+export function u8aUnwrapBytes(bytes) {
+    const u8a = u8aToU8a(bytes);
+    // we don't want to unwrap Ethereum-style wraps
+    return u8aIsWrapped(u8a, false)
+        ? u8a.subarray(U8A_WRAP_PREFIX.length, u8a.length - U8A_WRAP_POSTFIX.length)
+        : u8a;
+}
+/**
+ * @name u8aWrapBytes
+ * @description
+ * Adds a <Bytes>...</Bytes> wrapper to the supplied value, if
+ * - We don't already have a Bytes wrapper
+ * - The message is not an Ethereum-style message
+ */
+export function u8aWrapBytes(bytes) {
+    const u8a = u8aToU8a(bytes);
+    return u8aIsWrapped(u8a, true)
+        ? u8a
+        : u8aConcatStrict([U8A_WRAP_PREFIX, u8a, U8A_WRAP_POSTFIX]);
+}