@pezkuwi/types-codec 16.5.5 → 16.5.8

package/cjs/primitive/USize.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.usize = void 0;
+const U32_js_1 = require("./U32.js");
+/**
+ * @name USize
+ * @description
+ * A System default unsigned number, typically used in RPC to report non-consensus
+ * data. It is a wrapper for [[U32]] as a WASM default (as generated by Rust bindings).
+ * It is not to be used, since it created consensus mismatches.
+ */
+class usize extends U32_js_1.u32 {
+    constructor(registry, value) {
+        super(registry, value);
+        throw new Error('The `usize` type should not be used. Since it is platform-specific, it creates incompatibilities between native (generally u64) and WASM (always u32) code. Use one of the `u32` or `u64` types explicitly.');
+    }
+}
+exports.usize = usize;

package/cjs/primitive/index.d.ts

@@ -0,0 +1,16 @@
+export { f32 as F32, f32 } from './F32.js';
+export { f64 as F64, f64 } from './F64.js';
+export { i8 as I8, i8 } from './I8.js';
+export { i16 as I16, i16 } from './I16.js';
+export { i32 as I32, i32 } from './I32.js';
+export { i64 as I64, i64 } from './I64.js';
+export { i128 as I128, i128 } from './I128.js';
+export { i256 as I256, i256 } from './I256.js';
+export { isize as ISize, isize } from './ISize.js';
+export { u8 as U8, u8 } from './U8.js';
+export { u16 as U16, u16 } from './U16.js';
+export { u32 as U32, u32 } from './U32.js';
+export { u64 as U64, u64 } from './U64.js';
+export { u128 as U128, u128 } from './U128.js';
+export { u256 as U256, u256 } from './U256.js';
+export { usize as USize, usize } from './USize.js';

