...
Eroare Solidity · Panic: overflow, împărțire la zero, index greșit

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)

Pe scurt

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

Greșit
SOLIDITY
function seteaza(uint8 s) external {
    stare = Stare(s);
}
Corect
SOLIDITY
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

Greșit
SOLIDITY
function seteaza(uint8 s) external { stare = Stare(s); }
Corect
SOLIDITY
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ă tu

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.

Codul care dă eroarea
SOLIDITY
// 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);
    }
}
După reparație, programul afișează
Stare: 2
Starea 3: Stare invalida
Indiciu

Ultima valoare a enum-ului este type(Stare).max.

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

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