...
← Curs Solidity și Smart Contracts: toate lecțiile
Lecția 7 · Tipuri

Tipurile de bază: uint, bool, string

Solidity este un limbaj cu tipuri statice: fiecare variabilă își declară tipul, iar compilatorul verifică totul înainte de publicare. În această lecție înveți cele patru tipuri pe care le vei folosi cel mai des și afli de ce pe blockchain nu există numere cu virgulă.

De ce tipuri declarate?

În JavaScript scrii let x = 5 și apoi x = "cinci" fără probleme. În Solidity, uint x rămâne număr pentru totdeauna. Pare mai rigid, dar pe blockchain o greșeală nu se mai poate repara după publicare: e mult mai bine să o prindă compilatorul.

Tipurile de bază, ca niște cutiibooltrue / false1 octetuint2560 … 2²⁵⁶ − 132 de octeți, doar pozitiveint256−2²⁵⁵ … 2²⁵⁵ − 132 de octeți, cu semnstring… cât e nevoie"Caiet A4" = 8 octețilungime variabilă (UTF-8)fiecare pătrățel = 1 octet
bool, uint256 și int256 au mărime fixă (uint256 și int256 au 32 de octeți); string are lungime variabilă.
TipCe țineExemplu
uint (= uint256)numere întregi fără semn: 0, 1, 2, …uint public stoc = 120;
int (= int256)numere întregi cu semnint public temperatura = -5;
booltrue sau falsebool public deschis = true;
stringtext (UTF-8)string public oras = "Sinaia";

Cele patru tipuri în acțiune

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

contract Meteo {
    int public temperatura = -5;
    uint public umiditate = 80;
    bool public ninge = true;
    string public oras = "Sinaia";

    function imparte(uint a, uint b) public pure returns (uint) {
        return a / b;
    }
}
const m = await deploy("Meteo");
console.log(await m.oras(), await m.temperatura(), "grade");
console.log("Umiditate:", await m.umiditate());
console.log("Ninge:", await m.ninge());
console.log("7 / 2 =", await m.imparte(7, 2));
Sinaia -5 grade
Umiditate: 80
Ninge: true
7 / 2 = 3

Observă 7 / 2 = 3: împărțirea între întregi taie partea zecimală (nu rotunjește). Este cel mai important lucru de reținut despre numere în Solidity.

uint este cel mai folosit

Soldurile, prețurile, cantitățile, timpul: aproape totul pe blockchain este uint. int apare rar, doar când chiar ai nevoie de valori negative.

De ce nu există zecimale

Numerele cu virgulă mobilă (0.1 + 0.2 = 0.30000000000000004 în JavaScript) dau rezultate care pot diferi ușor între procesoare. Pe blockchain, toate nodurile trebuie să obțină exact același rezultat, deci EVM lucrează doar cu întregi.

Soluția este să lucrezi în unități mici: ether-ul în wei (10¹⁸ wei = 1 ETH), lei în bani, procente în puncte de bază (1% = 100). Așa cum un magazin online ține prețurile în bani, nu în lei:

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

contract Pret {
    // 12,50 lei ținuți în bani: 1250
    uint public pretInBani = 1250;

    function pretInLei() public view returns (uint) {
        return pretInBani / 100;
    }

    function restInBani() public view returns (uint) {
        return pretInBani % 100;
    }
}
const p = await deploy("Pret");
console.log("Preț:", await p.pretInLei(), "lei și", await p.restInBani(), "bani");
console.log("Un ether în wei:", ethers.parseEther("1"));
Preț: 12 lei și 50 bani
Un ether în wei: 1000000000000000000

% este restul împărțirii. Cu / și % împarți un preț în lei și bani, fără nicio zecimală.

Ce nu merge

  • uint public sold = -1; nu compilează: un uint nu poate fi negativ (eroare de conversie de tip).
  • uint public pret = 12.5; nu compilează: nu există literali zecimali pentru întregi.
  • string public oras = "Brașov"; nu compilează fără unicode"Brașov".
  • bool public deschis = 1; nu compilează: în Solidity, 1 nu înseamnă true.
Texte: puține operații

string în Solidity este doar un container de octeți. Nu are .length, toUpperCase sau comparație cu ==. Prelucrarea textelor se face în aplicație (JavaScript); contractul doar le păstrează.

Greșeli frecvente

  • Împărțirea înainte de înmulțire: cu a = 5 și b = 10, a / b * 100 dă 0, nu 50 (pentru că 5 / 10 este deja 0). Înmulțește întâi: a * 100 / b.
  • Uitarea unităților: 1 într-un contract este 1 wei; pentru 1 ether scrie 1 ether (Solidity are unitățile wei, gwei, ether).
  • Prea multe texte în storage: stringurile lungi costă mult gas; păstrează-le scurte sau în afara lanțului.

Exemple reale

USDC

Moneda stabilă are 6 zecimale: 1 USDC este ținut în contract ca 1 000 000.

ΞEther

Toate soldurile sunt în wei; portofelul împarte la 10¹⁸ doar când îți afișează suma.

Magazine online

Și în afara blockchain-ului, prețurile se țin adesea în bani (numere întregi), din același motiv.

Exercițiul tău

Scrie contractul Produs cu variabilele publice pret (uint, 4999, adică 49,99 lei în bani), inStoc (bool, true) și denumire (string, Caiet A4), plus funcția descriere(), de tip public view, care returnează denumirea. Scriptul lecției afișează toate valorile.

  • Declară cele trei variabile publice cu valorile cerute.
  • Scrie funcția descriere() care returns (string memory).
  • Funcția returnează denumire.
Funcția are forma lui citeste() din lecția 5: return denumire;.

Soluția exercițiului

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

contract Produs {
    uint public pret = 4999;
    bool public inStoc = true;
    string public denumire = "Caiet A4";

    function descriere() public view returns (string memory) {
        return denumire;
    }
}
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 7 · Tipurile de bază: uint, bool, string
Progres 0% 0 din 17
Lecția curentă 7 / 15 Tipuri