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

VM Exception while processing transaction: reverted with panic code 0x1 (Assertion error)

Pe scurt

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 assert pentru 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 e require cu 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

Greșit
SOLIDITY
function retrage(uint256 suma) external {
    assert(solduri[msg.sender] >= suma);
    solduri[msg.sender] -= suma;
}
Corect
SOLIDITY
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

Greșit
SOLIDITY
function transfera(address catre, uint256 suma) external {
    solduri[msg.sender] -= suma;
    solduri[catre] += suma + 1; // bug
    assert(sumaSoldurilor() == total);
}
Corect
SOLIDITY
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ă tu

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.

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 {
        assert(solduri[msg.sender] >= suma);
        solduri[msg.sender] -= suma;
    }
}
După reparație, programul afișează
Sold: 30
Retrag 100: Sold insuficient
Indiciu

Pentru intrările utilizatorului se folosește require(conditie, "mesaj").

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 (sau if (...) revert EroareCustom(...)) pentru tot ce vine din afară: argumente, msg.sender, msg.value, rezultatul altor contracte.
  • Păstrează assert doar 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

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