...
Eroare Solidity · Nume nedeclarate și membri inexistenți

TypeError: Immutable variables cannot have a non-value type.

Pe scurt

immutable merge doar pentru tipuri valoare: uintX, intX, bool, address, bytes1–bytes32, enum. Un string, bytes, un array sau un struct nu poate fi immutable. Fă-l variabilă de stare obișnuită (setată în constructor), constant dacă textul e fix, sau păstrează un bytes32.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

O variabilă immutable e copiată la publicare direct în codul contractului, în locuri de câte 32 de bytes. Asta merge doar pentru tipurile de mărime fixă (value types): numere, bool, address, bytesN, enum. Tipurile cu lungime variabilă (string, bytes, uint256[]) și structurile nu încap într-un astfel de loc, așa că primești Immutable variables cannot have a non-value type.

Cazul tipic: numele unui token, al unui magazin sau un mesaj setat în constructor, declarat string public immutable nume. Ai trei variante: o variabilă de stare normală (o setezi în constructor și pur și simplu nu scrii nicio funcție care s-o modifice), constant dacă textul e cunoscut de la început, sau bytes32 dacă textul are cel mult 32 de bytes și vrei neapărat imutabilitate.

Atenție: constant acceptă string și bytes, dar nu și array-uri sau structuri.

De ce apare: cauzele frecvente

1Text setat în constructor

Greșit
SOLIDITY
string public immutable nume;

constructor(string memory n) {
    nume = n;
}
Corect
SOLIDITY
string public nume;

constructor(string memory n) {
    nume = n;
}

Ca variabilă de stare normală, fără funcții care s-o schimbe, se comportă în practică tot ca o valoare fixă.

2Text cunoscut de la început

Greșit
SOLIDITY
string public immutable MONEDA = "RON";
Corect
SOLIDITY
string public constant MONEDA = "RON";

Pentru texte fixe, constant e acceptat și nu costă storage.

3Listă de adrese fixă

Greșit
SOLIDITY
address[] public immutable asociati;
Corect
SOLIDITY
address[] public asociati;

Array-urile nu pot fi nici immutable, nici constant; le ții în storage și le setezi o dată, în constructor.

Repară tu

Repară eroarea, direct în pagină

Contractul Magazin primește numele magazinului în constructor, dar declarația string public immutable nume; dă TypeError: Immutable variables cannot have a non-value type.. Păstrează numele într-o variabilă de stare obișnuită (proprietarul rămâne immutable). Scriptul publică magazinul cu numele „Brutăria Ana” și afișează numele.

Codul care dă eroarea
SOLIDITY
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.20;

contract Magazin {
    string public immutable nume;
    address public immutable proprietar;

    constructor(string memory numeMagazin) {
        nume = numeMagazin;
        proprietar = msg.sender;
    }
}
După reparație, programul afișează
Nume: Brutăria Ana
Proprietara este ana: true
Indiciu

string nu poate fi immutable; address poate.

Cum o eviți pe viitor

  • Folosește immutable pentru adrese, numere, bool și bytes32 aflate la publicare.
  • Pentru texte fixe folosește constant; pentru texte primite în constructor, o variabilă de stare obișnuită.
  • Dacă o valoare nu trebuie să se schimbe, nu scrie nicio funcție care o modifică.
  • Pentru nume scurte poți folosi bytes32 (ethers.encodeBytes32String în JavaScript).

Întrebări frecvente

De ce OpenZeppelin ține numele tokenului în storage?

Exact din acest motiv: numele și simbolul unui ERC-20 sunt string, deci nu pot fi immutable. Le setează constructorul și nu există funcții care să le modifice.

Pot pune un struct immutable?

Nu. Doar tipurile valoare pot fi immutable. Dacă ai câteva valori fixe, declară câte o variabilă immutable pentru fiecare câmp.

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.