...
Eroare Solidity · Importuri și erorile OpenZeppelin

DeclarationError: Declaration "ERC20" not found in "@openzeppelin/contracts/token/ERC20/IERC20.sol" (referenced as "@openzeppelin/contracts/token/ERC20/IERC20.sol").

Pe scurt

Fișierul importat există, dar nu conține numele pe care l-ai cerut între acolade: import { ERC20 } dintr-un fișier care are doar IERC20, sau un nume scris cu altă literă mare. Importă din fișierul corect sau scrie numele exact cum e declarat acolo.

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

Ce înseamnă

Cu import { A, B } from "fisier.sol"; aduci în fișierul tău doar declarațiile numite. Compilatorul a găsit fișierul (altfel ai fi primit Source ... not found), dar în el nu există nicio declarație cu numele cerut. Mesajul îți arată numele, fișierul în care a căutat și calea așa cum ai scris-o tu.

Cauze frecvente:

  • fișierul greșit: ERC20 e în ERC20.sol, iar IERC20.sol conține doar interfața IERC20;
  • litere mari și mici: ownable în loc de Ownable (numele sunt case-sensitive);
  • nume schimbat între versiuni de bibliotecă: un contract mutat sau redenumit în OpenZeppelin 5 (de exemplu Counters.sol a fost eliminat, Pausable a fost mutat din security/ în utils/);
  • o greșeală de tastare în nume.

Deschide fișierul importat și caută contract, interface sau library cu numele exact.

De ce apare: cauzele frecvente

1Import din fișierul interfeței

Greșit
SOLIDITY
import { ERC20 } from "@openzeppelin/contracts/token/ERC20/IERC20.sol";
Corect
SOLIDITY
import { ERC20 } from "@openzeppelin/contracts/token/ERC20/ERC20.sol";

Implementarea ERC20 e în ERC20.sol; IERC20.sol conține doar interfața.

2Literă mică în loc de mare

Greșit
SOLIDITY
import { ownable } from "./Ownable.sol";
Corect
SOLIDITY
import { Ownable } from "./Ownable.sol";

Numele din acolade trebuie să fie identic cu cel declarat în fișier.

Repară tu

Repară eroarea, direct în pagină

Contractul Seif moștenește Ownable din fișierul Ownable.sol (îl găsești în proiect), dar compilarea dă DeclarationError: Declaration "ownable" not found in "Ownable.sol" (referenced as "./Ownable.sol"). Repară importul. Scriptul setează limita din contul anei (proprietara) și încearcă din contul lui bogdan.

Codul care dă eroarea
SOLIDITY
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.20;

import { ownable } from "./Ownable.sol";

contract Seif is ownable {
    uint256 public limita = 100;

    function seteazaLimita(uint256 noua) external onlyOwner {
        limita = noua;
    }
}
După reparație, programul afișează
Limita: 300
Bogdan: Doar proprietarul
Indiciu

Numele din acolade trebuie scris exact ca în fișierul importat.

Alte forme ale mesajului

  • DeclarationError: Declaration "ownable" not found in "Ownable.sol" (referenced as "./Ownable.sol").
  • DeclarationError: Declaration "Counter" not found in "@openzeppelin/contracts/utils/Counters.sol" (referenced as "@openzeppelin/contracts/utils/Counters.sol").

Cum o eviți pe viitor

  • Copiază căile și numele din documentația versiunii de OpenZeppelin pe care o ai instalată.
  • Lasă editorul să completeze importurile (extensia Solidity din VS Code).
  • După un upgrade de bibliotecă, citește lista de schimbări: căi mutate, contracte eliminate.
  • Păstrează regula „un contract principal per fișier, cu același nume ca fișierul”.

Întrebări frecvente

Prin ce diferă de Source not found?

Source ... not found înseamnă că fișierul însuși lipsește (cale greșită, pachet neinstalat). Aici fișierul există, dar nu are numele cerut.

E mai bine import "fisier.sol"; fără acolade?

Merge și aduce toate declarațiile, dar umple spațiul de nume și ascunde de unde vine fiecare nume. Importul cu acolade e recomandat.

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.