package/cjs/primitive/index.js

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.usize = exports.USize = exports.u256 = exports.U256 = exports.u128 = exports.U128 = exports.u64 = exports.U64 = exports.u32 = exports.U32 = exports.u16 = exports.U16 = exports.u8 = exports.U8 = exports.isize = exports.ISize = exports.i256 = exports.I256 = exports.i128 = exports.I128 = exports.i64 = exports.I64 = exports.i32 = exports.I32 = exports.i16 = exports.I16 = exports.i8 = exports.I8 = exports.f64 = exports.F64 = exports.f32 = exports.F32 = void 0;
+var F32_js_1 = require("./F32.js");
+Object.defineProperty(exports, "F32", { enumerable: true, get: function () { return F32_js_1.f32; } });
+Object.defineProperty(exports, "f32", { enumerable: true, get: function () { return F32_js_1.f32; } });
+var F64_js_1 = require("./F64.js");
+Object.defineProperty(exports, "F64", { enumerable: true, get: function () { return F64_js_1.f64; } });
+Object.defineProperty(exports, "f64", { enumerable: true, get: function () { return F64_js_1.f64; } });
+var I8_js_1 = require("./I8.js");
+Object.defineProperty(exports, "I8", { enumerable: true, get: function () { return I8_js_1.i8; } });
+Object.defineProperty(exports, "i8", { enumerable: true, get: function () { return I8_js_1.i8; } });
+var I16_js_1 = require("./I16.js");
+Object.defineProperty(exports, "I16", { enumerable: true, get: function () { return I16_js_1.i16; } });
+Object.defineProperty(exports, "i16", { enumerable: true, get: function () { return I16_js_1.i16; } });
+var I32_js_1 = require("./I32.js");
+Object.defineProperty(exports, "I32", { enumerable: true, get: function () { return I32_js_1.i32; } });
+Object.defineProperty(exports, "i32", { enumerable: true, get: function () { return I32_js_1.i32; } });
+var I64_js_1 = require("./I64.js");
+Object.defineProperty(exports, "I64", { enumerable: true, get: function () { return I64_js_1.i64; } });
+Object.defineProperty(exports, "i64", { enumerable: true, get: function () { return I64_js_1.i64; } });
+var I128_js_1 = require("./I128.js");
+Object.defineProperty(exports, "I128", { enumerable: true, get: function () { return I128_js_1.i128; } });
+Object.defineProperty(exports, "i128", { enumerable: true, get: function () { return I128_js_1.i128; } });
+var I256_js_1 = require("./I256.js");
+Object.defineProperty(exports, "I256", { enumerable: true, get: function () { return I256_js_1.i256; } });
+Object.defineProperty(exports, "i256", { enumerable: true, get: function () { return I256_js_1.i256; } });
+var ISize_js_1 = require("./ISize.js");
+Object.defineProperty(exports, "ISize", { enumerable: true, get: function () { return ISize_js_1.isize; } });
+Object.defineProperty(exports, "isize", { enumerable: true, get: function () { return ISize_js_1.isize; } });
+var U8_js_1 = require("./U8.js");
+Object.defineProperty(exports, "U8", { enumerable: true, get: function () { return U8_js_1.u8; } });
+Object.defineProperty(exports, "u8", { enumerable: true, get: function () { return U8_js_1.u8; } });
+var U16_js_1 = require("./U16.js");
+Object.defineProperty(exports, "U16", { enumerable: true, get: function () { return U16_js_1.u16; } });
+Object.defineProperty(exports, "u16", { enumerable: true, get: function () { return U16_js_1.u16; } });
+var U32_js_1 = require("./U32.js");
+Object.defineProperty(exports, "U32", { enumerable: true, get: function () { return U32_js_1.u32; } });
+Object.defineProperty(exports, "u32", { enumerable: true, get: function () { return U32_js_1.u32; } });
+var U64_js_1 = require("./U64.js");
+Object.defineProperty(exports, "U64", { enumerable: true, get: function () { return U64_js_1.u64; } });
+Object.defineProperty(exports, "u64", { enumerable: true, get: function () { return U64_js_1.u64; } });
+var U128_js_1 = require("./U128.js");
+Object.defineProperty(exports, "U128", { enumerable: true, get: function () { return U128_js_1.u128; } });
+Object.defineProperty(exports, "u128", { enumerable: true, get: function () { return U128_js_1.u128; } });
+var U256_js_1 = require("./U256.js");
+Object.defineProperty(exports, "U256", { enumerable: true, get: function () { return U256_js_1.u256; } });
+Object.defineProperty(exports, "u256", { enumerable: true, get: function () { return U256_js_1.u256; } });
+var USize_js_1 = require("./USize.js");
+Object.defineProperty(exports, "USize", { enumerable: true, get: function () { return USize_js_1.usize; } });
+Object.defineProperty(exports, "usize", { enumerable: true, get: function () { return USize_js_1.usize; } });

package/cjs/types/codec.d.ts

