rocketh 0.9.1 → 0.10.0

package/dist/cli.cjs

@@ -95,9 +95,9 @@ function stringToJSON(str) {
 // src/environment/deployments.ts
 var import_node_path2 = __toESM(require("path"), 1);
 var import_node_fs2 = __toESM(require("fs"), 1);
-function loadDeployments(deploymentsPath, subPath, onlyABIAndAddress, expectedChain) {
+function loadDeployments(deploymentsPath, networkName, onlyABIAndAddress, expectedChain) {
   const deploymentsFound = {};
-  const deployPath = import_node_path2.default.join(deploymentsPath, subPath);
+  const deployPath = import_node_path2.default.join(deploymentsPath, networkName);
   let filesStats;
   try {
     filesStats = traverse(deployPath, void 0, void 0, (name) => !name.startsWith(".") && name !== "solcInputs");
@@ -119,7 +119,7 @@ function loadDeployments(deploymentsPath, subPath, onlyABIAndAddress, expectedCh
         genesisHash = chainData.genesisHash;
       } else {
         throw new Error(
-          `A '.chain' or '.chainId' file is expected to be present in the deployment folder for network ${subPath}`
+          `A '.chain' or '.chainId' file is expected to be present in the deployment folder for network ${networkName}`
         );
       }
     }
@@ -266,6 +266,124 @@ function getChain(id) {
   return chain;
 }
 
+// src/environment/utils/artifacts.ts
+var import_ethers = require("ethers");
+function deepEqual(obj1, obj2) {
+  function isObject(obj) {
+    if (typeof obj === "object" && obj != null) {
+      return true;
+    } else {
+      return false;
+    }
+  }
+  if (obj1 === obj2) {
+    return true;
+  } else if (isObject(obj1) && isObject(obj2)) {
+    if (Object.keys(obj1).length !== Object.keys(obj2).length) {
+      return false;
+    }
+    for (var prop in obj1) {
+      if (!deepEqual(obj1[prop], obj2[prop])) {
+        return false;
+      }
+    }
+    return true;
+  }
+  return false;
+}
+function mergeDoc(values, mergedDevDocs, field) {
+  if (values[field]) {
+    const mergedEventDocs = mergedDevDocs[field] = mergedDevDocs[field] || {};
+    for (const signature of Object.keys(values[field])) {
+      if (mergedEventDocs[signature] && !deepEqual(mergedEventDocs[signature], values[field][signature])) {
+        throw new Error(`Doc ${field} conflict: "${signature}" `);
+      }
+      mergedEventDocs[signature] = values[field][signature];
+    }
+  }
+}
+function mergeArtifacts(list) {
+  const mergedABI = [];
+  const added = /* @__PURE__ */ new Map();
+  const mergedDevDocs = { kind: "dev", version: 1, methods: {} };
+  const mergedUserDocs = { kind: "user", version: 1, methods: {} };
+  const sigJSMap = /* @__PURE__ */ new Map();
+  for (let i = 0; i < list.length; i++) {
+    const listElem = list[i];
+    for (const element of listElem.artifact.abi) {
+      if (element.type === "function") {
+        const selector = import_ethers.FunctionFragment.from(element).selector;
+        if (sigJSMap.has(selector)) {
+          const existing = sigJSMap.get(selector);
+          throw new Error(
+            `ABI conflict: ${existing.routeName} has function "${existing.functionName}" which conflict with ${listElem.name}'s "${element.name}" (selector: "${selector}")  `
+          );
+        }
+        sigJSMap.set(selector, { index: i, routeName: listElem.name, functionName: element.name });
+        const exists = added.has(element.name);
+        if (exists) {
+        } else {
+          added.set(element.name, element);
+          mergedABI.push(element);
+        }
+      } else if (element.type === "constructor") {
+      } else if (element.type === "error") {
+        const exists = added.has(element.name);
+        if (exists) {
+        } else {
+          added.set(element.name, element);
+          mergedABI.push(element);
+        }
+      } else if (element.type === "event") {
+        const exists = added.has(element.name);
+        if (exists) {
+        } else {
+          added.set(element.name, element);
+          mergedABI.push(element);
+        }
+      } else if (element.type === "fallback") {
+      } else if (element.type === "receive") {
+      } else {
+      }
+    }
+    const devdoc = listElem.artifact.devdoc;
+    if (devdoc) {
+      mergeDoc(devdoc, mergedDevDocs, "events");
+      mergeDoc(devdoc, mergedDevDocs, "errors");
+      mergeDoc(devdoc, mergedDevDocs, "methods");
+      if (devdoc.author) {
+        if (mergedDevDocs.author && mergedDevDocs.author != devdoc.author) {
+          throw new Error(`DevDoc author conflict `);
+        }
+        mergedDevDocs.author = devdoc.author;
+        if (mergedDevDocs.title && mergedDevDocs.title != devdoc.title) {
+          throw new Error(`DevDoc title conflict `);
+        }
+        mergedDevDocs.title = devdoc.title;
+      }
+    }
+    const userdoc = listElem.artifact.userdoc;
+    if (userdoc) {
+      mergeDoc(userdoc, mergedUserDocs, "events");
+      mergeDoc(userdoc, mergedUserDocs, "errors");
+      mergeDoc(userdoc, mergedUserDocs, "methods");
+      if (userdoc.notice) {
+        if (mergedUserDocs.notice && mergedUserDocs.notice != userdoc.notice) {
+          throw new Error(`UserDoc notice conflict `);
+        }
+        mergedUserDocs.notice = userdoc.notice;
+      }
+    }
+  }
+  return {
+    mergedABI,
+    added,
+    mergedDevDocs,
+    mergedUserDocs,
+    sigJSMap
+  };
+}
+
 // src/environment/index.ts
 globalThis.extensions = [];
 globalThis.signerProtocols = {};
@@ -283,8 +401,8 @@ function displayTransaction(transaction) {
     return `(gasPrice: ${BigInt(transaction.gasPrice).toString()})`;
   }
 }
-async function createEnvironment(config2, providedContext) {
-  const provider = "provider" in config2 ? config2.provider : new import_eip_1193_jsonrpc_provider.JSONRPCHTTPProvider(config2.nodeUrl);
+async function createEnvironment(config, providedContext) {
+  const provider = "provider" in config.network ? config.network.provider : new import_eip_1193_jsonrpc_provider.JSONRPCHTTPProvider(config.network.nodeUrl);
   const transport = (0, import_viem.custom)(provider);
   const viemClient = (0, import_viem.createPublicClient)({ transport });
   const chainId = (await viemClient.getChainId()).toString();
@@ -296,23 +414,29 @@ async function createEnvironment(config2, providedContext) {
   }
   let networkName;
   let saveDeployments;
-  let tags = {};
-  if ("nodeUrl" in config2) {
-    networkName = config2.networkName;
+  let networkTags = {};
+  for (const networkTag of config.network.tags) {
+    networkTags[networkTag] = true;
+  }
+  if ("nodeUrl" in config) {
+    networkName = config.network.name;
     saveDeployments = true;
   } else {
-    if (config2.networkName) {
-      networkName = config2.networkName;
+    if (config.network.name) {
+      networkName = config.network.name;
     } else {
       networkName = "memory";
     }
     if (networkName === "memory" || networkName === "hardhat") {
-      tags["memory"] = true;
+      networkTags["memory"] = true;
       saveDeployments = false;
     } else {
       saveDeployments = true;
     }
   }
+  if (config.saveDeployments !== void 0) {
+    saveDeployments = config.saveDeployments;
+  }
   const resolvedAccounts = {};
   const accountCache = {};
   async function getAccount(name, accounts, accountDef) {
@@ -392,15 +516,21 @@ async function createEnvironment(config2, providedContext) {
     artifacts: providedContext.artifacts,
     network: {
       name: networkName,
+      fork: config.network.fork,
       saveDeployments,
-      tags
+      tags: networkTags
     }
   };
-  const { deployments } = loadDeployments(config2.deployments, context.network.name, false, {
-    chainId,
-    genesisHash,
-    deleteDeploymentsIfDifferentGenesisHash: true
-  });
+  const { deployments } = loadDeployments(
+    config.deployments,
+    context.network.name,
+    false,
+    context.network.fork ? void 0 : {
+      chainId,
+      genesisHash,
+      deleteDeploymentsIfDifferentGenesisHash: true
+    }
+  );
   const namedAccounts = {};
   const namedSigners = {};
   const addressSigners = {};
@@ -412,7 +542,7 @@ async function createEnvironment(config2, providedContext) {
     namedSigners[name] = namedSigner;
   }
   const perliminaryEnvironment = {
-    config: config2,
+    config,
     deployments,
     accounts: namedAccounts,
     signers: namedSigners,
@@ -426,7 +556,7 @@ async function createEnvironment(config2, providedContext) {
     }
   };
   function ensureDeploymentFolder() {
-    const folderPath = import_node_path3.default.join(config2.deployments, context.network.name);
+    const folderPath = import_node_path3.default.join(config.deployments, context.network.name);
     import_node_fs3.default.mkdirSync(folderPath, { recursive: true });
     const chainFilepath = import_node_path3.default.join(folderPath, ".chain");
     if (!import_node_fs3.default.existsSync(chainFilepath)) {
@@ -442,7 +572,31 @@ async function createEnvironment(config2, providedContext) {
     return deployment;
   }
   function getOrNull(name) {
-    return deployments[name];
+    return deployments[name] || null;
+  }
+  function fromAddressToNamedABIOrNull(address) {
+    let list = [];
+    for (const name of Object.keys(deployments)) {
+      const deployment = deployments[name];
+      if (deployment.address.toLowerCase() == address.toLowerCase()) {
+        list.push({ name, artifact: deployment });
+      }
+    }
+    if (list.length === 0) {
+      return null;
+    }
+    const { mergedABI } = mergeArtifacts(list);
+    return {
+      mergedABI,
+      names: list.map((v) => v.name)
+    };
+  }
+  function fromAddressToNamedABI(address) {
+    const n = fromAddressToNamedABIOrNull(address);
+    if (!n) {
+      throw new Error(`could not find artifact for address ${address}`);
+    }
+    return n;
   }
   async function save(name, deployment) {
     deployments[name] = deployment;
@@ -711,6 +865,8 @@ async function createEnvironment(config2, providedContext) {
     savePendingExecution,
     get,
     getOrNull,
+    fromAddressToNamedABI,
+    fromAddressToNamedABIOrNull,
     showMessage,
     showProgress
   };
@@ -730,24 +886,55 @@ async function createEnvironment(config2, providedContext) {
 if (!process.env["ROCKETH_SKIP_ESBUILD"]) {
   require("esbuild-register/dist/node").register();
 }
-function readConfig(options2, extra) {
+function readConfig(options2) {
   let configFile;
   try {
     const configString = import_node_fs4.default.readFileSync("./rocketh.json", "utf-8");
     configFile = JSON.parse(configString);
   } catch {
   }
-  let nodeUrl;
+  if (configFile) {
+    if (!options2.deployments && configFile.deployments) {
+      options2.deployments = configFile.deployments;
+    }
+    if (!options2.scripts && configFile.scripts) {
+      options2.scripts = configFile.scripts;
+    }
+  }
   const fromEnv = process.env["ETH_NODE_URI_" + options2.network];
-  if (typeof fromEnv === "string") {
-    nodeUrl = fromEnv;
-  } else {
-    if (configFile) {
-      const network = configFile.networks && configFile.networks[options2.network];
-      if (network) {
-        nodeUrl = network.rpcUrl;
+  const fork = typeof options2.network !== "string";
+  let networkName = "memory";
+  if (options2.network) {
+    if (typeof options2.network === "string") {
+      networkName = options2.network;
+    } else if ("fork" in options2.network) {
+      networkName = options2.network.fork;
+    }
+  }
+  let networkTags = configFile?.networks && configFile?.networks[networkName]?.tags || [];
+  if (!options2.provider) {
+    let nodeUrl;
+    if (typeof fromEnv === "string") {
+      nodeUrl = fromEnv;
+    } else {
+      if (configFile) {
+        const network = configFile.networks && configFile.networks[networkName];
+        if (network && network.rpcUrl) {
+          nodeUrl = network.rpcUrl;
+        } else {
+          if (options2?.ignoreMissingRPC) {
+            nodeUrl = "";
+          } else {
+            if (options2.network === "localhost") {
+              nodeUrl = "http://127.0.0.1:8545";
+            } else {
+              logger.error(`network "${options2.network}" is not configured. Please add it to the rocketh.json file`);
+              process.exit(1);
+            }
+          }
+        }
       } else {
-        if (extra?.ignoreMissingRPC) {
+        if (options2?.ignoreMissingRPC) {
           nodeUrl = "";
         } else {
           if (options2.network === "localhost") {
@@ -758,45 +945,60 @@ function readConfig(options2, extra) {
           }
         }
       }
-    } else {
-      if (extra?.ignoreMissingRPC) {
-        nodeUrl = "";
-      } else {
-        if (options2.network === "localhost") {
-          nodeUrl = "http://127.0.0.1:8545";
-        } else {
-          logger.error(`network "${options2.network}" is not configured. Please add it to the rocketh.json file`);
-          process.exit(1);
-        }
-      }
     }
+    return {
+      network: {
+        nodeUrl,
+        name: networkName,
+        tags: networkTags,
+        fork
+      },
+      deployments: options2.deployments,
+      saveDeployments: options2.saveDeployments,
+      scripts: options2.scripts,
+      tags: typeof options2.tags === "undefined" ? void 0 : options2.tags.split(","),
+      logLevel: options2.logLevel
+    };
+  } else {
+    return {
+      network: {
+        provider: options2.provider,
+        name: networkName,
+        tags: networkTags,
+        fork
+      },
+      deployments: options2.deployments,
+      saveDeployments: options2.saveDeployments,
+      scripts: options2.scripts,
+      tags: typeof options2.tags === "undefined" ? void 0 : options2.tags.split(","),
+      logLevel: options2.logLevel
+    };
   }
-  return {
-    nodeUrl,
-    networkName: options2.network,
-    deployments: options2.deployments,
-    scripts: options2.scripts,
-    tags: typeof options2.tags === "undefined" ? void 0 : options2.tags.split(",")
-  };
 }
-function resolveConfig(config2) {
+function readAndResolveConfig(options2) {
+  return resolveConfig(readConfig(options2));
+}
+function resolveConfig(config) {
   const resolvedConfig = {
-    ...config2,
-    networkName: config2.networkName || "memory",
-    deployments: config2.deployments || "deployments",
-    scripts: config2.scripts || "deploy",
-    tags: config2.tags || []
+    ...config,
+    network: config.network,
+    // TODO default to || {name: 'memory'....}
+    deployments: config.deployments || "deployments",
+    scripts: config.scripts || "deploy",
+    tags: config.tags || [],
+    networkTags: config.networkTags || [],
+    saveDeployments: config.saveDeployments
   };
   return resolvedConfig;
 }
-async function loadAndExecuteDeployments(config2, args) {
-  const resolvedConfig = resolveConfig(config2);
+async function loadAndExecuteDeployments(options2, args) {
+  const resolvedConfig = readAndResolveConfig(options2);
   return executeDeployScripts(resolvedConfig, args);
 }
-async function executeDeployScripts(config2, args) {
-  setLogLevel(typeof config2.logLevel === "undefined" ? 0 : config2.logLevel);
+async function executeDeployScripts(config, args) {
+  setLogLevel(typeof config.logLevel === "undefined" ? 0 : config.logLevel);
   let filepaths;
-  filepaths = traverseMultipleDirectory([config2.scripts]);
+  filepaths = traverseMultipleDirectory([config.scripts]);
   filepaths = filepaths.filter((v) => !import_node_path4.default.basename(v).startsWith("_")).sort((a, b) => {
     if (a < b) {
       return -1;
@@ -848,10 +1050,10 @@ async function executeDeployScripts(config2, args) {
         bag.push(scriptFilePath);
       }
     }
-    if (config2.tags !== void 0 && config2.tags.length > 0) {
+    if (config.tags !== void 0 && config.tags.length > 0) {
       let found = false;
       if (scriptTags !== void 0) {
-        for (const tagToFind of config2.tags) {
+        for (const tagToFind of config.tags) {
           for (const tag of scriptTags) {
             if (tag === tagToFind) {
               scriptFilePaths.push(scriptFilePath);
@@ -871,7 +1073,7 @@ async function executeDeployScripts(config2, args) {
   if (!providedContext) {
     throw new Error(`no context loaded`);
   }
-  const { internal, external } = await createEnvironment(config2, providedContext);
+  const { internal, external } = await createEnvironment(config, providedContext);
   await internal.recoverTransactionsIfAny();
   const scriptsRegisteredToRun = {};
   const scriptsToRun = [];
@@ -935,7 +1137,7 @@ async function executeDeployScripts(config2, args) {
         throw e;
       }
       if (result && typeof result === "boolean") {
-        const deploymentFolderPath = config2.deployments;
+        const deploymentFolderPath = config.deployments;
       }
     }
   }
@@ -948,7 +1150,7 @@ var import_commander = require("commander");
 // package.json
 var package_default = {
   name: "rocketh",
-  version: "0.9.0",
+  version: "0.10.0",
   description: "deploy smart contract on ethereum-compatible networks",
   publishConfig: {
     access: "public"
@@ -976,6 +1178,7 @@ var package_default = {
     "eip-1193-jsonrpc-provider": "^0.3.0",
     esbuild: "^0.20.1",
     "esbuild-register": "^3.5.0",
+    ethers: "^6.11.1",
     figlet: "^1.7.0",
     ldenv: "^0.3.9",
     "named-logs": "^0.2.2",
@@ -997,6 +1200,5 @@ var commandName = package_default.name;
 var program = new import_commander.Command();
 program.name(commandName).version(package_default.version).usage(`${commandName}`).description("execute deploy scripts and store the deployments").option("-s, --scripts <value>", "path the folder containing the deploy scripts to execute").option("-t, --tags <value>", "comma separated list of tags to execute").option("-d, --deployments <value>", "folder where deployments are saved").requiredOption("-n, --network <value>", "network context to use").parse(process.argv);
 var options = program.opts();
-var config = readConfig(options);
-loadAndExecuteDeployments({ ...config, logLevel: 1 });
+loadAndExecuteDeployments({ ...options, logLevel: 1 });
 //# sourceMappingURL=cli.cjs.map