DeclarationError: Declaration "ERC20" not found in "@openzeppelin/contracts/token/ERC20/IERC20.sol" (referenced as "@openzeppelin/contracts/token/ERC20/IERC20.sol").
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:
ERC20e înERC20.sol, iarIERC20.solconține doar interfațaIERC20; - litere mari și mici:
ownableîn loc deOwnable(numele sunt case-sensitive); - nume schimbat între versiuni de bibliotecă: un contract mutat sau redenumit în OpenZeppelin 5 (de exemplu
Counters.sola fost eliminat,Pausablea fost mutat dinsecurity/înutils/); - 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
import { ERC20 } from "@openzeppelin/contracts/token/ERC20/IERC20.sol";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
import { ownable } from "./Ownable.sol";import { Ownable } from "./Ownable.sol";Numele din acolade trebuie să fie identic cu cel declarat în fișier.
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.
// 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;
}
}Limita: 300 Bogdan: Doar proprietarul
Indiciu
Numele din acolade trebuie scris exact ca în fișierul importat.
Reparația
// 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;
}
}De ce merge
Fișierul Ownable.sol exista, deci calea era bună, dar declarația din el se numește Ownable, cu O mare. Solidity face diferența între litere mari și mici, așa că ownable nu a fost găsit. Cu numele exact, importul aduce contractul, Seif primește onlyOwner, iar bogdan e oprit cu Doar proprietarul.
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
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: Expected "from". Importul cu acolade are forma fixă import { Nume } from "cale.sol"; Ai uitat cuvântul from, sau ai scris importul în stilul altui limbaj. Adaugă from între acolade și calea fișierului. 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ă. Î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.
