evm-contracts-tools 0.0.62 → 0.0.64

package/libevm-contract-call

@@ -2,25 +2,27 @@
 
 // SPDX-License-Identifier: AGPL-3.0-or-later
 
-/**    ----------------------------------------------------------------
+/**    ----------------------------------------------------------
  *     libevm-contract-call
- *     ----------------------------------------------------------------
+ *     ----------------------------------------------------------
  *     Copyright ©
  *       Pellegrino Prevete
- *         2024, 2025, 2026
+ *         2025, 2026
  * 
  *     All rights reserved
- *     ----------------------------------------------------------------
+ *     ----------------------------------------------------------
  * 
- *     This program is free software: you can redistribute it and/or
- *     modify it under the terms of the GNU General Public License as
- *     published by the Free Software Foundation, either version 3 of
- *     the License, or (at your option) any later version.
+ *     This program is free software: you can redistribute it
+ *     and/or modify it under the terms of the GNU General
+ *     Public License as published by the Free Software
+ *     Foundation, either version 3 of the License, or
+ *     (at your option) any later version.
  * 
- *     This program is distributed in the hope that it will be useful,
- *     but WITHOUT ANY WARRANTY; without even the implied warranty of
- *     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- *     GNU General Public License for more details.
+ *     This program is distributed in the hope that it will
+ *     be useful, but WITHOUT ANY WARRANTY; without even the
+ *     implied warranty of MERCHANTABILITY or FITNESS FOR A
+ *     PARTICULAR PURPOSE.
+ *     See the GNU General Public License for more details.
  * 
  *     You should have received a copy of the
  *     GNU General Public License
@@ -80,6 +82,11 @@ const
 const
   _echo =
     _libcrash_module._echo;
+/* global
+     _echo2*/
+const
+  _echo2=
+    _libcrash_module._echo2;
 /* global
      _file_exists */
 const
@@ -90,6 +97,11 @@ const
 const
   _get =
     _libcrash_module._get;
+/* global
+     _global_get */
+const
+  _global_get =
+    _libcrash_module._global_get;
 /* global
      _homedir_get */
 const
@@ -145,6 +157,70 @@ const
 const
   _set =
     _libcrash_module._set;
