@polkadot/types-codec 6.12.2-2

package/base/Enum.d.ts

@@ -0,0 +1,101 @@
+import type { HexString } from '@polkadot/util/types';
+import type { AnyJson, Codec, CodecClass, CodecRegistry, IEnum, IU8a } from '../types';
+export interface EnumCodecClass<T = Codec> {
+    new (registry: CodecRegistry, value?: any, index?: number): T;
+}
+/**
+ * @name Enum
+ * @description
+ * This implements an enum, that based on the value wraps a different type. It is effectively
+ * an extension to enum where the value type is determined by the actual index.
+ */
+export declare class Enum implements IEnum {
+    #private;
+    readonly registry: CodecRegistry;
+    createdAtHash?: IU8a;
+    readonly initialU8aLength?: number;
+    constructor(registry: CodecRegistry, Types: Record<string, string | CodecClass> | Record<string, number> | string[], value?: unknown, index?: number);
+    static with(Types: Record<string, string | CodecClass> | Record<string, number> | string[]): EnumCodecClass<Enum>;
+    /**
+     * @description The length of the value when encoded as a Uint8Array
+     */
+    get encodedLength(): number;
+    /**
+     * @description returns a hash of the contents
+     */
+    get hash(): IU8a;
+    /**
+     * @description The index of the enum value
+     */
+    get index(): number;
+    /**
+     * @description true if this is a basic enum (no values)
+     */
+    get isBasic(): boolean;
+    /**
+     * @description Checks if the value is an empty value
+     */
+    get isEmpty(): boolean;
+    /**
+     * @description Checks if the Enum points to a [[Null]] type
+     */
+    get isNone(): boolean;
+    /**
+     * @description Checks if the Enum points to a [[Null]] type
+     * @deprecated use isNone
+     */
+    get isNull(): boolean;
+    /**
+     * @description The available keys for this enum
+     */
+    get defIndexes(): number[];
+    /**
+     * @description The available keys for this enum
+     */
+    get defKeys(): string[];
+    /**
+     * @description The name of the type this enum value represents
+     */
+    get type(): string;
+    /**
+     * @description The value of the enum
+     */
+    get value(): Codec;
+    /**
+     * @description Compares the value of the input to see if there is a match
+     */
+    eq(other?: unknown): boolean;
+    /**
+     * @description Returns a hex string representation of the value
+     */
+    toHex(): HexString;
+    /**
+     * @description Converts the Object to to a human-friendly JSON, with additional fields, expansion and formatting of information
+     */
+    toHuman(isExtended?: boolean): AnyJson;
+    /**
+     * @description Converts the Object to JSON, typically used for RPC transfers
+     */
+    toJSON(): AnyJson;
+    /**
+     * @description Returns the number representation for the value
+     */
+    toNumber(): number;
+    /**
+     * @description Returns a raw struct representation of the enum types
+     */
+    protected _toRawStruct(): string[] | Record<string, string | number>;
+    /**
+     * @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)
+     */
+    toU8a(isBare?: boolean): Uint8Array;
+}

package/base/Enum.js

