quantumcoin 6.14.2 → 6.14.5

package/lib.esm/wallet/wallet.js

@@ -3,6 +3,8 @@ import { assertArgument, hexlify } from "../utils/index.js";
 import { BaseWallet } from "./base-wallet.js";
 //import { decryptCrowdsaleJson, isCrowdsaleJson  } from "./json-crowdsale.js";
 import { decryptKeystoreJsonSync, encryptKeystoreJsonSync, isKeystoreJson } from "./json-keystore.js";
+//import { Mnemonic } from "./mnemonic.js";
+import { newWallet } from "quantum-coin-js-sdk";
 //import {newWallet} from "quantum-coin-js-sdk";
 /**
  *  A **Wallet** manages a single private key which is used to sign
@@ -95,7 +97,7 @@ export class Wallet extends BaseWallet {
      *  If there is no crytographic random source, this will throw.
      */
     static createRandom(provider) {
-        let wal = qcsdk.newWallet();
+        let wal = newWallet();
         let privKey = wal.privateKey;
         return new Wallet(hexlify(privKey));
     }

package/lib.esm/wallet/wallet.js.map

@@ -1 +1 @@
-{"version":3,"file":"wallet.js","sourceRoot":"","sources":["../../src.ts/wallet/wallet.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"wallet.js","sourceRoot":"","sources":["../../src.ts/wallet/wallet.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -25,8 +25,8 @@
     "@types/semver": "7.5.8",
     "c8": "7.12.0",
     "mocha": "10.7.3",
+    "quantum-coin-js-sdk": "1.0.23",
     "quantum-coin-pqc-js-sdk": "^1.0.5",
-    "quantum-coin-js-sdk": "^1.0.20",
     "rollup": "4.24.0",
     "semver": "7.6.3",
     "typescript": "5.0.4",
@@ -85,7 +85,7 @@
       "default": "./lib.commonjs/wordlists/index.js"
     }
   },
-  "gitHead": "135db722756b81f44f55441e1e2d24ef4f85f216",
+  "gitHead": "ede6a5a650a591b064e783c828fd5297e4e186dc",
   "homepage": "https://QuantumCoin.org",
   "keywords": [
     "ethereum",
@@ -108,13 +108,14 @@
   },
   "scripts": {
     "_build-dist": "rollup -c && uglifyjs ./dist/quantumcoin.js -o ./dist/quantumcoin.min.js && uglifyjs ./dist/quantumcoin.umd.js -o ./dist/quantumcoin.umd.min.js && uglifyjs ./dist/wordlists-extra.js -o ./dist/wordlists-extra.min.js",
-    "_dist-stats": "gzip -k9f -S '.gz' ./dist/quantumcoin.min.js && gzip -k9f -S '.gz' ./dist/quantumcoin.umd.min.js && gzip -k9f -S '.gz' ./dist/wordlists-extra.min.js",
+    "_dist-stats": "gzip -k9f -S .gz ./dist/quantumcoin.min.js && gzip -k9f -S .gz ./dist/quantumcoin.umd.min.js && gzip -k9f -S .gz ./dist/wordlists-extra.min.js",
     "auto-build": "npm run build -- -w",
     "build": "tsc --project tsconfig.esm.json",
     "build-all": "npm run build && npm run build-commonjs",
-    "build-clean": "npm run clean && npm run build && node lib.esm/_admin/update-version.js && node lib.esm/_admin/update-changelog.js && npm run build-all && npm run _build-dist && npm run _dist-stats",
+    "build-clean": "npm run clean && npm run build && npm run build-all && npm run _build-dist && npm run _dist-stats",
     "build-commonjs": "tsc --project tsconfig.commonjs.json",
     "build-dist": "npm run build && npm run _build-dist && npm run _dist-stats",
+    "build-new": "npm run build && npm run build-all && npm run _build-dist && npm run _dist-stats",
     "clean": "rm -rf dist lib.esm lib.commonjs && cp -r misc/basedirs/* .",
     "postpublish": "node lib.esm/_admin/create-release.js",
     "stats": "echo 'Dependencies' && npm ls --all --omit=dev",
@@ -125,5 +126,5 @@
     "test-esm": "mocha --trace-warnings --reporter ./reporter.cjs ./lib.esm/_tests/test-*.js"
   },
   "sideEffects": false,
-  "version": "6.14.2"
+  "version": "6.14.5"
 }

package/rollup.config.mjs

