Warning: SPDX license identifier not provided in source file. Before publishing, consider adding a comment containing "SPDX-License-Identifier: <SPDX-License>" to each source file. Use "SPDX-License-Identifier: UNLICENSED" for non-open-source code. Please see https://spdx.org for more information.
Este un avertisment, nu o eroare: fișierului îi lipsește comentariul cu licența. Adaugă pe prima linie // SPDX-License-Identifier: MIT (sau UNLICENSED pentru cod închis), iar avertismentul dispare.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Compilatorul Solidity îți cere să spui sub ce licență este publicat codul, printr-un comentariu special pe care îl citește: // SPDX-License-Identifier: <licență>. Pe blockchain, codul contractelor verificate este public, iar licența spune ce au voie alții să facă cu el. Identificatorul vine din lista standard SPDX: MIT, GPL-3.0, Apache-2.0 sau UNLICENSED pentru cod care nu e open source.
Mesajul începe cu Warning, deci contractul se compilează și rulează normal. Totuși, un fișier fără licență arată neglijent la un code review și generează zgomot în consolă, printre avertismentele care chiar contează.
De obicei, lângă el apare și avertismentul despre pragma, când lipsește și linia cu versiunea: Source file does not specify required compiler version!.
De ce apare: cauzele frecvente
1Ai pornit fișierul direct cu pragma
pragma solidity ^0.8.20;
contract Token {
}// SPDX-License-Identifier: MIT
pragma solidity ^0.8.20;
contract Token {
}Compilatorul caută comentariul SPDX-License-Identifier în fișier. Fără el, afișează avertismentul pentru fiecare fișier.
2Ai scris licența greșit
// License: MIT
pragma solidity ^0.8.20;// SPDX-License-Identifier: MIT
pragma solidity ^0.8.20;Compilatorul recunoaște doar textul exact SPDX-License-Identifier: urmat de un identificator.
3Ai lipit cod fără primele două linii
contract Token {
uint256 public total;
}// SPDX-License-Identifier: MIT
pragma solidity ^0.8.20;
contract Token {
uint256 public total;
}Fără ele primești două avertismente: lipsește licența și lipsește versiunea cerută (Source file does not specify required compiler version!).
Repară eroarea, direct în pagină
Contractul Mesaj se compilează, dar consola arată două avertismente: lipsește licența SPDX și lipsește versiunea compilatorului. Adaugă la începutul fișierului linia cu licența MIT și apoi linia pragma pentru Solidity 0.8 (de exemplu ^0.8.20). Scriptul publică contractul și afișează mesajul.
contract Mesaj {
string public text = "Bun venit!";
}Bun venit!
Indiciu
Primele două linii ale oricărui fișier .sol: comentariul SPDX-License-Identifier și pragma solidity.
Reparația
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.20;
contract Mesaj {
string public text = "Bun venit!";
}De ce merge
Comentariul // SPDX-License-Identifier: MIT este citit de compilator și declară licența fișierului, iar pragma solidity ^0.8.20; spune cu ce versiuni de compilator poate fi construit. Cu ele, cele două avertismente dispar. Contractul funcționa și înainte, dar într-un proiect real vrei o consolă curată, ca să observi avertismentele care chiar semnalează probleme.
Alte forme ale mesajului
Warning: Source file does not specify required compiler version! Consider adding "pragma solidity ^0.8.30;"
Cum o eviți pe viitor
Începe fiecare fișier .sol cu aceleași două linii, mereu în aceeași ordine: licența, apoi pragma.
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.20;Dacă proiectul are un șablon sau un snippet în editor, pune aceste linii în el. Pentru cod de firmă care nu se publică open source, folosește UNLICENSED.
Întrebări frecvente
Contractul meu rulează și fără licență. Trebuie neapărat?
Nu blochează nimic, e doar un avertisment. Dar e o convenție respectată de toate proiectele serioase, iar exploratoarele de blocuri (de exemplu Etherscan) afișează licența la contractele verificate.
Ce licență aleg?
Pentru exerciții și proiecte open source, MIT este cea mai folosită (o folosesc și contractele OpenZeppelin). Pentru cod care nu vrei să fie refolosit, UNLICENSED.
Erori înrudite
ParserError: Source file requires different compiler version (current compiler is 0.8.30+commit.73712a01.Emscripten.clang) - note that nightly builds are considered to be strictly less than the released version Linia pragma solidity cere o versiune de compilator care nu se potrivește cu cea pe care o folosești (de exemplu ^0.7.0 cu compilatorul 0.8.30). Schimbă pragma într-un interval care include versiunea ta, de exemplu pragma solidity ^0.8.20;, și adaptează codul vechi la 0.8. Warning: Function state mutability can be restricted to view Avertismentul spune că funcția doar citește starea, deci poate fi marcată view. Adaugă view: pe lângă claritate, din ethers primești direct valoarea întoarsă, nu o tranzacție. Î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.