@@ -0,0 +1,113 @@
+import type { HexString } from '@pezkuwi/util/types';
+import type { AnyJson, ToString } from './helpers.js';
+import type { IU8a } from './interfaces.js';
+import type { Registry } from './registry.js';
+export type BareOpts = boolean | Record<string, boolean>;
+export interface Inspect {
+    inner?: Inspect[] | undefined;
+    name?: string;
+    outer?: Uint8Array[];
+}
+/**
+ * @name Codec
+ * @description
+ * The base Codec interface. All types implement the interface provided here.
+ * Additionally implementors can add their own specific interfaces and helpers
+ * with getters and functions. The Codec Base is however required for operating
+ * as an encoding/decoding layer
+ */
+export interface Codec {
+    /**
+     * @description
+     * The block at which this value was retrieved/created (set to non-empty when
+     * retrieved from storage)
+     */
+    createdAtHash?: IU8a | undefined;
+    /**
+     * @description
+     * The length of the initial encoded value (Only available when the value was
+     * constructed from a Uint8Array input)
+     */
+    initialU8aLength?: number | undefined;
+    /**
+     * @description
+     * (internal usage) Indicates that the value was created via a fallback. This
+     * is used when with data specified in the metadata when the storage entry is
+     * empty.
+     *
+     * With metadata fallback values (available as defaults on most storage entries)
+     * any empty storage item should erturn the default. (This is the same as the
+     * implementation on the Bizinikiwi runtime)
+     */
+    isStorageFallback?: boolean;
+    /**
+     * @description The length of the value when encoded as a Uint8Array
+     */
+    readonly encodedLength: number;
+    /**
+     * @description Returns a hash of the value
+     */
+    readonly hash: IU8a;
+    /**
+     * @description Checks if the value is an empty value
+     */
+    readonly isEmpty: boolean;
+    /**
+     * @description The registry associated with this object
+     */
+    readonly registry: Registry;
+    /**
+     * @description Compares the value of the input to see if there is a match
+     */
+    eq(other?: unknown): boolean;
+    /**
+     * @description Returns a breakdown of the hex encoding for this Codec
+     */
+    inspect(isBare?: BareOpts): Inspect;
+    /**
+     * @description Returns a hex string representation of the value. isLe returns a LE (number-only) representation
+     */
+    toHex(isLe?: boolean): HexString;
+    /**
+     * @description Converts the Object to to a human-friendly JSON, with additional fields, expansion and formatting of information
+     * @param isExtended When set, for some (e.g. call) it can add more info, e.g. metadata documentation. (Generally not needed in all cases, but can be useful in Events, Calls, ...)
+     * @param disableAscii When set, for some (e.g. `Raw` types) it will disable converting the value to ascii.
+     */
+    toHuman(isExtended?: boolean, disableAscii?: boolean): AnyJson;
+    /**
+     * @description Converts the Object to JSON, typically used for RPC transfers
+     */
+    toJSON(): AnyJson;
+    /**
+     * @description Converts the value in a best-fit primitive form
+     * @param disableAscii
+     */
+    toPrimitive(disableAscii?: boolean): AnyJson;
+    /**
+     * @description Returns the base runtime type name for this instance
+     */
+    toRawType(): string;
+    /**
+     * @description Returns the string representation of the value
+     */
+    toString(): string;
+    /**
+     * @description Encodes the value as a Uint8Array as per the SCALE specifications
+     * @param isBare true when the value has none of the type-specific prefixes (internal use, only available on
+     * some Codec types, specifically those that add encodings such as length of indexes)
+     */
+    toU8a(isBare?: BareOpts): Uint8Array;
+}
+export interface CodecClass<T = Codec, A extends unknown[] = any[]> {
+    /**
+     * @description An internal fallback type (previous generation) if encoding fails
+     */
+    readonly __fallbackType?: string;
+    new (registry: Registry, ...args: A): T;
+}
+export interface CodecObject<T extends ToString> extends Codec {
+    readonly $: T;
+    valueOf(): T;
+}
+export type CodecTo = 'toHex' | 'toJSON' | 'toPrimitive' | 'toString' | 'toU8a';
+export type ArgsDef = Record<string, CodecClass | string>;

package/cjs/types/codec.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/cjs/types/helpers.d.ts

@@ -0,0 +1,27 @@
+import type { BN } from '@pezkuwi/util';
+import type { HexString } from '@pezkuwi/util/types';
+import type { Codec } from './codec.js';
+export type AnyJson = string | number | boolean | null | undefined | AnyJson[] | {
+    [index: string]: AnyJson;
+};
+export type AnyFunction = (...args: any[]) => any;
+export type AnyNumber = BN | bigint | Uint8Array | number | string;
+export type AnyFloat = Number | number | Uint8Array | string;
+export type AnyString = String | string;
+export type AnyBool = Boolean | boolean;
+export type AnyTuple = Codec[];
+export type AnyU8a = Uint8Array | number[] | string;
+export type UIntBitLength = 8 | 16 | 32 | 64 | 128 | 256;
+export type U8aBitLength = 8 | 16 | 32 | 64 | 128 | 160 | 256 | 264 | 512 | 520 | 1024 | 2048;
+export type AnyTupleValue = Exclude<AnyU8a, string> | HexString | (Codec | AnyU8a | AnyNumber | AnyString | undefined | null)[];
+export interface ToString {
+    toString: () => string;
+}
+export interface ToBn {
+    toBn: () => BN;
+}
+export interface DefinitionSetter<T> {
+    definition?: T | undefined;
+    setDefinition?: (d: T) => T;
+}
+export type LookupString = `Lookup${number}`;