@@ -1,50 +1,50 @@
-
-import { nodeResolve } from '@rollup/plugin-node-resolve';
-
-function getConfig(opts) {
-  if (opts == null) { opts = { }; }
-
-  const file = `./dist/quantumcoin${ (opts.suffix || "") }.js`;
-  const exportConditions = [ "import", "default" ];
-  const mainFields = [ "module", "main" ];
-  if (opts.browser) { mainFields.unshift("browser"); }
-
-  return {
-    input: "./lib.esm/index.js",
-    output: {
-      file,
-      banner: "const __$G = (typeof globalThis !== 'undefined' ? globalThis: typeof window !== 'undefined' ? window: typeof global !== 'undefined' ? global: typeof self !== 'undefined' ? self: {});",
-      name: (opts.name || undefined),
-      format: (opts.format || "esm"),
-      sourcemap: true
-    },
-    context: "__$G",
-    treeshake: true,
-    plugins: [ nodeResolve({
-        exportConditions,
-        mainFields,
-        modulesOnly: true,
-        preferBuiltins: false
-    }) ],
-  };
-}
-
-export default [
-  getConfig({ browser: true }),
-  getConfig({ browser: true, suffix: ".umd", format: "umd", name: "ethers" }),
-  {
-    input: "./lib.esm/wordlists/wordlists-extra.js",
-    output: {
-      file: "./dist/wordlists-extra.js",
-      format: "esm",
-      sourcemap: true
-    },
-    treeshake: true,
-    plugins: [ nodeResolve({
-      exportConditions: [ "default", "module", "import" ],
-      mainFields: [ "browser", "module", "main" ],
-      modulesOnly: true,
-      preferBuiltins: false
-    }) ],
-  }
-];
+
+import { nodeResolve } from '@rollup/plugin-node-resolve';
+
+function getConfig(opts) {
+  if (opts == null) { opts = { }; }
+
+  const file = `./dist/quantumcoin${ (opts.suffix || "") }.js`;
+  const exportConditions = [ "import", "default" ];
+  const mainFields = [ "module", "main" ];
+  if (opts.browser) { mainFields.unshift("browser"); }
+
+  return {
+    input: "./lib.esm/index.js",
+    output: {
+      file,
+      banner: "const __$G = (typeof globalThis !== 'undefined' ? globalThis: typeof window !== 'undefined' ? window: typeof global !== 'undefined' ? global: typeof self !== 'undefined' ? self: {});",
+      name: (opts.name || undefined),
+      format: (opts.format || "esm"),
+      sourcemap: true
+    },
+    context: "__$G",
+    treeshake: true,
+    plugins: [ nodeResolve({
+        exportConditions,
+        mainFields,
+        modulesOnly: true,
+        preferBuiltins: false
+    }) ],
+  };
+}
+
+export default [
+  getConfig({ browser: true }),
+  getConfig({ browser: true, suffix: ".umd", format: "umd", name: "ethers" }),
+  {
+    input: "./lib.esm/wordlists/wordlists-extra.js",
+    output: {
+      file: "./dist/wordlists-extra.js",
+      format: "esm",
+      sourcemap: true
+    },
+    treeshake: true,
+    plugins: [ nodeResolve({
+      exportConditions: [ "default", "module", "import" ],
+      mainFields: [ "browser", "module", "main" ],
+      modulesOnly: true,
+      preferBuiltins: false
+    }) ],
+  }
+];

package/src.ts/_version.ts

@@ -3,4 +3,4 @@
 /**
  *  The current version of Ethers.
  */
-export const version: string = "6.14.1";
+export const version: string = "6.14.3";

package/src.ts/abi/abi-coder.ts

