@qevm/logger 5.7.1

package/README.md

@@ -0,0 +1,34 @@
+Logger
+======
+
+This sub-module is part of the qethers project, a fork of [ethers project](https://github.com/ethers-io/ethers.js).
+
+It is responsible for managing logging and errors to maintain a standard
+structure.
+
+
+Importing
+---------
+
+Most users will prefer to use the [umbrella package](https://www.npmjs.com/package/@qevm/qethers),
+but for those with more specific needs, individual components can be imported.
+
+```javascript
+const {
+
+    Logger,
+
+    // Enums
+
+    ErrorCode,
+
+    LogLevel,
+
+} = require("@qevm/logger");
+```
+
+
+License
+-------
+
+MIT License.

package/lib/_version.d.ts

@@ -0,0 +1,2 @@
+export declare const version = "logger/5.7.1";
+//# sourceMappingURL=_version.d.ts.map

package/lib/_version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_version.d.ts","sourceRoot":"","sources":["../src.ts/_version.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,OAAO,iBAAiB,CAAC"}

package/lib/_version.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.version = void 0;
+exports.version = "logger/5.7.1";
+//# sourceMappingURL=_version.js.map

package/lib/_version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_version.js","sourceRoot":"","sources":["../src.ts/_version.ts"],"names":[],"mappings":";;;AAAa,QAAA,OAAO,GAAG,cAAc,CAAC"}

package/lib/index.d.ts

@@ -0,0 +1,53 @@
+export declare enum LogLevel {
+    DEBUG = "DEBUG",
+    INFO = "INFO",
+    WARNING = "WARNING",
+    ERROR = "ERROR",
+    OFF = "OFF"
+}
+export declare enum ErrorCode {
+    UNKNOWN_ERROR = "UNKNOWN_ERROR",
+    NOT_IMPLEMENTED = "NOT_IMPLEMENTED",
+    UNSUPPORTED_OPERATION = "UNSUPPORTED_OPERATION",
+    NETWORK_ERROR = "NETWORK_ERROR",
+    SERVER_ERROR = "SERVER_ERROR",
+    TIMEOUT = "TIMEOUT",
+    BUFFER_OVERRUN = "BUFFER_OVERRUN",
+    NUMERIC_FAULT = "NUMERIC_FAULT",
+    MISSING_NEW = "MISSING_NEW",
+    INVALID_ARGUMENT = "INVALID_ARGUMENT",
+    MISSING_ARGUMENT = "MISSING_ARGUMENT",
+    UNEXPECTED_ARGUMENT = "UNEXPECTED_ARGUMENT",
+    CALL_EXCEPTION = "CALL_EXCEPTION",
+    INSUFFICIENT_FUNDS = "INSUFFICIENT_FUNDS",
+    NONCE_EXPIRED = "NONCE_EXPIRED",
+    REPLACEMENT_UNDERPRICED = "REPLACEMENT_UNDERPRICED",
+    UNPREDICTABLE_GAS_LIMIT = "UNPREDICTABLE_GAS_LIMIT",
+    TRANSACTION_REPLACED = "TRANSACTION_REPLACED",
+    ACTION_REJECTED = "ACTION_REJECTED"
+}
+export declare class Logger {
+    readonly version: string;
+    static errors: typeof ErrorCode;
+    static levels: typeof LogLevel;
+    constructor(version: string);
+    _log(logLevel: LogLevel, args: Array<any>): void;
+    debug(...args: Array<any>): void;
+    info(...args: Array<any>): void;
+    warn(...args: Array<any>): void;
+    makeError(message: string, code?: ErrorCode, params?: any): Error;
+    throwError(message: string, code?: ErrorCode, params?: any): never;
+    throwArgumentError(message: string, name: string, value: any): never;
+    assert(condition: any, message: string, code?: ErrorCode, params?: any): void;
+    assertArgument(condition: any, message: string, name: string, value: any): void;
+    checkNormalize(message?: string): void;
+    checkSafeUint53(value: number, message?: string): void;
+    checkArgumentCount(count: number, expectedCount: number, message?: string): void;
+    checkNew(target: any, kind: any): void;
+    checkAbstract(target: any, kind: any): void;
+    static globalLogger(): Logger;
+    static setCensorship(censorship: boolean, permanent?: boolean): void;
+    static setLogLevel(logLevel: LogLevel): void;
+    static from(version: string): Logger;
+}
+//# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src.ts/index.ts"],"names":[],"mappings":"AAqDA,oBAAY,QAAQ;IAChB,KAAK,UAAU;IACf,IAAI,SAAS;IACb,OAAO,YAAY;IACnB,KAAK,UAAU;IACf,GAAG,QAAQ;CACd;AAED,oBAAY,SAAS;IAKjB,aAAa,kBAAkB;IAG/B,eAAe,oBAAoB;IAInC,qBAAqB,0BAA0B;IAI/C,aAAa,kBAAkB;IAG/B,YAAY,iBAAiB;IAG7B,OAAO,YAAY;IAMnB,cAAc,mBAAmB;IAKjC,aAAa,kBAAkB;IAO/B,WAAW,gBAAgB;IAK3B,gBAAgB,qBAAqB;IAKrC,gBAAgB,qBAAqB;IAKrC,mBAAmB,wBAAwB;IAa3C,cAAc,mBAAmB;IAIjC,kBAAkB,uBAAuB;IAIzC,aAAa,kBAAkB;IAI/B,uBAAuB,4BAA4B;IAInD,uBAAuB,4BAA4B;IAQnD,oBAAoB,yBAAyB;IAO7C,eAAe,oBAAoB;CACtC;AAID,qBAAa,MAAM;IACf,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAEzB,MAAM,CAAC,MAAM,mBAAa;IAE1B,MAAM,CAAC,MAAM,kBAAY;gBAEb,OAAO,EAAE,MAAM;IAQ3B,IAAI,CAAC,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,CAAC,GAAG,CAAC,GAAG,IAAI;IAehD,KAAK,CAAC,GAAG,IAAI,EAAE,KAAK,CAAC,GAAG,CAAC,GAAG,IAAI;IAIhC,IAAI,CAAC,GAAG,IAAI,EAAE,KAAK,CAAC,GAAG,CAAC,GAAG,IAAI;IAI/B,IAAI,CAAC,GAAG,IAAI,EAAE,KAAK,CAAC,GAAG,CAAC,GAAG,IAAI;IAI/B,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,SAAS,EAAE,MAAM,CAAC,EAAE,GAAG,GAAG,KAAK;IA6FjE,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,SAAS,EAAE,MAAM,CAAC,EAAE,GAAG,GAAG,KAAK;IAIlE,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,KAAK;IAOpE,MAAM,CACF,SAAS,EAAE,GAAG,EACd,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE,SAAS,EAChB,MAAM,CAAC,EAAE,GAAG,GACb,IAAI;IAOP,cAAc,CACV,SAAS,EAAE,GAAG,EACd,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,GAAG,GACX,IAAI;IAOP,cAAc,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI;IAgBtC,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI;IA0BtD,kBAAkB,CACd,KAAK,EAAE,MAAM,EACb,aAAa,EAAE,MAAM,EACrB,OAAO,CAAC,EAAE,MAAM,GACjB,IAAI;IA8BP,QAAQ,CAAC,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,GAAG,IAAI;IAQtC,aAAa,CAAC,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,GAAG,IAAI;IAgB3C,MAAM,CAAC,YAAY,IAAI,MAAM;IAO7B,MAAM,CAAC,aAAa,CAAC,UAAU,EAAE,OAAO,EAAE,SAAS,CAAC,EAAE,OAAO,GAAG,IAAI;IA4BpE,MAAM,CAAC,WAAW,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI;IAS5C,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;CAGvC"}

package/lib/index.js

@@ -0,0 +1,372 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Logger = exports.ErrorCode = exports.LogLevel = void 0;
+let _permanentCensorErrors = false;
+let _censorErrors = false;
+const LogLevels = {
+    debug: 1,
+    default: 2,
+    info: 2,
+    warning: 3,
+    error: 4,
+    off: 5,
+};
+let _logLevel = LogLevels["default"];
+const _version_1 = require("./_version");
+let _globalLogger = null;
+function _checkNormalize() {
+    try {
+        const missing = [];
+        // Make sure all forms of normalization are supported
+        ["NFD", "NFC", "NFKD", "NFKC"].forEach((form) => {
+            try {
+                if ("test".normalize(form) !== "test") {
+                    throw new Error("bad normalize");
+                }
+            }
+            catch (error) {
+                missing.push(form);
+            }
+        });
+        if (missing.length) {
+            throw new Error("missing " + missing.join(", "));
+        }
+        if (String.fromCharCode(0xe9).normalize("NFD") !==
+            String.fromCharCode(0x65, 0x0301)) {
+            throw new Error("broken implementation");
+        }
+    }
+    catch (error) {
+        return error.message;
+    }
+    return null;
+}
+const _normalizeError = _checkNormalize();
+var LogLevel;
+(function (LogLevel) {
+    LogLevel["DEBUG"] = "DEBUG";
+    LogLevel["INFO"] = "INFO";
+    LogLevel["WARNING"] = "WARNING";
+    LogLevel["ERROR"] = "ERROR";
+    LogLevel["OFF"] = "OFF";
+})(LogLevel || (exports.LogLevel = LogLevel = {}));
+var ErrorCode;
+(function (ErrorCode) {
+    ///////////////////
+    // Generic Errors
+    // Unknown Error
+    ErrorCode["UNKNOWN_ERROR"] = "UNKNOWN_ERROR";
+    // Not Implemented
+    ErrorCode["NOT_IMPLEMENTED"] = "NOT_IMPLEMENTED";
+    // Unsupported Operation
+    //   - operation
+    ErrorCode["UNSUPPORTED_OPERATION"] = "UNSUPPORTED_OPERATION";
+    // Network Error (i.e. Ethereum Network, such as an invalid chain ID)
+    //   - event ("noNetwork" is not re-thrown in provider.ready; otherwise thrown)
+    ErrorCode["NETWORK_ERROR"] = "NETWORK_ERROR";
+    // Some sort of bad response from the server
+    ErrorCode["SERVER_ERROR"] = "SERVER_ERROR";
+    // Timeout
+    ErrorCode["TIMEOUT"] = "TIMEOUT";
+    ///////////////////
+    // Operational  Errors
+    // Buffer Overrun
+    ErrorCode["BUFFER_OVERRUN"] = "BUFFER_OVERRUN";
+    // Numeric Fault
+    //   - operation: the operation being executed
+    //   - fault: the reason this faulted
+    ErrorCode["NUMERIC_FAULT"] = "NUMERIC_FAULT";
+    ///////////////////
+    // Argument Errors
+    // Missing new operator to an object
+    //  - name: The name of the class
+    ErrorCode["MISSING_NEW"] = "MISSING_NEW";
+    // Invalid argument (e.g. value is incompatible with type) to a function:
+    //   - argument: The argument name that was invalid
+    //   - value: The value of the argument
+    ErrorCode["INVALID_ARGUMENT"] = "INVALID_ARGUMENT";
+    // Missing argument to a function:
+    //   - count: The number of arguments received
+    //   - expectedCount: The number of arguments expected
+    ErrorCode["MISSING_ARGUMENT"] = "MISSING_ARGUMENT";
+    // Too many arguments
+    //   - count: The number of arguments received
+    //   - expectedCount: The number of arguments expected
+    ErrorCode["UNEXPECTED_ARGUMENT"] = "UNEXPECTED_ARGUMENT";
+    ///////////////////
+    // Blockchain Errors
+    // Call exception
+    //  - transaction: the transaction
+    //  - address?: the contract address
+    //  - args?: The arguments passed into the function
+    //  - method?: The Solidity method signature
+    //  - errorSignature?: The EIP848 error signature
+    //  - errorArgs?: The EIP848 error parameters
+    //  - reason: The reason (only for EIP848 "Error(string)")
+    ErrorCode["CALL_EXCEPTION"] = "CALL_EXCEPTION";
+    // Insufficient funds (< value + gasLimit * gasPrice)
+    //   - transaction: the transaction attempted
+    ErrorCode["INSUFFICIENT_FUNDS"] = "INSUFFICIENT_FUNDS";
+    // Nonce has already been used
+    //   - transaction: the transaction attempted
+    ErrorCode["NONCE_EXPIRED"] = "NONCE_EXPIRED";
+    // The replacement fee for the transaction is too low
+    //   - transaction: the transaction attempted
+    ErrorCode["REPLACEMENT_UNDERPRICED"] = "REPLACEMENT_UNDERPRICED";
+    // The gas limit could not be estimated
+    //   - transaction: the transaction passed to estimateGas
+    ErrorCode["UNPREDICTABLE_GAS_LIMIT"] = "UNPREDICTABLE_GAS_LIMIT";
+    // The transaction was replaced by one with a higher gas price
+    //   - reason: "cancelled", "replaced" or "repriced"
+    //   - cancelled: true if reason == "cancelled" or reason == "replaced")
+    //   - hash: original transaction hash
+    //   - replacement: the full TransactionsResponse for the replacement
+    //   - receipt: the receipt of the replacement
+    ErrorCode["TRANSACTION_REPLACED"] = "TRANSACTION_REPLACED";
+    ///////////////////
+    // Interaction Errors
+    // The user rejected the action, such as signing a message or sending
+    // a transaction
+    ErrorCode["ACTION_REJECTED"] = "ACTION_REJECTED";
+})(ErrorCode || (exports.ErrorCode = ErrorCode = {}));
+const HEX = "0123456789abcdef";
+class Logger {
+    constructor(version) {
+        Object.defineProperty(this, "version", {
+            enumerable: true,
+            value: version,
+            writable: false,
+        });
+    }
+    _log(logLevel, args) {
+        const level = logLevel.toLowerCase();
+        if (LogLevels[level] == null) {
+            this.throwArgumentError("invalid log level name", "logLevel", logLevel);
+        }
+        if (_logLevel > LogLevels[level]) {
+            return;
+        }
+        console.log.apply(console, args);
+    }
+    debug(...args) {
+        this._log(Logger.levels.DEBUG, args);
+    }
+    info(...args) {
+        this._log(Logger.levels.INFO, args);
+    }
+    warn(...args) {
+        this._log(Logger.levels.WARNING, args);
+    }
+    makeError(message, code, params) {
+        // Errors are being censored
+        if (_censorErrors) {
+            return this.makeError("censored error", code, {});
+        }
+        if (!code) {
+            code = Logger.errors.UNKNOWN_ERROR;
+        }
+        if (!params) {
+            params = {};
+        }
+        const messageDetails = [];
+        Object.keys(params).forEach((key) => {
+            const value = params[key];
+            try {
+                if (value instanceof Uint8Array) {
+                    let hex = "";
+                    for (let i = 0; i < value.length; i++) {
+                        hex += HEX[value[i] >> 4];
+                        hex += HEX[value[i] & 0x0f];
+                    }
+                    messageDetails.push(key + "=Uint8Array(0x" + hex + ")");
+                }
+                else {
+                    messageDetails.push(key + "=" + JSON.stringify(value));
+                }
+            }
+            catch (error) {
+                messageDetails.push(key + "=" + JSON.stringify(params[key].toString()));
+            }
+        });
+        messageDetails.push(`code=${code}`);
+        messageDetails.push(`version=${this.version}`);
+        const reason = message;
+        let url = "";
+        switch (code) {
+            case ErrorCode.NUMERIC_FAULT: {
+                url = "NUMERIC_FAULT";
+                const fault = message;
+                switch (fault) {
+                    case "overflow":
+                    case "underflow":
+                    case "division-by-zero":
+                        url += "-" + fault;
+                        break;
+                    case "negative-power":
+                    case "negative-width":
+                        url += "-unsupported";
+                        break;
+                    case "unbound-bitwise-result":
+                        url += "-unbound-result";
+                        break;
+                }
+                break;
+            }
+            case ErrorCode.CALL_EXCEPTION:
+            case ErrorCode.INSUFFICIENT_FUNDS:
+            case ErrorCode.MISSING_NEW:
+            case ErrorCode.NONCE_EXPIRED:
+            case ErrorCode.REPLACEMENT_UNDERPRICED:
+            case ErrorCode.TRANSACTION_REPLACED:
+            case ErrorCode.UNPREDICTABLE_GAS_LIMIT:
+                url = code;
+                break;
+        }
+        if (url) {
+            message +=
+                " [ See: https:/\/links.ethers.org/v5-errors-" + url + " ]";
+        }
+        if (messageDetails.length) {
+            message += " (" + messageDetails.join(", ") + ")";
+        }
+        // @TODO: Any??
+        const error = new Error(message);
+        error.reason = reason;
+        error.code = code;
+        Object.keys(params).forEach(function (key) {
+            error[key] = params[key];
+        });
+        return error;
+    }
+    throwError(message, code, params) {
+        throw this.makeError(message, code, params);
+    }
+    throwArgumentError(message, name, value) {
+        return this.throwError(message, Logger.errors.INVALID_ARGUMENT, {
+            argument: name,
+            value: value,
+        });
+    }
+    assert(condition, message, code, params) {
+        if (!!condition) {
+            return;
+        }
+        this.throwError(message, code, params);
+    }
+    assertArgument(condition, message, name, value) {
+        if (!!condition) {
+            return;
+        }
+        this.throwArgumentError(message, name, value);
+    }
+    checkNormalize(message) {
+        if (message == null) {
+            message = "platform missing String.prototype.normalize";
+        }
+        if (_normalizeError) {
+            this.throwError("platform missing String.prototype.normalize", Logger.errors.UNSUPPORTED_OPERATION, {
+                operation: "String.prototype.normalize",
+                form: _normalizeError,
+            });
+        }
+    }
+    checkSafeUint53(value, message) {
+        if (typeof value !== "number") {
+            return;
+        }
+        if (message == null) {
+            message = "value not safe";
+        }
+        if (value < 0 || value >= 0x1fffffffffffff) {
+            this.throwError(message, Logger.errors.NUMERIC_FAULT, {
+                operation: "checkSafeInteger",
+                fault: "out-of-safe-range",
+                value: value,
+            });
+        }
+        if (value % 1) {
+            this.throwError(message, Logger.errors.NUMERIC_FAULT, {
+                operation: "checkSafeInteger",
+                fault: "non-integer",
+                value: value,
+            });
+        }
+    }
+    checkArgumentCount(count, expectedCount, message) {
+        if (message) {
+            message = ": " + message;
+        }
+        else {
+            message = "";
+        }
+        if (count < expectedCount) {
+            this.throwError("missing argument" + message, Logger.errors.MISSING_ARGUMENT, {
+                count: count,
+                expectedCount: expectedCount,
+            });
+        }
+        if (count > expectedCount) {
+            this.throwError("too many arguments" + message, Logger.errors.UNEXPECTED_ARGUMENT, {
+                count: count,
+                expectedCount: expectedCount,
+            });
+        }
+    }
+    checkNew(target, kind) {
+        if (target === Object || target == null) {
+            this.throwError("missing new", Logger.errors.MISSING_NEW, {
+                name: kind.name,
+            });
+        }
+    }
+    checkAbstract(target, kind) {
+        if (target === kind) {
+            this.throwError("cannot instantiate abstract class " +
+                JSON.stringify(kind.name) +
+                " directly; use a sub-class", Logger.errors.UNSUPPORTED_OPERATION, { name: target.name, operation: "new" });
+        }
+        else if (target === Object || target == null) {
+            this.throwError("missing new", Logger.errors.MISSING_NEW, {
+                name: kind.name,
+            });
+        }
+    }
+    static globalLogger() {
+        if (!_globalLogger) {
+            _globalLogger = new Logger(_version_1.version);
+        }
+        return _globalLogger;
+    }
+    static setCensorship(censorship, permanent) {
+        if (!censorship && permanent) {
+            this.globalLogger().throwError("cannot permanently disable censorship", Logger.errors.UNSUPPORTED_OPERATION, {
+                operation: "setCensorship",
+            });
+        }
+        if (_permanentCensorErrors) {
+            if (!censorship) {
+                return;
+            }
+            this.globalLogger().throwError("error censorship permanent", Logger.errors.UNSUPPORTED_OPERATION, {
+                operation: "setCensorship",
+            });
+        }
+        _censorErrors = !!censorship;
+        _permanentCensorErrors = !!permanent;
+    }
+    static setLogLevel(logLevel) {
+        const level = LogLevels[logLevel.toLowerCase()];
+        if (level == null) {
+            Logger.globalLogger().warn("invalid log level - " + logLevel);
+            return;
+        }
+        _logLevel = level;
+    }
+    static from(version) {
+        return new Logger(version);
+    }
+}
+exports.Logger = Logger;
+Logger.errors = ErrorCode;
+Logger.levels = LogLevel;
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

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

package/package.json

@@ -0,0 +1,27 @@
+{
+    "contributors": [
+        "Eugene Kuleshov <kulevgen32@gmail.com>",
+        "Richard Moore <me@ricmoo.com>"
+    ],
+    "dependencies": {},
+    "description": "Logger utility functions for qethers.",
+    "keywords": [
+        "QEVM",
+        "QuantumEVM",
+        "qethers"
+    ],
+    "license": "MIT",
+    "main": "./lib/index.js",
+    "module": "./lib.esm/index.js",
+    "name": "@qevm/logger",
+    "publishConfig": {
+        "access": "public"
+    },
+    "scripts": {
+        "test": "echo \"Error: no test specified\" && exit 1"
+    },
+    "sideEffects": false,
+    "tarballHash": "0x0e4fe629df0eded870b7750df05006454d92ebaa1c57279e846f5c41c131b816",
+    "types": "./lib/index.d.ts",
+    "version": "5.7.1"
+}

package/src.ts/_version.ts

@@ -0,0 +1 @@
+export const version = "logger/5.7.1";

package/src.ts/index.ts

@@ -0,0 +1,483 @@
+"use strict";
+
+let _permanentCensorErrors = false;
+let _censorErrors = false;
+
+const LogLevels: { [name: string]: number } = {
+    debug: 1,
+    default: 2,
+    info: 2,
+    warning: 3,
+    error: 4,
+    off: 5,
+};
+let _logLevel = LogLevels["default"];
+
+import { version } from "./_version";
+
+let _globalLogger: Logger = null;
+
+function _checkNormalize(): string {
+    try {
+        const missing: Array<string> = [];
+
+        // Make sure all forms of normalization are supported
+        ["NFD", "NFC", "NFKD", "NFKC"].forEach((form) => {
+            try {
+                if ("test".normalize(form) !== "test") {
+                    throw new Error("bad normalize");
+                }
+            } catch (error) {
+                missing.push(form);
+            }
+        });
+
+        if (missing.length) {
+            throw new Error("missing " + missing.join(", "));
+        }
+
+        if (
+            String.fromCharCode(0xe9).normalize("NFD") !==
+            String.fromCharCode(0x65, 0x0301)
+        ) {
+            throw new Error("broken implementation");
+        }
+    } catch (error) {
+        return error.message;
+    }
+
+    return null;
+}
+
+const _normalizeError = _checkNormalize();
+
+export enum LogLevel {
+    DEBUG = "DEBUG",
+    INFO = "INFO",
+    WARNING = "WARNING",
+    ERROR = "ERROR",
+    OFF = "OFF",
+}
+
+export enum ErrorCode {
+    ///////////////////
+    // Generic Errors
+
+    // Unknown Error
+    UNKNOWN_ERROR = "UNKNOWN_ERROR",
+
+    // Not Implemented
+    NOT_IMPLEMENTED = "NOT_IMPLEMENTED",
+
+    // Unsupported Operation
+    //   - operation
+    UNSUPPORTED_OPERATION = "UNSUPPORTED_OPERATION",
+
+    // Network Error (i.e. Ethereum Network, such as an invalid chain ID)
+    //   - event ("noNetwork" is not re-thrown in provider.ready; otherwise thrown)
+    NETWORK_ERROR = "NETWORK_ERROR",
+
+    // Some sort of bad response from the server
+    SERVER_ERROR = "SERVER_ERROR",
+
+    // Timeout
+    TIMEOUT = "TIMEOUT",
+
+    ///////////////////
+    // Operational  Errors
+
+    // Buffer Overrun
+    BUFFER_OVERRUN = "BUFFER_OVERRUN",
+
+    // Numeric Fault
+    //   - operation: the operation being executed
+    //   - fault: the reason this faulted
+    NUMERIC_FAULT = "NUMERIC_FAULT",
+
+    ///////////////////
+    // Argument Errors
+
+    // Missing new operator to an object
+    //  - name: The name of the class
+    MISSING_NEW = "MISSING_NEW",
+
+    // Invalid argument (e.g. value is incompatible with type) to a function:
+    //   - argument: The argument name that was invalid
+    //   - value: The value of the argument
+    INVALID_ARGUMENT = "INVALID_ARGUMENT",
+
+    // Missing argument to a function:
+    //   - count: The number of arguments received
+    //   - expectedCount: The number of arguments expected
+    MISSING_ARGUMENT = "MISSING_ARGUMENT",
+
+    // Too many arguments
+    //   - count: The number of arguments received
+    //   - expectedCount: The number of arguments expected
+    UNEXPECTED_ARGUMENT = "UNEXPECTED_ARGUMENT",
+
+    ///////////////////
+    // Blockchain Errors
+
+    // Call exception
+    //  - transaction: the transaction
+    //  - address?: the contract address
+    //  - args?: The arguments passed into the function
+    //  - method?: The Solidity method signature
+    //  - errorSignature?: The EIP848 error signature
+    //  - errorArgs?: The EIP848 error parameters
+    //  - reason: The reason (only for EIP848 "Error(string)")
+    CALL_EXCEPTION = "CALL_EXCEPTION",
+
+    // Insufficient funds (< value + gasLimit * gasPrice)
+    //   - transaction: the transaction attempted
+    INSUFFICIENT_FUNDS = "INSUFFICIENT_FUNDS",
+
+    // Nonce has already been used
+    //   - transaction: the transaction attempted
+    NONCE_EXPIRED = "NONCE_EXPIRED",
+
+    // The replacement fee for the transaction is too low
+    //   - transaction: the transaction attempted
+    REPLACEMENT_UNDERPRICED = "REPLACEMENT_UNDERPRICED",
+
+    // The gas limit could not be estimated
+    //   - transaction: the transaction passed to estimateGas
+    UNPREDICTABLE_GAS_LIMIT = "UNPREDICTABLE_GAS_LIMIT",
+
+    // The transaction was replaced by one with a higher gas price
+    //   - reason: "cancelled", "replaced" or "repriced"
+    //   - cancelled: true if reason == "cancelled" or reason == "replaced")
+    //   - hash: original transaction hash
+    //   - replacement: the full TransactionsResponse for the replacement
+    //   - receipt: the receipt of the replacement
+    TRANSACTION_REPLACED = "TRANSACTION_REPLACED",
+
+    ///////////////////
+    // Interaction Errors
+
+    // The user rejected the action, such as signing a message or sending
+    // a transaction
+    ACTION_REJECTED = "ACTION_REJECTED",
+}
+
+const HEX = "0123456789abcdef";
+
+export class Logger {
+    readonly version: string;
+
+    static errors = ErrorCode;
+
+    static levels = LogLevel;
+
+    constructor(version: string) {
+        Object.defineProperty(this, "version", {
+            enumerable: true,
+            value: version,
+            writable: false,
+        });
+    }
+
+    _log(logLevel: LogLevel, args: Array<any>): void {
+        const level = logLevel.toLowerCase();
+        if (LogLevels[level] == null) {
+            this.throwArgumentError(
+                "invalid log level name",
+                "logLevel",
+                logLevel,
+            );
+        }
+        if (_logLevel > LogLevels[level]) {
+            return;
+        }
+        console.log.apply(console, args);
+    }
+
+    debug(...args: Array<any>): void {
+        this._log(Logger.levels.DEBUG, args);
+    }
+
+    info(...args: Array<any>): void {
+        this._log(Logger.levels.INFO, args);
+    }
+
+    warn(...args: Array<any>): void {
+        this._log(Logger.levels.WARNING, args);
+    }
+
+    makeError(message: string, code?: ErrorCode, params?: any): Error {
+        // Errors are being censored
+        if (_censorErrors) {
+            return this.makeError("censored error", code, {});
+        }
+
+        if (!code) {
+            code = Logger.errors.UNKNOWN_ERROR;
+        }
+        if (!params) {
+            params = {};
+        }
+
+        const messageDetails: Array<string> = [];
+        Object.keys(params).forEach((key) => {
+            const value = params[key];
+            try {
+                if (value instanceof Uint8Array) {
+                    let hex = "";
+                    for (let i = 0; i < value.length; i++) {
+                        hex += HEX[value[i] >> 4];
+                        hex += HEX[value[i] & 0x0f];
+                    }
+                    messageDetails.push(key + "=Uint8Array(0x" + hex + ")");
+                } else {
+                    messageDetails.push(key + "=" + JSON.stringify(value));
+                }
+            } catch (error) {
+                messageDetails.push(
+                    key + "=" + JSON.stringify(params[key].toString()),
+                );
+            }
+        });
+        messageDetails.push(`code=${code}`);
+        messageDetails.push(`version=${this.version}`);
+
+        const reason = message;
+
+        let url = "";
+
+        switch (code) {
+            case ErrorCode.NUMERIC_FAULT: {
+                url = "NUMERIC_FAULT";
+                const fault = message;
+
+                switch (fault) {
+                    case "overflow":
+                    case "underflow":
+                    case "division-by-zero":
+                        url += "-" + fault;
+                        break;
+                    case "negative-power":
+                    case "negative-width":
+                        url += "-unsupported";
+                        break;
+                    case "unbound-bitwise-result":
+                        url += "-unbound-result";
+                        break;
+                }
+                break;
+            }
+            case ErrorCode.CALL_EXCEPTION:
+            case ErrorCode.INSUFFICIENT_FUNDS:
+            case ErrorCode.MISSING_NEW:
+            case ErrorCode.NONCE_EXPIRED:
+            case ErrorCode.REPLACEMENT_UNDERPRICED:
+            case ErrorCode.TRANSACTION_REPLACED:
+            case ErrorCode.UNPREDICTABLE_GAS_LIMIT:
+                url = code;
+                break;
+        }
+
+        if (url) {
+            message +=
+                " [ See: https:/\/links.ethers.org/v5-errors-" + url + " ]";
+        }
+
+        if (messageDetails.length) {
+            message += " (" + messageDetails.join(", ") + ")";
+        }
+
+        // @TODO: Any??
+        const error: any = new Error(message);
+        error.reason = reason;
+        error.code = code;
+
+        Object.keys(params).forEach(function (key) {
+            error[key] = params[key];
+        });
+
+        return error;
+    }
+
+    throwError(message: string, code?: ErrorCode, params?: any): never {
+        throw this.makeError(message, code, params);
+    }
+
+    throwArgumentError(message: string, name: string, value: any): never {
+        return this.throwError(message, Logger.errors.INVALID_ARGUMENT, {
+            argument: name,
+            value: value,
+        });
+    }
+
+    assert(
+        condition: any,
+        message: string,
+        code?: ErrorCode,
+        params?: any,
+    ): void {
+        if (!!condition) {
+            return;
+        }
+        this.throwError(message, code, params);
+    }
+
+    assertArgument(
+        condition: any,
+        message: string,
+        name: string,
+        value: any,
+    ): void {
+        if (!!condition) {
+            return;
+        }
+        this.throwArgumentError(message, name, value);
+    }
+
+    checkNormalize(message?: string): void {
+        if (message == null) {
+            message = "platform missing String.prototype.normalize";
+        }
+        if (_normalizeError) {
+            this.throwError(
+                "platform missing String.prototype.normalize",
+                Logger.errors.UNSUPPORTED_OPERATION,
+                {
+                    operation: "String.prototype.normalize",
+                    form: _normalizeError,
+                },
+            );
+        }
+    }
+
+    checkSafeUint53(value: number, message?: string): void {
+        if (typeof value !== "number") {
+            return;
+        }
+
+        if (message == null) {
+            message = "value not safe";
+        }
+
+        if (value < 0 || value >= 0x1fffffffffffff) {
+            this.throwError(message, Logger.errors.NUMERIC_FAULT, {
+                operation: "checkSafeInteger",
+                fault: "out-of-safe-range",
+                value: value,
+            });
+        }
+
+        if (value % 1) {
+            this.throwError(message, Logger.errors.NUMERIC_FAULT, {
+                operation: "checkSafeInteger",
+                fault: "non-integer",
+                value: value,
+            });
+        }
+    }
+
+    checkArgumentCount(
+        count: number,
+        expectedCount: number,
+        message?: string,
+    ): void {
+        if (message) {
+            message = ": " + message;
+        } else {
+            message = "";
+        }
+
+        if (count < expectedCount) {
+            this.throwError(
+                "missing argument" + message,
+                Logger.errors.MISSING_ARGUMENT,
+                {
+                    count: count,
+                    expectedCount: expectedCount,
+                },
+            );
+        }
+
+        if (count > expectedCount) {
+            this.throwError(
+                "too many arguments" + message,
+                Logger.errors.UNEXPECTED_ARGUMENT,
+                {
+                    count: count,
+                    expectedCount: expectedCount,
+                },
+            );
+        }
+    }
+
+    checkNew(target: any, kind: any): void {
+        if (target === Object || target == null) {
+            this.throwError("missing new", Logger.errors.MISSING_NEW, {
+                name: kind.name,
+            });
+        }
+    }
+
+    checkAbstract(target: any, kind: any): void {
+        if (target === kind) {
+            this.throwError(
+                "cannot instantiate abstract class " +
+                    JSON.stringify(kind.name) +
+                    " directly; use a sub-class",
+                Logger.errors.UNSUPPORTED_OPERATION,
+                { name: target.name, operation: "new" },
+            );
+        } else if (target === Object || target == null) {
+            this.throwError("missing new", Logger.errors.MISSING_NEW, {
+                name: kind.name,
+            });
+        }
+    }
+
+    static globalLogger(): Logger {
+        if (!_globalLogger) {
+            _globalLogger = new Logger(version);
+        }
+        return _globalLogger;
+    }
+
+    static setCensorship(censorship: boolean, permanent?: boolean): void {
+        if (!censorship && permanent) {
+            this.globalLogger().throwError(
+                "cannot permanently disable censorship",
+                Logger.errors.UNSUPPORTED_OPERATION,
+                {
+                    operation: "setCensorship",
+                },
+            );
+        }
+
+        if (_permanentCensorErrors) {
+            if (!censorship) {
+                return;
+            }
+            this.globalLogger().throwError(
+                "error censorship permanent",
+                Logger.errors.UNSUPPORTED_OPERATION,
+                {
+                    operation: "setCensorship",
+                },
+            );
+        }
+
+        _censorErrors = !!censorship;
+        _permanentCensorErrors = !!permanent;
+    }
+
+    static setLogLevel(logLevel: LogLevel): void {
+        const level = LogLevels[logLevel.toLowerCase()];
+        if (level == null) {
+            Logger.globalLogger().warn("invalid log level - " + logLevel);
+            return;
+        }
+        _logLevel = level;
+    }
+
+    static from(version: string): Logger {
+        return new Logger(version);
+    }
+}