...
Eroare Solidity · Scripturi și teste: ethers.js și Hardhat

HardhatError: HH700: Artifact for contract "contor" not found.

Pe scurt

Hardhat nu găsește contractul compilat cu numele cerut în getContractFactory / deployContract. Numele trebuie să fie exact numele contractului din cod (cu litere mari și mici), nu numele fișierului. Verifică și că fișierul e în contracts/ și că s-a compilat (npx hardhat compile).

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

Când scrii ethers.getContractFactory("Contor") sau ethers.deployContract("Contor"), Hardhat caută în artifacts/ rezultatul compilării unui contract cu exact acel nume. Dacă nu-l găsește, aruncă HH700: Artifact for contract "contor" not found. (uneori cu sugestii de nume apropiate).

Cauzele frecvente:

  • numele are altă formă decât în cod: contor în loc de Contor (Hardhat face diferența între litere mari și mici);
  • folosești numele fișierului (Magazin.sol sau Magazin când contractul din fișier se numește MagazinOnline);
  • fișierul nu e în folderul contracts/ sau nu s-a compilat (o eroare de compilare oprește generarea artefactelor);
  • două contracte au același nume în fișiere diferite: atunci folosești numele complet, "contracts/Magazin.sol:Magazin".

În mediul cursului, deploy("Nume") funcționează la fel și îți arată lista contractelor compilate.

De ce apare: cauzele frecvente

1Litere mari și mici

Greșit
SOLIDITY
const c = await ethers.deployContract("contor");
Corect
SOLIDITY
const c = await ethers.deployContract("Contor");

Numele e cel din contract Contor { }, exact cum e scris.

2Numele fișierului în locul contractului

Greșit
SOLIDITY
// contracts/Magazin.sol conține: contract MagazinOnline { ... }
await ethers.getContractFactory("Magazin");
Corect
SOLIDITY
await ethers.getContractFactory("MagazinOnline");

Contează numele contractului, nu al fișierului.

3Contracte cu același nume

Greșit
SOLIDITY
await ethers.getContractFactory("Token");
Corect
SOLIDITY
await ethers.getContractFactory("contracts/v2/Token.sol:Token");

Numele complet spune exact ce fișier vrei.

Repară tu

Repară eroarea, direct în pagină

Scriptul de mai jos (fișierul test.js) încearcă să publice contractul Contor, dar folosește alt nume și dă eroarea de tip HH700: Artifact for contract "contor" not found.. Repară numele contractului din apelul deploy. Scriptul crește contorul de două ori și afișează valoarea.

Codul care dă eroarea
SOLIDITY
const c = await deploy("contor");
await c.creste();
await c.creste();
console.log("Valoare:", await c.valoare());
După reparație, programul afișează
Valoare: 2
Indiciu

Numele trebuie să fie exact cel din contract Contor { }, cu literă mare.

Alte forme ale mesajului

  • HardhatError: HH700: Artifact for contract "Magazin" not found. Did you mean "MagazinOnline"?
  • HH701: There are multiple artifacts for contract "Token", please use a fully qualified name instead.

Cum o eviți pe viitor

  • Dă fișierului același nume ca al contractului principal din el.
  • Copiază numele contractului direct din cod în script.
  • Rulează npx hardhat compile și citește erorile înainte de teste.
  • Folosește nume complet calificate când ai contracte cu același nume.

Întrebări frecvente

Am compilat, dar tot nu-l găsește. De ce?

Verifică dacă fișierul e chiar în contracts/ (sau în folderul setat în paths.sources din configurare) și dacă compilarea s-a terminat fără erori. Uneori ajută npx hardhat clean urmat de npx hardhat compile.

Merge și pentru contractele din OpenZeppelin?

Da, dacă sunt importate de un contract al tău, Hardhat le compilează și poți cere artefactul după nume, de exemplu "ERC20" (sau cu numele complet, dacă există mai multe).

Erori înrudite

← Toate erorile Solidity

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Învață Solidity de la zero, cu exerciții la fiecare lecție

Curs Solidity și Smart Contracts: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.