Hardhat项目中getAllFullyQualifiedNames方法的路径过滤问题分析

在Hardhat智能合约开发框架中，getAllFullyQualifiedNames是一个用于获取所有完全限定合约名称的方法。近期发现该方法存在路径过滤不够严格的问题，可能导致非合约文件被错误识别为合约名称。

问题背景

Hardhat框架会在编译后生成合约的artifact文件，这些文件通常存储在artifacts/contracts/目录下。每个artifact文件都包含合约的ABI、字节码等关键信息，并以完全限定名称（Fully Qualified Name）的形式进行标识。

问题现象

当项目中存在artifacts/根目录下的JSON文件时（例如用户自行添加的package.json），getAllFullyQualifiedNames方法会错误地将这些文件也识别为合约artifact，生成类似".:package"这样的无效完全限定名称。这会导致依赖此方法的插件出现异常行为。

技术分析

当前实现的主要问题在于路径过滤逻辑不够严格：

1. 方法会扫描整个artifacts/目录下的所有JSON文件
2. 缺乏对文件路径的有效性验证
3. 没有检查文件内容是否符合artifact格式标准

解决方案建议

针对此问题，可以考虑以下几种改进方案：

1. 路径限制方案：修改扫描逻辑，仅处理artifacts/contracts/等特定子目录下的文件，忽略根目录文件。这是最直接有效的解决方案。

2. 内容验证方案：在返回名称前检查JSON文件内容，验证是否包含artifact特有的字段（如_format属性）。这种方法更严格但会增加性能开销。

3. 文档规范方案：明确禁止在artifacts/目录下存放非artifact文件，但这依赖于用户遵守规范，可靠性较低。

从实现难度和效果考虑，第一种路径限制方案最为推荐，既能解决问题又不会引入额外性能消耗。

影响评估

该问题主要影响以下场景：

• 使用getAllFullyQualifiedNames方法获取所有合约名称的插件
• 自动处理所有artifact文件的工具链
• 依赖完全限定名称准确性的构建流程

对于普通用户，只要不在artifacts根目录存放额外文件，通常不会遇到此问题。

最佳实践建议

为避免类似问题，建议：

1. 保持artifacts/目录结构规范
2. 避免手动修改或添加artifact目录下的文件
3. 在开发插件时，对获取的名称进行二次验证
4. 及时更新Hardhat版本以获取问题修复

该问题的修复已经合并到主分支，将在后续版本中发布。