DeclarationError: Undeclared identifier.
Folosești un nume (variabilă, funcție, eveniment) pe care compilatorul nu îl găsește: e scris diferit față de declarație, nu a fost declarat sau nu e vizibil în acel loc. Verifică literele mari și mici și declarația.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Compilatorul a întâlnit un nume și l-a căutat printre variabilele locale, parametrii, variabilele de stare, funcțiile și tipurile contractului (și ale părinților lui). Nu l-a găsit nicăieri, deci nu știe la ce te referi.
Cel mai des e o greșeală de scriere: totalvanzari în loc de totalVanzari. Solidity face diferența între literele mari și mici, așa că acestea sunt două nume diferite. Când găsește un nume asemănător, compilatorul te ajută: Undeclared identifier. Did you mean "totalVanzari"?.
Alte cauze: o variabilă locală folosită în afara blocului { } în care a fost declarată, o funcție external apelată din același contract (atunci mesajul spune "f" is not (or not yet) visible at this point) sau now, care a fost eliminat în 0.8 (folosește block.timestamp).
De ce apare: cauzele frecvente
1Numele e scris diferit față de declarație
uint256 public totalVanzari;
function vinde() external {
totalvanzari += 1;
}uint256 public totalVanzari;
function vinde() external {
totalVanzari += 1;
}totalvanzari și totalVanzari sunt nume diferite. Compilatorul sugerează aici Did you mean "totalVanzari"?.
2Variabila locală e folosită în afara blocului ei
function f(uint256 x) external pure returns (uint256) {
if (x > 10) {
uint256 bonus = 5;
}
return x + bonus;
}function f(uint256 x) external pure returns (uint256) {
uint256 bonus = 0;
if (x > 10) {
bonus = 5;
}
return x + bonus;
}O variabilă declarată între { } există doar acolo. Declar-o înaintea blocului, ca să o poți folosi și după el.
3Cod vechi care folosește now
uint256 public creat = now;uint256 public creat = block.timestamp;now a fost scos în Solidity 0.7. Numele corect este block.timestamp.
Repară eroarea, direct în pagină
Contractul Vanzari nu se compilează și dă DeclarationError: Undeclared identifier. O variabilă de stare e folosită cu alt nume decât cel declarat. Repară numele, fără să schimbi declarația. Scriptul înregistrează trei vânzări de câte 50, 20 și 30 de lei și afișează numărul de vânzări și totalul.
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.20;
contract Vanzari {
uint256 public numarVanzari;
uint256 public totalLei;
function inregistreaza(uint256 suma) external {
numarvanzari += 1;
totalLei += suma;
}
}Vânzări: 3 | total: 100 lei
Indiciu
Compară literă cu literă numele din declarații cu cele din funcția inregistreaza.
Reparația
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.20;
contract Vanzari {
uint256 public numarVanzari;
uint256 public totalLei;
function inregistreaza(uint256 suma) external {
numarVanzari += 1;
totalLei += suma;
}
}De ce merge
Variabila de stare este declarată numarVanzari, cu V mare, dar funcția folosea numarvanzari. Pentru Solidity sunt două nume diferite, iar al doilea nu există nicăieri, de unde Undeclared identifier (cu sugestia Did you mean "numarVanzari"?). Cu numele scris exact ca în declarație, contractul se compilează, iar după trei vânzări contorul este 3 și totalul 100 de lei.
Alte forme ale mesajului
DeclarationError: Undeclared identifier. Did you mean "totalVanzari"?DeclarationError: Undeclared identifier. "f" is not (or not yet) visible at this point.
Cum o eviți pe viitor
- Copiază numele variabilelor din declarație sau folosește completarea automată a editorului, în loc să le tastezi din nou.
- Respectă o singură convenție:
camelCasepentru variabile și funcții,PascalCasepentru contracte, evenimente și struct-uri. - Declară variabilele locale la nivelul la care le folosești (înaintea lui
if/for, nu în interior). - Citește sugestia
Did you mean ...?când apare: de obicei e chiar reparația.
Întrebări frecvente
Am declarat funcția, dar tot primesc Undeclared identifier. De ce?
Probabil e external și o apelezi din același contract. Funcțiile external se pot apela din interior doar prin this.f(), adică printr-un apel extern. Dacă vrei s-o apelezi și din contract, fă-o public sau mută logica într-o funcție internal.
Contează ordinea în care declar funcțiile și variabilele de stare?
Nu. Variabilele de stare și funcțiile sunt vizibile în tot contractul, oriunde ar fi declarate. Ordinea contează doar pentru variabilele locale, care există de la declarare până la finalul blocului lor.
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: Member "lenght" not found or not visible after argument-dependent lookup in uint256[] storage ref. După punct ai scris un membru care nu există pentru acel tip: lenght în loc de length, msg.sendr, block.timestap, o funcție inexistentă a unui contract sau length pe un string. Corectează numele sau folosește membrul potrivit tipului. DeclarationError: Identifier already declared. Ai declarat de două ori același nume în același loc: două variabile de stare, două variabile locale sau o variabilă și o funcție cu același nume. Redenumește una dintre ele sau, dacă voiai doar o atribuire, scoate tipul din fața celei de-a doua. Î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.