package/cjs/types/helpers.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/cjs/types/index.d.ts

@@ -0,0 +1,4 @@
+export * from './codec.js';
+export * from './helpers.js';
+export * from './interfaces.js';
+export * from './registry.js';

package/cjs/types/index.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./codec.js"), exports);
+tslib_1.__exportStar(require("./helpers.js"), exports);
+tslib_1.__exportStar(require("./interfaces.js"), exports);
+tslib_1.__exportStar(require("./registry.js"), exports);

package/cjs/types/interfaces.d.ts

@@ -0,0 +1,74 @@
+import type { BN } from '@pezkuwi/util';
+import type { ArgsDef, Codec } from './codec.js';
+import type { AnyTuple } from './helpers.js';
+export interface ICompact<T extends INumber = INumber> extends Codec {
+    toBigInt(): bigint;
+    toBn(): BN;
+    toNumber(): number;
+    unwrap(): T;
+}
+export interface IEnum extends Codec {
+    readonly defIndexes: number[];
+    readonly defKeys: string[];
+    readonly index: number;
+    readonly isBasic: boolean;
+    readonly type: string;
+    readonly value: Codec;
+    toNumber(): number;
+}
+export interface IMap<K extends Codec = Codec, V extends Codec = Codec> extends Map<K, V>, Codec {
+}
+export interface INumber extends Codec {
+    bitLength(): number;
+    toBigInt(): bigint;
+    toBn(): BN;
+    toNumber(): number;
+    toPrimitive(disableAscii?: boolean): string | number;
+}
+export interface IFloat extends Codec {
+    toNumber(): number;
+}
+export interface IOption<T extends Codec = Codec> extends Codec {
+    readonly isNone: boolean;
+    readonly isSome: boolean;
+    readonly value: Codec;
+    unwrap(): T;
+    unwrapOr<O>(other: O): T | O;
+    unwrapOrDefault(): T;
+}
+export interface IResult<O extends Codec = Codec, E extends Codec = Codec> extends IEnum {
+    readonly asErr: E;
+    readonly asOk: O;
+    readonly isErr: boolean;
+    readonly isOk: boolean;
+}
+export interface ISet<K = string> extends Set<K>, Codec {
+    readonly strings: string[];
+}
+export interface IStruct<K = string, V extends Codec = Codec> extends Map<K, V>, Codec {
+    readonly defKeys: string[];
+    getAtIndex(index: number): Codec;
+    toArray(): Codec[];
+}
+export interface IText extends String, Codec {
+}
+export type ITuple<T extends AnyTuple = Codec[]> = T & Codec;
+export interface IU8a extends Uint8Array, Codec {
+    readonly isAscii: boolean;
+    readonly isUtf8: boolean;
+    bitLength(): number;
+    toHuman(isExtended?: boolean, disableAscii?: boolean): any;
+    toJSON(): any;
+    toUtf8(): string;
+}
+export interface IVec<T extends Codec = Codec> extends Array<T>, Codec {
+    toArray(): T[];
+}
+export interface IMethod<A extends AnyTuple = AnyTuple, M = any> extends Codec {
+    readonly args: A;
+    readonly argsDef: ArgsDef;
+    readonly callIndex: Uint8Array;
+    readonly data: Uint8Array;
+    readonly meta: M;
+    is: (tx: IMethod<AnyTuple>) => tx is IMethod<A>;
+}

