...
Eroare Solidity · Importuri și erorile OpenZeppelin

ParserError: Source "@openzeppelin/contracts/access/Ownable.sol" not found: File not supplied initially.

Pe scurt

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

Greșit
SOLIDITY
import {ERC20} from "@openzeppelin/contracts/token/ERC20/ERC20.sol";
// fără pachetul instalat
Corect
SOLIDITY
npm install @openzeppelin/contracts
# Foundry: forge install OpenZeppelin/openzeppelin-contracts

Importul 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

Greșit
SOLIDITY
import {ReentrancyGuard} from "@openzeppelin/contracts/security/ReentrancyGuard.sol";
Corect
SOLIDITY
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ă

Greșit
SOLIDITY
import {Ownable} from "./Ownabel.sol";
Corect
SOLIDITY
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ă tu

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ță.

Codul care dă eroarea
SOLIDITY
// 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;
    }
}
După reparație, programul afișează
Mentenanță: true
Indiciu

O cale relativă spre același folder începe cu ./.

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

← 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.