VM Exception while processing transaction: reverted with custom error 'ERC20InsufficientBalance("0x04ae6DbF040c923A896958997fc6B85B97e65f45", 0, 100000000000000000000)'
Adresa din care pleacă tokenii (primul argument) are un sold mai mic decât suma transferată: soldul e al doilea argument, suma cerută al treilea. Verifică cine deține de fapt tokenii (de multe ori i-ai emis altei adrese) și unitățile (suma e în cea mai mică unitate, cu 18 zecimale).
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
ERC20InsufficientBalance(sender, balance, needed) e eroarea custom pe care tokenurile OpenZeppelin 5 o dau când transfer, transferFrom sau _burn încearcă să scoată dintr-o adresă mai mult decât are. Argumentele spun tot: sender e adresa din care se scot tokenii, balance e soldul ei actual, needed e suma cerută. În OpenZeppelin 4, aceeași situație dădea mesajul ERC20: transfer amount exceeds balance.
Cauzele frecvente:
- tokenii au fost emiși altei adrese decât crezi (
_mint(msg.sender, ...)în constructor, dar contractul încearcă să plătească din propriul sold,address(this)); - suma e scrisă în tokeni întregi într-un loc și în unități în altul (100 față de 100 × 10^18);
- scriptul folosește alt cont decât cel care are tokenii (lipsește
connect(...)).
Compară sender din eroare cu adresele pe care le cunoști: contul tău, al contractului, al altui utilizator.
De ce apare: cauzele frecvente
1Tokenii emiși deployer-ului, plătiți din contract
constructor() ERC20("Lei", "LEI") {
_mint(msg.sender, 1000 ether);
}
function plateste(address angajat) external {
_transfer(address(this), angajat, 100 ether);
}constructor() ERC20("Lei", "LEI") {
_mint(address(this), 1000 ether);
}
function plateste(address angajat) external {
_transfer(address(this), angajat, 100 ether);
}Contractul poate plăti doar din tokenii pe care îi deține el, la adresa address(this).
2Sumă fără zecimale într-un loc, cu zecimale în altul
await token.transfer(bogdan.address, ethers.parseEther("500")); // soldul anei: 100 tokeniawait token.transfer(bogdan.address, ethers.parseEther("50"));parseEther("500") înseamnă 500 de tokeni cu 18 zecimale; verifică soldul înainte.
3Transfer din contul greșit
await token.transfer(cristina.address, ethers.parseEther("10")); // tokenii sunt ai lui bogdanawait token.connect(bogdan).transfer(cristina.address, ethers.parseEther("10"));transfer scoate mereu din contul care semnează tranzacția.
Repară eroarea, direct în pagină
Contractul Salarii emite 1000 de tokeni LEI și plătește din propriul sold câte 100 fiecărui angajat, dar plata dă ERC20InsufficientBalance cu soldul 0. Repară constructorul, ca tokenii emiși să ajungă în contract. Scriptul plătește salariul lui bogdan și afișează soldurile lui bogdan și al contractului.
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.20;
import {ERC20} from "./ERC20.sol";
contract Salarii is ERC20 {
constructor() ERC20("Lei", "LEI") {
_mint(msg.sender, 1000 ether);
}
function plateste(address angajat) external {
_transfer(address(this), angajat, 100 ether);
}
}Bogdan: 100.0 LEI Contract: 900.0 LEI
Indiciu
Contractul plătește din address(this), deci acolo trebuie emiși tokenii.
Reparația
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.20;
import {ERC20} from "./ERC20.sol";
contract Salarii is ERC20 {
constructor() ERC20("Lei", "LEI") {
_mint(address(this), 1000 ether);
}
function plateste(address angajat) external {
_transfer(address(this), angajat, 100 ether);
}
}De ce merge
Eroarea ERC20InsufficientBalance(adresa contractului, 0, 100 LEI) arăta că adresa care plătea, contractul, avea sold 0: tokenii fuseseră emiși către msg.sender, adică ana. Cu _mint(address(this), 1000 ether), contractul deține cei 1000 de tokeni și poate plăti din ei: bogdan primește 100, iar contractului îi rămân 900.
Alte forme ale mesajului
execution reverted: custom error 'ERC20InsufficientBalance(0x04ae6DbF040c923A896958997fc6B85B97e65f45, 0, 100000000000000000000)'ERC20: transfer amount exceeds balanceERC20: burn amount exceeds balance
Cum o eviți pe viitor
- Hotărăște de la început cine primește supply-ul inițial (deployer-ul, contractul, o trezorerie) și scrie asta în constructor.
- Lucrează mereu în unități cu zecimale:
ethers.parseUnits("10", await token.decimals()). - Afișează soldurile înainte de transferuri când depanezi.
- În contracte, verifică soldul cu un mesaj propriu dacă vrei o eroare mai clară pentru utilizator.
Întrebări frecvente
Cum citesc argumentele erorii?
Primul e adresa din care se scot tokenii, al doilea soldul ei, al treilea suma cerută. Ambele sume sunt în cea mai mică unitate: 100000000000000000000 înseamnă 100 de tokeni cu 18 zecimale.
De ce primesc eroarea la transferFrom, deși am aprobat suma?
Pentru că aprobarea (allowance) și soldul sunt verificate separat. Dacă proprietarul a aprobat 100, dar are doar 50, primești ERC20InsufficientBalance; dacă are 100, dar a aprobat 50, primești ERC20InsufficientAllowance.
Erori înrudite
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 '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. VM Exception while processing transaction: reverted with custom error 'AccessControlUnauthorizedAccount("0xFe95ca6E619dF220150A486849D34dD898bfbF41", "0x9f2df0fed2c77648de5860a4cc508cd0818c85b8b8a1ab4ceeef8d981c8956a6")' Contul din primul argument nu are rolul cerut de funcție (al doilea argument, hash-ul rolului, de exemplu keccak256("MINTER_ROLE")). Dă-i rolul cu grantRole (din contul de admin) sau din constructor cu _grantRole, ori apelează funcția din contul care are rolul. Î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.