package/cjs/types/interfaces.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/cjs/types/registry.d.ts

@@ -0,0 +1,67 @@
+import type { BN } from '@pezkuwi/util';
+import type { Codec, CodecClass } from './codec.js';
+import type { AnyTuple, LookupString } from './helpers.js';
+import type { ICompact, IEnum, IMap, IMethod, INumber, IOption, IResult, ISet, IStruct, ITuple, IU8a, IVec } from './interfaces.js';
+export type OnlyCodec<K, T, Types> = K extends keyof Types ? Types[K] : T extends ICompact | IEnum | IMap | IMethod | INumber | IOption | IResult | ISet | IStruct | ITuple | IU8a | IVec ? T : T extends Codec ? T : never;
+export interface RegistryError {
+    args: string[];
+    docs: string[];
+    index: number;
+    method: string;
+    name: string;
+    section: string;
+}
+export type RegistryTypes = Record<string, CodecClass | string | Record<string, string> | {
+    _enum: string[] | Record<string, number> | Record<string, string | null>;
+} | {
+    _set: Record<string, number>;
+}>;
+export interface CodecCreateOptions {
+    blockHash?: Uint8Array | string | null | undefined;
+    isFallback?: boolean;
+    isOptional?: boolean;
+    isPedantic?: boolean;
+}
+export interface CallBase<A extends AnyTuple, M = any> extends IMethod<A, M> {
+    readonly method: string;
+    readonly section: string;
+    toJSON: () => any;
+}
+export interface CallFunction<A extends AnyTuple = AnyTuple, M = any> extends CallBase<A, M> {
+    (...args: any[]): IMethod<A, M>;
+}
+export interface Registry {
+    readonly chainDecimals: number[];
+    readonly chainIsEthereum: boolean;
+    readonly chainSS58: number | undefined;
+    readonly chainTokens: string[];
+    createdAtHash?: IU8a;
+    findMetaCall(callIndex: Uint8Array): CallFunction;
+    findMetaError(errorIndex: Uint8Array | {
+        error: BN;
+        index: BN;
+    } | {
+        error: BN | Uint8Array;
+        index: BN;
+    }): RegistryError;
+    findMetaEvent(eventIndex: Uint8Array): CodecClass<any>;
+    isLookupType(value: string): value is LookupString;
+    createLookupType(lookupId: ICompact<INumber> | number): LookupString;
+    createClassUnsafe<T extends Codec = Codec, K extends string = string>(type: K): CodecClass<T>;
+    createTypeUnsafe<T extends Codec = Codec, K extends string = string>(type: K, params: unknown[], options?: CodecCreateOptions): T;
+    get(...params: never[]): any;
+    getClassName(clazz: CodecClass): string | undefined;
+    getOrThrow<T extends Codec = Codec, K extends string = string>(name: K, msg?: string): CodecClass<T>;
+    getOrUnknown<T extends Codec = Codec, K extends string = string>(name: K): CodecClass<T>;
+    getTransactionExtensionVersion(): number;
+    getSignedExtensionExtra(): Record<string, string>;
+    getSignedExtensionTypes(): Record<string, string>;
+    hasClass(name: string): boolean;
+    hasDef(name: string): boolean;
+    hasType(name: string): boolean;
+    hash(data: Uint8Array): IU8a;
+    register(type: CodecClass | RegistryTypes): void;
+    register(name: string, type: CodecClass): void;
+    register(arg1: string | CodecClass | RegistryTypes, arg2?: CodecClass): void;
+    setMetadata(metadata: unknown, signedExtensions?: string[], userExtensions?: unknown, noInitWarn?: boolean): void;
+}

package/cjs/types/registry.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/cjs/utils/compareArray.d.ts

@@ -0,0 +1 @@
+export declare function compareArray(a: unknown[], b?: unknown): boolean;

