@polkadot/types-codec 6.12.2-2

package/native/Set.cjs

@@ -0,0 +1,268 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.CodecSet = void 0;
+
+var _classPrivateFieldLooseBase2 = _interopRequireDefault(require("@babel/runtime/helpers/classPrivateFieldLooseBase"));
+
+var _classPrivateFieldLooseKey2 = _interopRequireDefault(require("@babel/runtime/helpers/classPrivateFieldLooseKey"));
+
+var _util = require("@polkadot/util");
+
+var _index = require("../utils/index.cjs");
+
+// Copyright 2017-2021 @polkadot/types-codec authors & contributors
+// SPDX-License-Identifier: Apache-2.0
+function encodeSet(setValues, values) {
+  const encoded = new _util.BN(0);
+
+  for (let i = 0; i < values.length; i++) {
+    encoded.ior((0, _util.bnToBn)(setValues[values[i]] || 0));
+  }
+
+  return encoded;
+}
+/** @internal */
+
+
+function decodeSetArray(setValues, values) {
+  const result = new Array(values.length);
+
+  for (let i = 0; i < values.length; i++) {
+    const key = values[i];
+    (0, _util.assert)(!(0, _util.isUndefined)(setValues[key]), () => `Set: Invalid key '${key}' passed to Set, allowed ${Object.keys(setValues).join(', ')}`);
+    result[i] = key;
+  }
+
+  return result;
+}
+/** @internal */
+
+
+function decodeSetNumber(setValues, _value) {
+  const bn = (0, _util.bnToBn)(_value);
+  const keys = Object.keys(setValues);
+  const result = [];
+
+  for (let i = 0; i < keys.length; i++) {
+    const key = keys[i];
+
+    if (bn.and((0, _util.bnToBn)(setValues[key])).eq((0, _util.bnToBn)(setValues[key]))) {
+      result.push(key);
+    }
+  }
+
+  const computed = encodeSet(setValues, result);
+  (0, _util.assert)(bn.eq(computed), () => `Set: Mismatch decoding '${bn.toString()}', computed as '${computed.toString()}' with ${result.join(', ')}`);
+  return result;
+}
+/** @internal */
+
+
+function decodeSet(setValues) {
+  let value = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : 0;
+  let bitLength = arguments.length > 2 ? arguments[2] : undefined;
+  (0, _util.assert)(bitLength % 8 === 0, () => `Expected valid bitLength, power of 8, found ${bitLength}`);
+  const byteLength = bitLength / 8;
+
+  if ((0, _util.isU8a)(value)) {
+    return value.length === 0 ? [] : decodeSetNumber(setValues, (0, _util.u8aToBn)(value.subarray(0, byteLength), {
+      isLe: true
+    }));
+  } else if ((0, _util.isString)(value)) {
+    return decodeSet(setValues, (0, _util.u8aToU8a)(value), byteLength);
+  } else if (value instanceof Set || Array.isArray(value)) {
+    const input = Array.isArray(value) ? value : [...value.values()];
+    return decodeSetArray(setValues, input);
+  }
+
+  return decodeSetNumber(setValues, value);
+}
+/**
+ * @name Set
+ * @description
+ * An Set is an array of string values, represented an an encoded type by
+ * a bitwise representation of the values.
+ */
+
+
+var _allowed = /*#__PURE__*/(0, _classPrivateFieldLooseKey2.default)("allowed");
+
+var _byteLength = /*#__PURE__*/(0, _classPrivateFieldLooseKey2.default)("byteLength");
+
+class CodecSet extends Set {
+  constructor(registry, setValues, value) {
+    let bitLength = arguments.length > 3 && arguments[3] !== undefined ? arguments[3] : 8;
+    super(decodeSet(setValues, value, bitLength));
+    this.registry = void 0;
+    this.createdAtHash = void 0;
+    Object.defineProperty(this, _allowed, {
+      writable: true,
+      value: void 0
+    });
+    Object.defineProperty(this, _byteLength, {
+      writable: true,
+      value: void 0
+    });
+
+    this.add = key => {
+      // ^^^ add = () property done to assign this instance's this, otherwise Set.add creates "some" chaos
+      // we have the isUndefined(this._setValues) in here as well, add is used internally
+      // in the Set constructor (so it is undefined at this point, and should allow)
+      (0, _util.assert)((0, _util.isUndefined)((0, _classPrivateFieldLooseBase2.default)(this, _allowed)[_allowed]) || !(0, _util.isUndefined)((0, _classPrivateFieldLooseBase2.default)(this, _allowed)[_allowed][key]), () => `Set: Invalid key '${key}' on add`);
+      super.add(key);
+      return this;
+    };
+
+    this.registry = registry;
+    (0, _classPrivateFieldLooseBase2.default)(this, _allowed)[_allowed] = setValues;
+    (0, _classPrivateFieldLooseBase2.default)(this, _byteLength)[_byteLength] = bitLength / 8;
+  }
+
+  static with(values, bitLength) {
+    const keys = Object.keys(values);
+    const isKeys = new Array(keys.length);
+
+    for (let i = 0; i < keys.length; i++) {
+      isKeys[i] = `is${(0, _util.stringPascalCase)(keys[i])}`;
+    }
+
+    return class extends CodecSet {
+      constructor(registry, value) {
+        super(registry, values, value, bitLength);
+        (0, _util.objectProperties)(this, isKeys, (_, i) => this.strings.includes(keys[i]));
+      }
+
+    };
+  }
+  /**
+   * @description The length of the value when encoded as a Uint8Array
+   */
+
+
+  get encodedLength() {
+    return (0, _classPrivateFieldLooseBase2.default)(this, _byteLength)[_byteLength];
+  }
+  /**
+   * @description returns a hash of the contents
+   */
+
+
+  get hash() {
+    return this.registry.hash(this.toU8a());
+  }
+  /**
+   * @description true is the Set contains no values
+   */
+
+
+  get isEmpty() {
+    return this.size === 0;
+  }
+  /**
+   * @description The actual set values as a string[]
+   */
+
+
+  get strings() {
+    return [...super.values()];
+  }
+  /**
+   * @description The encoded value for the set members
+   */
+
+
+  get valueEncoded() {
+    return encodeSet((0, _classPrivateFieldLooseBase2.default)(this, _allowed)[_allowed], this.strings);
+  }
+  /**
+   * @description adds a value to the Set (extended to allow for validity checking)
+   */
+
+
+  /**
+   * @description Compares the value of the input to see if there is a match
+   */
+  eq(other) {
+    if (Array.isArray(other)) {
+      // we don't actually care about the order, sort the values
+      return (0, _index.compareArray)(this.strings.sort(), other.sort());
+    } else if (other instanceof Set) {
+      return this.eq([...other.values()]);
+    } else if ((0, _util.isNumber)(other) || (0, _util.isBn)(other)) {
+      return this.valueEncoded.eq((0, _util.bnToBn)(other));
+    }
+
+    return false;
+  }
+  /**
+   * @description Returns a hex string representation of the value
+   */
+
+
+  toHex() {
+    return (0, _util.u8aToHex)(this.toU8a());
+  }
+  /**
+   * @description Converts the Object to to a human-friendly JSON, with additional fields, expansion and formatting of information
+   */
+
+
+  toHuman() {
+    return this.toJSON();
+  }
+  /**
+   * @description Converts the Object to JSON, typically used for RPC transfers
+   */
+
+
+  toJSON() {
+    return this.strings;
+  }
+  /**
+   * @description The encoded value for the set members
+   */
+
+
+  toNumber() {
+    return this.valueEncoded.toNumber();
+  }
+  /**
+   * @description Returns the base runtime type name for this instance
+   */
+
+
+  toRawType() {
+    return (0, _util.stringify)({
+      _set: (0, _classPrivateFieldLooseBase2.default)(this, _allowed)[_allowed]
+    });
+  }
+  /**
+   * @description Returns the string representation of the value
+   */
+
+
+  toString() {
+    return `[${this.strings.join(', ')}]`;
+  }
+  /**
+   * @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)
+   */
+  // eslint-disable-next-line @typescript-eslint/no-unused-vars
+
+
+  toU8a(isBare) {
+    return (0, _util.bnToU8a)(this.valueEncoded, {
+      bitLength: (0, _classPrivateFieldLooseBase2.default)(this, _byteLength)[_byteLength] * 8,
+      isLe: true
+    });
+  }
+
+}
+
+exports.CodecSet = CodecSet;

