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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
import "cale"; cere compilatorului să încarce alt fișier .sol. Compilatorul în sine nu caută pe internet și nici nu instalează pachete: primește fișierele de la unealta care îl rulează (Hardhat, Foundry, Remix, editorul nostru). Dacă unealta nu îi dă fișierul cerut, apare Source "..." not found.
Textul de după două puncte depinde de unealtă: File not supplied initially. (fișierul nu a fost dat compilatorului), File not found. Searched the following locations: ... (solc din linia de comandă), iar Hardhat are propriul mesaj, HH404.
Cauzele tipice: pachetul @openzeppelin/contracts nu e instalat cu npm, calea are o greșeală (ERC2O cu O în loc de 0, acces în loc de access), fișierul s-a mutat între versiuni ale bibliotecii (în OpenZeppelin 5, security/ReentrancyGuard.sol a devenit utils/ReentrancyGuard.sol) sau o cale relativă greșită (./ față de ../).
De ce apare: cauzele frecvente
1Biblioteca nu e instalată în proiectul Hardhat / Foundry
import {ERC20} from "@openzeppelin/contracts/token/ERC20/ERC20.sol";
// fără pachetul instalatnpm install @openzeppelin/contracts
# Foundry: forge install OpenZeppelin/openzeppelin-contractsImportul cu @openzeppelin/... caută în node_modules (sau în lib/ la Foundry, prin remappings). Fără pachet, fișierul nu există.
2Calea s-a schimbat între versiuni
import {ReentrancyGuard} from "@openzeppelin/contracts/security/ReentrancyGuard.sol";import {ReentrancyGuard} from "@openzeppelin/contracts/utils/ReentrancyGuard.sol";În OpenZeppelin 5, ReentrancyGuard și Pausable s-au mutat din security/ în utils/.
3Greșeală în calea relativă
import {Ownable} from "./Ownabel.sol";import {Ownable} from "./Ownable.sol";Numele fișierului trebuie scris exact, cu litere mari și mici. ./ înseamnă același folder cu fișierul curent.
Repară eroarea, direct în pagină
Contractul Configurare nu se compilează și dă ParserError: Source "@openzeppelin/contracts/access/Ownable.sol" not found. În editorul de aici, contractul Ownable (OpenZeppelin 5) se află lângă contractul tău, în fișierul Ownable.sol. Repară calea importului. Scriptul publică contractul și o pune pe ana să activeze modul de mentenanță.
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.20;
import {Ownable} from "@openzeppelin/contracts/access/Ownable.sol";
contract Configurare is Ownable {
bool public mentenanta;
constructor() Ownable(msg.sender) {}
function seteazaMentenanta(bool activ) external onlyOwner {
mentenanta = activ;
}
}Mentenanță: true
Indiciu
O cale relativă spre același folder începe cu ./.
Reparația
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.20;
import {Ownable} from "./Ownable.sol";
contract Configurare is Ownable {
bool public mentenanta;
constructor() Ownable(msg.sender) {}
function seteazaMentenanta(bool activ) external onlyOwner {
mentenanta = activ;
}
}De ce merge
Compilatorul primește doar fișierele pe care i le dă mediul de lucru. Aici nu există un pachet @openzeppelin/contracts instalat, ci un fișier Ownable.sol lângă contractul tău, deci calea corectă este ./Ownable.sol. Într-un proiect Hardhat, reparația ar fi fost inversă: păstrezi calea @openzeppelin/... și instalezi pachetul cu npm.
Alte forme ale mesajului
Error: Source "@openzeppelin/contracts/access/Ownable.sol" not found: File not found. Searched the following locations: "".Error HH404: File @openzeppelin/contracts/access/Ownable.sol, imported from contracts/Magazin.sol, not found.
Cum o eviți pe viitor
- Instalează bibliotecile înainte să le importi și ține versiunea în
package.json. - Copiază căile de import din documentația versiunii pe care o folosești, nu din tutoriale vechi.
- Folosește importuri cu nume (
import {Ownable} from ...), ca să vezi imediat ce aduce fiecare linie.
Întrebări frecvente
În Remix importul din @openzeppelin merge. De ce în Hardhat nu?
Remix descarcă automat fișierele importate de pe internet. Hardhat și Foundry folosesc doar ce ai instalat local, deci trebuie npm install @openzeppelin/contracts (sau forge install).
Cum import contractele OpenZeppelin în editorul de pe acest site?
Editorul are versiuni compacte ale contractelor OpenZeppelin 5, puse lângă contractul tău, așa că le imporți cu calea relativă: import {Ownable} from "./Ownable.sol";, import {ERC20} from "./ERC20.sol";.
Erori înrudite
DeclarationError: Identifier not found or not unique. Compilatorul nu cunoaște tipul sau numele folosit într-o declarație: un tip scris greșit (adress, Uint256, String), un struct sau contract nedeclarat ori neimportat. Corectează numele tipului sau adaugă importul lipsă. TypeError: No arguments passed to the base constructor. Specify the arguments or mark "Magazin" as abstract. Contractul părinte are un constructor cu parametri (de exemplu Ownable din OpenZeppelin 5 cere proprietarul inițial), iar tu nu i-ai dat argumentele. Adaugă-le în constructorul tău: constructor() Ownable(msg.sender) {}. Î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.