package/cjs/utils/compareArray.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.compareArray = compareArray;
+const util_1 = require("@pezkuwi/util");
+const util_js_1 = require("./util.js");
+function compareArray(a, b) {
+    if (Array.isArray(b)) {
+        return (a.length === b.length) && (0, util_1.isUndefined)(a.find((v, index) => (0, util_js_1.hasEq)(v)
+            ? !v.eq(b[index])
+            : v !== b[index]));
+    }
+    return false;
+}

package/cjs/utils/compareMap.d.ts

@@ -0,0 +1 @@
+export declare function compareMap(a: Map<unknown, unknown>, b?: unknown): boolean;

package/cjs/utils/compareMap.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.compareMap = compareMap;
+const util_1 = require("@pezkuwi/util");
+const util_js_1 = require("./util.js");
+function hasMismatch(a, b) {
+    return (0, util_1.isUndefined)(a) || ((0, util_js_1.hasEq)(a)
+        ? !a.eq(b)
+        : a !== b);
+}
+function notEntry(value) {
+    return !Array.isArray(value) || value.length !== 2;
+}
+function compareMapArray(a, b) {
+    // equal number of entries and each entry in the array should match
+    return (a.size === b.length) && !b.some((e) => notEntry(e) ||
+        hasMismatch(a.get(e[0]), e[1]));
+}
+function compareMap(a, b) {
+    if (Array.isArray(b)) {
+        return compareMapArray(a, b);
+    }
+    else if (b instanceof Map) {
+        return compareMapArray(a, [...b.entries()]);
+    }
+    else if ((0, util_1.isObject)(b)) {
+        return compareMapArray(a, Object.entries(b));
+    }
+    return false;
+}

package/cjs/utils/compareSet.d.ts

@@ -0,0 +1 @@
+export declare function compareSet(a: Set<unknown>, b?: unknown): boolean;

package/cjs/utils/compareSet.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.compareSet = compareSet;
+const util_1 = require("@pezkuwi/util");
+function compareSetArray(a, b) {
+    // equal number of entries and each entry in the array should match
+    return (a.size === b.length) && !b.some((e) => !a.has(e));
+}
+function compareSet(a, b) {
+    if (Array.isArray(b)) {
+        return compareSetArray(a, b);
+    }
+    else if (b instanceof Set) {
+        return compareSetArray(a, [...b.values()]);
+    }
+    else if ((0, util_1.isObject)(b)) {
+        return compareSetArray(a, Object.values(b));
+    }
+    return false;
+}

package/cjs/utils/decodeU8a.d.ts

@@ -0,0 +1,26 @@
+import type { Codec, CodecClass, Registry } from '../types/index.js';
+/**
+ * @internal
+ *
+ * Given an u8a, and an array of Type constructors, decode the u8a against the
+ * types, and return an array of decoded values.
+ *
+ * @param u8a - The u8a to decode.
+ * @param result - The result array (will be returned with values pushed)
+ * @param types - The array of CodecClass to decode the U8a against.
+ */
+export declare function decodeU8a<T extends Codec = Codec>(registry: Registry, result: T[], u8a: Uint8Array, [Types, keys]: [CodecClass<T>[], string[]]): [T[], number];
+/**
+ * @internal
+ *
+ * Split from decodeU8a since this is specialized to zip returns ... while we duplicate, this
+ * is all on the hot-path, so it is not great, however there is (some) method behind the madness
+ */
+export declare function decodeU8aStruct(registry: Registry, result: [string, Codec][], u8a: Uint8Array, [Types, keys]: [CodecClass[], string[]]): [[string, Codec][], number];
+/**
+ * @internal
+ *
+ * Split from decodeU8a since this is specialized to 1 instance ... while we duplicate, this
+ * is all on the hot-path, so it is not great, however there is (some) method behind the madness
+ */
+export declare function decodeU8aVec<T extends Codec = Codec>(registry: Registry, result: unknown[], u8a: Uint8Array, startAt: number, Type: CodecClass<T>): [number, number];

