evm-contracts-tools 0.0.62 → 0.0.65

package/evm-contract-deployment-abi

@@ -2,27 +2,31 @@
 
 // SPDX-License-Identifier: AGPL-3.0-or-later
 
-/**    ----------------------------------------------------------------
+
+/**    ----------------------------------------------------------
  *     evm-contract-deployment-abi.js
- *     ----------------------------------------------------------------
+ *     ----------------------------------------------------------
  *     Copyright ©
  *       Pellegrino Prevete
  *         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
+ *     You should have received a copy of the
+ *     GNU General Public License
  *     along with this program.
  *     If not, see <https://www.gnu.org/licenses/>.
  */

package/evm-contract-deployment-address

@@ -2,27 +2,30 @@
 
 // SPDX-License-Identifier: AGPL-3.0-or-later
 
-/**    ----------------------------------------------------------------
+/**    ----------------------------------------------------------
  *     evm-contract-deployment-address.js
- *     ----------------------------------------------------------------
+ *     ----------------------------------------------------------
  *     Copyright ©
  *       Pellegrino Prevete
  *         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
+ *     You should have received a copy of the
+ *     GNU General Public License
  *     along with this program.
  *     If not, see <https://www.gnu.org/licenses/>.
  */

package/evm-contract-deployment-bytecode

@@ -2,27 +2,30 @@
 
 // SPDX-License-Identifier: AGPL-3.0-or-later
 
-/**    ----------------------------------------------------------------
+/**    ----------------------------------------------------------
  *     evm-contract-deployment-bytecode.js
- *     ----------------------------------------------------------------
+ *     ----------------------------------------------------------
  *     Copyright ©
  *       Pellegrino Prevete
  *         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
+ *     You should have received a copy of the
+ *     GNU General Public License
  *     along with this program.
  *     If not, see <https://www.gnu.org/licenses/>.
  */

package/evm-contract-deployment-compiler-output

@@ -2,27 +2,30 @@
 
 // SPDX-License-Identifier: AGPL-3.0-or-later
 
-/**    ----------------------------------------------------------------
- *     evm-contract-deployment-address.js
- *     ----------------------------------------------------------------
+/**    ----------------------------------------------------------
+ *     evm-contract-deployment-compiler-output.js
+ *     ----------------------------------------------------------
  *     Copyright ©
  *       Pellegrino Prevete
  *         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
+ *     You should have received a copy of the
+ *     GNU General Public License
  *     along with this program.
  *     If not, see <https://www.gnu.org/licenses/>.
  */

package/evm-contract-deployment-networks

@@ -2,27 +2,30 @@
 
 // SPDX-License-Identifier: AGPL-3.0-or-later
 
-/**    ----------------------------------------------------------------
+/**    ----------------------------------------------------------
  *     evm-contract-deployment-networks.js
- *     ----------------------------------------------------------------
+ *     ----------------------------------------------------------
  *     Copyright ©
  *       Pellegrino Prevete
  *         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
+ *     You should have received a copy of the
+ *     GNU General Public License
  *     along with this program.
  *     If not, see <https://www.gnu.org/licenses/>.
  */

package/evm-contract-deployment-versions

@@ -2,27 +2,30 @@
 
 // SPDX-License-Identifier: AGPL-3.0-or-later
 
-/**    ----------------------------------------------------------------
+/**    ----------------------------------------------------------
  *     evm-contract-deployment-versions.js
- *     ----------------------------------------------------------------
+ *     ----------------------------------------------------------
  *     Copyright ©
  *       Pellegrino Prevete
  *         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
+ *     You should have received a copy of the
+ *     GNU General Public License
  *     along with this program.
  *     If not, see <https://www.gnu.org/licenses/>.
  */

package/evm-contract-deployments-dir

@@ -2,27 +2,30 @@
 
 // SPDX-License-Identifier: AGPL-3.0-or-later
 
