...
Eroare Solidity · Revert la rulare: require, erori custom, gas

VM Exception while processing transaction: reverted with custom error 'StocInsuficient(5, 5)'

Pe scurt

Contractul a oprit tranzacția cu o eroare custom (declarată cu error Nume(...) și aruncată cu revert Nume(...)). Numele îți spune ce regulă a picat, iar valorile dintre paranteze sunt argumentele cu care a fost aruncată. Caută revert-ul în contract și compară condiția cu valorile primite.

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

Ce înseamnă

Din Solidity 0.8.4 poți declara erori proprii: error StocInsuficient(uint256 cerut, uint256 disponibil); și le arunci cu if (cantitate > stoc) revert StocInsuficient(cantitate, stoc);. Sunt mai ieftine decât mesajele text din require și pot transporta valori.

Mesajul reverted with custom error 'StocInsuficient(5, 5)' îți dă două informații: numele erorii (ce regulă a fost încălcată) și argumentele ei, în ordinea din declarație. Aici, s-au cerut 5 bucăți și erau disponibile 5, deci, de fapt, comanda ar fi trebuit să treacă: semn că problema e în condiția din contract, nu în apel.

Dacă unealta nu cunoaște ABI-ul contractului, vezi doar datele brute (un selector de 4 octeți, de exemplu 0x... urmat de valori), fără nume. Atunci decodează-le cu ABI-ul: contract.interface.parseError(data) în ethers.

De ce apare: cauzele frecvente

1Condiția care aruncă eroarea e greșită

Greșit
SOLIDITY
if (cantitate >= stoc) revert StocInsuficient(cantitate, stoc);
Corect
SOLIDITY
if (cantitate > stoc) revert StocInsuficient(cantitate, stoc);

Cu >=, comanda pentru tot stocul (5 din 5) e respinsă. Argumentele erorii (5, 5) arată imediat problema.

2Apelul chiar încalcă regula

Greșit
SOLIDITY
await depozit.scoate(10); // în stoc sunt 3
Corect
SOLIDITY
const disponibil = await depozit.stoc();
await depozit.scoate(disponibil < 10n ? disponibil : 10n);

Uneori eroarea e corectă și protejează contractul: verifică starea înainte de apel sau tratează eroarea în aplicație.

3Eroare dintr-un contract moștenit sau apelat

Greșit
SOLIDITY
await token.transfer(bogdan.address, ethers.parseEther("1000"));
// ERC20InsufficientBalance(...)
Corect
SOLIDITY
if ((await token.balanceOf(ana.address)) >= suma) {
    await token.transfer(bogdan.address, suma);
}

Erorile custom pot veni și din OpenZeppelin (ERC20InsufficientBalance, OwnableUnauthorizedAccount). Numele lor spune ce lipsește.

Repară tu

Repară eroarea, direct în pagină

Contractul Depozit respinge comenzile mai mari decât stocul cu eroarea custom StocInsuficient(cerut, disponibil). Scriptul pornește cu 5 bucăți și comandă toate 5, dar primește StocInsuficient(5, 5). Repară condiția, ca o comandă egală cu stocul să treacă, iar una mai mare să fie respinsă. Scriptul comandă 5 bucăți, afișează stocul și apoi încearcă încă o bucată.

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

contract Depozit {
    error StocInsuficient(uint256 cerut, uint256 disponibil);

    uint256 public stoc = 5;

    function scoate(uint256 cantitate) external {
        if (cantitate >= stoc) revert StocInsuficient(cantitate, stoc);
        stoc -= cantitate;
    }
}
După reparație, programul afișează
Stoc: 0
Încă una: StocInsuficient(1, 0)
Indiciu

Uită-te la argumentele erorii: cerut 5, disponibil 5.

Alte forme ale mesajului

  • execution reverted: custom error 'StocInsuficient(5, 5)'
  • Error: VM Exception while processing transaction: reverted with an unrecognized custom error (return data: 0x...)

Cum o eviți pe viitor

  • Dă erorilor nume care descriu regula și include valorile relevante ca parametri.
  • Testează limitele exacte (stocul întreg, suma exactă, termenul exact) pentru fiecare condiție care aruncă o eroare.
  • În teste, verifică eroarea și argumentele: revertedWithCustomError(c, "StocInsuficient").withArgs(6, 5).

Întrebări frecvente

Erorile custom sunt mai bune decât require cu mesaj?

De obicei, da: bytecode-ul e mai mic, revert-ul costă mai puțin gas și poți trimite valori. Din Solidity 0.8.27 poți folosi erori custom și direct în require(conditie, Eroare(...)).

De ce văd doar „unrecognized custom error” și un șir hex?

Unealta nu are ABI-ul contractului care a aruncat eroarea (de exemplu, a venit dintr-un contract apelat). Primii 4 octeți sunt selectorul erorii; îi poți decoda cu ABI-ul acelui contract.

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.