evm-contracts-tools 0.0.62 → 0.0.64

package/libevm-contract-deployment-compiler-output

@@ -2,25 +2,27 @@
 
 // SPDX-License-Identifier: AGPL-3.0-or-later
 
-/**    ----------------------------------------------------------------
+/**    ----------------------------------------------------------
  *     libevm-contract-deployment-compiler-output
- *     ----------------------------------------------------------------
+ *     ----------------------------------------------------------
  *     Copyright ©
  *       Pellegrino Prevete
  *         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
@@ -83,6 +85,11 @@ const
 const
   _dir_exists =
     _libcrash_module._dir_exists;
+/* global
+     _echo2 */
+const
+  _echo2 =
+    _libcrash_module._echo2;
 /* global
      _file_exists */
 const
@@ -98,6 +105,11 @@ const
 const
   _from_bash_ass_array =
     _libcrash_module._from_bash_ass_array;
+/* global
+     _get */
+const
+  _get =
+    _libcrash_module._get;
 /* global
      _homedir_get */
 const
@@ -157,15 +169,6 @@ const
 const
   _evm_chains_info =
     _evm_chains_info_module._evm_chains_info;
-const
-  _libevm_contract_deployments_dir_module =
-    await import(
-      "./libevm-contract-deployments-dir");
-/* global
-     _evm_contract_deployments_dir */
-const
-  _evm_contract_deployments_dir =
-    _libevm_contract_deployments_dir_module._evm_contract_deployments_dir;
 const
   _libevm_contract_deployment_module =
     await import(
@@ -200,6 +203,25 @@ const
 const
   _user_deployments_check =
     _libevm_contract_deployment_module._user_deployments_check;
+/* global
+     _user_defined_check */
+const
+  _user_defined_check =
+    _libevm_contract_deployment_module._user_defined_check;
+/* global
+     _version_check */
+const
+  _version_check =
+    _libevm_contract_deployment_module._version_check;
+const
+  _libevm_contract_deployments_dir_module =
+    await import(
+      "./libevm-contract-deployments-dir");
+/* global
+     _evm_contract_deployments_dir */
+const
+  _evm_contract_deployments_dir =
+    _libevm_contract_deployments_dir_module._evm_contract_deployments_dir;
 const
   _libevm_contract_deployment_networks_module =
     await import(
@@ -209,68 +231,200 @@ const
 const
   _evm_contract_deployment_networks =
     _libevm_contract_deployment_networks_module._evm_contract_deployment_networks;
-const
-  _libevm_contract_deployment_versions_module =
-    await import(
-      "./libevm-contract-deployment-versions");
-/* global
-     _evm_contract_deployment_versions */
-const
-  _evm_contract_deployment_versions =
-    _libevm_contract_deployment_versions_module._evm_contract_deployment_versions;
 
-function
+async function
   _contract_compiler_output_get(
     _deployments,
+    _app,
     _contract,
     _network,
     _network_id,
     _version,
-    _configuration_format) {
+    _configuration_format,
+    _user_defined) {
   let
+    _break,
     _compiler_output,
     _compiler_output_path,
+    _compiler_output_retrieve,
     _found,
     _msg,
-    _net;
+    _net,
+    _non_empty_networks;
   const
     _networks = [
       _network,
       _network_id
     ];
+  _non_empty_networks =
+    false;
   _found =
     false;
   for ( _net of _networks ) {
-    _compiler_output_path =
-      _path_join( [
-        _deployments,
-        _contract,
-        _net,
-        _version,
-        `${_contract}.json` ]);
-    if ( _file_exists(
-           _compiler_output_path) ) {
-      _found =
+    _compiler_output_retrieve =
+      false;
+    _break =
+      false;
+    if ( _net.length < 1 ) {
+      _msg =
+        `Empty value network '${_net}', ` +
+        "skipping.";
+      _msg_info(
+        _msg);
+    }
+    else {
+      _compiler_output_retrieve =
+      true;
+    }
+    if ( _compiler_output_retrieve ) {
+      _non_empty_networks =
         true;
+      _msg =
+        "Getting compiler output for network " +
+        `'${_net}'.`;
+      _msg_info(
+        _msg);
+      const
+        _version_check_args = [
+          _version,
+          _app,                  // app
+          _contract,
+          "",                    // address
+          _net,
+          _user_defined,
+          _deployments,
+          "",                    // config file
+          _configuration_format
+        ];
+      try {
+        _version =
+          await _version_check.apply(
+            null,
+            _version_check_args);
+      }
+      catch(
+        _error) {
+        _msg =
+          "Error running '_version_check' " +
+          "with arguments:";
+        _msg_error(
+          _msg,
+          0);
+        _echo2(
+          _version_check_args);
+        _echo2(
+          _error);
+        throw _error;
+      }
+      _msg =
+        `Checked version '${_version}'.`;
+      _msg_info(
+        _msg);
+      _compiler_output_path =
+        _path_join( [
+          _deployments,
+          _contract,
+          _net,
+          _version,
+          `${_contract}.json`
+      ]);
+      _msg =
+        `Checking file '${_compiler_output_path}'.`;
+      _msg_info(
+        _msg);
+      if ( _file_exists(
+             _compiler_output_path) ) {
+        _found =
+          true;
+        _break =
+          true;
+      }
+      else {
+        _msg =
+          `Compiler output at path '${_compiler_output_path}' ` +
+          `not found.`;
+        _msg_info(
+          _msg);
+      }
+    }
+    if ( _break ) {
+      _msg =
+        "File found, breaking loop.";
+      _msg_info(
+        _msg);
       break;
     }
   }
-  if ( ! _found ) {
+  if ( ! _found &&
+       _non_empty_networks ) {
+    let
+      _error_info;
     _msg =
       `No network '${_network}' deployment ` +
-      `configuration for contract '${_contract}' ` +
+      `configuration (hardhat compiler output) ` +
+      `for contract '${_contract}' ` +
       `found at path '${_deployments}'.`;
-    _msg_error(
-      _msg,
-      1);
+    _error_info =
+      false;
+    const
+      _contract_abi =
+        _get(
+          "contract",
+          "abi");
+    const
+      _contract_bytecode =
+        _get(
+          "contract",
+          "bytecode");
+    const
+      _contract_abi_type =
+        typeof(
+          _contract_abi);
+    const
+      _contract_bytecode_type =
+        typeof(
+          _contract_bytecode);
+    if ( _contract_abi_type == "string" &&
+         _contract_bytecode_type == "string" ) {
+      if ( 0 < _contract_abi.length &&
+           0 < _contract_bytecode.length ) {
+        if ( _file_exists(
+               _contract_abi) &&
+             _file_exists(
+               _contract_bytecode) ) {
+          _error_info =
+            true;
+        }
+        else {
+          _msg =
+            `Either contract abi '${_contract_abi}' ` +
+            `or contract bytecode '${_contract_bytecode}' ` +
+            `do not exist, so a missing compiler output ` +
+            `will trigger an error.`;
+	}
+      }
+    }
+    if ( _error_info ) {
+      _msg_info(
+        _msg);
+    }
+    else {
+      _msg_error(
+        _msg,
+        0);
+    }
+    throw _msg;
   }
   const
     _contract_compiler_output =
       _compiler_output_path;
-  if ( _contract_compiler_output == "" ||
-       _contract_compiler_output == null ||
-       typeof(
-         _contract_compiler_output) == "undefined" ) {
+  const
+    _contract_compiler_output_type =
+      typeof(
+        _contract_compiler_output);
+  if ( _contract_compiler_output === "" ||
+       _contract_compiler_output_type === "undefined" ||
+       _contract_compiler_output === null ) {
     _msg =
       `No '${_contract}' version '${_version}' ` +
       `contract deployment compiler output for network ` +
@@ -281,6 +435,10 @@ function
       0);
     throw _msg;
   }
+  _msg =
+    `Got compiler output: '${_contract_compiler_output}'.`;
+  _msg_info(
+    _msg);
   return _contract_compiler_output;
 }
 
@@ -298,6 +456,7 @@ async function
   let
     _args,
     _contract_compiler_output,
+    _deployments_dir_get,
     _network,
     _network_check_args,
     _target_network,
@@ -311,6 +470,59 @@ async function
   const
     _contract_compiler_output_get_args =
       [];
+  _user_defined =
+    _user_defined_check(
+      _user_defined);
+  const
+    _deployments_dir_type =
+      typeof(
+        _deployments_dir);
+  _deployments_dir_get =
+    false;
+  if ( _deployments_dir_type === "undefined" ) {
+    _msg =
+      "Deployments directory undefined, getting.";
+    _msg_info(
+      _msg);
+    _deployments_dir_get =
+      true;
+  }
+  else if ( _deployments_dir_type === "string" ) {
+    if ( _deployments_dir.length < 1 ) {
+      _msg =
+        "Deployments directory not set, getting.";
+      _msg_info(
+        _msg);
+      _deployments_dir_get =
+        true;
+    }
+  }
+  if ( _deployments_dir_get ) {
+    const
+      _evm_contract_deployments_dir_args = [
+        _target_app,
+        _user_defined
+      ];
+    try {
+      _deployments_dir =
+        await _evm_contract_deployments_dir.apply(
+          null,
+          _evm_contract_deployments_dir_args);
+    }
+    catch(
+      _error) {
+      _msg =
+        "Error while retrieving system deployments " +
+        "directory location for auto-detection.";
+      _msg_error(
+        _msg,
+        0);
+      _msg_error(
+        _error,
+        0);
+      throw _error;
+    }
+  }
   if ( _user_defined == "n" ) {
     if ( _target_app == "" ) {
       _msg =
@@ -385,52 +597,88 @@ async function
     //   `network '${_network}'.`;
     // _msg_info(
     //   _msg);
-    _target_network_id =
-      "";
-    _network_check_args = [
-      _deployments_dir,
-      _target_contract,
-      _network,
-      _target_network_id
-    ];
-    await _network_check.apply(
-      null,
-      _network_check_args);
-    _contract_compiler_output_get_args.push( [
-      _deployments_dir,
-      _target_contract,
-      _network,
-      _target_network_id,
-      _contract_version,
-      _configuration_format
-    ] );
+    if ( _network.length < 1 ) {
+      _msg =
+        "Empty network, skipping.";
+      _msg_info(
+        _msg);
+    }
+    else {
+      _target_network_id =
+        "";
+      _network_check_args = [
+        _deployments_dir,
+        _target_contract,
+        _network,
+        _target_network_id
+      ];
+      await _network_check.apply(
+        null,
+        _network_check_args);
+      _contract_compiler_output_get_args.push( [
+        _deployments_dir,
+        _target_app,
+        _target_contract,
+        _network,
+        _target_network_id,
+        _contract_version,
+        _configuration_format,
+        _user_defined
+      ] );
+    }
   }
-  for ( _network of  _network_ids ) {
-    _target_network =
-      "";
-    _network_check_args = [
-      _deployments_dir,
-      _target_contract,
-      _target_network,
-      _network
-    ];
-    await _network_check.apply(
-      null,
-      _network_check_args);
-    _contract_compiler_output_get_args.push( [
-      _deployments_dir,
-      _target_contract,
-      _target_network,
-      _target_network_id,
-      _contract_version,
-      _configuration_format
-    ] );
+  for ( _network of _network_ids ) {
+    if ( _network.length < 1 ) {
+      _msg =
+        "Empty network, skipping.";
+      _msg_info(
+        _msg);
+    }
+    else {
+      _target_network =
+        "";
+      _network_check_args = [
+        _deployments_dir,
+        _target_contract,
+        _target_network,
+        _network
+      ];
+      await _network_check.apply(
+        null,
+        _network_check_args);
+      _contract_compiler_output_get_args.push( [
+        _deployments_dir,
+        _target_app,
+        _target_contract,
+        _target_network,
+        _network,
+        _contract_version,
+        _configuration_format,
+        _user_defined
+      ] );
+    }
   }
   for ( _args of _contract_compiler_output_get_args ) {
-    _contract_compiler_output =
-      _contract_compiler_output_get.apply(
-        null,
+    try {
+      _contract_compiler_output =
+        await _contract_compiler_output_get.apply(
+          null,
+          _args);
+    }
+    catch(
+      _error) {
+      _msg =
+        "Error running '_contract_compiler_output_get' " +
+        "with parameters:";
+      _msg_error(
+        _msg,
+        0);
+      _echo2(
         _args);
+      _echo2(
+        _error);
+      throw _error;
+    }
     _contracts_compiler_outputs.push(
       _contract_compiler_output);
   }

package/libevm-contract-deployments-dir

@@ -2,25 +2,27 @@
 
 // SPDX-License-Identifier: AGPL-3.0-or-later
 
-/**    ----------------------------------------------------------------
+/**    ----------------------------------------------------------
  *     libevm-contract-deployments-dir
- *     ----------------------------------------------------------------
+ *     ----------------------------------------------------------
  *     Copyright ©
  *       Pellegrino Prevete
- *         2025, 2026
+ *         2024, 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
@@ -55,45 +57,28 @@ const
 const
   _msg_error =
     _libcrash_module._msg_error;
-
-function
-  _app_check(
-    _app) {
-  let
-    _error_flag,
-    _msg;
-  const
-    _app_type =
-      typeof(
-        _app);
-  if ( _app_type == "undefined" ||
-       _app == "" ) {
-    _msg =
-      "No application specified.";
-    _error_flag =
-      true;
-  }
-  if ( _app_type != "string" ) {
-    _msg =
-      "Application argument must be of " +
-      "type string.";
-    _error_flag =
-      true;
-  }
-  if ( _error_flag ) {
-    _msg_error(
-      _msg,
-      0);
-    throw _msg;
-  }
-}
+const
+  _libevm_contract_deployment_module =
+    await import(
+      "./libevm-contract-deployment");
+/* global
+     _app_check */
+const
+  _app_check =
+    _libevm_contract_deployment_module._app_check;
+/* global
+     _user_level_check */
+const
+  _user_level_check =
+    _libevm_contract_deployment_module._user_level_check;
 
 async function
   _default_deployments_dir_get(
     _app,
     _type) {
-  _app_check(
-    _app);
+  _app =
+    _app_check(
+      _app);
   if ( typeof(
          _type) == "undefined" ||
        _type == "" ) {
@@ -121,9 +106,16 @@ async function
     _app,
     _user_level) {
   let
-    _deployment_type;
-  _app_check(
-    _app);
+    _deployment_type,
+    _deployments,
+    _msg;
+  _app =
+    _app_check(
+      _app,
+      false);
+  _user_level =
+    _user_level_check(
+      _user_level);
   if ( _user_level == "n" ) {
     _deployment_type =
       "system";
@@ -142,11 +134,22 @@ async function
       0);
     throw _msg;
   }
-  const
+  try {
     _deployments =
       await _default_deployments_dir_get(
         _app,
         _deployment_type);
+  }
+  catch(
+    _error) {
+    _msg =
+      "Error running '_default_deployments_dir_get' " +
+      "with arguments:";
+    _msg_error(
+      _msg,
+      0);
+    throw _error;
+  }
   return _deployments;
 }