Core feature goal: Implement an appropriate edit-distance algorithm (Levenshtein) to suggest similar artifacts if a requested artifact is not found (i.e. if a user made a typo in the name)

New functions:

Public:

• formArtifactPathFromFullyQualifiedName

Private:

• _trueCasePath
• _trueCasePathSync
• _getAllContractNamesFromFiles
• _getAllFullyQualifiedNamesSync
• _handleWrongArtifactForFullyQualifiedName
• _handleWrongArtifactForContractName
• _handleMultipleSimilarContractNames
• _getSimilarContractNames
• findDistance (Levenshtein logic)

Added Error 703: ERRORS.ARTIFACTS.TYPO_SUGGESTION
Example:

HardhatError: HH703: Artifact for contract "Lob" not found, but we found some that were similar:

Lab
Lib.sol:Lib
Lib2.sol:Lib

Please replace Lob for the correct contract name wherever you are trying to read its artifact.

Some existing functions were edited such as moving the true-case-path logic from readArtifact and readArtifactSync into _getArtifactPathFromFullyQualifiedName (now called _getValidArtifactPathFromFullyQualifiedName due to needing to keep the old function for TypeChain).

The reasoning behind moving this logic is that it was only needed when the user passed in a fully qualified name, so its placement in the top-level public function was misleading. Moving it fully into the dedicated "fully qualified name" code path is clearer and doesn't make additional, unnecessary file system calls when a contract name is given instead of an FQN.