package/cjs/utils/decodeU8a.js

@@ -0,0 +1,105 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.decodeU8a = decodeU8a;
+exports.decodeU8aStruct = decodeU8aStruct;
+exports.decodeU8aVec = decodeU8aVec;
+const util_1 = require("@pezkuwi/util");
+const MAX_DEPTH = 1024;
+/** @internal */
+function isComplexType(Type) {
+    const typeName = Type.name?.toLowerCase() || '';
+    return ['enum', 'hashmap', 'linkage', 'null', 'option', 'range', 'rangeinclusive', 'result', 'struct', 'tuple', 'vec', 'vecfixed'].includes(typeName);
+}
+/** @internal */
+function formatFailure(registry, fn, _result, { message }, u8a, i, count, Type, key) {
+    let type = '';
+    try {
+        type = `: ${new Type(registry).toRawType()}`;
+    }
+    catch {
+        // ignore
+    }
+    // This is extra debugging info (we most-probably want this in in some way, shape or form,
+    // but at this point not quite sure how to include and format it (it can be quite massive)
+    // console.error(JSON.stringify(result, null, 2));
+    return `${fn}: failed at ${(0, util_1.u8aToHex)(u8a.subarray(0, 16))}…${key ? ` on ${key}` : ''} (index ${i + 1}/${count})${type}:: ${message}`;
+}
+/**
+ * @internal
+ *
+ * Given an u8a, and an array of Type constructors, decode the u8a against the
+ * types, and return an array of decoded values.
+ *
+ * @param u8a - The u8a to decode.
+ * @param result - The result array (will be returned with values pushed)
+ * @param types - The array of CodecClass to decode the U8a against.
+ */
+function decodeU8a(registry, result, u8a, [Types, keys]) {
+    const count = result.length;
+    let offset = 0;
+    let i = 0;
+    try {
+        while (i < count) {
+            const value = new Types[i](registry, u8a.subarray(offset));
+            offset += value.initialU8aLength || value.encodedLength;
+            result[i] = value;
+            i++;
+        }
+    }
+    catch (error) {
+        throw new Error(formatFailure(registry, 'decodeU8a', result, error, u8a.subarray(offset), i, count, Types[i], keys[i]));
+    }
+    return [result, offset];
+}
+/**
+ * @internal
+ *
+ * Split from decodeU8a since this is specialized to zip returns ... while we duplicate, this
+ * is all on the hot-path, so it is not great, however there is (some) method behind the madness
+ */
+function decodeU8aStruct(registry, result, u8a, [Types, keys]) {
+    const count = result.length;
+    let offset = 0;
+    let i = 0;
+    if (count > MAX_DEPTH && isComplexType(Types[i])) {
+        throw new Error(`decodeU8aStruct: Maximum depth exceeded, received ${count} elements, limit ${MAX_DEPTH}`);
+    }
+    try {
+        while (i < count) {
+            const value = new Types[i](registry, u8a.subarray(offset));
+            offset += value.initialU8aLength || value.encodedLength;
+            result[i] = [keys[i], value];
+            i++;
+        }
+    }
+    catch (error) {
+        throw new Error(formatFailure(registry, 'decodeU8aStruct', result, error, u8a.subarray(offset), i, count, Types[i], keys[i]));
+    }
+    return [result, offset];
+}
+/**
+ * @internal
+ *
+ * Split from decodeU8a since this is specialized to 1 instance ... while we duplicate, this
+ * is all on the hot-path, so it is not great, however there is (some) method behind the madness
+ */
+function decodeU8aVec(registry, result, u8a, startAt, Type) {
+    const count = result.length;
+    if (count > MAX_DEPTH && isComplexType(Type)) {
+        throw new Error(`decodeU8aVec: Maximum depth exceeded, received ${count} elements, limit ${MAX_DEPTH}`);
+    }
+    let offset = startAt;
+    let i = 0;
+    try {
+        while (i < count) {
+            const value = new Type(registry, u8a.subarray(offset));
+            offset += value.initialU8aLength || value.encodedLength;
+            result[i] = value;
+            i++;
+        }
+    }
+    catch (error) {
+        throw new Error(formatFailure(registry, 'decodeU8aVec', result, error, u8a.subarray(offset), i, count, Type));
+    }
+    return [offset, offset - startAt];
+}

