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ă.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
assert(conditie) oprește tranzacția cu eroarea specială Panic(0x01) dacă condiția e falsă. Spre deosebire de require, nu are mesaj: Panic semnalează o eroare de programare, o situație care după logica ta nu ar trebui să apară niciodată (de exemplu suma soldurilor diferită de total).
Două situații tipice:
- folosești
assertpentru a verifica intrările (suma retrasă, cine apelează, valoarea trimisă). Atunci orice greșeală a utilizatorului apare ca Panic fără explicații; reparația erequirecu mesaj sau o eroare custom; - chiar ai un invariant, iar el a fost încălcat. Atunci ai un bug real în logica de dinainte, iar
assertși-a făcut treaba.
În ethers mesajul apare ca Panic due to ASSERT_FALSE(1); în testele Hardhat îl verifici cu revertedWithPanic(0x01).
De ce apare: cauzele frecvente
1assert pentru o intrare de la utilizator
function retrage(uint256 suma) external {
assert(solduri[msg.sender] >= suma);
solduri[msg.sender] -= suma;
}function retrage(uint256 suma) external {
require(solduri[msg.sender] >= suma, "Sold insuficient");
solduri[msg.sender] -= suma;
}O sumă prea mare e o greșeală obișnuită a utilizatorului, nu un bug; require îi spune ce a greșit.
2Invariant încălcat de un bug
function transfera(address catre, uint256 suma) external {
solduri[msg.sender] -= suma;
solduri[catre] += suma + 1; // bug
assert(sumaSoldurilor() == total);
}function transfera(address catre, uint256 suma) external {
solduri[msg.sender] -= suma;
solduri[catre] += suma;
assert(sumaSoldurilor() == total);
}Aici assert e folosit corect: el a prins bug-ul, iar reparația e în logica de dinainte.
Repară eroarea, direct în pagină
Contractul Portofel verifică retragerile cu assert, așa că o retragere prea mare dă Panic(0x01), fără niciun motiv pentru utilizator. Înlocuiește verificarea cu una care respinge suma prea mare cu mesajul "Sold insuficient". Scriptul depune 50, retrage 20, afișează soldul și încearcă o retragere de 100.
// 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 {
assert(solduri[msg.sender] >= suma);
solduri[msg.sender] -= suma;
}
}Sold: 30 Retrag 100: Sold insuficient
Indiciu
Pentru intrările utilizatorului se folosește require(conditie, "mesaj").
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
assert e gândit pentru condiții care nu pot fi false decât din cauza unui bug, de aceea oprește tranzacția cu Panic(0x01), fără mesaj. O retragere mai mare decât soldul e însă o greșeală obișnuită a utilizatorului. Cu require(..., "Sold insuficient"), cererea e respinsă cu un motiv clar, iar soldul de 30 rămâne neatins.
Alte forme ale mesajului
execution reverted: Panic due to ASSERT_FALSE(1)panic: assertion failed (0x01)
Cum o eviți pe viitor
- Folosește
require(sauif (...) revert EroareCustom(...)) pentru tot ce vine din afară: argumente,msg.sender,msg.value, rezultatul altor contracte. - Păstrează
assertdoar pentru invarianți interni, care ar trebui să fie mereu adevărați. - Testează invarianții cu multe valori (fuzzing) ca să prinzi un
assertîncălcat înainte de publicare. - Dacă un utilizator primește
Panic(0x01), tratează-l ca pe un bug de reparat.
Întrebări frecvente
Costă diferit assert și require?
Din Solidity 0.8, ambele returnează gas-ul nefolosit. Diferența e de intenție: require respinge o cerere invalidă cu motiv, assert semnalează un bug, cu codul 0x01.
Cum testez un assert în Hardhat?
Cu await expect(c.f()).to.be.revertedWithPanic(0x01). În cursul nostru, expectRevert întoarce Panic(0x01).
Erori înrudite
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. 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"). 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"). Î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.
