HardhatError: HH700: Artifact for contract "contor" not found.
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 deContor(Hardhat face diferența între litere mari și mici); - folosești numele fișierului (
Magazin.solsauMagazincând contractul din fișier se numeșteMagazinOnline); - 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
const c = await ethers.deployContract("contor");const c = await ethers.deployContract("Contor");Numele e cel din contract Contor { }, exact cum e scris.
2Numele fișierului în locul contractului
// contracts/Magazin.sol conține: contract MagazinOnline { ... }
await ethers.getContractFactory("Magazin");await ethers.getContractFactory("MagazinOnline");Contează numele contractului, nu al fișierului.
3Contracte cu același nume
await ethers.getContractFactory("Token");await ethers.getContractFactory("contracts/v2/Token.sol:Token");Numele complet spune exact ce fișier vrei.
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.
const c = await deploy("contor");
await c.creste();
await c.creste();
console.log("Valoare:", await c.valoare());Valoare: 2
Indiciu
Numele trebuie să fie exact cel din contract Contor { }, cu literă mare.
Reparația
const c = await deploy("Contor");
await c.creste();
await c.creste();
console.log("Valoare:", await c.valoare());De ce merge
Contractele compilate sunt căutate după numele exact din cod, iar contor și Contor sunt nume diferite. Cu deploy("Contor"), mediul găsește artefactul (ABI-ul și bytecode-ul), publică contractul și întoarce obiectul cu funcțiile lui. În Hardhat, ethers.deployContract("Contor") și getContractFactory("Contor") folosesc aceeași regulă: numele exact din cod, 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
TypeError: contract.adauga is not a function Obiectul contractului din ethers nu are funcția pe care o apelezi: numele e scris greșit, funcția e internal / private (nu apare în ABI) sau folosești un ABI vechi. Verifică numele exact și fă funcția external sau public, apoi recompilează. ParserError: Source "@openzeppelin/contracts/access/Ownable.sol" not found: File not supplied initially. Compilatorul nu găsește fișierul din linia import: calea e greșită sau biblioteca nu e instalată în proiect. Instalează pachetul (npm install @openzeppelin/contracts) sau corectează calea spre fișierul real, de exemplu ./Ownable.sol. ParserError: Source file requires different compiler version (current compiler is 0.8.30+commit.73712a01.Emscripten.clang) - note that nightly builds are considered to be strictly less than the released version Linia pragma solidity cere o versiune de compilator care nu se potrivește cu cea pe care o folosești (de exemplu ^0.7.0 cu compilatorul 0.8.30). Schimbă pragma într-un interval care include versiunea ta, de exemplu pragma solidity ^0.8.20;, și adaptează codul vechi la 0.8. Î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.
