VM Exception while processing transaction: reverted with panic code 0x11 (Arithmetic operation underflowed or overflowed outside of an unchecked block)
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
function retrage(uint256 suma) external {
solduri[msg.sender] -= suma;
}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
for (uint256 i = v.length - 1; i >= 0; i--) {
total += v[i];
}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
uint8 total = cantitate * pret; // uint8 cantitate = 20, uint8 pret = 15uint256 total = uint256(cantitate) * pret;300 nu încape într-un uint8 (maximum 255). Calculează în uint256.
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.
// 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;
}
}Sold: 20 Retrag 100: Sold insuficient
Indiciu
Verifică solduri[msg.sender] >= suma înainte de scădere.
Reparația
// 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 {
require(solduri[msg.sender] >= suma, "Sold insuficient");
solduri[msg.sender] -= suma;
}
}De ce merge
Soldul era 20, iar 20 - 100 nu încape într-un uint256, care nu poate fi negativ. Solidity 0.8 a oprit calculul cu Panic(0x11), care protejează contractul, dar nu spune nimic util utilizatorului. Cu require(solduri[msg.sender] >= suma, "Sold insuficient"), verificarea se face înaintea scăderii, iar retragerea prea mare e respinsă cu un mesaj clar.
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
requirecă rezultatul nu e negativ. - Scrie buclele descrescătoare cu
i > 0și indexuli - 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
VM Exception while processing transaction: reverted with panic code 0x12 (Division or modulo division by zero) Contractul a împărțit (sau a calculat restul cu %) la zero, de obicei o medie calculată înainte să existe date sau un număr de participanți egal cu 0. Verifică împărțitorul înainte: if (numar == 0) return 0; sau require(numar > 0, "..."). 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++). VM Exception while processing transaction: reverted with reason string 'Plata insuficienta' Un require (sau revert) din contract a oprit tranzacția, iar textul dintre ghilimele este chiar mesajul scris în cod. Caută mesajul în contract, vezi ce condiție verifică și află de ce n-a fost îndeplinită: argumente greșite, alt cont, prea puțin ether sau o condiție scrisă greșit. Î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.