package/cjs/utils/index.d.ts

@@ -0,0 +1,8 @@
+export { compareArray } from './compareArray.js';
+export { compareMap } from './compareMap.js';
+export { compareSet } from './compareSet.js';
+export { decodeU8a, decodeU8aStruct, decodeU8aVec } from './decodeU8a.js';
+export { sanitize } from './sanitize.js';
+export { sortAsc, sortMap, sortSet } from './sortValues.js';
+export { mapToTypeMap, typesToConstructors, typeToConstructor } from './toConstructors.js';
+export { typesToMap } from './typesToMap.js';

package/cjs/utils/index.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.typesToMap = exports.typeToConstructor = exports.typesToConstructors = exports.mapToTypeMap = exports.sortSet = exports.sortMap = exports.sortAsc = exports.sanitize = exports.decodeU8aVec = exports.decodeU8aStruct = exports.decodeU8a = exports.compareSet = exports.compareMap = exports.compareArray = void 0;
+var compareArray_js_1 = require("./compareArray.js");
+Object.defineProperty(exports, "compareArray", { enumerable: true, get: function () { return compareArray_js_1.compareArray; } });
+var compareMap_js_1 = require("./compareMap.js");
+Object.defineProperty(exports, "compareMap", { enumerable: true, get: function () { return compareMap_js_1.compareMap; } });
+var compareSet_js_1 = require("./compareSet.js");
+Object.defineProperty(exports, "compareSet", { enumerable: true, get: function () { return compareSet_js_1.compareSet; } });
+var decodeU8a_js_1 = require("./decodeU8a.js");
+Object.defineProperty(exports, "decodeU8a", { enumerable: true, get: function () { return decodeU8a_js_1.decodeU8a; } });
+Object.defineProperty(exports, "decodeU8aStruct", { enumerable: true, get: function () { return decodeU8a_js_1.decodeU8aStruct; } });
+Object.defineProperty(exports, "decodeU8aVec", { enumerable: true, get: function () { return decodeU8a_js_1.decodeU8aVec; } });
+var sanitize_js_1 = require("./sanitize.js");
+Object.defineProperty(exports, "sanitize", { enumerable: true, get: function () { return sanitize_js_1.sanitize; } });
+var sortValues_js_1 = require("./sortValues.js");
+Object.defineProperty(exports, "sortAsc", { enumerable: true, get: function () { return sortValues_js_1.sortAsc; } });
+Object.defineProperty(exports, "sortMap", { enumerable: true, get: function () { return sortValues_js_1.sortMap; } });
+Object.defineProperty(exports, "sortSet", { enumerable: true, get: function () { return sortValues_js_1.sortSet; } });
+var toConstructors_js_1 = require("./toConstructors.js");
+Object.defineProperty(exports, "mapToTypeMap", { enumerable: true, get: function () { return toConstructors_js_1.mapToTypeMap; } });
+Object.defineProperty(exports, "typesToConstructors", { enumerable: true, get: function () { return toConstructors_js_1.typesToConstructors; } });
+Object.defineProperty(exports, "typeToConstructor", { enumerable: true, get: function () { return toConstructors_js_1.typeToConstructor; } });
+var typesToMap_js_1 = require("./typesToMap.js");
+Object.defineProperty(exports, "typesToMap", { enumerable: true, get: function () { return typesToMap_js_1.typesToMap; } });