VM Exception while processing transaction: reverted with custom error 'StocInsuficient(5, 5)'
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ă
if (cantitate >= stoc) revert StocInsuficient(cantitate, stoc);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
await depozit.scoate(10); // în stoc sunt 3const 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
await token.transfer(bogdan.address, ethers.parseEther("1000"));
// ERC20InsufficientBalance(...)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ă 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ă.
// 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;
}
}Stoc: 0 Încă una: StocInsuficient(1, 0)
Indiciu
Uită-te la argumentele erorii: cerut 5, disponibil 5.
Reparația
// 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;
}
}De ce merge
Argumentele erorii, StocInsuficient(5, 5), arătau că s-a cerut exact cât era disponibil, deci regula fusese scrisă prea strict. Cu cantitate > stoc, comanda pentru tot stocul trece și stocul ajunge la 0, iar următoarea bucată e respinsă cu StocInsuficient(1, 0). Erorile custom cu parametri îți arată valorile, nu doar faptul că ceva a picat.
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
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 custom error 'ERC20InsufficientAllowance("0x5FbDB2315678afecb367f032d93F642f64180aa3", 0, 30000000000000000000)' Un contract a încercat să ia tokeni din contul tău cu transferFrom, dar nu i-ai dat voie (sau i-ai dat voie pentru o sumă mai mică). Apelează întâi token.approve(adresaContractului, suma) din contul care plătește, apoi funcția care face transferFrom. VM Exception while processing transaction: reverted with custom error 'OwnableUnauthorizedAccount("0xFe95ca6E619dF220150A486849D34dD898bfbF41")' O funcție protejată cu onlyOwner a fost apelată de alt cont decât proprietarul contractului. Apelează-o din contul proprietarului (sau transferă proprietatea) și verifică cine a fost setat proprietar la publicare, prin Ownable(...). Î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.