@@ -0,0 +1,413 @@
+import _classPrivateFieldLooseBase from "@babel/runtime/helpers/esm/classPrivateFieldLooseBase";
+import _classPrivateFieldLooseKey from "@babel/runtime/helpers/esm/classPrivateFieldLooseKey";
+// Copyright 2017-2021 @polkadot/types-codec authors & contributors
+// SPDX-License-Identifier: Apache-2.0
+import { assert, isHex, isNumber, isObject, isString, isU8a, isUndefined, objectProperties, stringCamelCase, stringify, stringPascalCase, u8aConcat, u8aToHex, u8aToU8a } from '@polkadot/util';
+import { mapToTypeMap, typesToMap } from "../utils/index.js";
+import { Null } from "./Null.js"; // export interface, this is used in Enum.with, so required as public by TS
+
+function isRustEnum(def) {
+  const defValues = Object.values(def);
+
+  if (defValues.some(v => isNumber(v))) {
+    assert(defValues.every(v => isNumber(v) && v >= 0 && v <= 255), 'Invalid number-indexed enum definition');
+    return false;
+  }
+
+  return true;
+}
+
+function extractDef(registry, _def) {
+  const def = {};
+  let isBasic;
+  let isIndexed;
+
+  if (Array.isArray(_def)) {
+    for (let i = 0; i < _def.length; i++) {
+      def[_def[i]] = {
+        Type: Null,
+        index: i
+      };
+    }
+
+    isBasic = true;
+    isIndexed = false;
+  } else if (isRustEnum(_def)) {
+    const entries = Object.entries(mapToTypeMap(registry, _def));
+
+    for (let i = 0; i < entries.length; i++) {
+      const [key, Type] = entries[i];
+      def[key] = {
+        Type,
+        index: i
+      };
+    }
+
+    isBasic = !Object.values(def).some(({
+      Type
+    }) => Type !== Null);
+    isIndexed = false;
+  } else {
+    const entries = Object.entries(_def);
+
+    for (let i = 0; i < entries.length; i++) {
+      const [key, index] = entries[i];
+      def[key] = {
+        Type: Null,
+        index
+      };
+    }
+
+    isBasic = true;
+    isIndexed = true;
+  }
+
+  return {
+    def,
+    isBasic,
+    isIndexed
+  };
+}
+
+function createFromValue(registry, def, index = 0, value) {
+  const entry = Object.values(def).find(e => e.index === index);
+  assert(!isUndefined(entry), () => `Unable to create Enum via index ${index}, in ${Object.keys(def).join(', ')}`);
+  return {
+    index,
+    value: value instanceof entry.Type ? value : new entry.Type(registry, value)
+  };
+}
+
+function decodeFromJSON(registry, def, key, value) {
+  // JSON comes in the form of { "<type (camelCase)>": "<value for type>" }, here we
+  // additionally force to lower to ensure forward compat
+  const keys = Object.keys(def).map(k => k.toLowerCase());
+  const keyLower = key.toLowerCase();
+  const index = keys.indexOf(keyLower);
+  assert(index !== -1, () => `Cannot map Enum JSON, unable to find '${key}' in ${keys.join(', ')}`);
+
+  try {
+    return createFromValue(registry, def, Object.values(def)[index].index, value);
+  } catch (error) {
+    throw new Error(`Enum(${key}):: ${error.message}`);
+  }
+}
+
+function decodeEnum(registry, def, value, index) {
+  // NOTE We check the index path first, before looking at values - this allows treating
+  // the optional indexes before anything else, more-specific > less-specific
+  if (isNumber(index)) {
+    return createFromValue(registry, def, index, value);
+  } else if (isU8a(value) || isHex(value)) {
+    const u8a = u8aToU8a(value); // nested, we don't want to match isObject below
+
+    if (u8a.length) {
+      return createFromValue(registry, def, u8a[0], u8a.subarray(1));
+    }
+  } else if (value instanceof Enum) {
+    return createFromValue(registry, def, value.index, value.value);
+  } else if (isNumber(value)) {
+    return createFromValue(registry, def, value);
+  } else if (isString(value)) {
+    return decodeFromJSON(registry, def, value.toString());
+  } else if (isObject(value)) {
+    const key = Object.keys(value)[0];
+    return decodeFromJSON(registry, def, key, value[key]);
+  } // Worst-case scenario, return the first with default
+
+
+  return createFromValue(registry, def, Object.values(def)[0].index);
+}
+/**
+ * @name Enum
+ * @description
+ * This implements an enum, that based on the value wraps a different type. It is effectively
+ * an extension to enum where the value type is determined by the actual index.
+ */
+
+
+var _def2 = /*#__PURE__*/_classPrivateFieldLooseKey("def");
+
+var _entryIndex = /*#__PURE__*/_classPrivateFieldLooseKey("entryIndex");
+
+var _indexes = /*#__PURE__*/_classPrivateFieldLooseKey("indexes");
+
+var _isBasic = /*#__PURE__*/_classPrivateFieldLooseKey("isBasic");
+
+var _isIndexed = /*#__PURE__*/_classPrivateFieldLooseKey("isIndexed");
+
+var _raw = /*#__PURE__*/_classPrivateFieldLooseKey("raw");
+
+export class Enum {
+  constructor(registry, Types, value, index) {
+    this.registry = void 0;
+    this.createdAtHash = void 0;
+    Object.defineProperty(this, _def2, {
+      writable: true,
+      value: void 0
+    });
+    Object.defineProperty(this, _entryIndex, {
+      writable: true,
+      value: void 0
+    });
+    this.initialU8aLength = void 0;
+    Object.defineProperty(this, _indexes, {
+      writable: true,
+      value: void 0
+    });
+    Object.defineProperty(this, _isBasic, {
+      writable: true,
+      value: void 0
+    });
+    Object.defineProperty(this, _isIndexed, {
+      writable: true,
+      value: void 0
+    });
+    Object.defineProperty(this, _raw, {
+      writable: true,
+      value: void 0
+    });
+    const {
+      def,
+      isBasic,
+      isIndexed
+    } = extractDef(registry, Types); // shortcut isU8a as used in SCALE decoding
+
+    const decoded = isU8a(value) && value.length && !isNumber(index) ? createFromValue(registry, def, value[0], value.subarray(1)) : decodeEnum(registry, def, value, index);
+    this.registry = registry;
+    _classPrivateFieldLooseBase(this, _def2)[_def2] = def;
+    _classPrivateFieldLooseBase(this, _isBasic)[_isBasic] = isBasic;
+    _classPrivateFieldLooseBase(this, _isIndexed)[_isIndexed] = isIndexed;
+    _classPrivateFieldLooseBase(this, _indexes)[_indexes] = Object.values(def).map(({
+      index
+    }) => index);
+    _classPrivateFieldLooseBase(this, _entryIndex)[_entryIndex] = _classPrivateFieldLooseBase(this, _indexes)[_indexes].indexOf(decoded.index) || 0;
+    _classPrivateFieldLooseBase(this, _raw)[_raw] = decoded.value;
+
+    if (_classPrivateFieldLooseBase(this, _raw)[_raw].initialU8aLength) {
+      this.initialU8aLength = 1 + _classPrivateFieldLooseBase(this, _raw)[_raw].initialU8aLength;
+    }
+  }
+
+  static with(Types) {
+    const keys = Array.isArray(Types) ? Types : Object.keys(Types);
+    const asKeys = new Array(keys.length);
+    const isKeys = new Array(keys.length);
+
+    for (let i = 0; i < keys.length; i++) {
+      const name = stringPascalCase(keys[i].replace(' ', '_'));
+      asKeys[i] = `as${name}`;
+      isKeys[i] = `is${name}`;
+    }
+
+    return class extends Enum {
+      constructor(registry, value, index) {
+        super(registry, Types, value, index);
+        objectProperties(this, isKeys, (_, i) => this.type === keys[i]);
+        objectProperties(this, asKeys, (k, i) => {
+          assert(this[isKeys[i]], () => `Cannot convert '${this.type}' via ${k}`);
+          return this.value;
+        });
+      }
+
+    };
+  }
+  /**
+   * @description The length of the value when encoded as a Uint8Array
+   */
+
+
+  get encodedLength() {
+    return 1 + _classPrivateFieldLooseBase(this, _raw)[_raw].encodedLength;
+  }
+  /**
+   * @description returns a hash of the contents
+   */
+
+
+  get hash() {
+    return this.registry.hash(this.toU8a());
+  }
+  /**
+   * @description The index of the enum value
+   */
+
+
+  get index() {
+    return _classPrivateFieldLooseBase(this, _indexes)[_indexes][_classPrivateFieldLooseBase(this, _entryIndex)[_entryIndex]];
+  }
+  /**
+   * @description true if this is a basic enum (no values)
+   */
+
+
+  get isBasic() {
+    return _classPrivateFieldLooseBase(this, _isBasic)[_isBasic];
+  }
+  /**
+   * @description Checks if the value is an empty value
+   */
+
+
+  get isEmpty() {
+    return _classPrivateFieldLooseBase(this, _raw)[_raw].isEmpty;
+  }
+  /**
+   * @description Checks if the Enum points to a [[Null]] type
+   */
+
+
+  get isNone() {
+    return _classPrivateFieldLooseBase(this, _raw)[_raw] instanceof Null;
+  }
+  /**
+   * @description Checks if the Enum points to a [[Null]] type
+   * @deprecated use isNone
+   */
+
+
+  get isNull() {
+    return _classPrivateFieldLooseBase(this, _raw)[_raw] instanceof Null;
+  }
+  /**
+   * @description The available keys for this enum
+   */
+
+
+  get defIndexes() {
+    return _classPrivateFieldLooseBase(this, _indexes)[_indexes];
+  }
+  /**
+   * @description The available keys for this enum
+   */
+
+
+  get defKeys() {
+    return Object.keys(_classPrivateFieldLooseBase(this, _def2)[_def2]);
+  }
+  /**
+   * @description The name of the type this enum value represents
+   */
+
+
+  get type() {
+    return this.defKeys[_classPrivateFieldLooseBase(this, _entryIndex)[_entryIndex]];
+  }
+  /**
+   * @description The value of the enum
+   */
+
+
+  get value() {
+    return _classPrivateFieldLooseBase(this, _raw)[_raw];
+  }
+  /**
+   * @description Compares the value of the input to see if there is a match
+   */
+
+
+  eq(other) {
+    // cater for the case where we only pass the enum index
+    if (isU8a(other)) {
+      return !this.toU8a().some((entry, index) => entry !== other[index]);
+    } else if (isNumber(other)) {
+      return this.toNumber() === other;
+    } else if (_classPrivateFieldLooseBase(this, _isBasic)[_isBasic] && isString(other)) {
+      return this.type === other;
+    } else if (isHex(other)) {
+      return this.toHex() === other;
+    } else if (other instanceof Enum) {
+      return this.index === other.index && this.value.eq(other.value);
+    } else if (isObject(other)) {
+      return this.value.eq(other[this.type]);
+    } // compare the actual wrapper value
+
+
+    return this.value.eq(other);
+  }
+  /**
+   * @description Returns a hex string representation of the value
+   */
+
+
+  toHex() {
+    return u8aToHex(this.toU8a());
+  }
+  /**
+   * @description Converts the Object to to a human-friendly JSON, with additional fields, expansion and formatting of information
+   */
+
+
+  toHuman(isExtended) {
+    return _classPrivateFieldLooseBase(this, _isBasic)[_isBasic] || this.isNone ? this.type : {
+      [this.type]: _classPrivateFieldLooseBase(this, _raw)[_raw].toHuman(isExtended)
+    };
+  }
+  /**
+   * @description Converts the Object to JSON, typically used for RPC transfers
+   */
+
+
+  toJSON() {
+    return _classPrivateFieldLooseBase(this, _isBasic)[_isBasic] ? this.type : {
+      [stringCamelCase(this.type)]: _classPrivateFieldLooseBase(this, _raw)[_raw].toJSON()
+    };
+  }
+  /**
+   * @description Returns the number representation for the value
+   */
+
+
+  toNumber() {
+    return this.index;
+  }
+  /**
+   * @description Returns a raw struct representation of the enum types
+   */
+
+
+  _toRawStruct() {
+    if (_classPrivateFieldLooseBase(this, _isBasic)[_isBasic]) {
+      return _classPrivateFieldLooseBase(this, _isIndexed)[_isIndexed] ? this.defKeys.reduce((out, key, index) => {
+        out[key] = _classPrivateFieldLooseBase(this, _indexes)[_indexes][index];
+        return out;
+      }, {}) : this.defKeys;
+    }
+
+    const typeMap = Object.entries(_classPrivateFieldLooseBase(this, _def2)[_def2]).reduce((out, [key, {
+      Type
+    }]) => {
+      out[key] = Type;
+      return out;
+    }, {});
+    return typesToMap(this.registry, typeMap);
+  }
+  /**
+   * @description Returns the base runtime type name for this instance
+   */
+
+
+  toRawType() {
+    return stringify({
+      _enum: this._toRawStruct()
+    });
+  }
+  /**
+   * @description Returns the string representation of the value
+   */
+
+
+  toString() {
+    return this.isNull ? this.type : stringify(this.toJSON());
+  }
+  /**
+   * @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)
+   */
+
+
+  toU8a(isBare) {
+    return u8aConcat(new Uint8Array(isBare ? [] : [this.index]), _classPrivateFieldLooseBase(this, _raw)[_raw].toU8a(isBare));
+  }
+
+}

