@witnet/sdk 1.2.1 → 1.2.3

package/src/bin/helpers.js

@@ -1,974 +1,974 @@
-import { exec } from "node:child_process";
-import { createRequire } from "node:module";
-import * as net from "node:net";
-import * as os from "node:os";
-import * as readline from "node:readline";
-import moment from "moment";
-
-const require = createRequire(import.meta.url);
-
-export const colorstrip = (str) =>
-	str.replace(
-		/[\u001b\u009b][[()#;?]*(?:[0-9]{1,4}(?:;[0-9]{0,4})*)?[0-9A-ORZcf-nqry=><]/g,
-		"",
-	);
-
-export const commas = (number) => {
-	const parts = number.toString().split(".");
-	const result =
-		parts.length <= 1
-			? `${parts[0].replace(/\B(?=(\d{3})+(?!\d))/g, ",")}`
-			: `${parts[0].replace(/\B(?=(\d{3})+(?!\d))/g, ",")}.${parts[1]}`;
-	return result;
-};
-
-export function toFixedTrunc(x, n) {
-	const v = (typeof x === "string" ? x : x.toString()).split(".");
-	if (n <= 0) return v[0];
-	let f = v[1] || "";
-	if (f.length > n) return `${v[0]}.${f.substr(0, n)}`;
-	while (f.length < n) f += "0";
-	return `${v[0]}.${f}`;
-}
-
-export const whole_wits = (number, digits) => {
-	const lookup = [
-		{ value: 1n, symbol: "pedros" },
-		{ value: 10n ** 6n, symbol: "mWits" },
-		{ value: 10n ** 9n, symbol: " Wits" },
-		{ value: 10n ** 12n, symbol: "KWits" },
-		{ value: 10n ** 15n, symbol: "MWits" },
-	];
-	// const regexp = /\.0+$|(?<=\.[0-9])0+$/
-	const item = lookup.findLast((item) => number >= item.value);
-	const quotient = item
-		? Number(BigInt(number) / item.value)
-		: number.toString();
-	const decimals = item
-		? (item.value + BigInt(number) - BigInt(quotient) * item.value)
-				.toString()
-				.slice(1)
-		: "";
-	return item
-		? `${commas(quotient)}${decimals !== "" ? `.${decimals.slice(0, digits)}` : ""} ${item.symbol}`
-		: "(no coins)";
-};
-
-const bblue = (str) => `\x1b[1;98;44m${str}\x1b[0;0;0m`;
-const bcyan = (str) => `\x1b[38;46m${str}\x1b[0;0m`;
-const bgreen = (str) => `\x1b[30;42m${str}\x1b[0;0m`;
-const bred = (str) => `\x1b[30;41m${str}\x1b[0;0m`;
-const bviolet = (str) => `\x1b[30;45m${str}\x1b[0;0m`;
-
-const lcyan = (str) => `\x1b[1;96m${str}\x1b[0m`;
-const lgray = (str) => `\x1b[1;90m${str}\x1b[0m`;
-const lgreen = (str) => `\x1b[1;92m${str}\x1b[0m`;
-const lmagenta = (str) => `\x1b[1;95m${str}\x1b[0m`;
-const lyellow = (str) => `\x1b[1;93m${str}\x1b[0m`;
-const mblue = (str) => `\x1b[94m${str}\x1b[0m`;
-const mcyan = (str) => `\x1b[96m${str}\x1b[0m`;
-const mgreen = (str) => `\x1b[92m${str}\x1b[0m`;
-const mmagenta = (str) => `\x1b[0;95m${str}\x1b[0m`;
-const mred = (str) => `\x1b[91m${str}\x1b[0m`;
-const myellow = (str) => `\x1b[93m${str}\x1b[0m`;
-
-const blue = (str) => `\x1b[34m${str}\x1b[0m`;
-const cyan = (str) => `\x1b[36m${str}\x1b[0m`;
-const gray = (str) => `\x1b[90m${str}\x1b[0m`;
-const green = (str) => `\x1b[32m${str}\x1b[0m`;
-const magenta = (str) => `\x1b[0;35m${str}\x1b[0m`;
-const normal = (str) => `\x1b[98m${str}\x1b[0m`;
-const red = (str) => `\x1b[31m${str}\x1b[0m`;
-const white = (str) => `\x1b[1;98m${str}\x1b[0m`;
-const yellow = (str) => `\x1b[33m${str}\x1b[0m`;
-
-export const colors = {
-	bblue,
-	bcyan,
-	bgreen,
-	bred,
-	bviolet,
-	lcyan,
-	lgray,
-	lgreen,
-	lmagenta,
-	lyellow,
-	mblue,
-	mcyan,
-	mgreen,
-	mmagenta,
-	mred,
-	myellow,
-	blue,
-	cyan,
-	gray,
-	green,
-	magenta,
-	normal,
-	red,
-	white,
-	yellow,
-};
-
-export function countLeaves(t, obj) {
-	if (!obj || typeof obj === "string") return 0;
-	if (obj instanceof t) return 1;
-	if (Array.isArray(obj))
-		return obj.reduce((sum, item) => sum + countLeaves(t, item), 0);
-	else
-		return Object.values(obj).reduce(
-			(sum, item) => sum + countLeaves(t, item),
-			0,
-		);
-}
-
-export function deleteExtraFlags(args) {
-	return args.filter((arg) => !arg.startsWith("--"));
-}
-
-export function cmd(...command) {
-	return new Promise((resolve, reject) => {
-		exec(
-			command.join(" "),
-			{ maxBuffer: 1024 * 1024 * 10 },
-			(error, stdout, stderr) => {
-				if (error) {
-					reject(error);
-				}
-				if (stderr) {
-					reject(stderr);
-				}
-				resolve(stdout);
-			},
-		);
-	});
-}
-
-export async function execRadonBytecode(bytecode, ...flags) {
-	if (!isHexString(bytecode)) {
-		throw EvalError("invalid hex string");
-	} else {
-		const npx = os.type() === "Windows_NT" ? "npx.cmd" : "npx";
-		return cmd(npx, "witsdk", "radon", "dry-run", bytecode, ...flags);
-		// .catch((err) => {
-		//     let errorMessage = err.message.split('\n').slice(1).join('\n').trim()
-		//     const errorRegex = /.*^error: (?<message>.*)$.*/gm
-		//     const matched = errorRegex.exec(err.message)
-		//     if (matched) {
-		//         errorMessage = matched.groups.message
-		//     }
-		//     console.log(errorMessage || err)
-		//     console.error(errorMessage || err)
-		// })
-	}
-}
-
-export function extractFromArgs(args, flags) {
-	const curated = {};
-	if (args && flags) {
-		Object.keys(flags).forEach((flag) => {
-			const flagIndex = args.indexOf(`--${flag}`);
-			if (flagIndex >= 0) {
-				if (flags[flag].param) {
-					curated[flag] = args[flagIndex];
-					if (!args[flagIndex + 1] || args[flagIndex + 1].startsWith("--")) {
-						throw Error(`Missing required parameter for --${flag}`);
-					} else {
-						curated[flag] = args[flagIndex + 1];
-						args.splice(flagIndex, 2);
-					}
-				} else {
-					curated[flag] = true;
-					args.splice(flagIndex, 1);
-				}
-			}
-		});
-	}
-	return [args, curated];
-}
-
-export function fromHexString(hexString) {
-	if (hexString.startsWith("0x")) hexString = hexString.slice(2);
-	return Uint8Array.from(
-		hexString.match(/.{1,2}/g).map((byte) => parseInt(byte, 16)),
-	);
-}
-
-export function ipIsPrivateOrLocalhost(ip) {
-	if (ip.substring(0, 7) === "::ffff:") {
-		ip = ip.substring(7);
-	}
-
-	if (net.isIPv4(ip)) {
-		// check localhost
-		if (ip === "127.0.0.1") {
-			return true;
-		}
-
-		//         10.0.0.0 - 10.255.255.255        ||   172.16.0.0 - 172.31.255.255                          ||    192.168.0.0 - 192.168.255.255
-		return (
-			/^(10)\.(.*)\.(.*)\.(.*)$/.test(ip) ||
-			/^(172)\.(1[6-9]|2[0-9]|3[0-1])\.(.*)\.(.*)$/.test(ip) ||
-			/^(192)\.(168)\.(.*)\.(.*)$/.test(ip)
-		);
-	}
-
-	// else: ip is IPv6
-	const firstWord = ip.split(":").find((el) => !!el); // get first not empty word
-
-	// equivalent of 127.0.0.1 in IPv6
-	if (ip === "::1") return true;
-	// The original IPv6 Site Local addresses (fec0::/10) are deprecated. Range: fec0 - feff
-	else if (/^fe[c-f][0-f]$/.test(firstWord)) return true;
-	// These days Unique Local Addresses (ULA) are used in place of Site Local.
-	// Range: fc00 - fcff
-	else if (/^fc[0-f]{2}$/.test(firstWord)) return true;
-	// Range: fd00 - fcff
-	else if (/^fd[0-f]{2}$/.test(firstWord)) return true;
-	// Link local addresses (prefixed with fe80) are not routable
-	else if (firstWord === "fe80") return true;
-	// Discard Prefix
-	else if (firstWord === "100") return true;
-
-	// Any other IP address is not Unique Local Address (ULA)
-	return false;
-}
-
-export function isHexStringOfLength(str, length) {
-	return (
-		(isHexString(str) &&
-			((str.startsWith("0x") && str.slice(2).length === length * 2) ||
-				str.length === length * 2)) ||
-		isWildcard(str)
-	);
-}
-
-export function isHexString(str) {
-	return (
-		(typeof str === "string" &&
-			((str.startsWith("0x") && /^[a-fA-F0-9]+$/i.test(str.slice(2))) ||
-				/^[a-fA-F0-9]+$/i.test(str))) ||
-		isWildcard(str)
-	);
-}
-
-export function toHexString(buffer, prefix0x = false) {
-	if (buffer instanceof Uint8Array) buffer = Buffer.from(buffer);
-	return (
-		(prefix0x ? "0x" : "") +
-		Array.prototype.map
-			.call(buffer, (x) => `00${x.toString(16)}`.slice(-2))
-			.join("")
-			.match(/[a-fA-F0-9]{2}/g)
-			.join("")
-	);
-}
-
-export function parseURL(url) {
-	try {
-		const parsedUrl = new URL(url);
-		return [
-			`${parsedUrl.protocol}//`,
-			parsedUrl.host,
-			parsedUrl.pathname.slice(1),
-			parsedUrl.search.slice(1),
-		];
-	} catch {
-		throw new TypeError(`Invalid URL was provided: ${url}`);
-	}
-}
-
-export function showUsage(cmd, module) {
-	showUsageHeadline(cmd);
-	showUsageOptions({ ...module?.flags });
-	showUsageFlags({ ...module?.flags });
-	showUsageRouter({ ...module?.router });
-	showUsageEnvars({ ...module?.envars });
-}
-
-export function showUsageRouter(router) {
-	const cmds = Object.entries(router);
-	if (cmds.length > 0) {
-		console.info("\nSUBCOMMANDS:");
-		const maxLength = Math.max(...cmds.map(([cmd]) => cmd.length));
-		cmds.forEach((cmd) => {
-			console.info(
-				"  ",
-				`${cmd[0]}${" ".repeat(maxLength - cmd[0].length)}`,
-				"  ",
-				cmd[1].hint,
-			);
-		});
-	}
-}
-
-export function showUsageError(cmd, subcmd, module, error, flags) {
-	showUsageSubcommand(cmd, subcmd, module, error);
-	if (error) {
-		console.info("\nERROR:");
-		if (flags?.debug) {
-			console.error(error);
-		} else {
-			console.error(colors.red(error?.stack?.split("\n")[0] || error));
-		}
-	}
-}
-
-export function showUsageEnvars(envars) {
-	if (envars) {
-		envars = Object.entries(envars);
-		if (envars.length > 0) {
-			console.info("\nENVARS:");
-			const maxWidth = Math.max(...envars.map(([envar]) => envar.length));
-			envars.forEach(([envar, hint]) => {
-				if (envar.toUpperCase().indexOf("KEY") < 0 && process.env[envar]) {
-					console.info(
-						"  ",
-						`${yellow(envar.toUpperCase())}${" ".repeat(maxWidth - envar.length)}`,
-						` => Settled to "${myellow(process.env[envar])}"`,
-					);
-				} else {
-					console.info(
-						"  ",
-						`${yellow(envar.toUpperCase())}${" ".repeat(maxWidth - envar.length)}`,
-						` ${hint}`,
-					);
-				}
-			});
-		}
-	}
-}
-
-export function showUsageFlags(flags) {
-	if (flags) {
-		flags = Object.entries(flags)
-			.filter(([, flag]) => !flag?.param)
-			.sort(([a], [b]) => {
-				if (a < b) return -1;
-				else if (a > b) return 1;
-				else return 0;
-			});
-		if (flags.length > 0) {
-			console.info("\nFLAGS:");
-			const maxLength = Math.max(
-				...flags
-					.filter(([, { hint }]) => hint)
-					.map(([key, { param }]) =>
-						param ? key.length + param.length + 3 : key.length,
-					),
-			);
-			flags.forEach((flag) => {
-				const str = `${flag[0]}${flag[1].param ? gray(` <${flag[1].param}>`) : ""}`;
-				if (flag[1].hint) {
-					console.info(
-						"  ",
-						`--${str}${" ".repeat(maxLength - colorstrip(str).length)}`,
-						"  ",
-						flag[1].hint,
-					);
-				}
-			});
-		}
-	}
-}
-
-export function showUsageHeadline(cmd, subcmd, module) {
-	console.info("USAGE:");
-	if (subcmd) {
-		let params = module.router[subcmd]?.params;
-		// const options = module.router[subcmd]?.options
-		if (params) {
-			const optionalize = (str) =>
-				str.endsWith(" ...]")
-					? `[<${str.slice(1, -5)}> ...]`
-					: str[0] === "["
-						? `[<${str.slice(1, -1)}>]`
-						: `<${str}>`;
-			if (Array.isArray(params)) {
-				params = `${params.map((param) => optionalize(param)).join(" ")} `;
-			} else {
-				params = optionalize(params);
-			}
-		}
-		console.info(
-			`   ${colors.white(`npx witsdk ${cmd}`)} ${colors.white(subcmd)} ${params ? `${colors.green(params)} ` : ""}[OPTIONS] [FLAGS]`,
-		);
-		if (module?.router[subcmd]?.hint) {
-			console.info("\nDESCRIPTION:");
-			console.info(`   ${module.router[subcmd].hint}`);
-		}
-	} else {
-		console.info(
-			`   ${colors.white(`npx witsdk ${cmd}`)} <SUBCOMMAND> ... [OPTIONS] [FLAGS]`,
-		);
-	}
-}
-
-export function showUsageOptions(options) {
-	options = Object.entries(options)
-		.filter(([, option]) => option?.param)
-		.sort(([a], [b]) => {
-			if (a < b) return -1;
-			else if (a > b) return 1;
-			else return 0;
-		});
-	if (options.length > 0) {
-		console.info("\nOPTIONS:");
-		const maxLength = options
-			.map((option) =>
-				option[1].param
-					? option[1].param.length + option[0].length + 3
-					: option[0].length,
-			)
-			.reduce((prev, curr) => (curr > prev ? curr : prev));
-		options.forEach((option) => {
-			if (option[1].hint) {
-				const str = `${option[0]}${option[1].param ? gray(` <${option[1].param}>`) : ""}`;
-				console.info(
-					"  ",
-					`--${str}${" ".repeat(maxLength - colorstrip(str).length)}`,
-					"  ",
-					option[1].hint,
-				);
-			}
-		});
-	}
-}
-
-export function showUsageSubcommand(cmd, subcmd, module) {
-	showUsageHeadline(cmd, subcmd, module);
-	showUsageOptions({ ...module?.flags, ...module.router[subcmd]?.options });
-	showUsageFlags({ ...module?.flags, ...module.router[subcmd]?.options });
-	showUsageEnvars(module.router[subcmd]?.envars || module?.envars);
-}
-
-export function showVersion() {
-	console.info(
-		`${colors.mcyan(`Witnet SDK v${require("../../package.json").version}`)}`,
-	);
-}
-
-export function getWildcardsCountFromString(str) {
-	let maxArgsIndex = 0;
-	if (str && typeof str === "string") {
-		let match;
-		const regexp = /\\\d\\/g;
-		while ((match = regexp.exec(str)) !== null) {
-			const argsIndex = parseInt(match[0][1], 10) + 1;
-			if (argsIndex > maxArgsIndex) maxArgsIndex = argsIndex;
-		}
-	}
-	return maxArgsIndex;
-}
-
-export function checkRpcWildcards(wildcards) {
-	if (typeof wildcards === "object") {
-		Object.values(wildcards).forEach((wildcard) => {
-			if (Array.isArray(wildcard))
-				wildcard.forEach((item) => checkRpcWildcards(item));
-			else checkRpcWildcards(wildcard);
-		});
-	} else if (Array.isArray(wildcards)) {
-		wildcards.forEach((wildcard) => checkRpcWildcards(wildcard));
-	} else if (typeof wildcards === "string") {
-		if (isWildcard(wildcards)) {
-			const char = wildcards.charAt(1);
-			if (char < "0" || char > "9") {
-				throw Error("RPC: wildcards not in range [0 .. 9]");
-			}
-		}
-	}
-}
-
-export function isWildcard(str) {
-	return str.length === 3 && /\\\d\\/g.test(str);
-}
-
-export function replaceWildcards(obj, args) {
-	if (args.length > 10) args = args.slice(0, 10);
-	if (obj && typeof obj === "string") {
-		for (let argIndex = 0; argIndex < args.length; argIndex++) {
-			const wildcard = `\\${argIndex}\\`;
-			obj = obj.replaceAll(wildcard, args[argIndex]);
-		}
-	} else if (obj && Array.isArray(obj)) {
-		obj = obj.map((value) =>
-			typeof value === "string" || Array.isArray(value)
-				? replaceWildcards(value, args)
-				: value,
-		);
-	} else if (obj && typeof obj === "object") {
-		obj = replaceObjectWildcards(obj, args);
-	}
-	return obj;
-}
-
-export function replaceObjectWildcards(obj, args) {
-	return Object.fromEntries(
-		Object.entries(obj).map(([key, value]) => {
-			for (let argIndex = 0; argIndex < args.length; argIndex++) {
-				const wildcard = `\\${argIndex}\\`;
-				key = key.replaceAll(wildcard, args[argIndex]);
-				value = replaceWildcards(value, args);
-			}
-			return [key, value];
-		}),
-	);
-}
-
-export function spliceWildcard(obj, argIndex, argValue, argsCount) {
-	if (obj && typeof obj === "string") {
-		const wildcard = `\\${argIndex}\\`;
-		obj = obj.replaceAll(wildcard, argValue);
-		for (let j = argIndex + 1; j < argsCount; j++) {
-			obj = obj.replaceAll(`\\${j}\\`, `\\${j - 1}\\`);
-		}
-	} else if (obj && Array.isArray(obj)) {
-		obj = obj.map((value) =>
-			typeof value === "string" || Array.isArray(value)
-				? spliceWildcard(value, argIndex, argValue, argsCount)
-				: value,
-		);
-	}
-	return obj;
-}
-
-export async function toolkitRun(settings, args) {
-	const cmd = `${settings.paths.toolkitBinPath} ${args.join(" ")}`;
-	return new Promise((resolve, reject) => {
-		exec(cmd, { maxBuffer: 1024 * 1024 * 10 }, (error, stdout, stderr) => {
-			if (error) {
-				reject(error);
-			}
-			if (stderr) {
-				reject(stderr);
-			}
-			resolve(stdout);
-		});
-	});
-}
-
-export function toUpperCamelCase(str) {
-	return str
-		.replace(/\b(\w)/g, (_match, capture) => capture.toUpperCase())
-		.replace(/\s+/g, "");
-}
-
-export function toUtf16Bytes(str) {
-	const bytes = new Uint8Array(str.length * 2);
-	for (let i = 0; i < str.length; i++) {
-		const code = str.charCodeAt(i);
-		bytes[i * 2] = code >> 8;
-		bytes[i * 2 + 1] = code & 0xff;
-	}
-	return bytes;
-}
-
-export function toUtf8Array(str) {
-	const utf8 = [];
-	for (let i = 0; i < str.length; i++) {
-		let charcode = str.charCodeAt(i);
-		if (charcode < 0x80) utf8.push(charcode);
-		else if (charcode < 0x800) {
-			utf8.push(0xc0 | (charcode >> 6), 0x80 | (charcode & 0x3f));
-		} else if (charcode < 0xd800 || charcode >= 0xe000) {
-			utf8.push(
-				0xe0 | (charcode >> 12),
-				0x80 | ((charcode >> 6) & 0x3f),
-				0x80 | (charcode & 0x3f),
-			);
-		} else {
-			// surrogate pair
-			i++;
-			// UTF-16 encodes 0x10000-0x10FFFF by
-			// subtracting 0x10000 and splitting the
-			// 20 bits of 0x0-0xFFFFF into two halves
-			charcode =
-				0x10000 + (((charcode & 0x3ff) << 10) | (str.charCodeAt(i) & 0x3ff));
-			utf8.push(
-				0xf0 | (charcode >> 18),
-				0x80 | ((charcode >> 12) & 0x3f),
-				0x80 | ((charcode >> 6) & 0x3f),
-				0x80 | (charcode & 0x3f),
-			);
-		}
-	}
-	return utf8;
-}
-
-export function utf8ArrayToStr(array) {
-	const len = array.length;
-	let out = "";
-	let i = 0;
-	let c;
-	let char2, char3;
-	while (i < len) {
-		c = array[i++];
-		switch (c >> 4) {
-			case 0:
-			case 1:
-			case 2:
-			case 3:
-			case 4:
-			case 5:
-			case 6:
-			case 7:
-				// 0xxxxxxx
-				out += String.fromCharCode(c);
-				break;
-			case 12:
-			case 13:
-				// 110x xxxx   10xx xxxx
-				char2 = array[i++];
-				out += String.fromCharCode(((c & 0x1f) << 6) | (char2 & 0x3f));
-				break;
-			case 14:
-				// 1110 xxxx  10xx xxxx  10xx xxxx
-				char2 = array[i++];
-				char3 = array[i++];
-				out += String.fromCharCode(
-					((c & 0x0f) << 12) | ((char2 & 0x3f) << 6) | ((char3 & 0x3f) << 0),
-				);
-				break;
-		}
-	}
-	return out;
-}
-
-export async function prompt(question) {
-	const readlineInterface = readline.createInterface({
-		input: process.stdin,
-		output: process.stdout,
-	});
-	return new Promise((resolve, _reject) => {
-		readlineInterface.question(`${question} `, (response) => {
-			readlineInterface.close();
-			resolve(response.trim());
-		});
-	});
-}
-
-export function prompter(promise) {
-	const loading = (() => {
-		const h = ["|", "/", "-", "\\"];
-		let i = 0;
-		return setInterval(() => {
-			i = i > 3 ? 0 : i;
-			process.stdout.write(`\b\b${h[i]} `);
-			i++;
-		}, 50);
-	})();
-	return promise.then((result) => {
-		clearInterval(loading);
-		process.stdout.write("\b\b");
-		return result;
-	});
-}
-
-export function traceChecklists(checklists) {
-	if (checklists && Object.keys(checklists).length > 0) {
-		const headlines = [
-			"NODES",
-			...Object.keys(checklists).map((key) => `:${key}`),
-		];
-		checklists = Object.values(checklists);
-		const urls = Object.keys(checklists[0]);
-		const records = urls.map((url) => {
-			const errors = checklists.filter(
-				(checklist) => checklist[url] instanceof Error,
-			).length;
-			return [
-				errors === checklists.length
-					? colors.red(url)
-					: errors > 0
-						? colors.myellow(url)
-						: colors.mcyan(url),
-				...checklists.map((checklist) =>
-					checklist[url] instanceof Error
-						? colors.red(checklist[url])
-						: checklist[url] === true
-							? colors.lcyan("Aye")
-							: colors.cyan("Nay"),
-				),
-			];
-		});
-		traceTable(records, {
-			headlines,
-			maxColumnWidth: 31,
-		});
-	}
-}
-
-export function traceHeader(headline, color = normal, indent = "") {
-	console.info(`${indent}┌─${"─".repeat(headline.length)}─┐`);
-	console.info(`${indent}│ ${color(headline)} │`);
-	console.info(`${indent}└─${"─".repeat(headline.length)}─┘`);
-}
-
-export function traceTable(records, options) {
-	const stringify = (data, humanizers, index) =>
-		humanizers?.[index]
-			? humanizers[index](data).toString()
-			: (data?.toString() ?? "");
-	const max = (a, b) => (a > b ? a : b);
-	const reduceMax = (numbers) =>
-		numbers.reduce((curr, prev) => (prev > curr ? prev : curr), 0);
-	if (!options) options = {};
-	const indent = options?.indent || "";
-	const numColumns = reduceMax(records.map((record) => record?.length || 1));
-	const maxColumnWidth = options?.maxColumnWidth || 80;
-	const table = transpose(records, numColumns);
-	options.widths =
-		options?.widths ||
-		table.map((column, index) => {
-			let maxWidth = reduceMax(
-				column.map(
-					(field) =>
-						colorstrip(stringify(field, options?.humanizers, index)).length,
-				),
-			);
-			if (options?.headlines?.[index]) {
-				maxWidth = max(
-					maxWidth,
-					colorstrip(options.headlines[index].replaceAll(":", "")).length,
-				);
-			}
-			return Math.min(maxWidth, maxColumnWidth);
-		});
-	let headline = options.widths.map((maxWidth) => "─".repeat(maxWidth));
-	console.info(`${indent}┌─${headline.join("─┬─")}─┐`);
-	if (options?.headlines) {
-		headline = options.widths.map((maxWidth, index) => {
-			const caption = options.headlines[index].replaceAll(":", "");
-			const captionLength = colorstrip(caption).length;
-			return `${white(caption)}${" ".repeat(maxWidth - captionLength)}`;
-		});
-		console.info(`${indent}│ ${headline.join(" │ ")} │`);
-		headline = options.widths.map((maxWidth) => "─".repeat(maxWidth));
-		console.info(`${indent}├─${headline.join("─┼─")}─┤`);
-	}
-	for (let i = 0; i < records.length; i++) {
-		let line = "";
-		for (let j = 0; j < numColumns; j++) {
-			let data = table[j][i];
-			let color;
-			if (options?.colors?.[j]) {
-				color = options.colors[j];
-			} else {
-				color =
-					typeof data === "string"
-						? green
-						: Number(data) === data && data % 1 !== 0 // is float number?
-							? yellow
-							: (x) => x;
-			}
-			data = stringify(data, options?.humanizers, j);
-			if (colorstrip(data).length > maxColumnWidth) {
-				while (colorstrip(data).length > maxColumnWidth - 3) {
-					data = data.slice(0, -1);
-				}
-				data += "...";
-			}
-			const dataLength = colorstrip(data).length;
-			if (options?.headlines && options.headlines[j][0] === ":") {
-				data = `${color(data)}${" ".repeat(options.widths[j] - dataLength)}`;
-			} else {
-				data = `${" ".repeat(options.widths[j] - dataLength)}${color(data)}`;
-			}
-			line += `│ ${data} `;
-		}
-		console.info(`${indent}${line}│`);
-	}
-	headline = options.widths.map((maxWidth) => "─".repeat(maxWidth));
-	console.info(`${indent}└─${headline.join("─┴─")}─┘`);
-}
-
-function transpose(records, numColumns) {
-	const columns = [];
-	for (let index = 0; index < numColumns; index++) {
-		columns.push(records.map((row) => row[index]));
-	}
-	return columns;
-}
-
-export function txJsonReplacer(key, value) {
-	switch (key) {
-		case "bytes":
-		case "der":
-			return toHexString(value, true);
-		case "tx":
-			return JSON.stringify(value, txJsonReplacer);
-		case "change":
-		case "fees":
-		case "value":
-			return parseInt(value, 10) / 10 ** 9;
-		default:
-			return value;
-	}
-}
-
-export function txReceiptJsonReplacer(key, value) {
-	switch (key) {
-		case "bytes":
-		case "der":
-			return toHexString(value, true);
-		case "tx":
-			return JSON.stringify(value, txJsonReplacer);
-		case "change":
-		case "fees":
-		case "value":
-			return parseInt(value?.pedros, 10) / 10 ** 9;
-		case "timestamp":
-			return moment.unix(value).format("MMMM Do YYYY, h:mm:ss a");
-		default:
-			return value;
-	}
-}
-
-export function traceTransactionOnCheckpoint(receipt) {
-	if (receipt?.confirmations) {
-		console.info(` > Checkpoint #${commas(receipt.confirmations)}...`);
-	}
-}
-
-export function traceTransactionOnStatusChange(receipt) {
-	const captions = {
-		pending: "Awaiting relay...",
-		// confirmed: "Transaction confirmed:",
-		// finalized: "Transaction finalized:",
-		relayed: "Awaiting inclusion...",
-		mined: "Awaiting confirmations...",
-	};
-	const caption = captions[receipt.status];
-	if (caption) console.info(` > ${captions[receipt.status]}`);
-	if (["finalized", "confirmed"].includes(receipt.status)) {
-		console.info(` > Block hash:   ${colors.gray(receipt?.blockHash)}`);
-		console.info(` > Block miner:  ${colors.cyan(receipt?.blockMiner)}`);
-		console.info(
-			` > Block epoch:  ${colors.white(commas(receipt?.blockEpoch))}`,
-		);
-		console.info(
-			` > Included at:  ${colors.green(moment.unix(receipt?.blockTimestamp).format("MMMM Do YYYY, h:mm:ss a"))}`,
-		);
-		console.info(
-			` > ${receipt.status[0].toUpperCase() + receipt.status.slice(1)} at: ${colors.mgreen(moment.unix(receipt.timestamp).format("MMMM Do YYYY, h:mm:ss a"))}`,
-		);
-	}
-}
-
-export function traceTransactionReceipt(receipt) {
-	const captions = {
-		DataRequest: " > DRT hash:     ",
-		ValueTransfer: " > VTT hash:     ",
-	};
-	console.info(
-		`${captions[receipt.type] || " > TX hash:      "}${colors.white(receipt.hash)}`,
-	);
-	if (receipt?.droHash)
-		console.info(` > DRO hash:     ${colors.green(receipt.droHash)}`);
-	if (receipt?.radHash)
-		console.info(` > RAD hash:     ${colors.mgreen(receipt.radHash)}`);
-	if (receipt?.droSLA)
-		console.info(` > SLA params:   ${JSON.stringify(receipt.droSLA)}`);
-	if (receipt?.withdrawer) {
-		if (receipt?.validator) {
-			console.info(` > Validator:    ${colors.mcyan(receipt.validator)}`);
-		}
-		console.info(` > Withdrawer:   ${colors.mmagenta(receipt.withdrawer)}`);
-	} else {
-		const signers = Array.isArray(receipt.from) ? receipt.from : [receipt.from];
-		console.info(` > Signer/s:     ${colors.mmagenta(signers[0])}`);
-		signers.slice(1).forEach((signer) => {
-			console.info(`                 ${colors.mmagenta(signer)}`);
-		});
-	}
-	if (receipt?.recipients) {
-		console.info(
-			` > Recipient/s:  ${colors.mblue(
-				receipt.recipients.filter(
-					(pkh, index, array) => index === array.indexOf(pkh),
-				),
-			)}`,
-		);
-	}
-	if (receipt?.fees)
-		console.info(` > Network fee:  ${colors.yellow(receipt.fees.toString(2))}`);
-	if (receipt?.value)
-		console.info(
-			` > Value:        ${colors.myellow(receipt.value.toString(2))}`,
-		);
-	if (receipt?.weight)
-		console.info(` > Weight:       ${colors.mgreen(commas(receipt.weight))}`);
-	if (receipt?.witnesses) {
-		console.info(` > Witnesses:    ${receipt.witnesses}`);
-	}
-}
-
-export async function traceTransaction(transmitter, options) {
-	const color = options?.color || ((x) => `\x1b[30;45m${x}\x1b[0m`);
-	let receipt = await transmitter.signTransaction(options, options?.reload);
-	if (options?.verbose) {
-		console.info(`\n${gray(JSON.stringify(receipt.tx, txJsonReplacer))}`);
-	}
-	if (options?.headline) {
-		console.info(`\n ${color(`  ${options.headline}  `)}\n`);
-	}
-	traceTransactionReceipt(receipt);
-	if (!options?.force) {
-		// prompt user confirmation
-		console.info();
-		const answer = await require("inquirer").createPromptModule()([
-			{
-				message: "Send transaction?",
-				type: "confirm",
-				name: "continue",
-				default: false,
-			},
-		]);
-		if (!answer.continue) {
-			return receipt;
-		}
-	}
-	try {
-		console.info();
-		receipt = await transmitter.sendTransaction();
-		if (options?.await || options?.confirmations !== undefined) {
-			receipt = await transmitter.confirmTransaction(receipt.hash, {
-				confirmations: options?.confirmations || 0,
-				onCheckpoint: traceTransactionOnCheckpoint,
-				onStatusChange: traceTransactionOnStatusChange,
-			});
-		} else {
-			const data = {
-				status: receipt?.status,
-				timestamp: receipt?.timestamp || Math.floor(Date.now() / 1000),
-			};
-			console.info(data);
-		}
-	} catch (err) {
-		if (err?.inFlight && err.inFlight) {
-			console.info(
-				`\n${colors.gray(JSON.stringify(err.inFligt?.message, txReceiptJsonReplacer))}`,
-			);
-		}
-		throw err;
-	}
-	return receipt;
-}
-
-export function unescapeSlashes(str) {
-	// add another escaped slash if the string ends with an odd
-	// number of escaped slashes which will crash JSON.parse
-	let parsedStr = str.replace(/(^|[^\\])(\\\\)*\\$/, "$&\\");
-
-	// escape unescaped double quotes to prevent error with
-	// added double quotes in json string
-	parsedStr = parsedStr.replace(/(^|[^\\])((\\\\)*")/g, "$1\\$2");
-
-	try {
-		parsedStr = JSON.parse(`"${parsedStr}"`);
-	} catch (_e) {
-		return str;
-	}
-	return parsedStr;
-}
+import { exec } from "node:child_process";
+import { createRequire } from "node:module";
+import * as net from "node:net";
+import * as os from "node:os";
+import * as readline from "node:readline";
+import moment from "moment";
+
+const require = createRequire(import.meta.url);
+
+export const colorstrip = (str) =>
+	str.replace(
+		/[\u001b\u009b][[()#;?]*(?:[0-9]{1,4}(?:;[0-9]{0,4})*)?[0-9A-ORZcf-nqry=><]/g,
+		"",
+	);
+
+export const commas = (number) => {
+	const parts = number.toString().split(".");
+	const result =
+		parts.length <= 1
+			? `${parts[0].replace(/\B(?=(\d{3})+(?!\d))/g, ",")}`
+			: `${parts[0].replace(/\B(?=(\d{3})+(?!\d))/g, ",")}.${parts[1]}`;
+	return result;
+};
+
+export function toFixedTrunc(x, n) {
+	const v = (typeof x === "string" ? x : x.toString()).split(".");
+	if (n <= 0) return v[0];
+	let f = v[1] || "";
+	if (f.length > n) return `${v[0]}.${f.substr(0, n)}`;
+	while (f.length < n) f += "0";
+	return `${v[0]}.${f}`;
+}
+
+export const whole_wits = (number, digits) => {
+	const lookup = [
+		{ value: 1n, symbol: "pedros" },
+		{ value: 10n ** 6n, symbol: "mWits" },
+		{ value: 10n ** 9n, symbol: " Wits" },
+		{ value: 10n ** 12n, symbol: "KWits" },
+		{ value: 10n ** 15n, symbol: "MWits" },
+	];
+	// const regexp = /\.0+$|(?<=\.[0-9])0+$/
+	const item = lookup.findLast((item) => number >= item.value);
+	const quotient = item
+		? Number(BigInt(number) / item.value)
+		: number.toString();
+	const decimals = item
+		? (item.value + BigInt(number) - BigInt(quotient) * item.value)
+				.toString()
+				.slice(1)
+		: "";
+	return item
+		? `${commas(quotient)}${decimals !== "" ? `.${decimals.slice(0, digits)}` : ""} ${item.symbol}`
+		: "(no coins)";
+};
+
+const bblue = (str) => `\x1b[1;98;44m${str}\x1b[0;0;0m`;
+const bcyan = (str) => `\x1b[38;46m${str}\x1b[0;0m`;
+const bgreen = (str) => `\x1b[30;42m${str}\x1b[0;0m`;
+const bred = (str) => `\x1b[30;41m${str}\x1b[0;0m`;
+const bviolet = (str) => `\x1b[30;45m${str}\x1b[0;0m`;
+
+const lcyan = (str) => `\x1b[1;96m${str}\x1b[0m`;
+const lgray = (str) => `\x1b[1;90m${str}\x1b[0m`;
+const lgreen = (str) => `\x1b[1;92m${str}\x1b[0m`;
+const lmagenta = (str) => `\x1b[1;95m${str}\x1b[0m`;
+const lyellow = (str) => `\x1b[1;93m${str}\x1b[0m`;
+const mblue = (str) => `\x1b[94m${str}\x1b[0m`;
+const mcyan = (str) => `\x1b[96m${str}\x1b[0m`;
+const mgreen = (str) => `\x1b[92m${str}\x1b[0m`;
+const mmagenta = (str) => `\x1b[0;95m${str}\x1b[0m`;
+const mred = (str) => `\x1b[91m${str}\x1b[0m`;
+const myellow = (str) => `\x1b[93m${str}\x1b[0m`;
+
+const blue = (str) => `\x1b[34m${str}\x1b[0m`;
+const cyan = (str) => `\x1b[36m${str}\x1b[0m`;
+const gray = (str) => `\x1b[90m${str}\x1b[0m`;
+const green = (str) => `\x1b[32m${str}\x1b[0m`;
+const magenta = (str) => `\x1b[0;35m${str}\x1b[0m`;
+const normal = (str) => `\x1b[98m${str}\x1b[0m`;
+const red = (str) => `\x1b[31m${str}\x1b[0m`;
+const white = (str) => `\x1b[1;98m${str}\x1b[0m`;
+const yellow = (str) => `\x1b[33m${str}\x1b[0m`;
+
+export const colors = {
+	bblue,
+	bcyan,
+	bgreen,
+	bred,
+	bviolet,
+	lcyan,
+	lgray,
+	lgreen,
+	lmagenta,
+	lyellow,
+	mblue,
+	mcyan,
+	mgreen,
+	mmagenta,
+	mred,
+	myellow,
+	blue,
+	cyan,
+	gray,
+	green,
+	magenta,
+	normal,
+	red,
+	white,
+	yellow,
+};
+
+export function countLeaves(t, obj) {
+	if (!obj || typeof obj === "string") return 0;
+	if (obj instanceof t) return 1;
+	if (Array.isArray(obj))
+		return obj.reduce((sum, item) => sum + countLeaves(t, item), 0);
+	else
+		return Object.values(obj).reduce(
+			(sum, item) => sum + countLeaves(t, item),
+			0,
+		);
+}
+
+export function deleteExtraFlags(args) {
+	return args.filter((arg) => !arg.startsWith("--"));
+}
+
+export function cmd(...command) {
+	return new Promise((resolve, reject) => {
+		exec(
+			command.join(" "),
+			{ maxBuffer: 1024 * 1024 * 10 },
+			(error, stdout, stderr) => {
+				if (error) {
+					reject(error);
+				}
+				if (stderr) {
+					reject(stderr);
+				}
+				resolve(stdout);
+			},
+		);
+	});
+}
+
+export async function execRadonBytecode(bytecode, ...flags) {
+	if (!isHexString(bytecode)) {
+		throw EvalError("invalid hex string");
+	} else {
+		const npx = os.type() === "Windows_NT" ? "npx.cmd" : "npx";
+		return cmd(npx, "witsdk", "radon", "dry-run", bytecode, ...flags);
+		// .catch((err) => {
+		//     let errorMessage = err.message.split('\n').slice(1).join('\n').trim()
+		//     const errorRegex = /.*^error: (?<message>.*)$.*/gm
+		//     const matched = errorRegex.exec(err.message)
+		//     if (matched) {
+		//         errorMessage = matched.groups.message
+		//     }
+		//     console.log(errorMessage || err)
+		//     console.error(errorMessage || err)
+		// })
+	}
+}
+
+export function extractFromArgs(args, flags) {
+	const curated = {};
+	if (args && flags) {
+		Object.keys(flags).forEach((flag) => {
+			const flagIndex = args.indexOf(`--${flag}`);
+			if (flagIndex >= 0) {
+				if (flags[flag].param) {
+					curated[flag] = args[flagIndex];
+					if (!args[flagIndex + 1] || args[flagIndex + 1].startsWith("--")) {
+						throw Error(`Missing required parameter for --${flag}`);
+					} else {
+						curated[flag] = args[flagIndex + 1];
+						args.splice(flagIndex, 2);
+					}
+				} else {
+					curated[flag] = true;
+					args.splice(flagIndex, 1);
+				}
+			}
+		});
+	}
+	return [args, curated];
+}
+
+export function fromHexString(hexString) {
+	if (hexString.startsWith("0x")) hexString = hexString.slice(2);
+	return Uint8Array.from(
+		hexString.match(/.{1,2}/g).map((byte) => parseInt(byte, 16)),
+	);
+}
+
+export function ipIsPrivateOrLocalhost(ip) {
+	if (ip.substring(0, 7) === "::ffff:") {
+		ip = ip.substring(7);
+	}
+
+	if (net.isIPv4(ip)) {
+		// check localhost
+		if (ip === "127.0.0.1") {
+			return true;
+		}
+
+		//         10.0.0.0 - 10.255.255.255        ||   172.16.0.0 - 172.31.255.255                          ||    192.168.0.0 - 192.168.255.255
+		return (
+			/^(10)\.(.*)\.(.*)\.(.*)$/.test(ip) ||
+			/^(172)\.(1[6-9]|2[0-9]|3[0-1])\.(.*)\.(.*)$/.test(ip) ||
+			/^(192)\.(168)\.(.*)\.(.*)$/.test(ip)
+		);
+	}
+
+	// else: ip is IPv6
+	const firstWord = ip.split(":").find((el) => !!el); // get first not empty word
+
+	// equivalent of 127.0.0.1 in IPv6
+	if (ip === "::1") return true;
+	// The original IPv6 Site Local addresses (fec0::/10) are deprecated. Range: fec0 - feff
+	else if (/^fe[c-f][0-f]$/.test(firstWord)) return true;
+	// These days Unique Local Addresses (ULA) are used in place of Site Local.
+	// Range: fc00 - fcff
+	else if (/^fc[0-f]{2}$/.test(firstWord)) return true;
+	// Range: fd00 - fcff
+	else if (/^fd[0-f]{2}$/.test(firstWord)) return true;
+	// Link local addresses (prefixed with fe80) are not routable
+	else if (firstWord === "fe80") return true;
+	// Discard Prefix
+	else if (firstWord === "100") return true;
+
+	// Any other IP address is not Unique Local Address (ULA)
+	return false;
+}
+
+export function isHexStringOfLength(str, length) {
+	return (
+		(isHexString(str) &&
+			((str.startsWith("0x") && str.slice(2).length === length * 2) ||
+				str.length === length * 2)) ||
+		isWildcard(str)
+	);
+}
+
+export function isHexString(str) {
+	return (
+		(typeof str === "string" &&
+			((str.startsWith("0x") && /^[a-fA-F0-9]+$/i.test(str.slice(2))) ||
+				/^[a-fA-F0-9]+$/i.test(str))) ||
+		isWildcard(str)
+	);
+}
+
+export function toHexString(buffer, prefix0x = false) {
+	if (buffer instanceof Uint8Array) buffer = Buffer.from(buffer);
+	return (
+		(prefix0x ? "0x" : "") +
+		Array.prototype.map
+			.call(buffer, (x) => `00${x.toString(16)}`.slice(-2))
+			.join("")
+			.match(/[a-fA-F0-9]{2}/g)
+			.join("")
+	);
+}
+
+export function parseURL(url) {
+	try {
+		const parsedUrl = new URL(url);
+		return [
+			`${parsedUrl.protocol}//`,
+			parsedUrl.host,
+			parsedUrl.pathname.slice(1),
+			parsedUrl.search.slice(1),
+		];
+	} catch {
+		throw new TypeError(`Invalid URL was provided: ${url}`);
+	}
+}
+
+export function showUsage(cmd, module) {
+	showUsageHeadline(cmd);
+	showUsageOptions({ ...module?.flags });
+	showUsageFlags({ ...module?.flags });
+	showUsageRouter({ ...module?.router });
+	showUsageEnvars({ ...module?.envars });
+}
+
+export function showUsageRouter(router) {
+	const cmds = Object.entries(router);
+	if (cmds.length > 0) {
+		console.info("\nSUBCOMMANDS:");
+		const maxLength = Math.max(...cmds.map(([cmd]) => cmd.length));
+		cmds.forEach((cmd) => {
+			console.info(
+				"  ",
+				`${cmd[0]}${" ".repeat(maxLength - cmd[0].length)}`,
+				"  ",
+				cmd[1].hint,
+			);
+		});
+	}
+}
+
+export function showUsageError(cmd, subcmd, module, error, flags) {
+	showUsageSubcommand(cmd, subcmd, module, error);
+	if (error) {
+		console.info("\nERROR:");
+		if (flags?.debug) {
+			console.error(error);
+		} else {
+			console.error(colors.red(error?.stack?.split("\n")[0] || error));
+		}
+	}
+}
+
+export function showUsageEnvars(envars) {
+	if (envars) {
+		envars = Object.entries(envars);
+		if (envars.length > 0) {
+			console.info("\nENVARS:");
+			const maxWidth = Math.max(...envars.map(([envar]) => envar.length));
+			envars.forEach(([envar, hint]) => {
+				if (envar.toUpperCase().indexOf("KEY") < 0 && process.env[envar]) {
+					console.info(
+						"  ",
+						`${yellow(envar.toUpperCase())}${" ".repeat(maxWidth - envar.length)}`,
+						` => Settled to "${myellow(process.env[envar])}"`,
+					);
+				} else {
+					console.info(
+						"  ",
+						`${yellow(envar.toUpperCase())}${" ".repeat(maxWidth - envar.length)}`,
+						` ${hint}`,
+					);
+				}
+			});
+		}
+	}
+}
+
+export function showUsageFlags(flags) {
+	if (flags) {
+		flags = Object.entries(flags)
+			.filter(([, flag]) => !flag?.param)
+			.sort(([a], [b]) => {
+				if (a < b) return -1;
+				else if (a > b) return 1;
+				else return 0;
+			});
+		if (flags.length > 0) {
+			console.info("\nFLAGS:");
+			const maxLength = Math.max(
+				...flags
+					.filter(([, { hint }]) => hint)
+					.map(([key, { param }]) =>
+						param ? key.length + param.length + 3 : key.length,
+					),
+			);
+			flags.forEach((flag) => {
+				const str = `${flag[0]}${flag[1].param ? gray(` <${flag[1].param}>`) : ""}`;
+				if (flag[1].hint) {
+					console.info(
+						"  ",
+						`--${str}${" ".repeat(maxLength - colorstrip(str).length)}`,
+						"  ",
+						flag[1].hint,
+					);
+				}
+			});
+		}
+	}
+}
+
+export function showUsageHeadline(cmd, subcmd, module) {
+	console.info("USAGE:");
+	if (subcmd) {
+		let params = module.router[subcmd]?.params;
+		// const options = module.router[subcmd]?.options
+		if (params) {
+			const optionalize = (str) =>
+				str.endsWith(" ...]")
+					? `[<${str.slice(1, -5)}> ...]`
+					: str[0] === "["
+						? `[<${str.slice(1, -1)}>]`
+						: `<${str}>`;
+			if (Array.isArray(params)) {
+				params = `${params.map((param) => optionalize(param)).join(" ")} `;
+			} else {
+				params = optionalize(params);
+			}
+		}
+		console.info(
+			`   ${colors.white(`npx witsdk ${cmd}`)} ${colors.white(subcmd)} ${params ? `${colors.green(params)} ` : ""}[OPTIONS] [FLAGS]`,
+		);
+		if (module?.router[subcmd]?.hint) {
+			console.info("\nDESCRIPTION:");
+			console.info(`   ${module.router[subcmd].hint}`);
+		}
+	} else {
+		console.info(
+			`   ${colors.white(`npx witsdk ${cmd}`)} <SUBCOMMAND> ... [OPTIONS] [FLAGS]`,
+		);
+	}
+}
+
+export function showUsageOptions(options) {
+	options = Object.entries(options)
+		.filter(([, option]) => option?.param)
+		.sort(([a], [b]) => {
+			if (a < b) return -1;
+			else if (a > b) return 1;
+			else return 0;
+		});
+	if (options.length > 0) {
+		console.info("\nOPTIONS:");
+		const maxLength = options
+			.map((option) =>
+				option[1].param
+					? option[1].param.length + option[0].length + 3
+					: option[0].length,
+			)
+			.reduce((prev, curr) => (curr > prev ? curr : prev));
+		options.forEach((option) => {
+			if (option[1].hint) {
+				const str = `${option[0]}${option[1].param ? gray(` <${option[1].param}>`) : ""}`;
+				console.info(
+					"  ",
+					`--${str}${" ".repeat(maxLength - colorstrip(str).length)}`,
+					"  ",
+					option[1].hint,
+				);
+			}
+		});
+	}
+}
+
+export function showUsageSubcommand(cmd, subcmd, module) {
+	showUsageHeadline(cmd, subcmd, module);
+	showUsageOptions({ ...module?.flags, ...module.router[subcmd]?.options });
+	showUsageFlags({ ...module?.flags, ...module.router[subcmd]?.options });
+	showUsageEnvars(module.router[subcmd]?.envars || module?.envars);
+}
+
+export function showVersion() {
+	console.info(
+		`${colors.mcyan(`Witnet SDK v${require("../../package.json").version}`)}`,
+	);
+}
+
+export function getWildcardsCountFromString(str) {
+	let maxArgsIndex = 0;
+	if (str && typeof str === "string") {
+		let match;
+		const regexp = /\\\d\\/g;
+		while ((match = regexp.exec(str)) !== null) {
+			const argsIndex = parseInt(match[0][1], 10) + 1;
+			if (argsIndex > maxArgsIndex) maxArgsIndex = argsIndex;
+		}
+	}
+	return maxArgsIndex;
+}
+
+export function checkRpcWildcards(wildcards) {
+	if (typeof wildcards === "object") {
+		Object.values(wildcards).forEach((wildcard) => {
+			if (Array.isArray(wildcard))
+				wildcard.forEach((item) => checkRpcWildcards(item));
+			else checkRpcWildcards(wildcard);
+		});
+	} else if (Array.isArray(wildcards)) {
+		wildcards.forEach((wildcard) => checkRpcWildcards(wildcard));
+	} else if (typeof wildcards === "string") {
+		if (isWildcard(wildcards)) {
+			const char = wildcards.charAt(1);
+			if (char < "0" || char > "9") {
+				throw Error("RPC: wildcards not in range [0 .. 9]");
+			}
+		}
+	}
+}
+
+export function isWildcard(str) {
+	return str.length === 3 && /\\\d\\/g.test(str);
+}
+
+export function replaceWildcards(obj, args) {
+	if (args.length > 10) args = args.slice(0, 10);
+	if (obj && typeof obj === "string") {
+		for (let argIndex = 0; argIndex < args.length; argIndex++) {
+			const wildcard = `\\${argIndex}\\`;
+			obj = obj.replaceAll(wildcard, args[argIndex]);
+		}
+	} else if (obj && Array.isArray(obj)) {
+		obj = obj.map((value) =>
+			typeof value === "string" || Array.isArray(value)
+				? replaceWildcards(value, args)
+				: value,
+		);
+	} else if (obj && typeof obj === "object") {
+		obj = replaceObjectWildcards(obj, args);
+	}
+	return obj;
+}
+
+export function replaceObjectWildcards(obj, args) {
+	return Object.fromEntries(
+		Object.entries(obj).map(([key, value]) => {
+			for (let argIndex = 0; argIndex < args.length; argIndex++) {
+				const wildcard = `\\${argIndex}\\`;
+				key = key.replaceAll(wildcard, args[argIndex]);
+				value = replaceWildcards(value, args);
+			}
+			return [key, value];
+		}),
+	);
+}
+
+export function spliceWildcard(obj, argIndex, argValue, argsCount) {
+	if (obj && typeof obj === "string") {
+		const wildcard = `\\${argIndex}\\`;
+		obj = obj.replaceAll(wildcard, argValue);
+		for (let j = argIndex + 1; j < argsCount; j++) {
+			obj = obj.replaceAll(`\\${j}\\`, `\\${j - 1}\\`);
+		}
+	} else if (obj && Array.isArray(obj)) {
+		obj = obj.map((value) =>
+			typeof value === "string" || Array.isArray(value)
+				? spliceWildcard(value, argIndex, argValue, argsCount)
+				: value,
+		);
+	}
+	return obj;
+}
+
+export async function toolkitRun(settings, args) {
+	const cmd = `${settings.paths.toolkitBinPath} ${args.join(" ")}`;
+	return new Promise((resolve, reject) => {
+		exec(cmd, { maxBuffer: 1024 * 1024 * 10 }, (error, stdout, stderr) => {
+			if (error) {
+				reject(error);
+			}
+			if (stderr) {
+				reject(stderr);
+			}
+			resolve(stdout);
+		});
+	});
+}
+
+export function toUpperCamelCase(str) {
+	return str
+		.replace(/\b(\w)/g, (_match, capture) => capture.toUpperCase())
+		.replace(/\s+/g, "");
+}
+
+export function toUtf16Bytes(str) {
+	const bytes = new Uint8Array(str.length * 2);
+	for (let i = 0; i < str.length; i++) {
+		const code = str.charCodeAt(i);
+		bytes[i * 2] = code >> 8;
+		bytes[i * 2 + 1] = code & 0xff;
+	}
+	return bytes;
+}
+
+export function toUtf8Array(str) {
+	const utf8 = [];
+	for (let i = 0; i < str.length; i++) {
+		let charcode = str.charCodeAt(i);
+		if (charcode < 0x80) utf8.push(charcode);
+		else if (charcode < 0x800) {
+			utf8.push(0xc0 | (charcode >> 6), 0x80 | (charcode & 0x3f));
+		} else if (charcode < 0xd800 || charcode >= 0xe000) {
+			utf8.push(
+				0xe0 | (charcode >> 12),
+				0x80 | ((charcode >> 6) & 0x3f),
+				0x80 | (charcode & 0x3f),
+			);
+		} else {
+			// surrogate pair
+			i++;
+			// UTF-16 encodes 0x10000-0x10FFFF by
+			// subtracting 0x10000 and splitting the
+			// 20 bits of 0x0-0xFFFFF into two halves
+			charcode =
+				0x10000 + (((charcode & 0x3ff) << 10) | (str.charCodeAt(i) & 0x3ff));
+			utf8.push(
+				0xf0 | (charcode >> 18),
+				0x80 | ((charcode >> 12) & 0x3f),
+				0x80 | ((charcode >> 6) & 0x3f),
+				0x80 | (charcode & 0x3f),
+			);
+		}
+	}
+	return utf8;
+}
+
+export function utf8ArrayToStr(array) {
+	const len = array.length;
+	let out = "";
+	let i = 0;
+	let c;
+	let char2, char3;
+	while (i < len) {
+		c = array[i++];
+		switch (c >> 4) {
+			case 0:
+			case 1:
+			case 2:
+			case 3:
+			case 4:
+			case 5:
+			case 6:
+			case 7:
+				// 0xxxxxxx
+				out += String.fromCharCode(c);
+				break;
+			case 12:
+			case 13:
+				// 110x xxxx   10xx xxxx
+				char2 = array[i++];
+				out += String.fromCharCode(((c & 0x1f) << 6) | (char2 & 0x3f));
+				break;
+			case 14:
+				// 1110 xxxx  10xx xxxx  10xx xxxx
+				char2 = array[i++];
+				char3 = array[i++];
+				out += String.fromCharCode(
+					((c & 0x0f) << 12) | ((char2 & 0x3f) << 6) | ((char3 & 0x3f) << 0),
+				);
+				break;
+		}
+	}
+	return out;
+}
+
+export async function prompt(question) {
+	const readlineInterface = readline.createInterface({
+		input: process.stdin,
+		output: process.stdout,
+	});
+	return new Promise((resolve, _reject) => {
+		readlineInterface.question(`${question} `, (response) => {
+			readlineInterface.close();
+			resolve(response.trim());
+		});
+	});
+}
+
+export function prompter(promise) {
+	const loading = (() => {
+		const h = ["|", "/", "-", "\\"];
+		let i = 0;
+		return setInterval(() => {
+			i = i > 3 ? 0 : i;
+			process.stdout.write(`\b\b${h[i]} `);
+			i++;
+		}, 50);
+	})();
+	return promise.then((result) => {
+		clearInterval(loading);
+		process.stdout.write("\b\b");
+		return result;
+	});
+}
+
+export function traceChecklists(checklists) {
+	if (checklists && Object.keys(checklists).length > 0) {
+		const headlines = [
+			"NODES",
+			...Object.keys(checklists).map((key) => `:${key}`),
+		];
+		checklists = Object.values(checklists);
+		const urls = Object.keys(checklists[0]);
+		const records = urls.map((url) => {
+			const errors = checklists.filter(
+				(checklist) => checklist[url] instanceof Error,
+			).length;
+			return [
+				errors === checklists.length
+					? colors.red(url)
+					: errors > 0
+						? colors.myellow(url)
+						: colors.mcyan(url),
+				...checklists.map((checklist) =>
+					checklist[url] instanceof Error
+						? colors.red(checklist[url])
+						: checklist[url] === true
+							? colors.lcyan("Aye")
+							: colors.cyan("Nay"),
+				),
+			];
+		});
+		traceTable(records, {
+			headlines,
+			maxColumnWidth: 31,
+		});
+	}
+}
+
+export function traceHeader(headline, color = normal, indent = "") {
+	console.info(`${indent}┌─${"─".repeat(headline.length)}─┐`);
+	console.info(`${indent}│ ${color(headline)} │`);
+	console.info(`${indent}└─${"─".repeat(headline.length)}─┘`);
+}
+
+export function traceTable(records, options) {
+	const stringify = (data, humanizers, index) =>
+		humanizers?.[index]
+			? humanizers[index](data).toString()
+			: (data?.toString() ?? "");
+	const max = (a, b) => (a > b ? a : b);
+	const reduceMax = (numbers) =>
+		numbers.reduce((curr, prev) => (prev > curr ? prev : curr), 0);
+	if (!options) options = {};
+	const indent = options?.indent || "";
+	const numColumns = reduceMax(records.map((record) => record?.length || 1));
+	const maxColumnWidth = options?.maxColumnWidth || 80;
+	const table = transpose(records, numColumns);
+	options.widths =
+		options?.widths ||
+		table.map((column, index) => {
+			let maxWidth = reduceMax(
+				column.map(
+					(field) =>
+						colorstrip(stringify(field, options?.humanizers, index)).length,
+				),
+			);
+			if (options?.headlines?.[index]) {
+				maxWidth = max(
+					maxWidth,
+					colorstrip(options.headlines[index].replaceAll(":", "")).length,
+				);
+			}
+			return Math.min(maxWidth, maxColumnWidth);
+		});
+	let headline = options.widths.map((maxWidth) => "─".repeat(maxWidth));
+	console.info(`${indent}┌─${headline.join("─┬─")}─┐`);
+	if (options?.headlines) {
+		headline = options.widths.map((maxWidth, index) => {
+			const caption = options.headlines[index].replaceAll(":", "");
+			const captionLength = colorstrip(caption).length;
+			return `${white(caption)}${" ".repeat(maxWidth - captionLength)}`;
+		});
+		console.info(`${indent}│ ${headline.join(" │ ")} │`);
+		headline = options.widths.map((maxWidth) => "─".repeat(maxWidth));
+		console.info(`${indent}├─${headline.join("─┼─")}─┤`);
+	}
+	for (let i = 0; i < records.length; i++) {
+		let line = "";
+		for (let j = 0; j < numColumns; j++) {
+			let data = table[j][i];
+			let color;
+			if (options?.colors?.[j]) {
+				color = options.colors[j];
+			} else {
+				color =
+					typeof data === "string"
+						? green
+						: Number(data) === data && data % 1 !== 0 // is float number?
+							? yellow
+							: (x) => x;
+			}
+			data = stringify(data, options?.humanizers, j);
+			if (colorstrip(data).length > maxColumnWidth) {
+				while (colorstrip(data).length > maxColumnWidth - 3) {
+					data = data.slice(0, -1);
+				}
+				data += "...";
+			}
+			const dataLength = colorstrip(data).length;
+			if (options?.headlines && options.headlines[j][0] === ":") {
+				data = `${color(data)}${" ".repeat(options.widths[j] - dataLength)}`;
+			} else {
+				data = `${" ".repeat(options.widths[j] - dataLength)}${color(data)}`;
+			}
+			line += `│ ${data} `;
+		}
+		console.info(`${indent}${line}│`);
+	}
+	headline = options.widths.map((maxWidth) => "─".repeat(maxWidth));
+	console.info(`${indent}└─${headline.join("─┴─")}─┘`);
+}
+
+function transpose(records, numColumns) {
+	const columns = [];
+	for (let index = 0; index < numColumns; index++) {
+		columns.push(records.map((row) => row[index]));
+	}
+	return columns;
+}
+
+export function txJsonReplacer(key, value) {
+	switch (key) {
+		case "bytes":
+		case "der":
+			return toHexString(value, true);
+		case "tx":
+			return JSON.stringify(value, txJsonReplacer);
+		case "change":
+		case "fees":
+		case "value":
+			return parseInt(value, 10) / 10 ** 9;
+		default:
+			return value;
+	}
+}
+
+export function txReceiptJsonReplacer(key, value) {
+	switch (key) {
+		case "bytes":
+		case "der":
+			return toHexString(value, true);
+		case "tx":
+			return JSON.stringify(value, txJsonReplacer);
+		case "change":
+		case "fees":
+		case "value":
+			return parseInt(value?.pedros, 10) / 10 ** 9;
+		case "timestamp":
+			return moment.unix(value).format("MMMM Do YYYY, h:mm:ss a");
+		default:
+			return value;
+	}
+}
+
+export function traceTransactionOnCheckpoint(receipt) {
+	if (receipt?.confirmations) {
+		console.info(` > Checkpoint #${commas(receipt.confirmations)}...`);
+	}
+}
+
+export function traceTransactionOnStatusChange(receipt) {
+	const captions = {
+		pending: "Awaiting relay...",
+		// confirmed: "Transaction confirmed:",
+		// finalized: "Transaction finalized:",
+		relayed: "Awaiting inclusion...",
+		mined: "Awaiting confirmations...",
+	};
+	const caption = captions[receipt.status];
+	if (caption) console.info(` > ${captions[receipt.status]}`);
+	if (["finalized", "confirmed"].includes(receipt.status)) {
+		console.info(` > Block hash:   ${colors.gray(receipt?.blockHash)}`);
+		console.info(` > Block miner:  ${colors.cyan(receipt?.blockMiner)}`);
+		console.info(
+			` > Block epoch:  ${colors.white(commas(receipt?.blockEpoch))}`,
+		);
+		console.info(
+			` > Included at:  ${colors.green(moment.unix(receipt?.blockTimestamp).format("MMMM Do YYYY, h:mm:ss a"))}`,
+		);
+		console.info(
+			` > ${receipt.status[0].toUpperCase() + receipt.status.slice(1)} at: ${colors.mgreen(moment.unix(receipt.timestamp).format("MMMM Do YYYY, h:mm:ss a"))}`,
+		);
+	}
+}
+
+export function traceTransactionReceipt(receipt) {
+	const captions = {
+		DataRequest: " > DRT hash:     ",
+		ValueTransfer: " > VTT hash:     ",
+	};
+	console.info(
+		`${captions[receipt.type] || " > TX hash:      "}${colors.white(receipt.hash)}`,
+	);
+	if (receipt?.droHash)
+		console.info(` > DRO hash:     ${colors.green(receipt.droHash)}`);
+	if (receipt?.radHash)
+		console.info(` > RAD hash:     ${colors.mgreen(receipt.radHash)}`);
+	if (receipt?.droSLA)
+		console.info(` > SLA params:   ${JSON.stringify(receipt.droSLA)}`);
+	if (receipt?.withdrawer) {
+		if (receipt?.validator) {
+			console.info(` > Validator:    ${colors.mcyan(receipt.validator)}`);
+		}
+		console.info(` > Withdrawer:   ${colors.mmagenta(receipt.withdrawer)}`);
+	} else {
+		const signers = Array.isArray(receipt.from) ? receipt.from : [receipt.from];
+		console.info(` > Signer/s:     ${colors.mmagenta(signers[0])}`);
+		signers.slice(1).forEach((signer) => {
+			console.info(`                 ${colors.mmagenta(signer)}`);
+		});
+	}
+	if (receipt?.recipients) {
+		console.info(
+			` > Recipient/s:  ${colors.mblue(
+				receipt.recipients.filter(
+					(pkh, index, array) => index === array.indexOf(pkh),
+				),
+			)}`,
+		);
+	}
+	if (receipt?.fees)
+		console.info(` > Network fee:  ${colors.yellow(receipt.fees.toString(2))}`);
+	if (receipt?.value)
+		console.info(
+			` > Value:        ${colors.myellow(receipt.value.toString(2))}`,
+		);
+	if (receipt?.weight)
+		console.info(` > Weight:       ${colors.mgreen(commas(receipt.weight))}`);
+	if (receipt?.witnesses) {
+		console.info(` > Witnesses:    ${receipt.witnesses}`);
+	}
+}
+
+export async function traceTransaction(transmitter, options) {
+	const color = options?.color || ((x) => `\x1b[30;45m${x}\x1b[0m`);
+	let receipt = await transmitter.signTransaction(options, options?.reload);
+	if (options?.verbose) {
+		console.info(`\n${gray(JSON.stringify(receipt.tx, txJsonReplacer))}`);
+	}
+	if (options?.headline) {
+		console.info(`\n ${color(`  ${options.headline}  `)}\n`);
+	}
+	traceTransactionReceipt(receipt);
+	if (!options?.force) {
+		// prompt user confirmation
+		console.info();
+		const answer = await require("inquirer").createPromptModule()([
+			{
+				message: "Send transaction?",
+				type: "confirm",
+				name: "continue",
+				default: false,
+			},
+		]);
+		if (!answer.continue) {
+			return receipt;
+		}
+	}
+	try {
+		console.info();
+		receipt = await transmitter.sendTransaction();
+		if (options?.await || options?.confirmations !== undefined) {
+			receipt = await transmitter.confirmTransaction(receipt.hash, {
+				confirmations: options?.confirmations || 0,
+				onCheckpoint: traceTransactionOnCheckpoint,
+				onStatusChange: traceTransactionOnStatusChange,
+			});
+		} else {
+			const data = {
+				status: receipt?.status,
+				timestamp: receipt?.timestamp || Math.floor(Date.now() / 1000),
+			};
+			console.info(data);
+		}
+	} catch (err) {
+		if (err?.inFlight && err.inFlight) {
+			console.info(
+				`\n${colors.gray(JSON.stringify(err.inFligt?.message, txReceiptJsonReplacer))}`,
+			);
+		}
+		throw err;
+	}
+	return receipt;
+}
+
+export function unescapeSlashes(str) {
+	// add another escaped slash if the string ends with an odd
+	// number of escaped slashes which will crash JSON.parse
+	let parsedStr = str.replace(/(^|[^\\])(\\\\)*\\$/, "$&\\");
+
+	// escape unescaped double quotes to prevent error with
+	// added double quotes in json string
+	parsedStr = parsedStr.replace(/(^|[^\\])((\\\\)*")/g, "$1\\$2");
+
+	try {
+		parsedStr = JSON.parse(`"${parsedStr}"`);
+	} catch (_e) {
+		return str;
+	}
+	return parsedStr;
+}