evm-contracts-tools 0.0.34 → 0.0.36

package/Makefile

@@ -60,20 +60,19 @@ NPM_FILES=\
   "dist" \
   "evm-contract-call" \
   "evm-contract-call.webpack.config.cjs" \
+  "evm-contract-deployments-dir" \
+  "evm-contract-deployments-dir.webpack.config.cjs" \
   "lib" \
   "libevm-contract-call" \
   "libevm-contract-call.webpack.config.cjs" \
+  "libevm-contract-deployments-dir" \
+  "libevm-contract-deployments-dir.webpack.config.cjs" \
   "$(_PROJECT_NPM)" \
   "eslint.config.mjs" \
   "fs-worker.webpack.config.cjs" \
   "package.json" \
   "webpack.config.cjs"
 
-MAN_FILES=\
-  evm-contract-bytecode-get \
-  evm-contract-call \
-  evm-contract-deployer-get
-
 all: build-man build-npm build-scripts
 
 check: eslint
@@ -101,13 +100,13 @@ install-scripts:
 	    -s \
             "$(PREFIX)/lib/$(_PROJECT_NPM)/nodejs/$${_file}" \
 	    "$(LIB_DIR)/$${_file}" || \
-	  true; \
-	done
-	# ln \
-	#   -s \
-	#   "$(PREFIX)/lib/$(_PROJECT_NPM)/node/lib$(_PROJECT_NPM)" \
-	#   "$(LIB_DIR)/$(_PROJECT_NPM)-js" || \
-	# true
+	    true; \
+	    done
+	  # ln \
+		  #   -s \
+		  #   "$(PREFIX)/lib/$(_PROJECT_NPM)/node/lib$(_PROJECT_NPM)" \
+		  #   "$(LIB_DIR)/$(_PROJECT_NPM)-js" || \
+		  # true
 
 build-man:
 

package/dist/evm-contract-deployments-dir/index.html

@@ -0,0 +1,31 @@
+<!--
+  SPDX-License-Identifier: AGPL-3.0-or-later
+
+  ---------------------------------------------
+  Copyright © 2024, 2025, 2026
+              Pellegrino Prevete
+ 
+  All rights reserved
+  ---------------------------------------------
+ 
+  This program is free software: you can
+  redistribute it and/or modify it under the
+  terms of the GNU Affero 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 Affero General Public
+  License for more details.
+ 
+  You should have received a copy of the GNU
+  Affero General Public License
+  along with this program.
+  If not, see <https://www.gnu.org/licenses/>.
+-->
+
+<script src="evm-contract-deployments-dir.js"></script>

package/dist/libevm-contract-deployments-dir/index.html

@@ -0,0 +1,24 @@
+<!--
+  SPDX-License-Identifier: AGPL-3.0-or-later
+
+  ----------------------------------------------------------------------
+  Copyright © 2024, 2025, 2026  Pellegrino Prevete
+ 
+  All rights reserved
+  ----------------------------------------------------------------------
+ 
+  This program is free software: you can redistribute it and/or modify
+  it under the terms of the GNU Affero 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 Affero General Public License for more details.
+ 
+  You should have received a copy of the GNU Affero General Public License
+  along with this program.  If not, see <https://www.gnu.org/licenses/>.
+-->
+
+<script src="libevm-contract-deployments-dir.js"></script>

package/evm-contract-call