package/base/Int.cjs

@@ -0,0 +1,45 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.Int = void 0;
+
+var _AbstractInt = require("../abstract/AbstractInt.cjs");
+
+// Copyright 2017-2021 @polkadot/types-codec authors & contributors
+// SPDX-License-Identifier: Apache-2.0
+
+/**
+ * @name Int
+ * @description
+ * A generic signed integer codec. For Substrate all numbers are Little Endian encoded,
+ * this handles the encoding and decoding of those numbers. Upon construction
+ * the bitLength is provided and any additional use keeps the number to this
+ * length. This extends `BN`, so all methods available on a normal `BN` object
+ * is available here.
+ * @noInheritDoc
+ */
+class Int extends _AbstractInt.AbstractInt {
+  constructor(registry) {
+    let value = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : 0;
+    let bitLength = arguments.length > 2 ? arguments[2] : undefined;
+    super(registry, value, bitLength, true);
+  }
+
+  static with(bitLength, typeName) {
+    return class extends Int {
+      constructor(registry, value) {
+        super(registry, value, bitLength);
+      }
+
+      toRawType() {
+        return typeName || super.toRawType();
+      }
+
+    };
+  }
+
+}
+
+exports.Int = Int;

package/base/Int.d.ts

@@ -0,0 +1,16 @@
+import type { AnyNumber, CodecClass, CodecRegistry, UIntBitLength } from '../types';
+import { AbstractInt } from '../abstract/AbstractInt';
+/**
+ * @name Int
+ * @description
+ * A generic signed integer codec. For Substrate all numbers are Little Endian encoded,
+ * this handles the encoding and decoding of those numbers. Upon construction
+ * the bitLength is provided and any additional use keeps the number to this
+ * length. This extends `BN`, so all methods available on a normal `BN` object
+ * is available here.
+ * @noInheritDoc
+ */
+export declare class Int extends AbstractInt {
+    constructor(registry: CodecRegistry, value?: AnyNumber, bitLength?: UIntBitLength);
+    static with(bitLength: UIntBitLength, typeName?: string): CodecClass<Int>;
+}

package/base/Int.js

@@ -0,0 +1,33 @@
+// Copyright 2017-2021 @polkadot/types-codec authors & contributors
+// SPDX-License-Identifier: Apache-2.0
+import { AbstractInt } from "../abstract/AbstractInt.js";
+/**
+ * @name Int
+ * @description
+ * A generic signed integer codec. For Substrate all numbers are Little Endian encoded,
+ * this handles the encoding and decoding of those numbers. Upon construction
+ * the bitLength is provided and any additional use keeps the number to this
+ * length. This extends `BN`, so all methods available on a normal `BN` object
+ * is available here.
+ * @noInheritDoc
+ */
+
+export class Int extends AbstractInt {
+  constructor(registry, value = 0, bitLength) {
+    super(registry, value, bitLength, true);
+  }
+
+  static with(bitLength, typeName) {
+    return class extends Int {
+      constructor(registry, value) {
+        super(registry, value, bitLength);
+      }
+
+      toRawType() {
+        return typeName || super.toRawType();
+      }
+
+    };
+  }
+
+}