package/native/Set.d.ts

@@ -0,0 +1,76 @@
+/// <reference types="bn.js" />
+import type { HexString } from '@polkadot/util/types';
+import type { CodecClass, CodecRegistry, ISet, IU8a } from '../types';
+import { BN } from '@polkadot/util';
+declare type SetValues = Record<string, number | BN>;
+/**
+ * @name Set
+ * @description
+ * An Set is an array of string values, represented an an encoded type by
+ * a bitwise representation of the values.
+ */
+export declare class CodecSet extends Set<string> implements ISet<string> {
+    #private;
+    readonly registry: CodecRegistry;
+    createdAtHash?: IU8a;
+    constructor(registry: CodecRegistry, setValues: SetValues, value?: string[] | Set<string> | Uint8Array | BN | number | string, bitLength?: number);
+    static with(values: SetValues, bitLength?: number): CodecClass<CodecSet>;
+    /**
+     * @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 true is the Set contains no values
+     */
+    get isEmpty(): boolean;
+    /**
+     * @description The actual set values as a string[]
+     */
+    get strings(): string[];
+    /**
+     * @description The encoded value for the set members
+     */
+    get valueEncoded(): BN;
+    /**
+     * @description adds a value to the Set (extended to allow for validity checking)
+     */
+    add: (key: string) => this;
+    /**
+     * @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(): string[];
+    /**
+     * @description Converts the Object to JSON, typically used for RPC transfers
+     */
+    toJSON(): string[];
+    /**
+     * @description The encoded value for the set members
+     */
+    toNumber(): 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;
+}
+export {};

