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.
| Tip | Ce ține | Exemplu |
|---|---|---|
| uint (= uint256) | numere întregi fără semn: 0, 1, 2, … | uint public stoc = 120; |
| int (= int256) | numere întregi cu semn | int public temperatura = -5; |
| bool | true sau false | bool public deschis = true; |
| string | text (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.
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.
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
Moneda stabilă are 6 zecimale: 1 USDC este ținut în contract ca 1 000 000.
Toate soldurile sunt în wei; portofelul împarte la 10¹⁸ doar când îți afișează suma.
Și în afara blockchain-ului, prețurile se țin adesea în bani (numere întregi), din același motiv.
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.
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;
}
} 