255 lines
8.5 KiB
TypeScript
255 lines
8.5 KiB
TypeScript
|
import { version } from "../_version.js";
|
||
|
|
|
||
|
|
import type { BigNumberish, BytesLike } from "./index.js";
|
||
|
|
|
||
|
|
import type { CodedEthersError, ErrorCode } from "./errors.js";
|
||
|
|
|
||
|
|
|
||
|
|
export type ErrorInfo<T> = Omit<T, "code" | "name" | "message">;
|
||
|
|
|
||
|
|
export type LogLevel = "debug" | "info" | "warning" | "error" | "off";
|
||
|
|
|
||
|
|
const LogLevels: Array<LogLevel> = [ "debug", "info", "warning", "error", "off" ];
|
||
|
|
|
||
|
|
const _normalizeForms = ["NFD", "NFC", "NFKD", "NFKC"].reduce((accum, form) => {
|
||
|
|
try {
|
||
|
|
// General test for normalize
|
||
|
|
/* c8 ignore start */
|
||
|
|
if ("test".normalize(form) !== "test") { throw new Error("bad"); };
|
||
|
|
/* c8 ignore stop */
|
||
|
|
|
||
|
|
if (form === "NFD") {
|
||
|
|
const check = String.fromCharCode(0xe9).normalize("NFD");
|
||
|
|
const expected = String.fromCharCode(0x65, 0x0301)
|
||
|
|
/* c8 ignore start */
|
||
|
|
if (check !== expected) { throw new Error("broken") }
|
||
|
|
/* c8 ignore stop */
|
||
|
|
}
|
||
|
|
|
||
|
|
accum.push(form);
|
||
|
|
} catch(error) { }
|
||
|
|
|
||
|
|
return accum;
|
||
|
|
}, <Array<string>>[]);
|
||
|
|
|
||
|
|
function defineReadOnly<T, P extends keyof T>(object: T, name: P, value: T[P]): void {
|
||
|
|
Object.defineProperty(object, name, {
|
||
|
|
enumerable: true, writable: false, value,
|
||
|
|
});
|
||
|
|
}
|
||
|
|
|
||
|
|
// IEEE 754 support 53-bits of mantissa
|
||
|
|
const maxValue = 0x1fffffffffffff;
|
||
|
|
|
||
|
|
// The type of error to use for various error codes
|
||
|
|
const ErrorConstructors: Record<string, { new (...args: Array<any>): Error }> = { };
|
||
|
|
ErrorConstructors.INVALID_ARGUMENT = TypeError;
|
||
|
|
ErrorConstructors.NUMERIC_FAULT = RangeError;
|
||
|
|
ErrorConstructors.BUFFER_OVERRUN = RangeError;
|
||
|
|
|
||
|
|
export type AssertFunc<T> = () => (undefined | T);
|
||
|
|
|
||
|
|
export class Logger {
|
||
|
|
readonly version!: string;
|
||
|
|
|
||
|
|
#logLevel: number;
|
||
|
|
|
||
|
|
constructor(version?: string) {
|
||
|
|
defineReadOnly(this, "version", version || "_");
|
||
|
|
this.#logLevel = 1;
|
||
|
|
}
|
||
|
|
|
||
|
|
get logLevel(): LogLevel {
|
||
|
|
return LogLevels[this.#logLevel];
|
||
|
|
}
|
||
|
|
|
||
|
|
set logLevel(value: LogLevel) {
|
||
|
|
const logLevel = LogLevels.indexOf(value);
|
||
|
|
if (logLevel == null) {
|
||
|
|
this.throwArgumentError("invalid logLevel", "logLevel", value);
|
||
|
|
}
|
||
|
|
this.#logLevel = logLevel;
|
||
|
|
}
|
||
|
|
|
||
|
|
makeError<K extends ErrorCode, T extends CodedEthersError<K>>(message: string, code: K, info?: ErrorInfo<T>): T {
|
||
|
|
{
|
||
|
|
const details: Array<string> = [];
|
||
|
|
if (info) {
|
||
|
|
for (const key in info) {
|
||
|
|
const value = <any>(info[<keyof ErrorInfo<T>>key]);
|
||
|
|
try {
|
||
|
|
details.push(key + "=" + JSON.stringify(value));
|
||
|
|
} catch (error) {
|
||
|
|
details.push(key + "=[could not serialize object]");
|
||
|
|
}
|
||
|
|
}
|
||
|
|
}
|
||
|
|
details.push(`code=${ code }`);
|
||
|
|
details.push(`version=${ this.version }`);
|
||
|
|
|
||
|
|
if (details.length) {
|
||
|
|
message += " (" + details.join(", ") + ")";
|
||
|
|
}
|
||
|
|
}
|
||
|
|
|
||
|
|
const create = ErrorConstructors[code] || Error;
|
||
|
|
const error = <T>(new create(message));
|
||
|
|
defineReadOnly(error, "code", code);
|
||
|
|
if (info) {
|
||
|
|
for (const key in info) {
|
||
|
|
defineReadOnly(error, <keyof T>key, <any>(info[<keyof ErrorInfo<T>>key]));
|
||
|
|
}
|
||
|
|
}
|
||
|
|
return <T>error;
|
||
|
|
}
|
||
|
|
|
||
|
|
throwError<K extends ErrorCode, T extends CodedEthersError<K>>(message: string, code: K, info?: ErrorInfo<T>): never {
|
||
|
|
throw this.makeError(message, code, info);
|
||
|
|
}
|
||
|
|
|
||
|
|
throwArgumentError(message: string, name: string, value: any): never {
|
||
|
|
return this.throwError(message, "INVALID_ARGUMENT", {
|
||
|
|
argument: name,
|
||
|
|
value: value
|
||
|
|
});
|
||
|
|
}
|
||
|
|
|
||
|
|
assertNormalize(form: string): void {
|
||
|
|
if (_normalizeForms.indexOf(form) === -1) {
|
||
|
|
this.throwError("platform missing String.prototype.normalize", "UNSUPPORTED_OPERATION", {
|
||
|
|
operation: "String.prototype.normalize", info: { form }
|
||
|
|
});
|
||
|
|
}
|
||
|
|
}
|
||
|
|
|
||
|
|
assertPrivate(givenGuard: any, guard: any, className = ""): void {
|
||
|
|
if (givenGuard !== guard) {
|
||
|
|
let method = className, operation = "new";
|
||
|
|
if (className) {
|
||
|
|
method += ".";
|
||
|
|
operation += " " + className;
|
||
|
|
}
|
||
|
|
this.throwError(`private constructor; use ${ method }from* methods`, "UNSUPPORTED_OPERATION", {
|
||
|
|
operation
|
||
|
|
});
|
||
|
|
}
|
||
|
|
}
|
||
|
|
|
||
|
|
assertArgumentCount(count: number, expectedCount: number, message: string = ""): void {
|
||
|
|
if (message) { message = ": " + message; }
|
||
|
|
|
||
|
|
if (count < expectedCount) {
|
||
|
|
this.throwError("missing arguemnt" + message, "MISSING_ARGUMENT", {
|
||
|
|
count: count,
|
||
|
|
expectedCount: expectedCount
|
||
|
|
});
|
||
|
|
}
|
||
|
|
|
||
|
|
if (count > expectedCount) {
|
||
|
|
this.throwError("too many arguemnts" + message, "UNEXPECTED_ARGUMENT", {
|
||
|
|
count: count,
|
||
|
|
expectedCount: expectedCount
|
||
|
|
});
|
||
|
|
}
|
||
|
|
}
|
||
|
|
|
||
|
|
#getBytes(value: BytesLike, name?: string, copy?: boolean): Uint8Array {
|
||
|
|
if (value instanceof Uint8Array) {
|
||
|
|
if (copy) { return new Uint8Array(value); }
|
||
|
|
return value;
|
||
|
|
}
|
||
|
|
|
||
|
|
if (typeof(value) === "string" && value.match(/^0x([0-9a-f][0-9a-f])*$/i)) {
|
||
|
|
const result = new Uint8Array((value.length - 2) / 2);
|
||
|
|
let offset = 2;
|
||
|
|
for (let i = 0; i < result.length; i++) {
|
||
|
|
result[i] = parseInt(value.substring(offset, offset + 2), 16);
|
||
|
|
offset += 2;
|
||
|
|
}
|
||
|
|
return result;
|
||
|
|
}
|
||
|
|
|
||
|
|
return this.throwArgumentError("invalid BytesLike value", name || "value", value);
|
||
|
|
}
|
||
|
|
|
||
|
|
getBytes(value: BytesLike, name?: string): Uint8Array {
|
||
|
|
return this.#getBytes(value, name, false);
|
||
|
|
}
|
||
|
|
|
||
|
|
getBytesCopy(value: BytesLike, name?: string): Uint8Array {
|
||
|
|
return this.#getBytes(value, name, true);
|
||
|
|
}
|
||
|
|
|
||
|
|
getNumber(value: BigNumberish, name?: string): number {
|
||
|
|
switch (typeof(value)) {
|
||
|
|
case "bigint":
|
||
|
|
if (value < -maxValue || value > maxValue) {
|
||
|
|
this.throwArgumentError("overflow", name || "value", value);
|
||
|
|
}
|
||
|
|
return Number(value);
|
||
|
|
case "number":
|
||
|
|
if (!Number.isInteger(value)) {
|
||
|
|
this.throwArgumentError("underflow", name || "value", value);
|
||
|
|
} else if (value < -maxValue || value > maxValue) {
|
||
|
|
this.throwArgumentError("overflow", name || "value", value);
|
||
|
|
}
|
||
|
|
return value;
|
||
|
|
case "string":
|
||
|
|
try {
|
||
|
|
return this.getNumber(BigInt(value), name);
|
||
|
|
} catch(e: any) {
|
||
|
|
this.throwArgumentError(`invalid numeric string: ${ e.message }`, name || "value", value);
|
||
|
|
}
|
||
|
|
}
|
||
|
|
return this.throwArgumentError("invalid numeric value", name || "value", value);
|
||
|
|
}
|
||
|
|
|
||
|
|
getBigInt(value: BigNumberish, name?: string): bigint {
|
||
|
|
switch (typeof(value)) {
|
||
|
|
case "bigint": return value;
|
||
|
|
case "number":
|
||
|
|
if (!Number.isInteger(value)) {
|
||
|
|
this.throwArgumentError("underflow", name || "value", value);
|
||
|
|
} else if (value < -maxValue || value > maxValue) {
|
||
|
|
this.throwArgumentError("overflow", name || "value", value);
|
||
|
|
}
|
||
|
|
return BigInt(value);
|
||
|
|
case "string":
|
||
|
|
try {
|
||
|
|
return BigInt(value);
|
||
|
|
} catch(e: any) {
|
||
|
|
this.throwArgumentError(`invalid BigNumberish string: ${ e.message }`, name || "value", value);
|
||
|
|
}
|
||
|
|
}
|
||
|
|
return this.throwArgumentError("invalid BigNumberish value", name || "value", value);
|
||
|
|
}
|
||
|
|
|
||
|
|
#log(_logLevel: LogLevel, args: Array<any>): void {
|
||
|
|
const logLevel = LogLevels.indexOf(_logLevel);
|
||
|
|
if (logLevel === -1) {
|
||
|
|
this.throwArgumentError("invalid log level name", "logLevel", _logLevel);
|
||
|
|
}
|
||
|
|
if (this.#logLevel > logLevel) { return; }
|
||
|
|
console.log.apply(console, args);
|
||
|
|
}
|
||
|
|
|
||
|
|
debug(...args: Array<any>): void {
|
||
|
|
this.#log("debug", args);
|
||
|
|
}
|
||
|
|
|
||
|
|
info(...args: Array<any>): void {
|
||
|
|
this.#log("info", args);
|
||
|
|
}
|
||
|
|
|
||
|
|
warn(...args: Array<any>): void {
|
||
|
|
this.#log("warning", args);
|
||
|
|
}
|
||
|
|
}
|
||
|
|
|
||
|
|
export const logger = new Logger(version);
|
||
|
|
|
||
|
|
export function assertArgument(check: unknown, message: string, name: string, value: unknown): asserts check {
|
||
|
|
if (!check) { logger.throwArgumentError(message, name, value); }
|
||
|
|
}
|
||
|
|
|