...
Eroare Solidity · Funcții: locația datelor, vizibilitate, view și pure

Warning: Function state mutability can be restricted to view

Pe scurt

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

Greșit
SOLIDITY
function sold() external returns (uint256) {
    return total;
}
Corect
SOLIDITY
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

Greșit
SOLIDITY
function dublu(uint256 x) external view returns (uint256) {
    return x * 2;
}
Corect
SOLIDITY
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

Greșit
SOLIDITY
function eMembru(address a) public returns (bool) {
    return membri[a];
}
Corect
SOLIDITY
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ă tu

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.

Codul care dă eroarea
SOLIDITY
// 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;
    }
}
După reparație, programul afișează
Media: 40
Indiciu

Funcția doar citește total și numar.

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 view funcțiile care întorc date și pure calculele.
  • Î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

← Toate erorile Solidity

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Î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.