Warning: Function state mutability can be restricted to view
Avertismentul spune că funcția doar citește starea, deci poate fi marcată view. Adaugă view: pe lângă claritate, din ethers primești direct valoarea întoarsă, nu o tranzacție.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Compilatorul a analizat funcția și a văzut că nu modifică nimic: doar citește variabile de stare sau mediul (msg.sender, block.timestamp). Îți sugerează să o marchezi view. Varianta can be restricted to pure înseamnă că nici măcar nu citește starea.
E doar un avertisment, codul se compilează. Dar diferența contează mai mult decât pare: pentru o funcție fără view, ethers (și orice aplicație) trimite o tranzacție, care costă gas, așteaptă să fie minată și întoarce un obiect TransactionResponse, nu valoarea din return. Valoarea întoarsă de o funcție care nu e view / pure nu ajunge la apelantul din afară.
Cu view, apelul se face local (eth_call), gratuit, iar rezultatul e chiar valoarea întoarsă.
De ce apare: cauzele frecvente
1Funcție de citire fără view
function sold() external returns (uint256) {
return total;
}function sold() external view returns (uint256) {
return total;
}Funcția doar citește total. Cu view, apelul din script întoarce numărul, nu o tranzacție.
2Calcul fără stare, marcat view sau fără nimic
function dublu(uint256 x) external view returns (uint256) {
return x * 2;
}function dublu(uint256 x) external pure returns (uint256) {
return x * 2;
}Avertismentul devine can be restricted to pure: funcția folosește doar parametrul.
3Ai scos view temporar și ai uitat să-l pui la loc
function eMembru(address a) public returns (bool) {
return membri[a];
}function eMembru(address a) public view returns (bool) {
return membri[a];
}Avertismentul te anunță că funcția a rămas fără view, chiar dacă nu mai modifică nimic.
Repară eroarea, direct în pagină
Contractul Statistici se compilează cu avertismentul Function state mutability can be restricted to view, iar scriptul afișează un TransactionResponse în loc de media vânzărilor. Repară declarația funcției media, ca apelul din script să întoarcă direct valoarea. Scriptul înregistrează vânzări de 30, 50 și 40 și afișează media.
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.20;
contract Statistici {
uint256 public total;
uint256 public numar;
function inregistreaza(uint256 suma) external {
total += suma;
numar += 1;
}
function media() external returns (uint256) {
return total / numar;
}
}Media: 40
Indiciu
Funcția doar citește total și numar.
Reparația
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.20;
contract Statistici {
uint256 public total;
uint256 public numar;
function inregistreaza(uint256 suma) external {
total += suma;
numar += 1;
}
function media() external view returns (uint256) {
return total / numar;
}
}De ce merge
Fără view, media() era o funcție care poate modifica starea, așa că ethers trimitea o tranzacție și întorcea obiectul tranzacției, nu rezultatul lui return. Cu view, apelul devine o citire locală, gratuită, iar scriptul primește direct media: (30 + 50 + 40) / 3 = 40. Avertismentul compilatorului dispare și el.
Alte forme ale mesajului
Warning: Function state mutability can be restricted to pure
Cum o eviți pe viitor
- Citește avertismentele compilatorului, nu doar erorile: acesta schimbă cum se comportă funcția din aplicație.
- Marchează din prima
viewfuncțiile care întorc date șipurecalculele. - În teste, dacă primești un obiect tranzacție în loc de un număr, verifică dacă funcția e
view.
Întrebări frecvente
De ce scriptul meu afișează un TransactionResponse în loc de număr?
Pentru că funcția nu e view sau pure, deci ethers trimite o tranzacție și îți întoarce tranzacția. Marchează funcția view sau, dacă trebuie să modifice starea, emite un eveniment cu rezultatul și citește-l din receipt.
Pot obține totuși valoarea unei funcții care modifică starea, fără tranzacție?
Da, cu contract.functie.staticCall(...): nodul simulează apelul și îți dă valoarea întoarsă, fără să salveze nimic. E util pentru previzualizări, nu și pentru a modifica starea.
Erori înrudite
TypeError: Function cannot be declared as view because this expression (potentially) modifies the state. Ai marcat funcția view (doar citește), dar în ea modifici o variabilă de stare, emiți un eveniment sau trimiți ether. Scoate view dacă funcția chiar trebuie să schimbe ceva, sau mută modificarea în altă funcție. TypeError: Function declared as pure, but this expression (potentially) reads from the environment or state and thus requires "view". Funcția e marcată pure, dar citește o variabilă de stare sau ceva din mediu (msg.sender, block.timestamp, address(this).balance). Schimbă pure în view, sau transmite valoarea ca parametru dacă vrei să rămână pure. Warning: SPDX license identifier not provided in source file. Before publishing, consider adding a comment containing "SPDX-License-Identifier: <SPDX-License>" to each source file. Use "SPDX-License-Identifier: UNLICENSED" for non-open-source code. Please see https://spdx.org for more information. Este un avertisment, nu o eroare: fișierului îi lipsește comentariul cu licența. Adaugă pe prima linie // SPDX-License-Identifier: MIT (sau UNLICENSED pentru cod închis), iar avertismentul dispare. Învață Solidity de la zero, cu exerciții la fiecare lecție
Curs Solidity și Smart Contracts: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.