-/**    ----------------------------------------------------------------
- *     evm-contract-deployment-dir.js
- *     ----------------------------------------------------------------
+/**    ----------------------------------------------------------
+ *     evm-contract-deployments-dir.js
+ *     ----------------------------------------------------------
  *     Copyright ©
  *       Pellegrino Prevete
  *         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
+ *     You should have received a copy of the
+ *     GNU General Public License
  *     along with this program.
  *     If not, see <https://www.gnu.org/licenses/>.
  */

package/evm-contracts-tools

@@ -2,25 +2,27 @@
 
 // SPDX-License-Identifier: AGPL-3.0-or-later
 
-/**    ----------------------------------------------------------------
+/**    ----------------------------------------------------------
  *     evm-contracts-tools
- *     ----------------------------------------------------------------
+ *     ----------------------------------------------------------
  *     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

package/lib/contract-get

@@ -56,6 +56,11 @@ const
 const
   _echo =
     _libcrash._echo;
+/* global
+     _echo2 */
+const
+  _echo2 =
+    _libcrash._echo2;
 /* global
      _exit */
 const
@@ -276,27 +281,102 @@ async function
     _contract,
     _contract_abi,
     _contract_bytecode,
+    _factory,
     _msg;
-  if ( _contract_abi_path == "" ) {
-    _contract_abi = [];
-  }
-  else if ( _contract_abi_path != "" ) {
-    _contract_abi =
-      _json_read(
+  _msg =
+    "Getting contract through ABI + bytecode.";
+  _msg_info(
+    _msg);
+  const
+    _contract_abi_path_type =
+      typeof(
         _contract_abi_path);
+  if ( _contract_abi_path_type === "undefined" ) {
+    _msg =
+      "Contract ABI path undefined, " +
+      "setting empty contract ABI.";
+    _msg_info(
+      _msg);
+    _contract_abi =
+      {};
+  }
+  if ( _contract_abi_path_type === "string" ) {
+    if ( _contract_abi_path.length < 1 ) {
+      _msg =
+        "Contract ABI path not set, " +
+        "setting empty contract ABI.";
+      _msg_info(
+        _msg);
+      _contract_abi =
+        {};
+    }
+    else {
+      try {
+        _msg =
+          `Reading ABI at '${_contract_abi_path}'`;
+        _contract_abi =
+          await _json_read(
+            _contract_abi_path);
+      }
+      catch(
+        _error) {
+        _msg =
+          "Error running '_json_read' on " +
+          `'${_contract_abi_path}'.`;
+        _echo2(
+          _error);
+        throw _error;
+      }
+    }
   }
   if ( _contract_bytecode_path != "" ) {
-    _contract_bytecode =
-      _file_read(
-        _contract_bytecode_path);
+    try {
+      _contract_bytecode =
+        _file_read(
+          _contract_bytecode_path);
+    }
+    catch(
+      _error) {
+      _msg =
+        "Error running '_json_read'.";
+      _echo2(
+        _error);
+      throw _error;
+    }
   }
   const
+    _contract_factory_args = [
+      _contract_abi,
+      _contract_bytecode,
+      _wallet
+    ];
+  try {
     _factory =
       new _contract_factory(
         _contract_abi,
         _contract_bytecode,
         _wallet);
+  }
+  catch(
+    _error) {
+    _msg =
+      "Error running '_contract_factory' " +
+      "with arguments:";
+    _msg_error(
+      _msg,
+      0);
+    _echo2(
+      _contract_factory_args);
+    _echo2(
+      _error);
+    throw _error
+  }
   if ( _contract_address != "" ) {
+    _msg =
+      "Attaching address " +
+      `'${_contract_address}' to factory.`;
+    _msg_info(
+      _msg);
     _contract =
       _factory.attach(
         _contract_address);
@@ -305,15 +385,18 @@ async function
     try {
       _contract =
         _factory.getDeployTransaction();
-    } catch (e) {
-      const
-        _msg =
-          `Encountered the above error.`;
-      console.error(
-        e);
-      _msg_error(
-        _msg,
-        0);
+    }
+    catch (
+      _error) {
+    const
+      _msg =
+        `Error running 'factory.getDeployTransaction'.`;
+    _msg_error(
+      _msg,
+      0);
+    _echo2(
+      _error);
+    throw _error;
     }
   }
   return _contract;
@@ -379,7 +462,9 @@ async function
   let
     _api_key,
     _contract,
-    _contract_get_opts,
+    _contract_get_fun,
+    _contract_get_args,
+    _msg,
     _network_provider,
     _wallet,
     _wallet_get_opts,
@@ -390,11 +475,32 @@ async function
       _file_read(
         _api_key_path);
   }
-  _network_provider =
-    _provider_get(
+  const
+    _provider_get_args = [
       _target_network,
-      _api_key);
-  _contract_get_opts =
+      _api_key
+    ];
+  try {
+    _network_provider =
+      await _provider_get.apply(
+        null,
+        _provider_get_args);
+  }
+  catch(
+    _error) {
+    _msg =
+      "Error running '_provider_get' " +
+      "with arguments:";
+    _msg_error(
+      _msg,
+      0);
+    _echo2(
+      _provider_get_args);
+    _echo2(
+      _error);
+    throw _error;
+  }
+  _contract_get_args =
     [];
   if ( _wallet_seed != "" ) {
     _wallet_path_list = [
@@ -411,43 +517,56 @@ async function
       _wallet_seed,
       _network_provider
     ];
-    _wallet =
-      _wallet_get.apply(
-        null,
-        _wallet_get_opts);
+    try {
+      _wallet =
+        await _wallet_get.apply(
+          null,
+          _wallet_get_opts);
+    }
+    catch(
+      _error) {
+      _msg =
+        "Error running '_wallet_get'.";
+      _msg_error(
+        _msg,
+        0);
+      _echo2(
+        _error);
+      throw _error;
+    }
     _msg_info_wallet_selected(
       _wallet);
-    _contract_get_opts.push(
+    _contract_get_args.push(
       _wallet);
   }
   else {
-    _contract_get_opts.push(
+    _contract_get_args.push(
       _network_provider);
   }
-  _contract_get_opts.push(
+  _contract_get_args.push(
     _contract_address);
   if ( _contract_bytecode_path != "" ) {
-    _contract_get_opts.push(
+    _contract_get_args.push(
       _contract_abi_path,
       _contract_bytecode_path);
     _contract_get_fun =
       _contract_get_bytecode;
   }
   else if ( _contract_compiler_output_path != "" ) {
-    _contract_get_opts.push(
+    _contract_get_args.push(
       _contract_compiler_output_path);
     _contract_get_fun =
       _contract_get_compiler_output;
   }
   else if ( _contract_bytecode_path == "" && 
-	    _contract_abi_path != "" ) {
-    _contract_get_opts.push(
+            _contract_abi_path != "" ) {
+    _contract_get_args.push(
       _contract_abi_path);
     _contract_get_fun =
       _contract_get_abi;
   }
   else if ( _contract_bytecode_path == "" &&
-	    _contract_abi_path == "" &&
+            _contract_abi_path == "" &&
             _contract_compiler_output_path == "" ) {
     _msg_error_no_input_data();
   }
@@ -455,10 +574,21 @@ async function
     _contract = await
       _contract_get_fun.apply(
         null,
-        _contract_get_opts);
-  } catch (e) {
-    console.error(
-      e);
+        _contract_get_args);
+  } catch (
+    _error) {
+    _msg =
+      "Error running " +
+      `'${_contract_get_fun}' ` +
+      "with parameters:";
+    _msg_error(
+      _msg,
+      0);
+    _echo2(
+      _contract_get_args);
+    _echo2(
+      _error);
+    throw _error;
   }
   return _contract;
 }