@@ -265,8 +265,24 @@ function
 
 async function 
   _overrides_set() {
-  _address_check(
-    contract_address);
+  if ( ! _help_display &&
+       typeof(_help_display) != "undefined" &&
+       _help_display != "" ) {
+    const
+      _address_valid =
+        _address_check(
+          contract_address);
+    if ( ! _address_valid ) {
+      const
+        _msg =
+          "Contract address " +
+          `'${contract_address}' is ` +
+          `invalid.`;
+      _msg_error(
+        _msg,
+        1);
+    }
+  }
   if ( call_date == "" ||
        typeof(
          call_date) == "undefined" ) {
@@ -524,7 +540,8 @@ async function
   if ( _help_display ) {
     quiet =
       "n";
-    await _overrides_set();
+    await _overrides_set(
+      _help_display);
     _usage(
       0);
   }
@@ -844,7 +861,6 @@ if ( _cmdline_check(
      _cmdline_check(
        "evm-contract-call") == true ) {
   _cmdline_parse();
-  console.log("quiet", quiet);
 }
 else{
   _url_parse();

package/evm-contract-deployments-dir

@@ -0,0 +1,376 @@
+#!/usr/bin/env node
+
+// SPDX-License-Identifier: AGPL-3.0-or-later
+
+/**    ----------------------------------------------------------------
+ *     evm-contract-deployment-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 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
+ *     along with this program.
+ *     If not, see <https://www.gnu.org/licenses/>.
+ */
+
+/* eslint-disable
+     no-unused-vars */
+
+/* Crash Javascript global variables */
+/* global
+     quiet:
+       writable */
+
+const
+  _libcrash =
+  require(
+    "crash-js");
+/* global
+     _argv_get */
+const
+  _argv_get =
+    _libcrash._argv_get;
+/* global
+     _argv_url_get */
+const
+  _argv_url_get =
+    _libcrash._argv_url_get;
+/* global
+     _cmdline_check */
+const
+  _cmdline_check =
+    _libcrash._cmdline_check;
+/* global
+     _get_date_human */
+const
+  _get_date_human =
+    _libcrash._get_date_human;
+/* global
+     _msg_info */
+const
+  _msg_info =
+    _libcrash._msg_info;
+/* global
+     _msg_error */
+const
+  _msg_error =
+    _libcrash._msg_error;
+/* global
+     _printf */
+const
+_printf =
+  _libcrash._printf;
+/* global
+     _process_exit */
+const
+_process_exit =
+  _libcrash._process_exit;
+const
+  _libevm_contract_deployments_dir_module =
+    require(
+      "./libevm-contract-deployments-dir");
+/* global
+     _evm_contract_deployments_dir */
+const
+  _evm_contract_deployments_dir =
+    _libevm_contract_deployments_dir_module._evm_contract_deployments_dir;
+
+function
+  _global_variables() {
+  /* global
+       app_name:
+         writable */
+  app_name =
+    "evm-contract-deployments-dir.js";
+  /* global
+       app_opts:
+         writable */
+  app_opts =
+    [];
+  /* global
+       runtime_environment:
+         writable */
+  runtime_environment =
+    "";
+  /* global
+       resolve_date:
+         writable */
+  resolve_date =
+    "";
+  /* global
+       user_level:
+         writable */
+  user_level =
+    "";
+  quiet =
+    "";
+  /* global
+       verbose:
+         writable */
+  verbose =
+    "";
+}
+
+async function 
+  _overrides_set(
+    _help_display) {
+  if ( ! _help_display &&
+       typeof(_help_display) != "undefined" &&
+       _help_display != "" ) {
+    const
+      _address_valid =
+        _address_check(
+          contract_address);
+    if ( ! _address_valid ) {
+      const
+        _msg =
+          "Contract address " +
+          `'${contract_address}' is ` +
+          `invalid.`;
+      _msg_error(
+        _msg,
+        1);
+    }
+  }
+  if ( resolve_date == "" ||
+       typeof(
+         resolve_date) == "undefined" ) {
+    resolve_date =
+      _get_date_human();
+  }
+  if ( user_level == "" ) {
+    user_level =
+      "n";
+  }
+}
+
+function
+  _config_show() {
+  let
+    _line;
+  const
+    _text = [
+      `${app_name} configuration:`,
+      `             Resolve date:   ${resolve_date}`,
+      `      Runtime environment:   ${runtime_environment}`,
+      `       Target application:   ${target_app}`,
+      `               User level:   ${user_level}`,
+    ];
+  for ( _line of _text ) {
+    _msg_info(
+      _line);
+  }
+}
+
+function
+  _usage(
+    _exit_code) {
+  let
+    _line;
+  const
+    _text = [
+      "",
+      "Returns default deployments directory for an application",
+      "",
+      "Usage:",
+      "",
+      `  ${app_name}`,
+      "    [options]",
+      "    <target-app>",
+      "",
+      "  options:",
+      "",
+      "     -u --user-level                 Returns user-level location",
+      "                                     for an application deployments",
+      `                                     Default: '${user_level}`,
+      "",
+      "     -h --help                       This message.",
+      "     -v --verbose                    Enable verbose output.",
+      ""
+    ];
+  for ( _line of _text ) {
+    console.log(
+      _line);
+  }
+  _process_exit(
+    _exit_code);
+}
+
+async function 
+  _cmdline_parse() {
+  let
+    _help_display,
+    _msg;
+  const
+    _argv_args = {
+      "booleans": [
+        "u",
+        "user-level",
+        "h",
+        "help",
+        "v",
+        "verbose"
+      ]
+    };
+  const
+    _argv =
+      _argv_get(
+        _argv_args);
+  const
+    _options =
+      _argv[
+        "_"];
+  quiet = 
+    "y";
+  runtime_environment =
+    "node";
+  if ( _argv[
+         "h"] ) {
+    _help_display =
+      true;
+  }
+  if ( _argv[
+         "help"] ) {
+    _help_display =
+      true;
+  }
+  if ( ( _options.indexOf(
+           "--help") > -1 ||
+         _options.indexOf(
+           "-h") > -1) ) {
+    _help_display =
+      true;
+  }
+  if ( _help_display ) {
+    quiet =
+      "n";
+    await _overrides_set(
+      _help_display);
+    _usage(
+      0);
+  }
+  if ( typeof(
+         _argv) == "undefined" ||
+       _argv[
+         "_"].length < 1 ) {
+    _msg =
+      "Target application " +
+      "argument required.";
+    _msg_error(
+      _msg,
+      0);
+    _usage(
+      1);
+  }
+  target_app =
+    _argv[
+      "_"][
+        0];
+  if ( "u" in _argv ) {
+    user_level =
+      _argv[
+        "u"];
+  }
+  if ( "user_level" in _argv ) {
+    user_level =
+      _argv[
+        "user_level"];
+  }
+  if ( _argv[
+         "v"] ||
+       _argv[
+         "verbose"] ) {
+    quiet =
+      "n";
+  }
+}
+
+function
+  _url_parse() {
+  let
+    _method,
+    _network;
+  runtime_environment =
+    "browser";
+  user_level =
+    _argv_url_get(
+      "user_level")[
+        0];
+  quiet =
+    _argv_url_get(
+      "quiet");
+  if ( quiet.length === 0 ) {
+    quiet =
+      "n";
+  }
+}
+
+async function
+  _evm_contract_deployments_dir_cmdline(
+    _app_opts) {
+  let
+    _result;
+  const
+    _results =
+      await _evm_contract_deployments_dir.apply(
+        null,
+        app_opts);
+  const
+    _results_type =
+      typeof(
+        _results);
+  if ( _results_type == "object" ) {
+    for ( _result of _results ) {
+      console.log(
+        _result);
+    }
+  }
+  else if ( _results_type == "string" ) {
+    _printf(
+      _results);
+  }
+}
+
+async function
+  _main() {
+  const
+    _overrides_set_up =
+      await _overrides_set();
+  _config_show();
+  const
+    app_opts = [
+      target_app,
+      user_level
+    ];
+  const
+    _deployments =
+      await _evm_contract_deployments_dir.apply(
+        null,
+        app_opts);
+}
+
+_global_variables();
+if ( _cmdline_check(
+       "evm-contract-deployments-dir.js") == true ||
+     _cmdline_check(
+       "evm-contract-deployments-dir") == true ) {
+  _cmdline_parse();
+}
+else{
+  _url_parse();
+}
+_main();

package/evm-contracts-tools

@@ -1,10 +1,9 @@
 #!/usr/bin/env node
 
-
 // SPDX-License-Identifier: AGPL-3.0-or-later
 
 /**    ----------------------------------------------------------------
- *     libevm-contracts-tools
+ *     evm-contracts-tools
  *     ----------------------------------------------------------------
  *     Copyright ©
  *       Pellegrino Prevete
@@ -115,25 +114,13 @@ const
   _contract_call_static =
     _evm_contract_call_static_module._contract_call_static;
 
-
-
-
-function
-  _artifact_local_auto_detect() {
-  true;
-}
-
 module.exports = {
   _address_check:
     _address_check,
-  _artifact_local_auto_detect:
-    _artifact_local_auto_detect,
   _bytecode_creation_get:
     _bytecode_creation_get,
   _bytecode_runtime_get:
     _bytecode_runtime_get,
-  _call_auth_auto_detect:
-    _call_auth_auto_detect,
   _contract_call_dynamic:
     _contract_call_dynamic,
   _contract_call_static:

package/libevm-contract-deployments-dir

@@ -0,0 +1,247 @@
+#!/usr/bin/env node
+
+// SPDX-License-Identifier: AGPL-3.0-or-later
+
+/**    ----------------------------------------------------------------
+ *     libevm-contract-deployments-dir
+ *     ----------------------------------------------------------------
+ *     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 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
+ *     along with this program.
+ *     If not, see <https://www.gnu.org/licenses/>.
+ */
+
+/* eslint-disable
+     no-unused-vars */
+/* eslint-disable
+     no-useless-assignment */
+
+/* EVM Contracts tools global variables */
+/* global
+     call_type */
+/* global
+     call_auth:
+       writable */
+
+/* libEVM global variables */
+/* global 
+     api_key */
+/* global
+     contract_abi:
+       writable */
+/* global
+     contract_address */
+/* global
+     contract_bytecode:
+       writable */
+/* global
+     contract_compiler_output:
+       writable */
+/* global
+     target_network:
+       writable */
+/* global
+     target_networks:
+       writable */
+
+const
+  _libcrash_module =
+    require(
+      "crash-js");
+/* global
+     _dirname */
+/* eslint-disable-next-line
+     no-global-assign */
+const
+  _dirname =
+    _libcrash_module._dirname;
+/* global
+     _file_exists */
+/* eslint-disable-next-line
+     no-global-assign */
+const
+  _file_exists =
+    _libcrash_module._file_exists;
+/* global
+     _homedir_get */
+/* eslint-disable-next-line
+     no-global-assign */
+const
+  _homedir_get =
+    _libcrash_module._homedir_get;
+/* global
+     _json_read */
+/* eslint-disable-next-line
+     no-global-assign */
+const
+  _json_read =
+    _libcrash_module._json_read;
+/* global
+     _lib_get */
+/* eslint-disable-next-line
+     no-global-assign */
+const
+  _lib_get =
+    _libcrash_module._lib_get;
+/* global
+     _msg_info */
+/* eslint-disable-next-line
+     no-global-assign */
+const
+  _msg_info =
+    _libcrash_module._msg_info;
+/* global
+     _msg_error */
+/* eslint-disable-next-line
+     no-global-assign */
+const
+  _msg_error =
+    _libcrash_module._msg_error;
+/* global
+     _path_join */
+/* eslint-disable-next-line
+     no-global-assign */
+const
+  _path_join =
+    _libcrash_module._path_join;
+/* global
+     _range */
+/* eslint-disable-next-line
+     no-global-assign */
+const
+  _range =
+    _libcrash_module._range;
+const
+  _evm_contracts_tools_module =
+    require("./evm-contracts-tools");
+/* global
+     _address_check */
+const
+  _address_check =
+    _evm_contracts_tools_module._address_check;
+
+const
+  _ethereum_data_module =
+    require(
+      "ethereum-data");
+/* global
+     _data_get */
+const
+  _data_get =
+    _ethereum_data_module._data_get;
+
+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;
+  }
+  console.log(_app);
+  if ( _app_type != "string" ) {
+    _msg =
+      "Application argument must be of " +
+      "type string.";
+    _error_flag =
+      true;
+  }
+  if ( _error_flag ) {
+    _msg_error(
+      _msg,
+      1);
+  }
+}
+
+function
+  _default_deployments_dir_get(
+    _app,
+    _type) {
+  _app_check(
+    _app);
+  if ( typeof(
+         _type) == "undefined" ||
+       _type == "" ) {
+    _type =
+      "system";
+  }
+  let
+    _conf_dir;
+  if ( _type == "system" ) {
+    _conf_dir =
+      _lib_get();
+  }
+  else if ( _type == "user" ) {
+    const
+      _homedir =
+        _homedir_get();
+    _conf_dir =
+      `${_homedir}/.config`;
+  }
+  return `${_conf_dir}/${_app}/deployments`;
+}
+
+function
+  _evm_contract_deployments_dir(
+    _app,
+    _user_level) {
+  let
+    _deployments,
+    _deployment_type;
+  _app_check(
+    _app);
+  if ( _user_level == "n" ) {
+    _deployment_type =
+      "system";
+  }
+  else if ( _user_level == "n" ) {
+    _deployment_type =
+      "system";
+  }
+  else {
+    _msg =
+      "User level argument must be " +
+      "can be 'y' or 'n'."
+    _msg_error(
+      _msg,
+      1);
+  }
+  _deployments =
+    _default_deployments_dir_get(
+      _app,
+      _deployment_type);
+  return _deployments;
+}
+
+module.exports = {
+  _default_deployments_dir_get:
+    _default_deployments_dir_get,
+  _evm_contract_deployments_dir:
+    _evm_contract_deployments_dir,
+};

package/package.json

@@ -1,6 +1,6 @@
 { "name": "evm-contracts-tools",
   "version":
-    "0.0.34",
+    "0.0.36",
   "description":
     "JavaScript programs and libraries to enable seamless development of native computer applications designed to interact with Ethereum Virtual Machine-compatible networks.",
   "funding": {
@@ -14,6 +14,7 @@
     "./man/evm-contract-bytecode-get.1",
     "./man/evm-contract-deployer-get.1",
     "./man/evm-contract-deployment-address.1",
+    "./man/evm-contract-deployments-dir.1",
     "./man/evm-contract-call.1",
     "./man/evm-contract-call-dynamic.1"
   ],
@@ -25,10 +26,14 @@
     "dist",
     "evm-contract-call",
     "evm-contract-call.webpack.config.js",
+    "evm-contract-deployments-dir",
+    "evm-contract-deployments-dir.webpack.config.js",
     "fs-worker.webpack.config.js",
     "index.html",
     "libevm-contract-call",
     "libevm-contract-call.webpack.config.js",
+    "libevm-contract-deployments-dir",
+    "libevm-contract-deployments-dir.webpack.config.js",
     "lib",
     "evm-contracts-tools",
     "package.json",
@@ -40,13 +45,15 @@
     "themartiancompany",
     "dogeos",
     "ethereum",
-    "evmfs"
+    "evmfs",
+    "libevm",
+    "evm-toolchain"
   ],
   "homepage":
     "https://github.com/themartiancompany/evm-contracts-tools",
   "bugs": {
     "url":
-      "https://github.com/themartiancompany/evm-contracts-tools/issues"
+      "https://github.com/themartiancompany/evm-contracts-tools.js/issues"
   },
   "repository": {
     "type":
@@ -66,7 +73,7 @@
   },
   "devDependencies": {
     "crash-js-webpack":
-      "^0.0.10",
+      "^0.0.28",
     "flatted":
       "^3.2.9",
     "eslint":
@@ -84,7 +91,7 @@
   },
   "dependencies": {
     "crash-js":
-      "^0.1.111",
+      "^0.1.134",
     "ethers":
       "^6.13.2",
     "evm-chains-info":
@@ -118,15 +125,29 @@
         "evm-contract-call",
       "evm-contract-call-dynamic.js":
         "lib/evm-contract-call-dynamic",
+      "evm-contract-deployments-dir.js":
+        "evm-contract-deployments-dir",
+      "evm-contract-deployments-dir":
+        "evm-contract-deployments-dir",
       "evm-contract-call-static.js":
         "lib/evm-contract-call-static" },
   "scripts": {
     "build-fs-worker":
       "npx webpack --mode 'production' --config 'fs-worker.webpack.config.cjs' --stats-error-details && cp 'fs-worker.js' 'dist/'{'evm-contract-call','evm-contracts-tools','libevm-contract-call'}",
-    "build-lib":
+    "build-libevm-contract-call":
       "npx webpack --mode 'production' --config 'libevm-contract-call.webpack.config.cjs' --stats-error-details && mv 'libevm-contract-call.js' 'dist/libevm-contract-call'",
+    "build-libevm-contract-deployments-dir":
+      "npx webpack --mode 'production' --config 'libevm-contract-deployments-dir.webpack.config.cjs' --stats-error-details && mv 'libevm-contract-deployments-dir.js' 'dist/libevm-contract-deployments-dir'",
+    "build-lib":
+      "npm run build-libevm-contract-call && npm run build-libevm-contract-deployments-dir",
+    "build-evm-contract-call":
+      "npx webpack --mode 'production' --config 'evm-contract-call.webpack.config.cjs' --stats-error-details && mv 'evm-contract-call.js' 'dist/evm-contract-call'",
+    "build-evm-contracts-tools":
+      "npx webpack --mode 'production' --config 'webpack.config.cjs' --stats-error-details && mv 'evm-contracts-tools.js' 'dist/evm-contracts-tools'",
+    "build-evm-contract-deployments-dir":
+      "npx webpack --mode 'production' --config 'evm-contract-deployments-dir.webpack.config.cjs' --stats-error-details && mv 'evm-contract-deployments-dir.js' 'dist/evm-contract-deployments-dir' && npx webpack --mode 'production' --config 'webpack.config.cjs' --stats-error-details && mv 'evm-contracts-tools.js' 'dist/evm-contracts-tools'",
     "build-bin":
-      "npx webpack --mode 'production' --config 'evm-contract-call.webpack.config.cjs' --stats-error-details && mv 'evm-contract-call.js' 'dist/evm-contract-call' && npx webpack --mode 'production' --config 'webpack.config.cjs' --stats-error-details && mv 'evm-contracts-tools.js' 'dist/evm-contracts-tools'",
+      "npm run build-evm-contract-call && npm run build-evm-contract-deployments-dir && npm run build-evm-contracts-tools",
     "build-man":
       "make build-man",
     "build":