Primul contract, linie cu linie
Un fișier Solidity are o structură fixă: licența, versiunea compilatorului, apoi contractul cu datele și funcțiile lui. În această lecție iei fiecare linie pe rând, înveți regulile de scriere (acolade, punct și virgulă, comentarii) și vezi cum arată erorile de compilare.
Anatomia unui fișier .sol
Fișierele Solidity au extensia .sol. În curs, contractul tău stă în Contract.sol. Orice fișier începe la fel, iar compilatorul verifică strict fiecare caracter.
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.20;
/// @title Primul contract cu o variabilă
contract Salutare {
// un comentariu pe o linie
string public text = "Salut!";
/* un comentariu
pe mai multe linii */
function citeste() public view returns (string memory) {
return text;
}
}const s = await deploy("Salutare");
console.log(await s.text());
console.log(await s.citeste());Salut! Salut!
text() a fost creată automat de compilator pentru că variabila este public; citeste() am scris-o noi și face același lucru.
Primele două linii
Licența: SPDX
// SPDX-License-Identifier: MIT este un comentariu special. Codul contractelor de pe Ethereum este public, așa că declari sub ce licență îl poate refolosi altcineva. MIT permite aproape orice. Dacă lipsește, compilatorul afișează un avertisment (nu o eroare).
Versiunea: pragma
pragma solidity ^0.8.20; spune ce compilatoare pot compila fișierul. ^ înseamnă „0.8.20 sau mai nou, dar tot 0.8.x”. Limbajul se schimbă între versiunile mari (0.7 → 0.8 a adus verificarea automată a depășirilor), deci fixezi versiunea ca să nu ai surprize.
| Scriere | Acceptă |
|---|---|
| pragma solidity ^0.8.20; | 0.8.20, 0.8.21, …, 0.8.30 (nu 0.9.0) |
| pragma solidity 0.8.30; | doar 0.8.30, exact |
| pragma solidity >=0.8.0 <0.9.0; | orice 0.8.x |
Editorul folosește compilatorul oficial Solidity 0.8.30. Dacă ceri, de exemplu, pragma solidity ^0.7.0;, primești eroarea: Versiunea cerută în pragma nu se potrivește.
Contractul, acoladele și punctul și virgula
- contract Nume { ... } seamănă cu o clasă din JavaScript: între acolade pui variabilele și funcțiile. Numele începe, prin convenție, cu literă mare (Salutare, Contor).
- Fiecare instrucțiune se termină cu ;: declarațiile de variabile, atribuirile, return.
- Blocurile (contractul, funcțiile, if) se deschid și se închid cu acolade. După } nu pui ;.
- Spațiile și rândurile noi nu contează pentru compilator, dar indentarea cu 4 spații face codul ușor de citit.
Textele cu litere românești trebuie marcate cu unicode, altfel compilarea eșuează:
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.20;
contract Oras {
string public nume = unicode"Brașov";
string public tara = "Romania";
}const oras = await deploy("Oras");
console.log(await oras.nume(), "-", await oras.tara());Brașov - Romania
Comentariile
| Formă | Folosire |
|---|---|
| // text | comentariu până la capătul rândului |
| /* text */ | comentariu pe mai multe rânduri |
| /// @title ... | NatSpec: documentație pentru contract și funcții (@notice, @param, @return), citită de unelte și de exploratoare |
Comentariile nu ajung în bytecode, deci nu costă gas. Scrie-le pentru oamenii care vor citi contractul: pe blockchain, codul unui contract important este citit de mulți.
Erorile de compilare
Dacă uiți un ;, compilatorul oprește totul și îți arată linia. De exemplu, la fișierul de mai jos (lipsește ; după variabilă), consola afișează în roșu: Linia 5: Lipsește punctul și virgula ; (am găsit „function”)., iar dedesubt mesajul original în engleză.
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.20;
contract Gresit {
string public text = "Salut!"
function citeste() public view returns (string memory) {
return text;
}
}Citește mesajul cu atenție: „am găsit function” înseamnă că după valoarea "Salut!" compilatorul aștepta ;, dar următorul lucru întâlnit a fost cuvântul function de pe linia 7. Rândurile goale nu contează, de aceea pentru compilator cele două se lipesc.
- **Lipsește ;** după o declarație sau o atribuire.
- Acolade neînchise: eroare la finalul fișierului; numără { și }.
- Ghilimele românești sau diacritice fără unicode: textul nu se poate converti.
- Nume scrise diferit: Text și text sunt nume diferite (Solidity face diferența între litere mari și mici).
Notele gri (de exemplu „lipsește SPDX” sau „funcția poate fi view”) sunt avertismente: codul rulează, dar compilatorul îți sugerează o îmbunătățire. Merită să le rezolvi.
Pe scurt
Contractele verificate apar pe Etherscan exact în această formă, cu licența și versiunea compilatorului.
Biblioteca folosită de majoritatea proiectelor are fiecare fișier cu SPDX, pragma și comentarii NatSpec.
Scrie de la zero contractul Mesaj, cu o variabilă de stare publică text de tip string, inițializată cu Prima mea linie pe blockchain. Scriptul lecției publică contractul și afișează text().
- Scrie linia de licență SPDX și pragma solidity ^0.8.20;.
- Declară contractul Mesaj.
- Adaugă string public text = "Prima mea linie pe blockchain";.
Soluția exercițiului
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.20;
contract Mesaj {
string public text = "Prima mea linie pe blockchain";
} 