+const
+  _libevm_contract_deployment_module =
+    await import(
+      "./libevm-contract-deployment");
+/* global
+     _contract_abi_auto_detect */
+const
+  _contract_abi_auto_detect =
+    _libevm_contract_deployment_module._contract_abi_auto_detect;
+/* global
+     _contract_abi_check */
+const
+  _contract_abi_check =
+    _libevm_contract_deployment_module._contract_abi_check;
+/* global
+     _contract_address_auto_detect */
+const
+  _contract_address_auto_detect =
+    _libevm_contract_deployment_module._contract_address_auto_detect;
+/* global
+     _contract_address_check */
+const
+  _contract_address_check =
+    _libevm_contract_deployment_module._contract_address_check;
+/* global
+     _contract_bytecode_auto_detect */
+const
+  _contract_bytecode_auto_detect =
+    _libevm_contract_deployment_module._contract_bytecode_auto_detect;
+/* global
+     _contract_bytecode_check */
+const
+  _contract_bytecode_check =
+    _libevm_contract_deployment_module._contract_bytecode_check;
+/* global
+     _contract_compiler_output_auto_detect */
+const
+  _contract_compiler_output_auto_detect =
+    _libevm_contract_deployment_module._contract_compiler_output_auto_detect;
+/* global
+     _contract_compiler_output_check */
+const
+  _contract_compiler_output_check =
+    _libevm_contract_deployment_module._contract_compiler_output_check;
+/* global
+     _default_artifact_path_get */
+const
+  _default_artifact_path_get =
+    _libevm_contract_deployment_module._default_artifact_path_get;
+/* global
+     _deployments_dir_auto_detect */
+const
+  _deployments_dir_auto_detect =
+    _libevm_contract_deployment_module._deployments_dir_auto_detect;
+/* global
+     _target_contract_auto_detect */
+const
+  _target_contract_auto_detect =
+    _libevm_contract_deployment_module._target_contract_auto_detect;
+/* global
+     _target_contract_check */
+const
+  _target_contract_check =
+    _libevm_contract_deployment_module._target_contract_check;
 const
   _evm_contracts_tools_module =
     await import(
@@ -154,6 +230,16 @@ const
 const
   _address_check =
     _evm_contracts_tools_module._address_check;
+/* global
+     _contract_call_static */
+const
+  _contract_call_static =
+    _evm_contracts_tools_module._contract_call_static;
+/* global
+     _contract_run */
+const
+  _contract_run =
+    _evm_contracts_tools_module._contract_run;
 const
   _evm_contract_deployment_address_module =
     await import(
@@ -163,6 +249,33 @@ const
 const
   _evm_contract_deployment_address =
     _evm_contract_deployment_address_module._evm_contract_deployment_address;
+const
+  _evm_contract_deployment_abi_module =
+    await import(
+      "./libevm-contract-deployment-abi");
+/* global
+     _evm_contract_deployment_abi */
+const
+  _evm_contract_deployment_abi =
+    _evm_contract_deployment_abi_module._evm_contract_deployment_abi;
+const
+  _evm_contract_deployment_bytecode_module =
+    await import(
+      "./libevm-contract-deployment-bytecode");
+/* global
+     _evm_contract_deployment_bytecode */
+const
+  _evm_contract_deployment_bytecode =
+    _evm_contract_deployment_bytecode_module._evm_contract_deployment_bytecode;
+const
+  _evm_contract_deployment_compiler_output_module =
+    await import(
+      "./libevm-contract-deployment-compiler-output");
+/* global
+     _evm_contract_deployment_compiler_output */
+const
+  _evm_contract_deployment_compiler_output =
+    _evm_contract_deployment_compiler_output_module._evm_contract_deployment_compiler_output;
 const
   _evm_contract_deployments_dir_module =
     await import(
@@ -185,24 +298,129 @@ const
 function
   _target_networks_get(
     _target_networks) {
+  let
+    _msg,
+    _target_networks_type;
+  const
+    _global =
+      _global_get();
+  const
+    _quiet =
+      _global[
+        "quiet"];
   // TODO:
   //   _evm_wallet_module._balance_discovery
-  const
-    _target_networks_type =
-      typeof(
-        _target_networks);
-  if ( _target_networks_type == "undefined" ) {
+  _target_networks_type =
+    typeof(
+      _target_networks);
+  if ( _target_networks_type === "undefined" ) {
     _target_networks =
       _get(
         "target",
         "networks");
-  }
-  if ( _target_networks == "" ||
-       _target_networks == [] ) {
-    // to be auto-detected
-    _target_networks = [
-        "1"
+    _msg =
+      "Variable '_target_networks' undefined, " +
+      `defaulting to value ` +
+      `'${_target_networks}' of global variable ` +
+      `'target_networks'.`;
+    _msg_info(
+      _msg);
+    _target_networks_type =
+      typeof(
+        _target_networks);
+    if ( _target_networks_type === "undefined" ) {
+      _msg =
+        "Global variable 'target_networks' undefined, " +
+        `defaulting to chain with ID 1.`;
+      _msg_info(
+        _msg);
+      _target_networks = [
+        1
       ];
+    }
+    else if ( _target_networks_type === "string" ) {
+      if ( _target_networks.length < 1 ) {
+        _msg =
+          "Global variable 'target_networks' undefined, " +
+          `defaulting to chain with ID 1.`;
+        _msg_info(
+          _msg);
+        _target_networks = [
+          1
+        ];
+      }
+      else {
+        _msg =
+          `Unknown type '${_target_networks_type}' ` +
+          `for variable '_target_networks'.`;
+        _msg_error(
+          _msg,
+          0);
+        _echo2(
+          _target_networks);
+        throw _msg;
+      }
+    }
+  }
+  else if ( _target_networks_type === "string" ) {
+    if ( _target_networks.length < 1 ) {
+      _target_networks =
+        _get(
+          "target",
+          "networks");
+      _msg =
+        "Variable '_target_networks' undefined, " +
+        `defaulting to value ` +
+        `'${_target_networks}' of global variable ` +
+        `'target_networks'.`;
+      _msg_info(
+        _msg);
+      _target_networks_type =
+        typeof(
+          _target_networks);
+      if ( _target_networks_type === "undefined" ) {
+        _msg =
+          "Global variable 'target_networks' undefined, " +
+          `defaulting to chain with ID 1.`;
+        _msg_info(
+          _msg);
+        _target_networks = [
+          1
+        ];
+      }
+    }
+    else {
+      _msg =
+        `Invalid type 'string' ` +
+        `for variable '_target_networks' ` +
+        `('${_target_networks}').`;
+      _msg_error(
+        _msg,
+        0);
+      _echo2(
+        _target_networks);
+      throw _msg;
+    }
+  }
+  else if ( _target_networks_type === "array" ||
+            _target_networks_type === "object" ) {
+    _msg =
+      "Selecting target networks:";
+    _msg_info(
+      _msg);
+    if ( _quiet == "n" ) {
+      _echo(
+        _target_networks);
+    }
+  }
+  else {
+    _msg =
+      "Variable '_target_networks' must be of " +
+      "type 'array'.";
+    _msg_error(
+      _msg,
+      0);
+    throw _msg;
   }
   const
     _target_network =   
@@ -238,210 +456,11 @@ function
     _target_network);
 }
 
-function
-  _default_artifact_path_get(
-    _type,
-    _target_network,
-    _contract_address) {
-  let
-    _file_name;
-  const
-    _network_type =
-      typeof(
-        _target_network);
-  if ( _network_type === "undefined" ||
-       _target_network === "" ) {
-    _target_network =
-      _get(
-        "target",
-        "network");
-  }
-  const
-    _contract_address_type =
-      typeof(
-        _contract_address);
-  if ( _contract_address_type === "undefined" ||
-       _contract_address === "" ) {
-    _contract_address =
-      _get(
-        "contract",
-        "address");
-  }
-  const
-    _home =
-      _homedir_get();
-  const
-    _data_dir =
-      _path_join( [
-        _home,
-        ".local",
-        "share",
-        "evm-contract-call" ]);
-  if ( _type == "abi" ) {
-    _file_name =
-      `${_contract_address}.abi.json`;
-  }
-  else if ( _type == "bytecode" ) {
-    _file_name =
-      `${_contract_address}.bin`;
-  }
-  else if ( _type == "compiler_output" ) {
-    _file_name =
-      `${_contract_address}.json`;
-  }
-  else {
-    const
-      _msg =
-        `Unknown artifact type '${_type}'.`;
-    _msg_error(
-      _msg,
-      0);
-    throw _msg;
-  }
-  const
-    _artifact =
-      _path_join( [
-        _data_dir,
-        _target_network,
-        _file_name ]);
-  return _artifact;
-}
-
 function
   _contract_artifacts_retrieve() {
   true;
 }
 
-function
-  _contract_abi_get(
-    _network,
-    _address,
-    _api_key,
-    _compiler_output,
-    _abi) {
-  let
-    _abi_target;
-  const
-    _abi_type =
-      typeof(
-        _abi);
-  if ( _abi_type == "undefined" ) {
-    _abi =
-      _get(
-        "contract",
-        "abi");
-  }
-  const
-    _network_type =
-      typeof(
-        _network);
-  if ( _network_type == "undefined" ) {
-    _network =
-      _get(
-        "target",
-        "network");
-  }
-  const
-    _address_type =
-      typeof(
-        _address);
-  if ( _address_type == "undefined" ) {
-    _address =
-      _get(
-        "contract",
-        "address");
-  }
-  const
-    _api_key_type =
-      typeof(
-        _api_key);
-  if ( _api_key_type == "undefined" ) {
-    _api_key =
-      _get(
-        "api",
-        "key");
-  }
-  const
-    _compiler_output_type =
-      typeof(
-        _compiler_output);
-  if ( _compiler_output_type == "undefined" ) {
-    _compiler_output =
-      _get(
-        "contract",
-        "compiler_output");
-  }
-  _abi_target =
-    _abi;
-  if ( typeof(
-         _abi_target) === "undefined" ||
-       _abi_target === "" ) {
-    _abi_target =
-      _default_artifact_path_get(
-        "abi");
-  }
-  const
-    _abi_dir =
-      _dirname(
-        _abi);
-  if ( ! _file_exists(
-           _abi) &&
-       ! _file_exists(
-           _compiler_output) ) {
-    if ( _file_exists(
-           _abi_target) ) {
-      _abi =
-        _abi_target;
-    }
-    else {
-      _contract_artifacts_retrieve(
-        _abi_dir);
-    }
-  }
-  return _abi;
-}
-
-function
-  _contract_abi_auto_detect() {
-  let
-    _abi;
-  const
-    _network =
-      _get(
-        "target",
-        "network");
-  const
-    _address =
-      _get(
-        "contract",
-        "address");
-  const
-    _api_key =
-      _get(
-        "api",
-        "key");
-  const
-    _compiler_output =
-      _get(
-        "contract",
-        "compiler_output");
-  _abi =
-    _get(
-      "contract",
-      "abi");
-  _abi =
-    _contract_abi_get(
-      _network,
-      _address,
-      _api_key,
-      _compiler_output,
-      _abi);
-  _override_set(
-    "contract",
-    "abi",
-    _abi);
-}
-
 function
   _call_auth_get(
     _call_type) {
@@ -494,6 +513,98 @@ function
     _call_type);
 }
 
+function
+  _call_type_check(
+    _call_type) {
+  let
+    _msg;
+  const
+    _call_type_type =
+      typeof(
+        _call_type);
+  if ( _call_type_type == "undefined" ) {
+    _call_type =
+      "static";
+  }
+  else if ( _call_type_type == "string" ) {
+    if ( _call_type.length < 1 ) {
+      // To be properly auto-detected.
+      _call_type =
+        "static";
+    }
+  }
+  else if ( _call_type_type == "object" ||
+            _call_type_type == "array" ) {
+    _msg =
+      "Parameter '_call_type' " +
+      "must be of type 'string'";
+    _msg_error(
+      _msg,
+      0);
+    throw _msg;
+  }
+  else {
+    _msg =
+      `Call type '${_call_type}' ` +
+      `('${_call_type_type}'):`;
+    _msg_error(
+      _msg,
+       0);
+    _echo2(
+      _call_type);
+    throw _msg;
+  }
+  return _call_type;
+}
+
+function
+  _contracts_init(
+    _contracts,
+    _target_networks) {
+  let
+    _network;
+  for ( _network of _target_networks ) {
+    if ( ! ( _network in _contracts ) ) {
+      _contracts[
+        _network] =
+        "";
+    }
+  }
+  return _contracts;
+}
+
+function
+  _methods_init(
+    _methods,
+    _target_networks) {
+  let
+    _network;
+  for ( _network of _target_networks ) {
+    if ( ! ( _network in _methods ) ) {
+      _methods[
+        _network] =
+        "";
+    }
+  }
+  return _methods;
+}
+
+function
+  _target_networks_check(
+    _target_networks) {
+  const
+    _target_networks_length =
+      _target_networks.length;
+  if ( _target_networks.length < 1 ) {
+    const
+      _msg =
+        "Auto-selecting network (chain ID '1').";
+    _target_networks.push(
+      1);
+  }
+  return _target_networks;
+}
+
 async function
   _evm_contract_call(
     _call_type,
@@ -514,75 +625,245 @@ async function
     _contract_bytecode,
     _contract_compiler_output,
     _contract_method,
-    _method_args) {
-  // let
-  //   _msg,
-  //   _out;
+    _method_args,
+    _output_file) {
+  let
+    _contract,
+    _contract_run_args,
+    _contracts,
+    _msg,
+    _method,
+    _methods,
+    _network,
+    _out,
+    _receipt,
+    _static_call_args,
+    _tx,
+    _value;
   const
-    _call_type_type =
+    _global =
+      _global_get();
+  const
+    _quiet =
+      _global[
+        "quiet"];
+  _contracts =
+    {};
+  _methods =
+    {};
+  _target_networks =
+    _target_networks_check(
+      _target_networks);
+  _contracts =
+    _contracts_init(
+      _contracts,
+      _target_networks);
+  _methods =
+    _methods_init(
+      _methods,
+      _target_networks);
+  _out =
+    [];
+  _call_type =
+    _call_type_check(
+      _call_type);
+  // const
+  //   _rpc =
+  //     await =
+  //       _rpc_get.apply(
+  //         null,
+  //         _rpc_get_args);
+  // _out.push(
+  //   _call_type);
+  // return _out;
+  // _msg =
+  //   "Running EVM network call " +
+  //   `of type '${_call_type}'.`;
+  // _msg_info(
+  //   _msg);
+  if ( _call_type == "static" ) {
+    for ( _network of _target_networks ) {
+      _method =
+        _methods[
+          _network];
+      _static_call_args = [
+        _wallet_seed,
+        _retries_max,
+        _api_key,
+        _network,
+        _contract_abi,
+        _contract_bytecode,
+        _contract_compiler_output,
+        _method,
+        _contract_address,
+        _contract_method,
+        _method_args
+      ];
+      _msg =
+        "Performing static call " +
+        `on network '${_network}' ` +
+        "with arguments:";
+      _msg_info(
+        _msg);
+      if ( _quiet == "n" ) {
+        _echo(
+          _static_call_args);
+      }
+      try {
+        [ _value,
+          _method ] =
+          await _contract_call_static.apply(
+            null,
+            _static_call_args);
+      }
+      catch(
+        _error) {
+        _msg =
+          "Error running '_contract_call_static' " +
+          "with arguments:";
+        _msg_error(
+          _msg,
+          0);
+        _echo2(
+          _static_call_args);
+        throw _error;
+      }
+      _out.push(
+        _value);
+    }
+  }
+  else if ( _call_type == "dynamic" ) {
+    for ( _network of _target_networks ) {
+      _method =
+        _methods[
+          _network];
+      _contract =
+        _contracts[
+          _network];
+      _contract_run_args = [
+        _retries_max,
+        _call_timeout,
+        _wallet_seed,
+        _wallet_password,
+        _api_key,
+        _price_gas,
+        _msg_value,
+        _measure_unit,
+        _network,
+        _contract_address,
+        _contract_abi,
+        _contract_bytecode,
+        _contract_compiler_output,
+        _contract_method,
+        _method_args,
+        _output_file,
+        _quiet,
+        _contract,
+        _method
+      ];
+      [ _tx,
+        _receipt,
+        _method,
+        _contract ] =
+        await _contract_run.apply(
+          null,
+          _contract_run_args);
+      _out.push([
+        _tx,
+        _receipt
+      ]);
+    }
+    _out =
+      await _contract_run.apply(
+        null,
+        _contract_run_args);
+  }
+  return _out;
+}
+
+function
+  _artifact_type_check(
+    _artifact_type) {
+  let
+    _flag_empty,
+    _flag_wrong,
+    _msg_empty,
+    _msg_wrong;
+  _flag_empty =
+    false;
+  _flag_wrong =
+    false;
+  const
+    _artifact_type_type =
       typeof(
-        _call_type);
-  if ( _call_type_type == "undefined" ) {
-    _call_type =
-      "static";
+        _artifact_type);
+  if ( _artifact_type_type === "undefined" ) {
+    _msg_empty =
+      "Artifact type undefined.";
+    _flag_empty =
+      true;
   }
-  else if ( _call_type_type == "string" ) {
-    if ( _call_type.length < 1 ) {
-      // Properly
-      _call_type =
-        "static";
+  else if ( _artifact_type_type === "string" ) {
+    if ( _artifact_type_type.length < 1 ) {
+    _msg_empty =
+      "Artifact type not set.";
+    _flag_empty =
+      true;
     }
     else {
-      _echo(
-        _call_type);
+      if ( _artifact_type !== "abi" &&
+           _artifact_type !== "bytecode" &&
+           _artifact_type !== "compiler_output" ) {
+        _msg_wrong =
+          "Artifact type can be 'abi', " +
+          "'bytecode' or 'compiler_output'.";
+        _flag_wrong =
+          true;
+      }
     }
   }
-  else if ( _call_type_type == "object" ) {
-    _echo(
-      _call_type);
-  }
   else {
-    _echo(
-      _call_type);
+    _msg_wrong =
+      "Artifact type must be of type string.";
+    _flag_wrong =
+      true;
   }
-  return [ _call_type ];
-  // _msg =
-  //   "Running EVM network call " +
-  //   `of type '${_call_type}'.`;
-  // _msg_info(
-  //   _msg);
-  // if ( _call_type == "static" ) {
-  //   _out =
-  //     "static";
-  //   _echo(
-  //     "static");
-  //   // const
-  //   //   _infos =
-  //   //     [];
-  //   // _out =
-  //   //   "";
-  // }
-  // else if ( _call_type == "dynamic" ) {
-  //   _echo(
-  //     "dynamic");
-  //   _out =
-  //     "static";
-  // }
-  // else {
-  //   _msg =
-  //     `Unknown call type ` +
-  //     `'${_call_type}'.`;
-  //   _msg_error(
-  //     _msg,
-  //     0);
-  //   throw _msg;
-  // }
-  // return _out;
+  if ( _flag_empty ) {
+    _msg_error(
+      _msg_empty,
+      0);
+    throw _msg_empty;
+  }
+  if ( _flag_wrong ) {
+    _msg_error(
+      _msg_wrong,
+      0);
+    throw _msg_wrong;
+  }
+  return _artifact_type;
 }
 
 function
   _artifact_local_auto_detect(
     _artifact_type) {
+  let
+    _msg;
+  try {
+    _artifact_type =
+      _artifact_type_check(
+        _artifact_type);
+  }
+  catch(
+    _error) {
+    _msg =
+      "Error checking artifact type.";
+    _msg_error(
+      _msg,
+      0);
+    _echo2(
+      _error);
+    throw _error;
+  }
   const
     _artifact =
       _default_artifact_path_get(
@@ -856,161 +1137,6 @@ async function
     _target_app);
 }
 
-async function
-  _target_contract_auto_detect() {
-  let
-    _target_contract;
-  _target_contract =
-    "";
-  const
-    _contract_address =
-      _get(
-        "contract",
-        "address");
-  const
-    _address_valid =
-      await _address_check(
-        _contract_address);
-  if ( ! _address_valid ) {
-    _target_contract =
-      _contract_address;
-  }
-  _override_set(
-    "target",
-    "contract",
-    _target_contract);
-}
-
-async function
-  _contract_address_auto_detect() {
-  let
-    _contract_address,
-    _contract_addresses,
-    _evm_contract_deployment_address_args,
-    _msg,
-    _network;
-  const
-    _target_networks_index =
-      {};
-  _contract_address =
-    _get(
-      "contract",
-      "address");
-  const
-    _target_app =
-      _get(
-        "target",
-        "app");
-  const
-    _target_networks =
-      _get(
-        "target",
-        "networks");
-  const
-    _target_contract =
-      _get(
-        "target",
-        "contract");
-  const
-    _deployments_dir =
-      _get(
-        "deployments",
-        "dir");
-  for ( _network of _target_networks ) {
-    _target_networks_index[
-      _network] =
-        1;
-  }
-  const
-    _target_networks_set =
-      Object.keys(
-        _target_networks_index);
-  _msg =
-    "Auto-detecting address " +
-    `for contract '${_contract_address}' ` +
-    `on network '${_target_networks_set}' ` +
-    `for application '${_target_app}'.`;
-  _msg_info(
-    _msg);
-  if ( _contract_address != "" ) {
-    const
-      _address_valid =
-        await _address_check(
-          _contract_address);
-    if ( _address_valid ) {
-      _msg =
-        `Address '${_contract_address}' ` +
-        `is valid.`;
-      _msg_info(
-        _msg);
-    }
-    else {
-      if ( _target_app != "" &&
-           0 < _target_networks.length &&
-           _target_contract != "" ) {
-        _msg =
-          "Looking for address " +
-          "corresponding to contract " +
-          `'${_target_contract}' for the ` +
-          `'${_target_app}' ` +
-          "libEVM application on network " +
-          `'${_target_networks}' at deployments ` +
-          `directory '${_deployments_dir}'.`;
-        _msg_info(
-          _msg);
-        _evm_contract_deployment_address_args = [
-          _target_networks_set,      // target networks
-          _target_networks_set,      // target chain ids
-          "n",                       // all networks
-          _target_app,
-          _target_contract,
-          "",                        // contract version
-          "n",                       // user-level
-          "",                        // configuration format
-          _deployments_dir
-        ];
-        try {
-          _contract_addresses =
-            await _evm_contract_deployment_address.apply(
-              null,
-              _evm_contract_deployment_address_args);
-          _contract_address =
-            _contract_addresses[
-              0];
-        }
-        catch(
-          _error) {
-          _msg =
-            "Error while looking for contract " +
-            "address from local libEVM applications " +
-            "deployments directories.";
-          _msg_error(
-            _msg,
-            0);
-          _msg_error(
-            _error,
-            0);
-          throw _error;
-        }
-      }
-      else {
-        _msg =
-          "One between the " +
-          `application '${_target_app}', ` +
-          `the network '${_target_networks_set}' ` +
-          `or the contract '${_target_contract}' ` +
-          `has not been specified.`;
-        _msg_info(
-          _msg);
-      }
-    }
-  }
-  _set(
-    "contract",
-    "address",
-    _contract_address);
-}
-
 function
   _data_dir_auto_detect() {
   const
@@ -1058,6 +1184,51 @@ function
     _cache_dir);
 }
 
+function
+  _help_display_check(
+    _help_display) {
+  let
+    _msg;
+  const
+    _help_display_type =
+      typeof(
+        _help_display);
+  if ( _help_display_type === "undefined" ) {
+    _help_display =
+      false;
+  }
+  else if ( _help_display_type === "boolean" ) {
+    true;
+  }
+  else if ( _help_display_type === "string" ) {
+    if ( _help_display.length < 1 ) {
+      _help_display =
+        false;
+    }
+    else {
+      if ( _help_display == "true" ) {
+        _help_display =
+          true;
+      }
+      else if ( _help_display == "false" ) {
+        _help_display =
+          false;
+      }
+      else {
+        _msg =
+          `Unknown value '${_help_display}' ` +
+          "for variable '_help_display' (boolean).";
+        _msg_error(
+          _msg,
+          0);
+        throw _msg;
+      }
+    }
+  }
+  return _help_display;
+}
+
+
 // ES6 module exports
 
 export {
@@ -1068,11 +1239,18 @@ export {
   _call_auth_auto_detect,
   _call_auth_get,
   _contract_abi_auto_detect,
-  _contract_abi_get,
+  _contract_abi_check,
   _contract_address_auto_detect,
+  _contract_address_check,
+  _contract_bytecode_auto_detect,
+  _contract_bytecode_check,
+  _contract_compiler_output_auto_detect,
+  _contract_compiler_output_check,
   _data_dir_auto_detect,
   _default_artifact_path_get,
+  _deployments_dir_auto_detect,
   _evm_contract_call,
+  _help_display_check,
   _target_app_auto_detect,
   _target_contract_auto_detect,
   _target_networks_auto_detect,
@@ -1096,14 +1274,26 @@ export {
 //     _call_auth_get,
 //   _contract_abi_auto_detect:
 //     _contract_abi_auto_detect,
-//   _contract_abi_get:
-//     _contract_abi_get,
+//   _contract_abi_check:
+//     _contract_abi_check,
 //   _contract_address_auto_detect:
 //     _contract_address_auto_detect,
+//   _contract_address_check:
+//     _contract_address_check,
+//   _contract_bytecode_auto_detect:
+//     _contract_bytecode_auto_detect,
+//   _contract_bytecode_check:
+//     _contract_bytecode_check,
+//   _contract_compiler_output_auto_detect:
+//     _contract_compiler_output_auto_detect,
+//   _contract_compiler_output_check:
+//     _contract_compiler_output_check,
 //   _data_dir_auto_detect:
 //     _data_dir_auto_detect,
 //   _default_artifact_path_get:
 //     _default_artifact_path_get,
+//   _deployments_dir_auto_detect:
+//     _deployments_dir_auto_detect,
 //   _evm_contract_call:
 //     _evm_contract_call,
 //   _target_app_auto_detect: