sol2uml 2.5.21 → 2.5.23

package/README.md

@@ -1,7 +1,7 @@
 # Solidity 2 UML
 
 [![npm (tag)](https://img.shields.io/npm/v/sol2uml)](https://www.npmjs.com/package/sol2uml)
-[![Twitter Follow](https://img.shields.io/twitter/follow/naddison?style=social)](https://twitter.com/naddison)
+[![X Follow](https://img.shields.io/twitter/follow/naddison?style=social)](https://x.com/naddison)
 
 A visualisation tool for [Solidity](https://solidity.readthedocs.io/) contracts featuring:
 1. [Unified Modeling Language (UML)](https://en.wikipedia.org/wiki/Unified_Modeling_Language) [class diagram](https://en.wikipedia.org/wiki/Class_diagram) generator for Solidity contracts.
@@ -22,7 +22,7 @@ See an explanation of how storage diagrams work with lots of examples [here](./e
 # Install
 
 The following installation assumes [Node.js](https://nodejs.org/en/download/) has already been installed which comes with [Node Package Manager (NPM)](https://www.npmjs.com/).
-`sol2uml` works with node 14 or above.
+`sol2uml` works with node 20 or above.
 
 To install globally so you can run `sol2uml` from anywhere
 
@@ -57,9 +57,9 @@ Options:
   -f, --outputFormat <value>                      output file format. (choices: "svg", "png", "dot", "all", default: "svg")
   -o, --outputFileName <value>                    output file name
   -i, --ignoreFilesOrFolders <names>              comma-separated list of files or folders to ignore
-  -n, --network <network>                         Ethereum network which maps to a blockchain explorer (choices: "mainnet", "holesky", "sepolia", "polygon", "arbitrum", "avalanche", "bsc", "crono", "fantom", "moonbeam", "optimism", "gnosis", "celo", "scroll", "base", "sonic", default: "mainnet", env: ETH_NETWORK)
-  -e, --explorerUrl <url>                         Override the `network` option with a custom blockchain explorer API URL. eg Polygon Mumbai testnet https://api-testnet.polygonscan.com/api (env: EXPLORER_URL)
-  -k, --apiKey <key>                              Blockchain explorer API key. eg Etherscan, Arbiscan, Optimism, BscScan, CronoScan, FTMScan, PolygonScan, SonicScan or SnowTrace API key (env: SCAN_API_KEY)
+  -n, --network <network>                         Name or chain id of the blockchain explorer. A name like `ethereum` or `base` will map to a chain id, eg 1 or 8453. Alternatively, use an integer of the chain id. Supported names: ethereum, sepolia, holesky, hoodi, arbitrum, optimism, polygon, avalanche, base, bsc, crono, fantom, sonic, gnosis, moonbeam, celo, scroll, linea, blast, berachain, zksync (default: "ethereum", env: ETH_NETWORK)
+  -e, --explorerUrl <url>                         Override the `network` option with a custom blockchain explorer API URL. eg Polygon Amoy testnet https://api-amoy.polygonscan.com/api (env: EXPLORER_URL)
+  -k, --apiKey <key>                              Blockchain explorer API key. (env: SCAN_API_KEY)
   -bc, --backColor <color>                        Canvas background color. "none" will use a transparent canvas. (default: "white")
   -sc, --shapeColor <color>                       Basic drawing color for graphics, not text (default: "black")
   -fc, --fillColor <color>                        Color used to fill the background of a node (default: "gray95")
@@ -81,7 +81,7 @@ Commands:
                                                   3. File imports are commented out.
                                                   4. "SPDX-License-Identifier" is renamed to "SPDX--License-Identifier".
                                                   5. Contract dependencies are analysed so the files are merged in an order that will compile.
-  diff [options] <addressA> <fileFoldersAddress>  Compare verified Solidity code to another verified contract, a local file or local source files.
+  diff [options] <addressA> <fileFoldersAddress>  Compare verified contract code on Etherscan-like explorers to another verified contract, a local file or multiple local files.
   
                                                   The results show the comparison of contract A to B.
                                                   The green sections are additions to contract B that are not in contract A.
@@ -106,7 +106,7 @@ Arguments:
                                         sol2uml 0x79fEbF6B9F76853EDBcBc913e6aAE8232cFB9De9
 
 Options:
-  -b, --baseContractNames <names>  only output contracts connected to these comma separated base contract names
+  -b, --baseContractNames <names>  only output contracts connected to these comma-separated base contract names
   -d, --depth <value>              depth of connected classes to the base contracts. 1 will only show directly connected contracts, interfaces, libraries, structs and enums. (default: all)
   -c, --clusterFolders             cluster contracts into source folders (default: false)
   -hv, --hideVariables             hide variables from contracts, interfaces, structs and enums (default: false)
@@ -139,8 +139,8 @@ WARNING: sol2uml does not use the Solidity compiler so may differ with solc. A k
 Arguments:
   fileFolderAddress               file name, folder(s) or contract address.
                                   When a folder is used, all *.sol files in that folder and all sub folders are used.
-                                  A comma-separated list of files and folders can also be used. For example
-                                        sol2uml contracts,node_modules/openzeppelin-solidity
+                                  A comma-separated list of files and folders can also be used. For example,
+                                        sol2uml contracts,node_modules/@openzeppelin
                                   If an Ethereum address with a 0x prefix is passed, the verified source code from Etherscan will be used. For example
                                         sol2uml 0x79fEbF6B9F76853EDBcBc913e6aAE8232cFB9De9
 
@@ -203,13 +203,12 @@ Options:
   -s, --summary              Only show a summary of the file differences (default: false)
   -af --aFile <value>        Limit code compare to contract A source file with the full path and extension as displayed in the file summary (default: compares all source files)
   -bf --bFile <value>        Contract B source file with the full path and extension as displayed in the file summary. Used if aFile is specified and the source file has been renamed (default: aFile if specified)
-  -bn, --bNetwork <network>  Ethereum network which maps to a blockchain explorer for contract B if on a different blockchain to contract A. Contract A uses the `network` option (default: value of `network` option) (choices: "mainnet", "holesky", "sepolia", "polygon", "arbitrum", "avalanche", "bsc", "crono", "fantom", "moonbeam", "optimism", "gnosis", "celo", "base")
-  -be, --bExplorerUrl <url>  Override the `bNetwork` option with custom blockchain explorer API URL for contract B if on a different blockchain to contract A. Contract A uses the `explorerUrl` (default: value of `explorerUrl` option)
-  -bk, --bApiKey <key>       Blockchain explorer API key for contract B if on a different blockchain to contract A. Contract A uses the `apiKey` option (default: value of `apiKey` option)
+  -bn, --bNetwork <network>  Ethereum network which maps to a blockchain explorer for contract B if on a different blockchain to contract A. Contract A uses the `network` option (default: value of `network` option) (choices: "ethereum", "sepolia", "holesky", "hoodi", "arbitrum", "optimism", "polygon", "avalanche", "base", "bsc", "crono", "fantom", "sonic", "gnosis", "moonbeam", "celo", "scroll", "linea", "blast", "berachain", "zksync")
   --flatten                  Flatten into a single file before comparing. Only works when comparing two verified contracts, not to local files (default: false)
   --saveFiles                Save the flattened contract code to the filesystem when using the `flatten` option. The file names will be the contract address with a .sol extension (default: false)
   -l, --lineBuffer <value>   Minimum number of lines before and after changes (default: 4)
   -h, --help                 display help for command
+
 ```
 
 ## UML Class diagram examples
@@ -226,10 +225,10 @@ To generate a diagram of EtherDelta's contract from the verified source code on
 sol2uml class 0x8d12A197cB00D4747a1fe03395095ce2A5CC6819
 ```
 
-To generate a diagram of EtherDelta's contract from the verified source code on [Etherscan Ropsten](https://ropsten.etherscan.io/address/0xa19833bd291b66aB0E17b9C6d46D2Ec5fEC15190#code). The output will be a svg file `0xa19833bd291b66aB0E17b9C6d46D2Ec5fEC15190.svg` in the working folder.
+To generate a diagram of a contract on [Hoodi](https://hoodi.etherscan.io/address/0x8d62350d6DfC8A928bBF5efD2e44c66034Afa7C6#code). The output will be a svg file `0x8d62350d6DfC8A928bBF5efD2e44c66034Afa7C6.svg` in the working folder.
 
 ```bash
-sol2uml class 0xa19833bd291b66aB0E17b9C6d46D2Ec5fEC15190 -n ropsten
+sol2uml class 0x8d62350d6DfC8A928bBF5efD2e44c66034Afa7C6 -n hoodi
 ```
 
 To generate all Solidity files under some root folder and output the svg file to a specific location
@@ -355,7 +354,7 @@ npm run clean
 npm run package-lock
 npm run build
 npm run permit
-# make tx2uml globally available for local testing
+# make sol2uml globally available for local testing
 npm link
 # check all the files are included in the npm package
 npm pack --dry-run

package/lib/SlotValueCache.js

@@ -16,7 +16,7 @@ class SlotValueCache {
     static readSlotValues(slotKeys) {
         const cachedValues = [];
         const missingKeys = [];
-        slotKeys.forEach((slotKey, i) => {
+        slotKeys.forEach((slotKey) => {
             const key = bignumber_1.BigNumber.from(slotKey).toHexString();
             if (this.slotCache[key]) {
                 cachedValues.push(this.slotCache[key]);

package/lib/associations.d.ts

@@ -1,2 +1,2 @@
 import { Association, UmlClass } from './umlClass';
-export declare const findAssociatedClass: (association: Association, sourceUmlClass: UmlClass, umlClasses: readonly UmlClass[], searchedAbsolutePaths?: string[]) => UmlClass | undefined;
+export declare const findAssociatedClass: (association: Association, sourceUmlClass: UmlClass, umlClasses: readonly UmlClass[], _searchedAbsolutePaths?: string[]) => UmlClass | undefined;

package/lib/associations.js

@@ -2,7 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.findAssociatedClass = void 0;
 // Find the UML class linked to the association
-const findAssociatedClass = (association, sourceUmlClass, umlClasses, searchedAbsolutePaths = []) => {
+const findAssociatedClass = (association, sourceUmlClass, umlClasses, _searchedAbsolutePaths = []) => {
     const umlClass = umlClasses.find((targetUmlClass) => {
         const targetParentClass = association.parentUmlClassName &&
             targetUmlClass.parentId !== undefined
@@ -13,16 +13,23 @@ const findAssociatedClass = (association, sourceUmlClass, umlClasses, searchedAb
     // If a link was found
     if (umlClass)
         return umlClass;
-    // Could not find association so now need to recursively look at imports of imports
-    // add to already recursively processed files to avoid getting stuck in circular imports
-    searchedAbsolutePaths.push(sourceUmlClass.absolutePath);
-    const importedType = findChainedImport(association, sourceUmlClass, umlClasses, searchedAbsolutePaths);
-    if (importedType)
-        return importedType;
-    // Still could not find association so now need to recursively look for inherited types
-    const inheritedType = findInheritedType(association, sourceUmlClass, umlClasses);
-    if (inheritedType)
-        return inheritedType;
+    // // Could not find association so now need to recursively look at imports of imports
+    // // add to already recursively processed files to avoid getting stuck in circular imports
+    // searchedAbsolutePaths.push(sourceUmlClass.absolutePath)
+    // const importedType = findChainedImport(
+    //     association,
+    //     sourceUmlClass,
+    //     umlClasses,
+    //     searchedAbsolutePaths,
+    // )
+    // if (importedType) return importedType
+    // // Still could not find association so now need to recursively look for inherited types
+    // const inheritedType = findInheritedType(
+    //     association,
+    //     sourceUmlClass,
+    //     umlClasses,
+    // )
+    // if (inheritedType) return inheritedType
     return undefined;
 };
 exports.findAssociatedClass = findAssociatedClass;
@@ -76,7 +83,7 @@ const isAssociated = (association, sourceUmlClass, targetUmlClass, targetParentU
                     importedClass.alias &&
                     importedClass.className === targetUmlClass.name))));
 };
-const findInheritedType = (association, sourceUmlClass, umlClasses) => {
+const _findInheritedType = (association, sourceUmlClass, umlClasses) => {
     // Get all realized associations.
     const parentAssociations = sourceUmlClass.getParentContracts();
     // For each parent association
@@ -103,45 +110,68 @@ const findInheritedType = (association, sourceUmlClass, umlClasses) => {
             }
         }
         // Recursively look for inherited types
-        const targetClass = findInheritedType(association, parent, umlClasses);
+        const targetClass = _findInheritedType(association, parent, umlClasses);
         if (targetClass)
             return targetClass;
     }
     return undefined;
 };
-const findChainedImport = (association, sourceUmlClass, umlClasses, searchedRelativePaths) => {
-    // Get all valid imports. That is, imports that do not explicitly import contracts or interfaces
-    // or explicitly import the source class
-    const imports = sourceUmlClass.imports.filter((i) => i.classNames.length === 0 ||
-        i.classNames.some((cn) => (association.targetUmlClassName === cn.className &&
-            !cn.alias) ||
-            association.targetUmlClassName === cn.alias));
-    // For each import
-    for (const importDetail of imports) {
-        // Find a class with the same absolute path as the import so we can get the new imports
-        const newSourceUmlClass = umlClasses.find((c) => c.absolutePath === importDetail.absolutePath);
-        if (!newSourceUmlClass) {
-            // Could not find a class in the import file so just move onto the next loop
-            continue;
-        }
-        // Avoid circular imports
-        if (searchedRelativePaths.includes(newSourceUmlClass.absolutePath)) {
-            // Have already recursively looked for imports of imports in this file
-            continue;
-        }
-        // find class linked to the association without aliased imports
-        const umlClass = (0, exports.findAssociatedClass)(association, newSourceUmlClass, umlClasses, searchedRelativePaths);
-        if (umlClass)
-            return umlClass;
-        // find all aliased imports
-        const aliasedImports = importDetail.classNames.filter((cn) => cn.alias);
-        // For each aliased import
-        for (const aliasedImport of aliasedImports) {
-            const umlClass = (0, exports.findAssociatedClass)({ ...association, targetUmlClassName: aliasedImport.className }, newSourceUmlClass, umlClasses, searchedRelativePaths);
-            if (umlClass)
-                return umlClass;
-        }
-    }
-    return undefined;
-};
+// const findChainedImport = (
+//     association: Association,
+//     sourceUmlClass: UmlClass,
+//     umlClasses: readonly UmlClass[],
+//     searchedRelativePaths: string[],
+// ): UmlClass | undefined => {
+//     // Get all valid imports. That is, imports that do not explicitly import contracts or interfaces
+//     // or explicitly import the source class
+//     const imports = sourceUmlClass.imports.filter(
+//         (i) =>
+//             i.classNames.length === 0 ||
+//             i.classNames.some(
+//                 (cn) =>
+//                     (association.targetUmlClassName === cn.className &&
+//                         !cn.alias) ||
+//                     association.targetUmlClassName === cn.alias,
+//             ),
+//     )
+//     // For each import
+//     for (const importDetail of imports) {
+//         // Find a class with the same absolute path as the import so we can get the new imports
+//         const newSourceUmlClass = umlClasses.find(
+//             (c) => c.absolutePath === importDetail.absolutePath,
+//         )
+//         if (!newSourceUmlClass) {
+//             // Could not find a class in the import file so just move onto the next loop
+//             continue
+//         }
+//         // Avoid circular imports
+//         if (searchedRelativePaths.includes(newSourceUmlClass.absolutePath)) {
+//             // Have already recursively looked for imports of imports in this file
+//             continue
+//         }
+//
+//         // find class linked to the association without aliased imports
+//         const umlClass = findAssociatedClass(
+//             association,
+//             newSourceUmlClass,
+//             umlClasses,
+//             searchedRelativePaths,
+//         )
+//         if (umlClass) return umlClass
+//
+//         // find all aliased imports
+//         const aliasedImports = importDetail.classNames.filter((cn) => cn.alias)
+//         // For each aliased import
+//         for (const aliasedImport of aliasedImports) {
+//             const umlClass = findAssociatedClass(
+//                 { ...association, targetUmlClassName: aliasedImport.className },
+//                 newSourceUmlClass,
+//                 umlClasses,
+//                 searchedRelativePaths,
+//             )
+//             if (umlClass) return umlClass
+//         }
+//     }
+//     return undefined
+// }
 //# sourceMappingURL=associations.js.map

package/lib/converterAST2Classes.js

@@ -15,15 +15,26 @@ var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (
 }) : function(o, v) {
     o["default"] = v;
 });
-var __importStar = (this && this.__importStar) || function (mod) {
-    if (mod && mod.__esModule) return mod;
-    var result = {};
-    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
-    __setModuleDefault(result, mod);
-    return result;
-};
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.renameFile = exports.convertAST2UmlClasses = void 0;
+exports.renameFile = void 0;
+exports.convertAST2UmlClasses = convertAST2UmlClasses;
 const path = __importStar(require("path"));
 const path_1 = require("path");
 const umlClass_1 = require("./umlClass");
@@ -44,11 +55,11 @@ function convertAST2UmlClasses(node, relativePath, remappings, filesystem = fals
     if (node.type === 'SourceUnit') {
         node.children.forEach((childNode) => {
             if (childNode.type === 'ContractDefinition') {
-                let umlClass = new umlClass_1.UmlClass({
+                const umlClass = new umlClass_1.UmlClass({
                     name: childNode.name,
                     absolutePath: filesystem
                         ? path.resolve(relativePath) // resolve the absolute path
-                        : relativePath,
+                        : relativePath, // from Etherscan so don't resolve
                     relativePath,
                 });
                 umlClasses.push(umlClass);
@@ -57,12 +68,12 @@ function convertAST2UmlClasses(node, relativePath, remappings, filesystem = fals
             }
             else if (childNode.type === 'StructDefinition') {
                 debug(`Adding file level struct ${childNode.name}`);
-                let umlClass = new umlClass_1.UmlClass({
+                const umlClass = new umlClass_1.UmlClass({
                     name: childNode.name,
                     stereotype: umlClass_1.ClassStereotype.Struct,
                     absolutePath: filesystem
                         ? path.resolve(relativePath) // resolve the absolute path
-                        : relativePath,
+                        : relativePath, // from Etherscan so don't resolve
                     relativePath,
                 });
                 parseStructDefinition(childNode, umlClass);
@@ -71,12 +82,12 @@ function convertAST2UmlClasses(node, relativePath, remappings, filesystem = fals
             }
             else if (childNode.type === 'EnumDefinition') {
                 debug(`Adding file level enum ${childNode.name}`);
-                let umlClass = new umlClass_1.UmlClass({
+                const umlClass = new umlClass_1.UmlClass({
                     name: childNode.name,
                     stereotype: umlClass_1.ClassStereotype.Enum,
                     absolutePath: filesystem
                         ? path.resolve(relativePath) // resolve the absolute path
-                        : relativePath,
+                        : relativePath, // from Etherscan so don't resolve
                     relativePath,
                 });
                 debug(`Added enum ${umlClass.name}`);
@@ -105,7 +116,7 @@ function convertAST2UmlClasses(node, relativePath, remappings, filesystem = fals
                         debug(`Added filesystem import ${newImport.absolutePath} with class names ${newImport.classNames.map((i) => i.className)}`);
                         imports.push(newImport);
                     }
-                    catch (err) {
+                    catch {
                         debug(`Failed to resolve import ${childNode.path} from file ${relativePath}`);
                     }
                 }
@@ -143,7 +154,7 @@ function convertAST2UmlClasses(node, relativePath, remappings, filesystem = fals
                     stereotype: umlClass_1.ClassStereotype.Constant,
                     absolutePath: filesystem
                         ? path.resolve(relativePath) // resolve the absolute path
-                        : relativePath,
+                        : relativePath, // from Etherscan so don't resolve
                     relativePath,
                     attributes: [
                         {
@@ -181,7 +192,7 @@ function convertAST2UmlClasses(node, relativePath, remappings, filesystem = fals
             stereotype: umlClass_1.ClassStereotype.Import,
             absolutePath: filesystem
                 ? path.resolve(relativePath) // resolve the absolute path
-                : relativePath,
+                : relativePath, // from Etherscan so don't resolve
             relativePath,
         });
         importUmlClass.imports = imports;
@@ -189,7 +200,6 @@ function convertAST2UmlClasses(node, relativePath, remappings, filesystem = fals
     }
     return umlClasses;
 }
-exports.convertAST2UmlClasses = convertAST2UmlClasses;
 /**
  * Parse struct definition for UML attributes and associations.
  * @param node defined in ASTNode as `StructDefinition`
@@ -616,7 +626,7 @@ function parseTypeName(typeName) {
         case 'FunctionTypeName':
             // TODO add params and return type
             return [typeName.type + '\\(\\)', umlClass_1.AttributeType.Function];
-        case 'ArrayTypeName':
+        case 'ArrayTypeName': {
             const [arrayElementType] = parseTypeName(typeName.baseTypeName);
             let length = '';
             if (Number.isInteger(typeName.length)) {
@@ -630,7 +640,8 @@ function parseTypeName(typeName) {
             }
             // TODO does not currently handle Expression types like BinaryOperation
             return [arrayElementType + '[' + length + ']', umlClass_1.AttributeType.Array];
-        case 'Mapping':
+        }
+        case 'Mapping': {
             const key = typeName.keyType?.name ||
                 typeName.keyType?.namePath;
             const [valueType] = parseTypeName(typeName.valueType);
@@ -638,6 +649,7 @@ function parseTypeName(typeName) {
                 'mapping\\(' + key + '=\\>' + valueType + '\\)',
                 umlClass_1.AttributeType.Mapping,
             ];
+        }
         default:
             throw Error(`Invalid typeName ${typeName}`);
     }
@@ -651,7 +663,7 @@ function parseParameters(params) {
     if (!params || !params) {
         return [];
     }
-    let parameters = [];
+    const parameters = [];
     for (const param of params) {
         const [type] = parseTypeName(param.typeName);
         parameters.push({

package/lib/converterClass2Dot.js

@@ -166,7 +166,7 @@ const dotOperators = (umlClass, vizGroup, operators, options) => {
         return b.stereotype - a.stereotype;
     });
     // Filter out any modifiers or events if options are flagged to hide them
-    let operatorsFiltered = operatorsSortedByStereotype.filter((o) => !((options.hideModifiers === true &&
+    const operatorsFiltered = operatorsSortedByStereotype.filter((o) => !((options.hideModifiers === true &&
         o.stereotype === umlClass_1.OperatorStereotype.Modifier) ||
         (options.hideEvents === true &&
             o.stereotype === umlClass_1.OperatorStereotype.Event)));

package/lib/converterClasses2Dot.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.addAssociationsToDot = exports.convertUmlClasses2Dot = void 0;
+exports.convertUmlClasses2Dot = convertUmlClasses2Dot;
+exports.addAssociationsToDot = addAssociationsToDot;
 const path_1 = require("path");
 const converterClass2Dot_1 = require("./converterClass2Dot");
 const umlClass_1 = require("./umlClass");
@@ -49,7 +50,6 @@ label="${codeFolder}"`;
     debug(dotString);
     return dotString;
 }
-exports.convertUmlClasses2Dot = convertUmlClasses2Dot;
 let subGraphCount = 0;
 function getSubGraphName(clusterFolders = false) {
     if (clusterFolders) {
@@ -104,7 +104,6 @@ function addAssociationsToDot(umlClasses, classOptions = {}) {
     }
     return dotString;
 }
-exports.addAssociationsToDot = addAssociationsToDot;
 function addAssociationToDot(sourceUmlClass, targetUmlClass, association, classOptions = {}) {
     // do not include library or interface associations if hidden
     // Or associations to Structs, Enums or Constants if they are hidden

package/lib/converterClasses2Storage.js

@@ -151,8 +151,8 @@ const parseVariables = (umlClass, umlClasses, variables, storageSections, inheri
         const getValue = calcGetValue(attribute.attributeType, mapping);
         // Get the toSlot of the last storage item
         const lastVariable = variables[variables.length - 1];
-        let lastToSlot = lastVariable ? lastVariable.toSlot : 0;
-        let nextOffset = lastVariable
+        const lastToSlot = lastVariable ? lastVariable.toSlot : 0;
+        const nextOffset = lastVariable
             ? lastVariable.byteOffset + lastVariable.byteSize
             : 0;
         let fromSlot;
@@ -347,7 +347,7 @@ const parseStorageSectionFromAttribute = (attribute, umlClass, otherClasses, sto
             // Find UserDefined type can be a contract, struct or enum
             const typeClass = findTypeClass(result[1], attribute, umlClass, otherClasses);
             if (typeClass.stereotype === umlClass_1.ClassStereotype.Struct) {
-                let variables = parseVariables(typeClass, otherClasses, [], storageSections, [], true, arrayItems, noExpandVariables);
+                const variables = parseVariables(typeClass, otherClasses, [], storageSections, [], true, arrayItems, noExpandVariables);
                 const storageSection = {
                     id: storageId++,
                     name: typeClass.name,
@@ -535,7 +535,7 @@ const calcStorageByteSize = (attribute, umlClass, otherClasses) => {
             case umlClass_1.ClassStereotype.Interface:
             case umlClass_1.ClassStereotype.Library:
                 return { size: 20, dynamic: false };
-            case umlClass_1.ClassStereotype.Struct:
+            case umlClass_1.ClassStereotype.Struct: {
                 let structByteSize = 0;
                 attributeTypeClass.attributes.forEach((structAttribute) => {
                     // If next attribute is an array, then we need to start in a new slot
@@ -569,6 +569,7 @@ const calcStorageByteSize = (attribute, umlClass, otherClasses) => {
                     size: Math.ceil(structByteSize / 32) * 32,
                     dynamic: false,
                 };
+            }
             default:
                 return { size: 20, dynamic: false };
         }
@@ -593,7 +594,7 @@ const calcElementaryTypeSize = (type) => {
         case 'ufixed':
         case 'fixed':
             return { size: 32, dynamic: false };
-        default:
+        default: {
             const result = type.match(/[u]*(int|fixed|bytes)([0-9]+)/);
             if (result === null || !result[2]) {
                 throw Error(`Failed size elementary type "${type}"`);
@@ -606,6 +607,7 @@ const calcElementaryTypeSize = (type) => {
             // If an int
             const bitSize = parseInt(result[2]);
             return { size: bitSize / 8, dynamic: false };
+        }
     }
 };
 const isElementary = (type) => {
@@ -619,9 +621,10 @@ const isElementary = (type) => {
         case 'ufixed':
         case 'fixed':
             return true;
-        default:
+        default: {
             const result = type.match(/^[u]?(int|fixed|bytes)([0-9]+)$/);
             return result !== null;
+        }
     }
 };
 exports.isElementary = isElementary;

package/lib/converterStorage2Dot.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.convertStorage2Dot = exports.convertStorages2Dot = void 0;
+exports.convertStorages2Dot = void 0;
+exports.convertStorage2Dot = convertStorage2Dot;
 const converterClasses2Storage_1 = require("./converterClasses2Storage");
 const umlClass_1 = require("./umlClass");
 const formatters_1 = require("./utils/formatters");
@@ -113,7 +114,6 @@ function convertStorage2Dot(storageSection, dotString, options) {
     dotString += '}}"]\n';
     return dotString;
 }
-exports.convertStorage2Dot = convertStorage2Dot;
 const dotVariable = (variable, contractName) => {
     const port = variable.referenceSectionId !== undefined ? `<${variable.id}>` : '';
     const contractNamePrefix = variable.contractName !== contractName

package/lib/diffContracts.d.ts

@@ -27,7 +27,7 @@ export declare const compareFlattenContracts: (addressA: string, addressB: strin
     contractNameB: string;
 }>;
 export declare const diffVerified2Local: (addressA: string, etherscanParserA: EtherscanParser, fileOrBaseFolders: string[], ignoreFilesOrFolders?: string[]) => Promise<CompareContracts>;
-export declare const diffVerifiedContracts: (addressA: string, addressB: string, etherscanParserA: EtherscanParser, etherscanParserB: EtherscanParser, options: DiffOptions) => Promise<CompareContracts>;
+export declare const diffVerifiedContracts: (addressA: string, addressB: string, etherscanParserA: EtherscanParser, etherscanParserB: EtherscanParser, _options: DiffOptions) => Promise<CompareContracts>;
 export declare const displayFileDiffSummary: (fileDiffs: DiffFiles[]) => void;
 export declare const displayFileDiffs: (fileDiffs: DiffFiles[], options?: {
     lineBuffer?: number;

package/lib/diffContracts.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.displayFileDiffs = exports.displayFileDiffSummary = exports.diffVerifiedContracts = exports.diffVerified2Local = exports.compareFlattenContracts = exports.compareVerified2Local = exports.compareVerifiedContracts = void 0;
 const clc = require('cli-color');
+const fs_1 = require("fs");
 const path_1 = require("path");
 const parserFiles_1 = require("./parserFiles");
 const writerFiles_1 = require("./writerFiles");
@@ -91,12 +92,20 @@ const diffVerified2Local = async (addressA, etherscanParserA, fileOrBaseFolders,
         let bFile;
         // for each of the base folders
         for (const baseFolder of fileOrBaseFolders) {
-            bFile = bFiles.find((bFile) => {
-                const resolvedPath = (0, path_1.resolve)(process.cwd(), baseFolder, aFile.filename);
-                return bFile === resolvedPath;
-            });
-            if (bFile) {
-                break;
+            const aFileResolvedPath = (0, path_1.resolve)(process.cwd(), baseFolder, aFile.filename);
+            try {
+                // Resolve full path including symlinks. For example,
+                // node_modules/@openzeppelin/contracts is a symlink to
+                // node_modules/.pnpm/@openzeppelin+contracts@x.y.z/node_modules/@openzeppelin/contracts
+                const aFileRealPath = (0, fs_1.realpathSync)(aFileResolvedPath);
+                bFile = bFiles.find((bFile) => bFile === aFileRealPath);
+                if (bFile) {
+                    // Found match of aFile in bFiles, break out of loop to try next aFile
+                    break;
+                }
+            }
+            catch {
+                // Do nothing, continue to next bFile in loop
             }
         }
         if (bFile) {
@@ -139,7 +148,7 @@ const diffVerified2Local = async (addressA, etherscanParserA, fileOrBaseFolders,
     };
 };
 exports.diffVerified2Local = diffVerified2Local;
-const diffVerifiedContracts = async (addressA, addressB, etherscanParserA, etherscanParserB, options) => {
+const diffVerifiedContracts = async (addressA, addressB, etherscanParserA, etherscanParserB, _options) => {
     const files = [];
     const { files: aFiles, contractName: contractNameA } = await etherscanParserA.getSourceCode(addressA);
     const { files: bFiles, contractName: contractNameB } = await etherscanParserB.getSourceCode(addressB);

package/lib/parserEtherscan.d.ts

@@ -4,13 +4,14 @@ export interface Remapping {
     from: RegExp;
     to: string;
 }
-export declare const networks: readonly ["mainnet", "holesky", "sepolia", "polygon", "arbitrum", "avalanche", "bsc", "crono", "fantom", "moonbeam", "optimism", "gnosis", "celo", "scroll", "base", "sonic"];
+export declare const networks: readonly ["ethereum", "sepolia", "holesky", "hoodi", "arbitrum", "optimism", "polygon", "avalanche", "base", "bsc", "crono", "fantom", "sonic", "gnosis", "moonbeam", "celo", "scroll", "linea", "blast", "berachain", "zksync"];
 export type Network = (typeof networks)[number];
+export declare const setChainId: (network: string) => number;
 export declare class EtherscanParser {
-    protected apikey: string;
+    protected apiKey?: string;
     network: Network;
     readonly url: string;
-    constructor(apikey?: string, network?: Network, url?: string);
+    constructor(apiKey?: string, network?: Network, url?: string);
     /**
      * Parses the verified source code files from Etherscan
      * @param contractAddress Ethereum contract address with a 0x prefix

package/lib/parserEtherscan.js

@@ -3,7 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.parseRemapping = exports.parseRemappings = exports.EtherscanParser = exports.networks = void 0;
+exports.parseRemapping = exports.parseRemappings = exports.EtherscanParser = exports.setChainId = exports.networks = void 0;
 const axios_1 = __importDefault(require("axios"));
 const parser_1 = require("@solidity-parser/parser");
 const converterAST2Classes_1 = require("./converterAST2Classes");
@@ -13,92 +13,89 @@ const path_1 = __importDefault(require("path"));
 require('axios-debug-log');
 const debug = require('debug')('sol2uml');
 exports.networks = [
-    'mainnet',
-    'holesky',
+    'ethereum',
     'sepolia',
-    'polygon',
+    'holesky',
+    'hoodi',
     'arbitrum',
+    'optimism',
+    'polygon',
     'avalanche',
+    'base',
     'bsc',
     'crono',
     'fantom',
-    'moonbeam',
-    'optimism',
+    'sonic',
     'gnosis',
+    'moonbeam',
     'celo',
     'scroll',
-    'base',
-    'sonic',
+    'linea',
+    'blast',
+    'berachain',
+    'zksync',
 ];
+const setChainId = (network) => 
+// If an integer is passed, return it as is
+/^-?(0|[1-9]\d*)$/.test(network)
+    ? parseInt(network)
+    : network === 'sepolia'
+        ? 11155111
+        : network === 'holesky'
+            ? 17000
+            : network === 'hoodi'
+                ? 560048
+                : network === 'arbitrum'
+                    ? 42161
+                    : network === 'optimism'
+                        ? 10
+                        : network === 'polygon'
+                            ? 137
+                            : network === 'avalanche'
+                                ? 43114
+                                : network === 'base'
+                                    ? 8453
+                                    : network === 'bsc'
+                                        ? 56
+                                        : network === 'crono'
+                                            ? 25
+                                            : network === 'fantom'
+                                                ? 250
+                                                : network === 'sonic'
+                                                    ? 146
+                                                    : network === 'gnosis'
+                                                        ? 100
+                                                        : network === 'moonbeam'
+                                                            ? 1284
+                                                            : network === 'celo'
+                                                                ? 42220
+                                                                : network === 'scroll'
+                                                                    ? 534352
+                                                                    : network === 'linea'
+                                                                        ? 59144
+                                                                        : network === 'blast'
+                                                                            ? 81457
+                                                                            : network === 'berachain'
+                                                                                ? 80094
+                                                                                : network === 'zksync'
+                                                                                    ? 324
+                                                                                    : 1;
+exports.setChainId = setChainId;
 class EtherscanParser {
-    constructor(apikey = 'ZAD4UI2RCXCQTP38EXS3UY2MPHFU5H9KB1', network = 'mainnet', url) {
-        this.apikey = apikey;
+    constructor(apiKey, network = 'ethereum', url) {
+        this.apiKey = apiKey;
         this.network = network;
         if (url) {
             this.url = url;
             return;
         }
-        if (!exports.networks.includes(network)) {
-            throw new Error(`Invalid network "${network}". Must be one of ${exports.networks}`);
-        }
-        else if (network === 'mainnet') {
-            this.url = 'https://api.etherscan.io/api';
-        }
-        else if (network === 'polygon') {
-            this.url = 'https://api.polygonscan.com/api';
-            this.apikey = 'AMHGNTV5A7XYGX2M781JB3RC1DZFVRWQEB';
-        }
-        else if (network === 'arbitrum') {
-            this.url = 'https://api.arbiscan.io/api';
-            this.apikey = 'ZGTK2TAGWMAB6IAC12BMK8YYPNCPIM8VDQ';
-        }
-        else if (network === 'avalanche') {
-            this.url = 'https://api.snowtrace.io/api';
-            this.apikey = 'U5FAN98S5XNH5VI83TI4H35R9I4TDCKEJY';
-        }
-        else if (network === 'bsc') {
-            this.url = 'https://api.bscscan.com/api';
-            this.apikey = 'APYH49FXVY9UA3KTDI6F4WP3KPIC86NITN';
-        }
-        else if (network === 'crono') {
-            this.url = 'https://api.cronoscan.com/api';
-            this.apikey = '76A3RG5WHTPMMR66E9SFI2EIDT6MP976W2';
-        }
-        else if (network === 'fantom') {
-            this.url = 'https://api.ftmscan.com/api';
-            this.apikey = '71KRX13XPZMGR3D1Q85W78G2DSZ4JPMAEX';
-        }
-        else if (network === 'optimism') {
-            this.url = `https://api-optimistic.etherscan.io/api`;
-            this.apikey = 'FEXS1HXVA4Y2RNTMEA8V1UTK21S4JWHH9U';
-        }
-        else if (network === 'moonbeam') {
-            this.url = 'https://api-moonbeam.moonscan.io/api';
-            this.apikey = '5EUFXW6TDC16VERF3D9SCWRRU6AEMTBHNJ';
-        }
-        else if (network === 'gnosis') {
-            this.url = 'https://api.gnosisscan.io/api';
-            this.apikey = '2RWGXIWK538EJ8XSP9DE2JUINSCG7UCSJB';
-        }
-        else if (network === 'scroll') {
-            this.url = 'https://api.scrollscan.com/api';
-            this.apikey = '4V37ZJFIN9AURJSU9YG1RP3MSVTPH6D6Z4';
-        }
-        else if (network === 'celo') {
-            this.url = 'https://api.celoscan.io/api';
-            this.apikey = 'JBV78T5KP15W7WKKKD6KC4J8RX2F4PK8AF';
-        }
-        else if (network === 'base') {
-            this.url = 'https://api.basescan.org/api';
-            this.apikey = '9I5HUJHPD4ZNXJ4M8TZJ1HD2QBVP1U3M3J';
-        }
-        else if (network === 'sonic') {
-            this.url = 'https://api.sonicscan.org/api';
-            this.apikey = 'STCM7CPYP341C66C4IVV1IFMWDYRUTI1QY';
-        }
-        else {
-            this.url = `https://api-${network}.etherscan.io/api`;
+        if (!apiKey) {
+            console.error(`The -k, --apiKey option or SCAN_API_KEY env var must be set when getting verified source code from an Etherscan like explorer`);
+            process.exit(1);
         }
+        const chainId = (0, exports.setChainId)(network);
+        debug(`Chain id ${chainId} for network ${network}`);
+        this.url = `https://api.etherscan.io/v2/api?chainid=${chainId}`;
     }
     /**
      * Parses the verified source code files from Etherscan
@@ -200,7 +197,7 @@ class EtherscanParser {
                     module: 'contract',
                     action: 'getsourcecode',
                     address: contractAddress,
-                    apikey: this.apikey,
+                    apikey: this.apiKey,
                 },
             });
             if (!Array.isArray(response?.data?.result)) {

package/lib/parserFiles.js

@@ -3,7 +3,10 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.isFolder = exports.isFile = exports.readFile = exports.parseSolidityFile = exports.getSolidityFilesFromFolderOrFile = exports.getSolidityFilesFromFolderOrFiles = exports.parseUmlClassesFromFiles = void 0;
+exports.isFolder = exports.isFile = exports.readFile = exports.parseUmlClassesFromFiles = void 0;
+exports.getSolidityFilesFromFolderOrFiles = getSolidityFilesFromFolderOrFiles;
+exports.getSolidityFilesFromFolderOrFile = getSolidityFilesFromFolderOrFile;
+exports.parseSolidityFile = parseSolidityFile;
 const fs_1 = require("fs");
 const path_1 = require("path");
 const klaw_1 = __importDefault(require("klaw"));
@@ -30,7 +33,6 @@ async function getSolidityFilesFromFolderOrFiles(folderOrFilePaths, ignoreFilesO
     }
     return files;
 }
-exports.getSolidityFilesFromFolderOrFiles = getSolidityFilesFromFolderOrFiles;
 function getSolidityFilesFromFolderOrFile(folderOrFilePath, ignoreFilesOrFolders = [], depthLimit = -1) {
     debug(`About to get Solidity files under ${folderOrFilePath}`);
     return new Promise((resolve, reject) => {
@@ -87,7 +89,6 @@ function getSolidityFilesFromFolderOrFile(folderOrFilePath, ignoreFilesOrFolders
         }
     });
 }
-exports.getSolidityFilesFromFolderOrFile = getSolidityFilesFromFolderOrFile;
 function parseSolidityFile(fileName) {
     const solidityCode = (0, exports.readFile)(fileName);
     try {
@@ -99,7 +100,6 @@ function parseSolidityFile(fileName) {
         });
     }
 }
-exports.parseSolidityFile = parseSolidityFile;
 const readFile = (fileName, extension) => {
     try {
         // try to read file with no extension
@@ -128,7 +128,7 @@ const isFile = (fileName) => {
         const file = (0, fs_1.lstatSync)(fileName);
         return file.isFile();
     }
-    catch (err) {
+    catch {
         return false;
     }
 };
@@ -138,7 +138,7 @@ const isFolder = (fileName) => {
         const file = (0, fs_1.lstatSync)(fileName);
         return file.isDirectory();
     }
-    catch (err) {
+    catch {
         return false;
     }
 };

package/lib/parserGeneral.js

@@ -16,7 +16,7 @@ const parserUmlClasses = async (fileFolderAddress, options) => {
     };
     if ((0, regEx_1.isAddress)(fileFolderAddress)) {
         debug(`argument ${fileFolderAddress} is an Ethereum address so checking Etherscan for the verified source code`);
-        const etherscanApiKey = options.apiKey || 'ZAD4UI2RCXCQTP38EXS3UY2MPHFU5H9KB1';
+        const etherscanApiKey = options.apiKey;
         const etherscanParser = new parserEtherscan_1.EtherscanParser(etherscanApiKey, options.network, options.explorerUrl);
         result = await etherscanParser.getUmlClasses(fileFolderAddress);
     }

package/lib/slotValues.d.ts

@@ -22,7 +22,7 @@ export declare const parseValue: (variable: Variable) => string;
  * @param blockTag block number or `latest`
  * @return slotValues array of 32 byte slot values as hexadecimal strings
  */
-export declare const getSlotValues: (url: string, contractAddress: string, slotKeys: readonly BigNumberish[], blockTag?: BigNumberish | 'latest') => Promise<string[]>;
+export declare const getSlotValues: (url: string, contractAddress: string, slotKeys: readonly BigNumberish[], blockTag?: BigNumberish | "latest") => Promise<string[]>;
 /**
  * Get storage slot values from JSON-RPC API provider.
  * @param url of Ethereum JSON-RPC API provider. eg Infura or Alchemy
@@ -32,7 +32,7 @@ export declare const getSlotValues: (url: string, contractAddress: string, slotK
  * @param blockTag block number or `latest`
  * @return slotValue 32 byte slot value as hexadecimal string
  */
-export declare const getSlotValue: (url: string, contractAddress: string, slotKey: BigNumberish, blockTag: BigNumberish | 'latest') => Promise<string>;
+export declare const getSlotValue: (url: string, contractAddress: string, slotKey: BigNumberish, blockTag: BigNumberish | "latest") => Promise<string>;
 /**
  * Calculates the number of string characters or bytes of a string or bytes type.
  * See the following for how string and bytes are stored in storage slots

package/lib/slotValues.js

@@ -46,7 +46,7 @@ const addSlotValues = async (url, contractAddress, storageSection, arrayItems, b
     // remove duplicate slot numbers
     const uniqueFromSlots = [...new Set(slots)];
     // Convert slot numbers to BigNumbers and offset dynamic arrays
-    let slotKeys = uniqueFromSlots.map((fromSlot) => {
+    const slotKeys = uniqueFromSlots.map((fromSlot) => {
         if (storageSection.offset) {
             return bignumber_1.BigNumber.from(storageSection.offset).add(fromSlot);
         }

package/lib/sol2uml.js

@@ -30,12 +30,12 @@ Can also flatten or compare verified source files on Etherscan-like explorers.`)
     .default('svg'))
     .option('-o, --outputFileName <value>', 'output file name')
     .option('-i, --ignoreFilesOrFolders <names>', 'comma-separated list of files or folders to ignore', validators_1.validateNames)
-    .addOption(new commander_1.Option('-n, --network <network>', 'Ethereum network which maps to a blockchain explorer')
-    .choices(parserEtherscan_1.networks)
-    .default('mainnet')
+    .addOption(new commander_1.Option('-n, --network <network>', 'Name or chain id of the blockchain explorer. A name like `ethereum` or `base` will map to a chain id, eg 1 or 8453. Alternatively, use an integer of the chain id. Supported names: ' +
+    parserEtherscan_1.networks.join(', '))
+    .default('ethereum')
     .env('ETH_NETWORK'))
     .addOption(new commander_1.Option('-e, --explorerUrl <url>', 'Override the `network` option with a custom blockchain explorer API URL. eg Polygon Mumbai testnet https://api-testnet.polygonscan.com/api').env('EXPLORER_URL'))
-    .addOption(new commander_1.Option('-k, --apiKey <key>', 'Blockchain explorer API key. eg Etherscan, Arbiscan, Optimism, BscScan, CronoScan, FTMScan, PolygonScan, SonicScan or SnowTrace API key').env('SCAN_API_KEY'))
+    .addOption(new commander_1.Option('-k, --apiKey <key>', 'Blockchain explorer API key.').env('SCAN_API_KEY'))
     .option('-bc, --backColor <color>', 'Canvas background color. "none" will use a transparent canvas.', 'white')
     .option('-sc, --shapeColor <color>', 'Basic drawing color for graphics, not text', 'black')
     .option('-fc, --fillColor <color>', 'Color used to fill the background of a node', 'gray95')
@@ -171,7 +171,7 @@ WARNING: sol2uml does not use the Solidity compiler so may differ with solc. A k
                 }
                 storageAddress = fileFolderAddress;
             }
-            let block = await (0, block_1.getBlock)(combinedOptions);
+            const block = await (0, block_1.getBlock)(combinedOptions);
             // Get slot values for each storage section
             for (const storageSection of storageSections) {
                 await (0, slotValues_1.addSlotValues)(combinedOptions.url, storageAddress, storageSection, arrayItems, block);
@@ -235,8 +235,6 @@ The line numbers are from contract B. There are no line numbers for the red sect
     .option('-af --aFile <value>', 'Limit code compare to contract A source file with the full path and extension as displayed in the file summary (default: compares all source files)')
     .option('-bf --bFile <value>', 'Contract B source file with the full path and extension as displayed in the file summary. Used if aFile is specified and the source file has been renamed (default: aFile if specified)')
     .addOption(new commander_1.Option('-bn, --bNetwork <network>', 'Ethereum network which maps to a blockchain explorer for contract B if on a different blockchain to contract A. Contract A uses the `network` option (default: value of `network` option)').choices(parserEtherscan_1.networks))
-    .option('-be, --bExplorerUrl <url>', 'Override the `bNetwork` option with custom blockchain explorer API URL for contract B if on a different blockchain to contract A. Contract A uses the `explorerUrl` (default: value of `explorerUrl` option)')
-    .option('-bk, --bApiKey <key>', 'Blockchain explorer API key for contract B if on a different blockchain to contract A. Contract A uses the `apiKey` option (default: value of `apiKey` option)')
     .option('--flatten', 'Flatten into a single file before comparing. Only works when comparing two verified contracts, not to local files', false)
     .option('--saveFiles', 'Save the flattened contract code to the filesystem when using the `flatten` option. The file names will be the contract address with a .sol extension', false)
     .option('-l, --lineBuffer <value>', 'Minimum number of lines before and after changes (default: 4)', validators_1.validateLineBuffer)
@@ -250,7 +248,7 @@ The line numbers are from contract B. There are no line numbers for the red sect
         const aEtherscanParser = new parserEtherscan_1.EtherscanParser(combinedOptions.apiKey, combinedOptions.network, combinedOptions.explorerUrl);
         if ((0, regEx_1.isAddress)(fileFoldersAddress)) {
             const addressB = fileFoldersAddress;
-            const bEtherscanParser = new parserEtherscan_1.EtherscanParser(combinedOptions.bApiKey || combinedOptions.apiKey, combinedOptions.bNetwork || combinedOptions.network, combinedOptions.bExplorerUrl || combinedOptions.explorerUrl);
+            const bEtherscanParser = new parserEtherscan_1.EtherscanParser(combinedOptions.apiKey, combinedOptions.bNetwork || combinedOptions.network, combinedOptions.explorerUrl);
             // If flattening
             if (options.flatten) {
                 await (0, diffContracts_1.compareFlattenContracts)(addressA, addressB, aEtherscanParser, bEtherscanParser, combinedOptions);

package/lib/squashClasses.js

@@ -15,13 +15,23 @@ var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (
 }) : function(o, v) {
     o["default"] = v;
 });
-var __importStar = (this && this.__importStar) || function (mod) {
-    if (mod && mod.__esModule) return mod;
-    var result = {};
-    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
-    __setModuleDefault(result, mod);
-    return result;
-};
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.squashUmlClasses = void 0;
 const umlClass_1 = require("./umlClass");
@@ -37,14 +47,14 @@ const squashUmlClasses = (umlClasses, baseContractNames) => {
     let removedClassIds = [];
     for (const baseContractName of baseContractNames) {
         // Find the base UML Class to squash
-        let baseIndex = umlClasses.findIndex(({ name }) => {
+        const baseIndex = umlClasses.findIndex(({ name }) => {
             return name === baseContractName;
         });
         if (baseIndex === undefined) {
             throw Error(`Failed to find contract with name "${baseContractName}" to squash`);
         }
         const baseClass = umlClasses[baseIndex];
-        let squashedClass = new umlClass_1.UmlClass({
+        const squashedClass = new umlClass_1.UmlClass({
             name: baseClass.name,
             absolutePath: baseClass.absolutePath,
             relativePath: baseClass.relativePath,

package/lib/utils/block.js

@@ -11,7 +11,7 @@ const getBlock = async (options) => {
             debug(`Latest block is ${block}. All storage slot values will be from this block.`);
             return block;
         }
-        catch (err) {
+        catch {
             const defaultMessage = options.url === 'http://localhost:8545'
                 ? 'This is the default url. Use the `-u, --url` option or `NODE_URL` environment variable to set the url of your blockchain node.'
                 : `Check your --url option or NODE_URL environment variable is pointing to the correct node for the "${options.network}" blockchain.`;
@@ -21,7 +21,7 @@ const getBlock = async (options) => {
     try {
         return parseInt(options.block);
     }
-    catch (err) {
+    catch {
         throw Error(`Invalid block number: ${options.block}`);
     }
 };

package/lib/utils/diff.js

@@ -15,13 +15,23 @@ var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (
 }) : function(o, v) {
     o["default"] = v;
 });
-var __importStar = (this && this.__importStar) || function (mod) {
-    if (mod && mod.__esModule) return mod;
-    var result = {};
-    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
-    __setModuleDefault(result, mod);
-    return result;
-};
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.diffCode = void 0;
 const diff_match_patch_1 = __importStar(require("diff-match-patch"));
@@ -34,7 +44,7 @@ const SkippedLinesMarker = `\n---`;
  * @param lineBuff the number of lines to display before and after each change.
  */
 const diffCode = (codeA, codeB, lineBuff) => {
-    // @ts-ignore
+    // @ts-ignore diff_match_patch constructor has no type declarations
     const dmp = new diff_match_patch_1.default();
     const diff = dmp.diff_main(codeA, codeB);
     dmp.diff_cleanupSemantic(diff);
@@ -60,18 +70,20 @@ const diff_pretty = (diffs, lines, lineBuff = 2) => {
         const op = diff[0]; // Operation (insert, delete, equal)
         const text = diff[1]; // Text of change.
         switch (op) {
-            case diff_match_patch_1.DIFF_INSERT:
+            case diff_match_patch_1.DIFF_INSERT: {
                 // If first diff then we need to add the first line number
                 const linesInserted = addLineNumbers(text, lineCount, linePad);
                 output += initialLineNumber + clc.green(linesInserted);
                 lineCount += countLines(text);
                 break;
-            case diff_match_patch_1.DIFF_DELETE:
+            }
+            case diff_match_patch_1.DIFF_DELETE: {
                 // zero start line means blank line numbers are used
                 const linesDeleted = addLineNumbers(text, 0, linePad);
                 output += initialLineNumber + clc.red(linesDeleted);
                 break;
-            case diff_match_patch_1.DIFF_EQUAL:
+            }
+            case diff_match_patch_1.DIFF_EQUAL: {
                 const eolPositions = findEOLPositions(text);
                 // If no changes yet
                 if (diffIndex <= 1) {
@@ -87,6 +99,7 @@ const diff_pretty = (diffs, lines, lineBuff = 2) => {
                 }
                 lineCount += eolPositions.length;
                 break;
+            }
         }
     }
     output += '\n';
@@ -168,7 +181,7 @@ const countLines = (text) => (text.match(/\n/g) || '').length;
 const addLineNumbers = (text, lineStart, linePad) => {
     let lineCount = lineStart;
     let textWithLineNumbers = '';
-    text.split('').forEach((c, i) => {
+    text.split('').forEach((c) => {
         if (c === '\n') {
             if (lineStart > 0) {
                 textWithLineNumbers += `\n${(++lineCount)

package/lib/utils/validators.js

@@ -11,7 +11,7 @@ const validateAddress = (address) => {
         if (typeof address === 'string' && address?.match(regEx_1.ethereumAddress))
             return (0, utils_1.getAddress)(address);
     }
-    catch (err) { }
+    catch { /* validation failed */ }
     throw new commander_1.InvalidArgumentError(`Address must be in hexadecimal format with a 0x prefix.`);
 };
 exports.validateAddress = validateAddress;
@@ -22,7 +22,7 @@ const validateNames = (variables) => {
             variables.match(regEx_1.commaSeparatedList))
             return variables.split(',');
     }
-    catch (err) { }
+    catch { /* validation failed */ }
     throw new commander_1.InvalidArgumentError(`Must be a comma-separate list of names with no white spaces.`);
 };
 exports.validateNames = validateNames;
@@ -32,7 +32,7 @@ const validateLineBuffer = (lineBufferParam) => {
         if (lineBuffer >= 0)
             return lineBuffer;
     }
-    catch (err) { }
+    catch { /* validation failed */ }
     throw new commander_1.InvalidOptionArgumentError(`Must be a zero or a positive integer.`);
 };
 exports.validateLineBuffer = validateLineBuffer;
@@ -56,7 +56,7 @@ const validateSlotNames = (slotNames) => {
         console.log(results.length);
         return results;
     }
-    catch (err) { }
+    catch { /* validation failed */ }
     throw new commander_1.InvalidOptionArgumentError(`Must be a comma-separate list of slots with no white spaces.`);
 };
 exports.validateSlotNames = validateSlotNames;
@@ -72,7 +72,7 @@ const validateTypes = (typesString) => {
             return types;
         }
     }
-    catch (err) { }
+    catch { /* validation failed */ }
     throw new commander_1.InvalidArgumentError(`Slot type must be an elementary type which includes dynamic and fixed size arrays. eg address, address[], uint256, int256[2], bytes32, string, bool`);
 };
 exports.validateTypes = validateTypes;

package/lib/writerFiles.js

@@ -3,7 +3,12 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.writePng = exports.writeSVG = exports.writeDot = exports.writeSourceCode = exports.convertDot2Svg = exports.writeOutputFiles = void 0;
+exports.writeOutputFiles = void 0;
+exports.convertDot2Svg = convertDot2Svg;
+exports.writeSourceCode = writeSourceCode;
+exports.writeDot = writeDot;
+exports.writeSVG = writeSVG;
+exports.writePng = writePng;
 const fs_1 = require("fs");
 const path_1 = __importDefault(require("path"));
 const sync_1 = __importDefault(require("@aduh95/viz.js/sync"));
@@ -34,7 +39,7 @@ const writeOutputFiles = async (dot, contractName, outputFormat = 'svg', outputF
                         outputExt;
             }
         }
-        catch (err) { } // we can ignore errors as it just means outputFilename does not exist yet
+        catch { /* outputFilename does not exist yet */ }
     }
     if (outputFormat === 'dot' || outputFormat === 'all') {
         writeDot(dot, outputFilename);
@@ -63,7 +68,6 @@ function convertDot2Svg(dot) {
         throw new Error(`Failed to parse dot string`, { cause: err });
     }
 }
-exports.convertDot2Svg = convertDot2Svg;
 function writeSourceCode(code, filename = 'source', extension = '.sol') {
     const fileExtension = path_1.default.extname(filename);
     const outputFile = fileExtension === extension ? filename : filename + extension;
@@ -79,7 +83,6 @@ function writeSourceCode(code, filename = 'source', extension = '.sol') {
         }
     });
 }
-exports.writeSourceCode = writeSourceCode;
 function writeDot(dot, filename) {
     const dotFilename = changeFileExtension(filename, 'dot');
     debug(`About to write Dot file to ${dotFilename}`);
@@ -94,7 +97,6 @@ function writeDot(dot, filename) {
         }
     });
 }
-exports.writeDot = writeDot;
 /**
  * Writes an SVG file to the file system.
  * @param svg The SVG input to be written to the file system.
@@ -127,7 +129,6 @@ function writeSVG(svg, svgFilename = 'classDiagram.svg', outputFormats = 'png')
         });
     });
 }
-exports.writeSVG = writeSVG;
 /**
  * Asynchronously writes a PNG file to the file system from an SVG input.
  * @param svg - The SVG input to be converted to a PNG file.
@@ -161,7 +162,6 @@ async function writePng(svg, filename) {
         });
     }
 }
-exports.writePng = writePng;
 // put a new file extension on a filename
 const changeFileExtension = (filename, extension) => {
     const parsedFile = path_1.default.parse(filename);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sol2uml",
-  "version": "2.5.21",
+  "version": "2.5.23",
   "description": "Solidity contract visualisation tool.",
   "main": "./lib/index.js",
   "types": "./lib/index.d.ts",
@@ -8,6 +8,7 @@
     "buildSol": "cd ./src/contracts && solc **/*.sol",
     "build": "tsc --build ./tsconfig.json",
     "clean": "tsc --build --clean ./tsconfig.json",
+    "lint": "eslint src/ts",
     "package-lock": "npm i --package-lock-only",
     "permit": " chmod 775 lib/sol2uml.js",
     "prettier": "prettier --write src/**/*.ts **/*.md",
@@ -23,28 +24,32 @@
   "license": "MIT",
   "dependencies": {
     "@aduh95/viz.js": "^3.7.0",
-    "@solidity-parser/parser": "^0.16.1",
-    "axios": "^1.6.0",
+    "@solidity-parser/parser": "^0.20.1",
+    "axios": "^1.10.0",
     "axios-debug-log": "^1.0.0",
-    "cli-color": "^2.0.3",
-    "commander": "^11.1.0",
+    "cli-color": "^2.0.4",
+    "commander": "^12.1.0",
     "convert-svg-to-png": "^0.6.4",
-    "debug": "^4.3.4",
+    "debug": "^4.4.1",
     "diff-match-patch": "^1.0.5",
-    "ethers": "^5.7.2",
+    "ethers": "^5.8.0",
     "js-graph-algorithms": "^1.0.18",
     "klaw": "^4.1.0"
   },
   "devDependencies": {
+    "@eslint/js": "^9.39.2",
     "@openzeppelin/contracts": "^4.9.3",
-    "@types/diff-match-patch": "^1.0.35",
-    "@types/jest": "^29.5.7",
-    "@types/klaw": "^3.0.5",
-    "jest": "^29.7.0",
-    "prettier": "^3.0.3",
-    "ts-jest": "^29.1.1",
-    "ts-node": "^10.9.1",
-    "typescript": "^5.2.2"
+    "@types/diff-match-patch": "^1.0.36",
+    "@types/jest": "^29.5.14",
+    "@types/klaw": "^3.0.7",
+    "eslint": "^9.39.2",
+    "eslint-config-prettier": "^10.1.8",
+    "jest": "^30.0.0",
+    "prettier": "^3.5.3",
+    "ts-jest": "^29.4.0",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.8.3",
+    "typescript-eslint": "^8.55.0"
   },
   "files": [
     "lib/*.js",