@witnet/sdk 1.1.3 → 1.2.0

package/src/bin/helpers.js

@@ -1,873 +1,974 @@
-const { exec } = require("child_process")
-const moment = require("moment")
-const net = require("net")
-const os = require("os")
-const readline = require("readline")
-
-const colorstrip = (str) => str.replace(
-  /[\u001b\u009b][[()#;?]*(?:[0-9]{1,4}(?:;[0-9]{0,4})*)?[0-9A-ORZcf-nqry=><]/g, ""
-)
-
-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
-}
-
-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}`
+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;
 };
 
-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`
-
-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)
-}
-
-function deleteExtraFlags (args) {
-  return args.filter(arg => !arg.startsWith("--"))
-}
-
-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 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)";
 };
 
-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)
-    // })
-  }
-}
-
-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]
-}
-
-function fromHexString (hexString) {
-  if (hexString.startsWith("0x")) hexString = hexString.slice(2)
-  return Uint8Array.from(hexString.match(/.{1,2}/g).map((byte) => parseInt(byte, 16)))
-}
-
-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
-}
-
-function isHexStringOfLength (str, length) {
-  return (isHexString(str) &&
-        (
-          (str.startsWith("0x") && str.slice(2).length === length * 2) ||
-            str.length === length * 2
-        )
-  ) || isWildcard(str)
-}
-
-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)
-}
-
-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("")
-}
-
-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}`)
-  }
-}
-
-function showUsage (cmd, module) {
-  showUsageHeadline(cmd)
-  showUsageOptions({ ...module?.flags })
-  showUsageFlags({ ...module?.flags })
-  showUsageRouter({ ...module?.router })
-  showUsageEnvars({ ...module?.envars })
-}
-
-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)
-    })
-  }
-}
-
-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(error?.stack?.split("\n")[0] || error)
-    }
-  }
-}
-
-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}`)
-        }
-      })
-    }
-  }
-}
-
-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)
-        }
-      })
-    }
-  }
-}
-
-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(`   ${white(`npx witsdk ${cmd}`)} ${white(subcmd)} ${params ? green(params) + " " : ""}[OPTIONS] [FLAGS]`)
-    if (module?.router[subcmd]?.hint) {
-      console.info("\nDESCRIPTION:")
-      console.info(`   ${module.router[subcmd].hint}`)
-    }
-  } else {
-    console.info(`   ${white(`npx witsdk ${cmd}`)} <SUBCOMMAND> ... [OPTIONS] [FLAGS]`)
-  }
-}
-
-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)
-      }
-    })
-  }
-}
-
-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)
-}
-
-function showVersion () {
-  console.info(`${mcyan(`Witnet SDK v${require("../../package.json").version}`)}`)
-}
-
-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]) + 1
-      if (argsIndex > maxArgsIndex) maxArgsIndex = argsIndex
-    }
-  }
-  return maxArgsIndex
-}
-
-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]")
-      }
-    }
-  }
-}
-
-function isWildcard (str) {
-  return str.length === 3 && /\\\d\\/g.test(str)
-}
-
-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
-}
-
-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]
-    })
-  )
-}
-
-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
-}
-
-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)
-    })
-  })
-}
-
-function toUpperCamelCase (str) {
-  return str.replace(/\b(\w)/g, function (match, capture) {
-    return capture.toUpperCase()
-  }).replace(/\s+/g, "")
-}
-
-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;
-}
-
-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
-}
-
-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
-}
-
-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())
-    })
-  })
-}
-
-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
-    })
-}
-
-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 ? red(url) : (errors > 0 ? myellow(url) : mcyan(url)),
-        ...checklists.map(checklist => checklist[url] instanceof Error
-          ? red(checklist[url])
-          : (checklist[url] === true ? lcyan("Aye") : cyan("Nay"))
-        ),
-      ]
-    })
-    traceTable(records, {
-      headlines,
-      maxColumnWidth: 31,
-    })
-  }
-}
-
-function traceHeader (headline, color = normal, indent = "",) {
-  console.info(`${indent}┌─${"─".repeat(headline.length)}─┐`)
-  console.info(`${indent}│ ${color(headline)} │`)
-  console.info(`${indent}└─${"─".repeat(headline.length)}─┘`)
-}
-
-function traceTable (records, options) {
-  const stringify = (data, humanizers, index) => humanizers && 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 && 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 && 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
-}
-
-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 ** 9
-    default:
-      return value
-  }
-}
-
-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 ** 9
-    case "timestamp":
-      return moment.unix(value).format("MMMM Do YYYY, h:mm:ss a")
-    default:
-      return value
-  }
-}
-
-function traceTransactionOnCheckpoint (receipt) {
-  if (receipt?.confirmations) {
-    console.info(` > Checkpoint #${commas(receipt.confirmations)}...`)
-  }
-}
-
-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:   ${gray(receipt?.blockHash)}`)
-    console.info(` > Block miner:  ${cyan(receipt?.blockMiner)}`);
-    console.info(` > Block epoch:  ${white(commas(receipt?.blockEpoch))}`)
-    console.info(` > Included at:  ${green(moment.unix(receipt?.blockTimestamp).format("MMMM Do YYYY, h:mm:ss a"))}`)
-    console.info(` > ${receipt.status[0].toUpperCase() + receipt.status.slice(1)} at: ${mgreen(moment.unix(receipt.timestamp).format("MMMM Do YYYY, h:mm:ss a"))}`)
-  }
-}
-
-function traceTransactionReceipt (receipt) {
-  const captions = {
-    DataRequest: " > DRT hash:     ",
-    ValueTransfer: " > VTT hash:     ",
-  }
-  console.info(`${captions[receipt.type] || " > TX hash:      "}${white(receipt.hash)}`)
-  if (receipt?.droHash) console.info(` > DRO hash:     ${green(receipt.droHash)}`)
-  if (receipt?.radHash) console.info(` > RAD hash:     ${mgreen(receipt.radHash)}`)
-  if (receipt?.droSLA) console.info(` > SLA params:   ${JSON.stringify(receipt.droSLA)}`)
-  if (receipt?.withdrawer) {
-    if (receipt?.validator) {
-      console.info(` > Validator:    ${mcyan(receipt.validator)}`)
-    }
-    console.info(` > Withdrawer:   ${mmagenta(receipt.withdrawer)}`)
-  } else {
-    const signers = Array.isArray(receipt.from) ? receipt.from : [receipt.from]
-    console.info(` > Signer/s:     ${mmagenta(signers[0])}`)
-    signers.slice(1).forEach(signer => {
-      console.info(`                 ${mmagenta(signer)}`)
-    })
-  }
-  if (receipt?.recipients) {
-    console.info(` > Recipient/s:  ${
-      mblue(receipt.recipients.filter((pkh, index, array) => index === array.indexOf(pkh)))
-    }`)
-  }
-  if (receipt?.fees) console.info(` > Network fee:  ${yellow(receipt.fees.toString(2))}`)
-  if (receipt?.value) console.info(` > Value:        ${myellow(receipt.value.toString(2))}`)
-  if (receipt?.weight) console.info(` > Weight:       ${mgreen(commas(receipt.weight))}`)
-  if (receipt?.witnesses) {
-    console.info(` > Witnesses:    ${receipt.witnesses}`)
-  }
-}
-
-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${gray(JSON.stringify(err.inFligt?.message, txReceiptJsonReplacer))}`)
-    }
-    throw err
-  }
-  return receipt
-}
-
-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 ;
-}
-
-module.exports = {
-  colors: {
-    bblue,
-    bcyan,
-    bgreen,
-    blue,
-    bred,
-    bviolet,
-    cyan,
-    gray,
-    green,
-    magenta,
-    red,
-    white,
-    yellow,
-    normal,
-    lcyan,
-    lgray,
-    lgreen,
-    lmagenta,
-    lyellow,
-    mblue,
-    mcyan,
-    mgreen,
-    mmagenta,
-    mred,
-    myellow,
-  },
-  colorstrip,
-  commas,
-  whole_wits,
-  toFixedTrunc,
-  countLeaves,
-  execRadonBytecode,
-  deleteExtraFlags,
-  extractFromArgs,
-  fromHexString,
-  isHexString,
-  isHexStringOfLength,
-  toHexString,
-  parseURL,
-  ipIsPrivateOrLocalhost,
-  showUsage,
-  showUsageError,
-  showUsageSubcommand,
-  showVersion,
-  toolkitRun,
-  toUpperCamelCase,
-  toUtf16Bytes,
-  toUtf8Array,  
-  utf8ArrayToStr,
-  prompt,
-  prompter,
-  traceChecklists,
-  traceHeader,
-  traceTable,
-  traceTransaction,
-  traceTransactionOnStatusChange,
-  traceTransactionOnCheckpoint,
-  traceTransactionReceipt,
-  checkRpcWildcards,
-  isWildcard,
-  getWildcardsCountFromString,
-  replaceWildcards,
-  spliceWildcard,
-  txJsonReplacer,
-  unescapeSlashes,
+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;
 }