...
← Curs Solidity și Smart Contracts: toate lecțiile
Lecția 5 · Primii pași

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: MITlicența coduluipragma solidity ^0.8.20;versiunea compilatoruluicontract Salutare {începutul contractului // un comentariuignorat de compilator string public text = "Salut!";o variabilă de stare function citeste() public viewo funcție returns (string memory) { return text;instrucțiune: se termină cu ; }}acolada închide contractul
Contractul Salutare linie cu linie: licența, versiunea, contractul, o variabilă de stare și o funcție, fiecare cu rolul ei.
// 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.

ScriereAcceptă
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
Compilatorul din curs

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
// textcomentariu 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).
Avertismente

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

1
Prima linie: licența SPDX.
2
A doua: pragma solidity ^0.8.20;.
3
contract Nume { deschide contractul.
4
În interior: variabile (cu ;) și funcții (cu acolade).
5
} închide contractul.
Etherscan

Contractele verificate apar pe Etherscan exact în această formă, cu licența și versiunea compilatorului.

OpenZeppelin

Biblioteca folosită de majoritatea proiectelor are fiecare fișier cu SPDX, pragma și comentarii NatSpec.

Exercițiul tău

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";.
Nu uita ; după declarația variabilei și acolada de închidere a contractului.

Soluția exercițiului

// SPDX-License-Identifier: MIT
pragma solidity ^0.8.20;

contract Mesaj {
    string public text = "Prima mea linie pe blockchain";
}
Excelent! Continuă cu lecția următoare →
Contract.solSolidity
ConsolăSe încarcă...
Mediul de lucru se încarcă. Poți citi lecția între timp.
Rulează codul cu butonul de sus sau cu Ctrl + Enter / Cmd + Enter.
Parcursul tău Primii pași cu smart contracts Lecția 5 · Primul contract, linie cu linie
Progres 0% 0 din 17
Lecția curentă 5 / 15 Primii pași