@@ -1,237 +1,237 @@
-/**
- *  When sending values to or receiving values from a [[Contract]], the
- *  data is generally encoded using the [ABI standard](link-solc-abi).
- *
- *  The AbiCoder provides a utility to encode values to ABI data and
- *  decode values from ABI data.
- *
- *  Most of the time, developers should favour the [[Contract]] class,
- *  which further abstracts a lot of the finer details of ABI data.
- *
- *  @_section api/abi/abi-coder:ABI Encoding
- */
-
-// See: https://github.com/ethereum/wiki/wiki/Ethereum-Contract-ABI
-
-import { assertArgumentCount, assertArgument } from "../utils/index.js";
-
-import { Coder, Reader, Result, Writer } from "./coders/abstract-coder.js";
-import { AddressCoder } from "./coders/address.js";
-import { ArrayCoder } from "./coders/array.js";
-import { BooleanCoder } from "./coders/boolean.js";
-import { BytesCoder } from "./coders/bytes.js";
-import { FixedBytesCoder } from "./coders/fixed-bytes.js";
-import { NullCoder } from "./coders/null.js";
-import { NumberCoder } from "./coders/number.js";
-import { StringCoder } from "./coders/string.js";
-import { TupleCoder } from "./coders/tuple.js";
-import { ParamType } from "./fragments.js";
-
-import { getAddress } from "../address/index.js";
-import { getBytes, hexlify, makeError } from "../utils/index.js";
-
-import type {
-    BytesLike,
-    CallExceptionAction, CallExceptionError, CallExceptionTransaction
-} from "../utils/index.js";
-
-// https://docs.soliditylang.org/en/v0.8.17/control-structures.html
-const PanicReasons: Map<number, string> = new Map();
-PanicReasons.set(0x00, "GENERIC_PANIC");
-PanicReasons.set(0x01, "ASSERT_FALSE");
-PanicReasons.set(0x11, "OVERFLOW");
-PanicReasons.set(0x12, "DIVIDE_BY_ZERO");
-PanicReasons.set(0x21, "ENUM_RANGE_ERROR");
-PanicReasons.set(0x22, "BAD_STORAGE_DATA");
-PanicReasons.set(0x31, "STACK_UNDERFLOW");
-PanicReasons.set(0x32, "ARRAY_RANGE_ERROR");
-PanicReasons.set(0x41, "OUT_OF_MEMORY");
-PanicReasons.set(0x51, "UNINITIALIZED_FUNCTION_CALL");
-
-const paramTypeBytes = new RegExp(/^bytes([0-9]*)$/);
-const paramTypeNumber = new RegExp(/^(u?int)([0-9]*)$/);
-
-
-let defaultCoder: null | AbiCoder = null;
-let defaultMaxInflation = 1024;
-
-function getBuiltinCallException(action: CallExceptionAction, tx: { to?: null | string, from?: null | string, data?: string }, data: null | BytesLike, abiCoder: AbiCoder): CallExceptionError {
-    let message = "missing revert data";
-
-    let reason: null | string = null;
-    const invocation = null;
-    let revert: null | { signature: string, name: string, args: Array<any> } = null;
-
-    if (data) {
-        message = "execution reverted";
-
-        const bytes = getBytes(data);
-        data = hexlify(data);
-
-        if (bytes.length === 0) {
-            message += " (no data present; likely require(false) occurred";
-            reason = "require(false)";
-
-        } else if (bytes.length % 32 !== 4) {
-            message += " (could not decode reason; invalid data length)";
-
-        } else if (hexlify(bytes.slice(0, 4)) === "0x08c379a0") {
-            // Error(string)
-            try {
-                reason = abiCoder.decode([ "string" ], bytes.slice(4))[0]
-                revert = {
-                    signature: "Error(string)",
-                    name: "Error",
-                    args: [ reason ]
-                };
-                message += `: ${ JSON.stringify(reason) }`;
-
-            } catch (error) {
-                message += " (could not decode reason; invalid string data)";
-            }
-
-        } else if (hexlify(bytes.slice(0, 4)) === "0x4e487b71") {
-            // Panic(uint256)
-            try {
-                const code = Number(abiCoder.decode([ "uint256" ], bytes.slice(4))[0]);
-                revert = {
-                    signature: "Panic(uint256)",
-                    name: "Panic",
-                    args: [ code ]
-                };
-                reason = `Panic due to ${ PanicReasons.get(code) || "UNKNOWN" }(${ code })`;
-                message += `: ${ reason }`;
-            } catch (error) {
-                message += " (could not decode panic code)";
-            }
-        } else {
-            message += " (unknown custom error)";
-        }
-    }
-
-    const transaction: CallExceptionTransaction = {
-        to: (tx.to ? getAddress(tx.to): null),
-        data: (tx.data || "0x")
-    };
-    if (tx.from) { transaction.from = getAddress(tx.from); }
-
-    return makeError(message, "CALL_EXCEPTION", {
-        action, data, reason, transaction, invocation, revert
-    });
-}
-
-/**
- *  The **AbiCoder** is a low-level class responsible for encoding JavaScript
- *  values into binary data and decoding binary data into JavaScript values.
- */
-export class AbiCoder {
-
-    #getCoder(param: ParamType): Coder {
-        if (param.isArray()) {
-            return new ArrayCoder(this.#getCoder(param.arrayChildren), param.arrayLength, param.name);
-        }
-
-        if (param.isTuple()) {
-            return new TupleCoder(param.components.map((c) => this.#getCoder(c)), param.name);
-        }
-
-        switch (param.baseType) {
-            case "address":
-                return new AddressCoder(param.name);
-            case "bool":
-                return new BooleanCoder(param.name);
-            case "string":
-                return new StringCoder(param.name);
-            case "bytes":
-                return new BytesCoder(param.name);
-            case "":
-                return new NullCoder(param.name);
-        }
-
-        // u?int[0-9]*
-        let match = param.type.match(paramTypeNumber);
-        if (match) {
-            let size = parseInt(match[2] || "256");
-            assertArgument(size !== 0 && size <= 256 && (size % 8) === 0,
-                "invalid " + match[1] + " bit length", "param", param);
-            return new NumberCoder(size / 8, (match[1] === "int"), param.name);
-        }
-
-        // bytes[0-9]+
-        match = param.type.match(paramTypeBytes);
-        if (match) {
-            let size = parseInt(match[1]);
-            assertArgument(size !== 0 && size <= 32, "invalid bytes length", "param", param);
-            return new FixedBytesCoder(size, param.name);
-        }
-
-        assertArgument(false, "invalid type", "type", param.type);
-    }
-
-    /**
-     *  Get the default values for the given %%types%%.
-     *
-     *  For example, a ``uint`` is by default ``0`` and ``bool``
-     *  is by default ``false``.
-     */
-    getDefaultValue(types: ReadonlyArray<string | ParamType>): Result {
-        const coders: Array<Coder> = types.map((type) => this.#getCoder(ParamType.from(type)));
-        const coder = new TupleCoder(coders, "_");
-        return coder.defaultValue();
-    }
-
-    /**
-     *  Encode the %%values%% as the %%types%% into ABI data.
-     *
-     *  @returns DataHexstring
-     */
-    encode(types: ReadonlyArray<string | ParamType>, values: ReadonlyArray<any>): string {
-        assertArgumentCount(values.length, types.length, "types/values length mismatch");
-
-        const coders = types.map((type) => this.#getCoder(ParamType.from(type)));
-        const coder = (new TupleCoder(coders, "_"));
-
-        const writer = new Writer();
-        coder.encode(writer, values);
-        return writer.data;
-    }
-
-    /**
-     *  Decode the ABI %%data%% as the %%types%% into values.
-     *
-     *  If %%loose%% decoding is enabled, then strict padding is
-     *  not enforced. Some older versions of Solidity incorrectly
-     *  padded event data emitted from ``external`` functions.
-     */
-    decode(types: ReadonlyArray<string | ParamType>, data: BytesLike, loose?: boolean): Result {
-        const coders: Array<Coder> = types.map((type) => this.#getCoder(ParamType.from(type)));
-        const coder = new TupleCoder(coders, "_");
-        return coder.decode(new Reader(data, loose, defaultMaxInflation));
-    }
-
-    static _setDefaultMaxInflation(value: number): void {
-        assertArgument(typeof(value) === "number" && Number.isInteger(value), "invalid defaultMaxInflation factor", "value", value);
-        defaultMaxInflation = value;
-    }
-
-    /**
-     *  Returns the shared singleton instance of a default [[AbiCoder]].
-     *
-     *  On the first call, the instance is created internally.
-     */
-    static defaultAbiCoder(): AbiCoder {
-        if (defaultCoder == null) {
-            defaultCoder = new AbiCoder();
-        }
-        return defaultCoder;
-    }
-
-    /**
-     *  Returns an ethers-compatible [[CallExceptionError]] Error for the given
-     *  result %%data%% for the [[CallExceptionAction]] %%action%% against
-     *  the Transaction %%tx%%.
-     */
-    static getBuiltinCallException(action: CallExceptionAction, tx: { to?: null | string, from?: null | string, data?: string }, data: null | BytesLike): CallExceptionError {
-        return getBuiltinCallException(action, tx, data, AbiCoder.defaultAbiCoder());
-    }
-}
+/**
+ *  When sending values to or receiving values from a [[Contract]], the
+ *  data is generally encoded using the [ABI standard](link-solc-abi).
+ *
+ *  The AbiCoder provides a utility to encode values to ABI data and
+ *  decode values from ABI data.
+ *
+ *  Most of the time, developers should favour the [[Contract]] class,
+ *  which further abstracts a lot of the finer details of ABI data.
+ *
+ *  @_section api/abi/abi-coder:ABI Encoding
+ */
+
+// See: https://github.com/ethereum/wiki/wiki/Ethereum-Contract-ABI
+
+import { assertArgumentCount, assertArgument } from "../utils/index.js";
+
+import { Coder, Reader, Result, Writer } from "./coders/abstract-coder.js";
+import { AddressCoder } from "./coders/address.js";
+import { ArrayCoder } from "./coders/array.js";
+import { BooleanCoder } from "./coders/boolean.js";
+import { BytesCoder } from "./coders/bytes.js";
+import { FixedBytesCoder } from "./coders/fixed-bytes.js";
+import { NullCoder } from "./coders/null.js";
+import { NumberCoder } from "./coders/number.js";
+import { StringCoder } from "./coders/string.js";
+import { TupleCoder } from "./coders/tuple.js";
+import { ParamType } from "./fragments.js";
+
+import { getAddress } from "../address/index.js";
+import { getBytes, hexlify, makeError } from "../utils/index.js";
+
+import type {
+    BytesLike,
+    CallExceptionAction, CallExceptionError, CallExceptionTransaction
+} from "../utils/index.js";
+
+// https://docs.soliditylang.org/en/v0.8.17/control-structures.html
+const PanicReasons: Map<number, string> = new Map();
+PanicReasons.set(0x00, "GENERIC_PANIC");
+PanicReasons.set(0x01, "ASSERT_FALSE");
+PanicReasons.set(0x11, "OVERFLOW");
+PanicReasons.set(0x12, "DIVIDE_BY_ZERO");
+PanicReasons.set(0x21, "ENUM_RANGE_ERROR");
+PanicReasons.set(0x22, "BAD_STORAGE_DATA");
+PanicReasons.set(0x31, "STACK_UNDERFLOW");
+PanicReasons.set(0x32, "ARRAY_RANGE_ERROR");
+PanicReasons.set(0x41, "OUT_OF_MEMORY");
+PanicReasons.set(0x51, "UNINITIALIZED_FUNCTION_CALL");
+
+const paramTypeBytes = new RegExp(/^bytes([0-9]*)$/);
+const paramTypeNumber = new RegExp(/^(u?int)([0-9]*)$/);
+
+
+let defaultCoder: null | AbiCoder = null;
+let defaultMaxInflation = 1024;
+
+function getBuiltinCallException(action: CallExceptionAction, tx: { to?: null | string, from?: null | string, data?: string }, data: null | BytesLike, abiCoder: AbiCoder): CallExceptionError {
+    let message = "missing revert data";
+
+    let reason: null | string = null;
+    const invocation = null;
+    let revert: null | { signature: string, name: string, args: Array<any> } = null;
+
+    if (data) {
+        message = "execution reverted";
+
+        const bytes = getBytes(data);
+        data = hexlify(data);
+
+        if (bytes.length === 0) {
+            message += " (no data present; likely require(false) occurred";
+            reason = "require(false)";
+
+        } else if (bytes.length % 32 !== 4) {
+            message += " (could not decode reason; invalid data length)";
+
+        } else if (hexlify(bytes.slice(0, 4)) === "0x08c379a0") {
+            // Error(string)
+            try {
+                reason = abiCoder.decode([ "string" ], bytes.slice(4))[0]
+                revert = {
+                    signature: "Error(string)",
+                    name: "Error",
+                    args: [ reason ]
+                };
+                message += `: ${ JSON.stringify(reason) }`;
+
+            } catch (error) {
+                message += " (could not decode reason; invalid string data)";
+            }
+
+        } else if (hexlify(bytes.slice(0, 4)) === "0x4e487b71") {
+            // Panic(uint256)
+            try {
+                const code = Number(abiCoder.decode([ "uint256" ], bytes.slice(4))[0]);
+                revert = {
+                    signature: "Panic(uint256)",
+                    name: "Panic",
+                    args: [ code ]
+                };
+                reason = `Panic due to ${ PanicReasons.get(code) || "UNKNOWN" }(${ code })`;
+                message += `: ${ reason }`;
+            } catch (error) {
+                message += " (could not decode panic code)";
+            }
+        } else {
+            message += " (unknown custom error)";
+        }
+    }
+
+    const transaction: CallExceptionTransaction = {
+        to: (tx.to ? getAddress(tx.to): null),
+        data: (tx.data || "0x")
+    };
+    if (tx.from) { transaction.from = getAddress(tx.from); }
+
+    return makeError(message, "CALL_EXCEPTION", {
+        action, data, reason, transaction, invocation, revert
+    });
+}
+
+/**
+ *  The **AbiCoder** is a low-level class responsible for encoding JavaScript
+ *  values into binary data and decoding binary data into JavaScript values.
+ */
+export class AbiCoder {
+
+    #getCoder(param: ParamType): Coder {
+        if (param.isArray()) {
+            return new ArrayCoder(this.#getCoder(param.arrayChildren), param.arrayLength, param.name);
+        }
+
+        if (param.isTuple()) {
+            return new TupleCoder(param.components.map((c) => this.#getCoder(c)), param.name);
+        }
+
+        switch (param.baseType) {
+            case "address":
+                return new AddressCoder(param.name);
+            case "bool":
+                return new BooleanCoder(param.name);
+            case "string":
+                return new StringCoder(param.name);
+            case "bytes":
+                return new BytesCoder(param.name);
+            case "":
+                return new NullCoder(param.name);
+        }
+
+        // u?int[0-9]*
+        let match = param.type.match(paramTypeNumber);
+        if (match) {
+            let size = parseInt(match[2] || "256");
+            assertArgument(size !== 0 && size <= 256 && (size % 8) === 0,
+                "invalid " + match[1] + " bit length", "param", param);
+            return new NumberCoder(size / 8, (match[1] === "int"), param.name);
+        }
+
+        // bytes[0-9]+
+        match = param.type.match(paramTypeBytes);
+        if (match) {
+            let size = parseInt(match[1]);
+            assertArgument(size !== 0 && size <= 32, "invalid bytes length", "param", param);
+            return new FixedBytesCoder(size, param.name);
+        }
+
+        assertArgument(false, "invalid type", "type", param.type);
+    }
+
+    /**
+     *  Get the default values for the given %%types%%.
+     *
+     *  For example, a ``uint`` is by default ``0`` and ``bool``
+     *  is by default ``false``.
+     */
+    getDefaultValue(types: ReadonlyArray<string | ParamType>): Result {
+        const coders: Array<Coder> = types.map((type) => this.#getCoder(ParamType.from(type)));
+        const coder = new TupleCoder(coders, "_");
+        return coder.defaultValue();
+    }
+
+    /**
+     *  Encode the %%values%% as the %%types%% into ABI data.
+     *
+     *  @returns DataHexstring
+     */
+    encode(types: ReadonlyArray<string | ParamType>, values: ReadonlyArray<any>): string {
+        assertArgumentCount(values.length, types.length, "types/values length mismatch");
+
+        const coders = types.map((type) => this.#getCoder(ParamType.from(type)));
+        const coder = (new TupleCoder(coders, "_"));
+
+        const writer = new Writer();
+        coder.encode(writer, values);
+        return writer.data;
+    }
+
+    /**
+     *  Decode the ABI %%data%% as the %%types%% into values.
+     *
+     *  If %%loose%% decoding is enabled, then strict padding is
+     *  not enforced. Some older versions of Solidity incorrectly
+     *  padded event data emitted from ``external`` functions.
+     */
+    decode(types: ReadonlyArray<string | ParamType>, data: BytesLike, loose?: boolean): Result {
+        const coders: Array<Coder> = types.map((type) => this.#getCoder(ParamType.from(type)));
+        const coder = new TupleCoder(coders, "_");
+        return coder.decode(new Reader(data, loose, defaultMaxInflation));
+    }
+
+    static _setDefaultMaxInflation(value: number): void {
+        assertArgument(typeof(value) === "number" && Number.isInteger(value), "invalid defaultMaxInflation factor", "value", value);
+        defaultMaxInflation = value;
+    }
+
+    /**
+     *  Returns the shared singleton instance of a default [[AbiCoder]].
+     *
+     *  On the first call, the instance is created internally.
+     */
+    static defaultAbiCoder(): AbiCoder {
+        if (defaultCoder == null) {
+            defaultCoder = new AbiCoder();
+        }
+        return defaultCoder;
+    }
+
+    /**
+     *  Returns an ethers-compatible [[CallExceptionError]] Error for the given
+     *  result %%data%% for the [[CallExceptionAction]] %%action%% against
+     *  the Transaction %%tx%%.
+     */
+    static getBuiltinCallException(action: CallExceptionAction, tx: { to?: null | string, from?: null | string, data?: string }, data: null | BytesLike): CallExceptionError {
+        return getBuiltinCallException(action, tx, data, AbiCoder.defaultAbiCoder());
+    }
+}