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

VM Exception while processing transaction: reverted with panic code 0x11 (Arithmetic operation underflowed or overflowed outside of an unchecked block)

Pe scurt

Un calcul a ieșit din limitele tipului: de obicei o scădere care ar da un număr negativ într-un uint (underflow), de exemplu sold -= suma când suma e mai mare decât soldul. Verifică înainte de calcul cu require(sold >= suma, "Sold insuficient").

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

Ce înseamnă

Din Solidity 0.8, operațiile +, -, * sunt verificate automat. Dacă rezultatul nu încape în tip (un uint256 nu poate fi negativ, un uint8 nu poate trece de 255), tranzacția dă revert cu eroarea specială Panic(0x11). În versiunile vechi, valoarea „dădea peste cap” în tăcere (0 - 1 devenea un număr uriaș), iar asta a produs multe atacuri.

Panic înseamnă o eroare a programului, nu o regulă de business: nu are mesaj text, ci doar codul 0x11. Cel mai des apare la scăderi fără verificare (sold, stoc, voturi rămase), la bucle descrescătoare cu uint (for (uint256 i = n; i >= 0; i--), unde i-- la 0 dă underflow) și la array.length - 1 pe un array gol.

Reparația nu e să ascunzi eroarea cu unchecked, ci să verifici condiția înainte, cu un mesaj clar.

De ce apare: cauzele frecvente

1Scădere fără verificarea soldului

Greșit
SOLIDITY
function retrage(uint256 suma) external {
    solduri[msg.sender] -= suma;
}
Corect
SOLIDITY
function retrage(uint256 suma) external {
    require(solduri[msg.sender] >= suma, "Sold insuficient");
    solduri[msg.sender] -= suma;
}

Cu require, utilizatorul primește un motiv clar în loc de un Panic fără explicații.

2Buclă descrescătoare cu i >= 0

Greșit
SOLIDITY
for (uint256 i = v.length - 1; i >= 0; i--) {
    total += v[i];
}
Corect
SOLIDITY
for (uint256 i = v.length; i > 0; i--) {
    total += v[i - 1];
}

Un uint e mereu >= 0, deci bucla nu se oprește, iar i-- la 0 dă underflow. Pentru un array gol, chiar v.length - 1 dă underflow.

3Înmulțire care depășește un tip mic

Greșit
SOLIDITY
uint8 total = cantitate * pret; // uint8 cantitate = 20, uint8 pret = 15
Corect
SOLIDITY
uint256 total = uint256(cantitate) * pret;

300 nu încape într-un uint8 (maximum 255). Calculează în uint256.

Repară tu

Repară eroarea, direct în pagină

Contractul Portofel scade din sold fără nicio verificare. Scriptul depune 50, retrage 30 și apoi încearcă să retragă 100: în loc de un mesaj clar, tranzacția dă Panic(0x11) (underflow). Adaugă în retrage o verificare care respinge suma mai mare decât soldul cu mesajul "Sold insuficient". Scriptul afișează soldul și mesajul primit la retragerea prea mare.

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

contract Portofel {
    mapping(address => uint256) public solduri;

    function depune(uint256 suma) external {
        solduri[msg.sender] += suma;
    }

    function retrage(uint256 suma) external {
        solduri[msg.sender] -= suma;
    }
}
După reparație, programul afișează
Sold: 20
Retrag 100: Sold insuficient
Indiciu

Verifică solduri[msg.sender] >= suma înainte de scădere.

Alte forme ale mesajului

  • execution reverted: Panic due to OVERFLOW(17)
  • panic: arithmetic underflow or overflow (0x11)
  • reverted with panic code 0x11 (Arithmetic operation overflowed outside of an unchecked block)

Cum o eviți pe viitor

  • Înainte de fiecare scădere dintr-o valoare salvată (sold, stoc, voturi), verifică cu require că rezultatul nu e negativ.
  • Scrie buclele descrescătoare cu i > 0 și indexul i - 1.
  • Folosește unchecked { ... } doar când ai demonstrat că depășirea e imposibilă (de exemplu contorul unei bucle).
  • Testează cazurile limită: zero, sold exact, array gol.

Întrebări frecvente

Pot folosi unchecked ca să scap de eroare?

Tehnic, da, dar atunci 0 - 1 devine 2^256 - 1, un număr uriaș, exact bug-ul de care te protejează 0.8. Folosește unchecked doar pentru economie de gas, acolo unde ai demonstrat că depășirea nu se poate întâmpla.

De ce nu primesc un mesaj, ca la require?

Pentru că Panic semnalează o eroare de logică, nu o regulă pe care ai scris-o. Ea conține doar codul (0x11). Dacă vrei un mesaj pentru utilizator, pune un require sau o eroare custom înaintea calculului.

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.