Funcții view și pure
Nu orice funcție schimbă starea. Multe doar calculează sau citesc. Cu view și pure îi spui compilatorului (și aplicațiilor) că funcția nu modifică nimic, iar asta o face gratuită când o apelezi din afară.
Trei feluri de funcții
Gândește-te la o bibliotecă. Să împrumuți o carte schimbă registrul (funcție normală). Să te uiți în catalog doar citește registrul (view). Să calculezi cât costă o întârziere de 3 zile la 2 lei pe zi nu are nevoie de registru deloc (pure).
- view: poate citi variabile de stare, msg.sender, block.timestamp, dar nu poate scrie nimic.
- pure: nu poate nici citi, nici scrie starea; rezultatul depinde doar de parametri.
- fără niciunul: funcție normală, care poate modifica starea.
Un exemplu cu amândouă
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.20;
contract Magazin {
uint public tva = 19;
// view: citește tva din storage
function pretCuTva(uint pret) public view returns (uint) {
return pret + pret * tva / 100;
}
// pure: lucrează doar cu parametrii
function reducere(uint pret, uint procent) public pure returns (uint) {
return pret - pret * procent / 100;
}
}const m = await deploy("Magazin");
console.log("1000 cu TVA:", await m.pretCuTva(1000));
console.log("1000 cu 25% reducere:", await m.reducere(1000, 25));
const inainte = await sold(ana);
for (let i = 0; i < 5; i++) await m.pretCuTva(500);
console.log("Sold neschimbat după 5 citiri:", (await sold(ana)) === inainte);1000 cu TVA: 1190 1000 cu 25% reducere: 750 Sold neschimbat după 5 citiri: true
pretCuTva are nevoie de tva din storage, deci este view. reducere folosește doar parametrii, deci este pure. Cinci citiri nu au costat nimic: soldul Anei este exact același.
Un apel view/pure făcut din JavaScript este un call: rulează pe un singur nod, fără tranzacție. Dacă însă o funcție normală apelează în interiorul ei o funcție view, instrucțiunile acelea consumă gas ca parte din tranzacție.
Compilatorul te verifică
Cuvintele view și pure nu sunt doar etichete: compilatorul verifică că le respecți. Dacă o funcție view încearcă să scrie, primești o eroare de compilare:
function seteaza(uint t) public view {
temperatura = t; // eroare
}Compilatorul oprește totul cu o eroare de tip pe linia atribuirii (în editor o vezi tradusă): Funcția este declarată view, dar această instrucțiune modifică starea. În engleză, mesajul original al lui solc începe cu Function cannot be declared as view. Iar dacă o funcție pure citește o variabilă de stare, eroarea (tradusă) spune: Funcția este declarată pure, dar citește starea contractului (sau msg / block). Folosește view în loc de pure.
Invers, dacă scrii o funcție normală care doar citește, compilatorul nu dă eroare, dar afișează un avertisment gri: funcția poate fi restricționată la view (sau pure). Ascultă-l: aplicațiile vor ști astfel că o pot apela gratuit.
Cum alegi
| Funcție | Tip corect | De ce |
|---|---|---|
| numar() (getter) | view | citește numar din storage |
| aduna(a, b) | pure | doar parametrii |
| creste() | normală | scrie numar |
| cineSunt() | view | citește msg.sender |
Greșeli frecvente
- **returns uitat**: o funcție view fără returns (...) nu întoarce nimic și nu are sens.
- **pure pe o funcție care citește msg.sender**: eroare de compilare; msg.sender face parte din context, deci funcția e view.
- „view înseamnă privat.” Nu: view spune doar că funcția nu modifică starea; vizibilitatea (public) este altă proprietate.
- Ignorarea avertismentelor: o funcție care putea fi view va fi tratată de unele aplicații ca tranzacție, cu cost inutil.
Exemple reale
Uniswap are funcții view care calculează cât primești la un schimb, apelate gratuit de interfață la fiecare tastă.
Funcțiile matematice (procente, dobânzi) sunt de obicei pure.
Soldul unui token este o funcție view: portofelele o apelează constant, fără cost.
Scrie contractul Calculator cu variabila publică baza (uint) egală cu 10, funcția inmultesteCuBaza(uint x) de tip view, care returnează x * baza, și funcția patrat(uint x) de tip pure, care returnează x * x. Scriptul lecției afișează rezultatele pentru 7.
- Declară uint public baza = 10;.
- Scrie inmultesteCuBaza(uint x) ca public view returns (uint).
- Scrie patrat(uint x) ca public pure returns (uint).
Soluția exercițiului
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.20;
contract Calculator {
uint public baza = 10;
function inmultesteCuBaza(uint x) public view returns (uint) {
return x * baza;
}
function patrat(uint x) public pure returns (uint) {
return x * x;
}
} 