package/native/Set.js

@@ -0,0 +1,251 @@
+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, BN, bnToBn, bnToU8a, isBn, isNumber, isString, isU8a, isUndefined, objectProperties, stringify, stringPascalCase, u8aToBn, u8aToHex, u8aToU8a } from '@polkadot/util';
+import { compareArray } from "../utils/index.js";
+
+function encodeSet(setValues, values) {
+  const encoded = new BN(0);
+
+  for (let i = 0; i < values.length; i++) {
+    encoded.ior(bnToBn(setValues[values[i]] || 0));
+  }
+
+  return encoded;
+}
+/** @internal */
+
+
+function decodeSetArray(setValues, values) {
+  const result = new Array(values.length);
+
+  for (let i = 0; i < values.length; i++) {
+    const key = values[i];
+    assert(!isUndefined(setValues[key]), () => `Set: Invalid key '${key}' passed to Set, allowed ${Object.keys(setValues).join(', ')}`);
+    result[i] = key;
+  }
+
+  return result;
+}
+/** @internal */
+
+
+function decodeSetNumber(setValues, _value) {
+  const bn = bnToBn(_value);
+  const keys = Object.keys(setValues);
+  const result = [];
+
+  for (let i = 0; i < keys.length; i++) {
+    const key = keys[i];
+
+    if (bn.and(bnToBn(setValues[key])).eq(bnToBn(setValues[key]))) {
+      result.push(key);
+    }
+  }
+
+  const computed = encodeSet(setValues, result);
+  assert(bn.eq(computed), () => `Set: Mismatch decoding '${bn.toString()}', computed as '${computed.toString()}' with ${result.join(', ')}`);
+  return result;
+}
+/** @internal */
+
+
+function decodeSet(setValues, value = 0, bitLength) {
+  assert(bitLength % 8 === 0, () => `Expected valid bitLength, power of 8, found ${bitLength}`);
+  const byteLength = bitLength / 8;
+
+  if (isU8a(value)) {
+    return value.length === 0 ? [] : decodeSetNumber(setValues, u8aToBn(value.subarray(0, byteLength), {
+      isLe: true
+    }));
+  } else if (isString(value)) {
+    return decodeSet(setValues, u8aToU8a(value), byteLength);
+  } else if (value instanceof Set || Array.isArray(value)) {
+    const input = Array.isArray(value) ? value : [...value.values()];
+    return decodeSetArray(setValues, input);
+  }
+
+  return decodeSetNumber(setValues, value);
+}
+/**
+ * @name Set
+ * @description
+ * An Set is an array of string values, represented an an encoded type by
+ * a bitwise representation of the values.
+ */
+
+
+var _allowed = /*#__PURE__*/_classPrivateFieldLooseKey("allowed");
+
+var _byteLength = /*#__PURE__*/_classPrivateFieldLooseKey("byteLength");
+
+export class CodecSet extends Set {
+  constructor(registry, setValues, value, bitLength = 8) {
+    super(decodeSet(setValues, value, bitLength));
+    this.registry = void 0;
+    this.createdAtHash = void 0;
+    Object.defineProperty(this, _allowed, {
+      writable: true,
+      value: void 0
+    });
+    Object.defineProperty(this, _byteLength, {
+      writable: true,
+      value: void 0
+    });
+
+    this.add = key => {
+      // ^^^ add = () property done to assign this instance's this, otherwise Set.add creates "some" chaos
+      // we have the isUndefined(this._setValues) in here as well, add is used internally
+      // in the Set constructor (so it is undefined at this point, and should allow)
+      assert(isUndefined(_classPrivateFieldLooseBase(this, _allowed)[_allowed]) || !isUndefined(_classPrivateFieldLooseBase(this, _allowed)[_allowed][key]), () => `Set: Invalid key '${key}' on add`);
+      super.add(key);
+      return this;
+    };
+
+    this.registry = registry;
+    _classPrivateFieldLooseBase(this, _allowed)[_allowed] = setValues;
+    _classPrivateFieldLooseBase(this, _byteLength)[_byteLength] = bitLength / 8;
+  }
+
+  static with(values, bitLength) {
+    const keys = Object.keys(values);
+    const isKeys = new Array(keys.length);
+
+    for (let i = 0; i < keys.length; i++) {
+      isKeys[i] = `is${stringPascalCase(keys[i])}`;
+    }
+
+    return class extends CodecSet {
+      constructor(registry, value) {
+        super(registry, values, value, bitLength);
+        objectProperties(this, isKeys, (_, i) => this.strings.includes(keys[i]));
+      }
+
+    };
+  }
+  /**
+   * @description The length of the value when encoded as a Uint8Array
+   */
+
+
+  get encodedLength() {
+    return _classPrivateFieldLooseBase(this, _byteLength)[_byteLength];
+  }
+  /**
+   * @description returns a hash of the contents
+   */
+
+
+  get hash() {
+    return this.registry.hash(this.toU8a());
+  }
+  /**
+   * @description true is the Set contains no values
+   */
+
+
+  get isEmpty() {
+    return this.size === 0;
+  }
+  /**
+   * @description The actual set values as a string[]
+   */
+
+
+  get strings() {
+    return [...super.values()];
+  }
+  /**
+   * @description The encoded value for the set members
+   */
+
+
+  get valueEncoded() {
+    return encodeSet(_classPrivateFieldLooseBase(this, _allowed)[_allowed], this.strings);
+  }
+  /**
+   * @description adds a value to the Set (extended to allow for validity checking)
+   */
+
+
+  /**
+   * @description Compares the value of the input to see if there is a match
+   */
+  eq(other) {
+    if (Array.isArray(other)) {
+      // we don't actually care about the order, sort the values
+      return compareArray(this.strings.sort(), other.sort());
+    } else if (other instanceof Set) {
+      return this.eq([...other.values()]);
+    } else if (isNumber(other) || isBn(other)) {
+      return this.valueEncoded.eq(bnToBn(other));
+    }
+
+    return false;
+  }
+  /**
+   * @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() {
+    return this.toJSON();
+  }
+  /**
+   * @description Converts the Object to JSON, typically used for RPC transfers
+   */
+
+
+  toJSON() {
+    return this.strings;
+  }
+  /**
+   * @description The encoded value for the set members
+   */
+
+
+  toNumber() {
+    return this.valueEncoded.toNumber();
+  }
+  /**
+   * @description Returns the base runtime type name for this instance
+   */
+
+
+  toRawType() {
+    return stringify({
+      _set: _classPrivateFieldLooseBase(this, _allowed)[_allowed]
+    });
+  }
+  /**
+   * @description Returns the string representation of the value
+   */
+
+
+  toString() {
+    return `[${this.strings.join(', ')}]`;
+  }
+  /**
+   * @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)
+   */
+  // eslint-disable-next-line @typescript-eslint/no-unused-vars
+
+
+  toU8a(isBare) {
+    return bnToU8a(this.valueEncoded, {
+      bitLength: _classPrivateFieldLooseBase(this, _byteLength)[_byteLength] * 8,
+      isLe: true
+    });
+  }
+
+}