VM Exception while processing transaction: reverted with panic code 0x21 (Tried to convert a value into an enum, but the value was too big or negative)
Ai convertit un număr într-un enum (Stare(n)), dar numărul e mai mare decât ultima valoare a enum-ului. Un enum cu 3 valori acceptă doar 0, 1 și 2. Verifică numărul înainte de conversie cu require(n <= uint8(type(Stare).max), "Stare invalida").
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Un enum e intern un număr mic: enum Stare { Noua, Trimisa, Livrata } înseamnă 0, 1 și 2. Când primești un număr din afară (un uint8 dintr-o funcție, o valoare decodată) și îl transformi cu Stare(n), Solidity verifică intervalul. Pentru 3 sau mai mult, tranzacția dă Panic(0x21).
Aceeași eroare apare și când apelezi direct o funcție care primește un parametru de tip enum cu o valoare prea mare din script: decodarea ABI verifică intervalul (în unele cazuri, decodarea pică și fără motiv).
Ca să dai un mesaj clar, verifică numărul înainte de conversie. type(Stare).max îți dă ultima valoare a enum-ului, deci verificarea rămâne corectă și când adaugi stări noi. Mai bine, dacă se poate, primește direct parametrul ca Stare, sau oferă funcții separate pentru fiecare tranziție (trimite(), livreaza()), care nu primesc numere deloc.
De ce apare: cauzele frecvente
1Conversie fără verificare
function seteaza(uint8 s) external {
stare = Stare(s);
}function seteaza(uint8 s) external {
require(s <= uint8(type(Stare).max), "Stare invalida");
stare = Stare(s);
}type(Stare).max este ultima valoare (aici Livrata = 2).
2Funcții separate în loc de numere
function seteaza(uint8 s) external { stare = Stare(s); }function trimite() external {
require(stare == Stare.Noua, "Nu e noua");
stare = Stare.Trimisa;
}O funcție pe tranziție nu primește numere, deci nu poate primi o stare inexistentă, și verifică și ordinea stărilor.
Repară eroarea, direct în pagină
Contractul Comanda primește starea ca număr și o convertește în enum-ul Stare (0 = Noua, 1 = Trimisa, 2 = Livrata). Pentru 3, tranzacția dă Panic(0x21). Adaugă o verificare care respinge numerele în afara enum-ului cu mesajul "Stare invalida", înainte de conversie. Scriptul setează starea 2, o afișează și încearcă starea 3.
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.20;
contract Comanda {
enum Stare { Noua, Trimisa, Livrata }
Stare public stare;
function seteaza(uint8 s) external {
stare = Stare(s);
}
}Stare: 2 Starea 3: Stare invalida
Indiciu
Ultima valoare a enum-ului este type(Stare).max.
Reparația
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.20;
contract Comanda {
enum Stare { Noua, Trimisa, Livrata }
Stare public stare;
function seteaza(uint8 s) external {
require(s <= uint8(type(Stare).max), "Stare invalida");
stare = Stare(s);
}
}De ce merge
Stare are trei valori, 0, 1 și 2, așa că Stare(3) nu are sens, iar Solidity oprește conversia cu Panic(0x21). Verificarea s <= uint8(type(Stare).max) respinge numărul înainte de conversie, cu un mesaj clar, și rămâne corectă dacă enum-ul primește stări noi. Starea 2 (Livrata) se setează normal.
Alte forme ale mesajului
execution reverted: Panic due to ENUM_RANGE_ERROR(33)panic: failed to convert value into enum type (0x21)
Cum o eviți pe viitor
- Nu converti numere în enum fără verificare; folosește
type(Enum).max. - Preferă funcții dedicate pentru fiecare tranziție a unei mașini de stări.
- Nu reordona și nu șterge valori dintr-un enum după publicare: valorile salvate își schimbă sensul.
- În scripturi, folosește aceleași numere ca în contract (0 pentru prima valoare).
Întrebări frecvente
Cum văd un enum din JavaScript?
Ca un număr: await c.stare() întoarce 2n pentru Livrata. Dacă vrei nume, ține în aplicație lista ["Noua", "Trimisa", "Livrata"] în aceeași ordine.
Pot adăuga o valoare nouă la enum mai târziu?
Doar într-un contract nou (sau într-un upgrade, la final, nu la mijloc). Un contract publicat nu își mai schimbă codul.
Erori înrudite
VM Exception while processing transaction: reverted with panic code 0x1 (Assertion error) Un assert(...) din contract a picat. assert e pentru condiții care nu ar trebui să fie niciodată false (invarianți); pentru datele primite de la utilizator folosește require(..., "mesaj"), care dă un motiv clar. Verifică ce condiție din assert a fost încălcată. VM Exception while processing transaction: reverted with panic code 0x32 (Array accessed at an out-of-bounds or negative index) Ai citit sau scris un element de array la un index care nu există: indexul e egal cu length sau mai mare (de exemplu i <= v.length într-o buclă) ori array-ul e gol. Indicii merg de la 0 la length - 1, deci bucla corectă este for (i = 0; i < v.length; i++). TypeError: Explicit type conversion not allowed from "uint256" to "address". Încerci o conversie directă pe care Solidity 0.8 nu o permite, de exemplu address(numar) sau address(hash). Fă conversia în pași, prin tipul intermediar potrivit: address(uint160(numar)) sau address(uint160(uint256(hash))). Î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.
