...
Eroare Solidity · Importuri și erorile OpenZeppelin

VM Exception while processing transaction: reverted with custom error 'ERC20InsufficientBalance("0x04ae6DbF040c923A896958997fc6B85B97e65f45", 0, 100000000000000000000)'

Pe scurt

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

Greșit
SOLIDITY
constructor() ERC20("Lei", "LEI") {
    _mint(msg.sender, 1000 ether);
}
function plateste(address angajat) external {
    _transfer(address(this), angajat, 100 ether);
}
Corect
SOLIDITY
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

Greșit
SOLIDITY
await token.transfer(bogdan.address, ethers.parseEther("500")); // soldul anei: 100 tokeni
Corect
SOLIDITY
await token.transfer(bogdan.address, ethers.parseEther("50"));

parseEther("500") înseamnă 500 de tokeni cu 18 zecimale; verifică soldul înainte.

3Transfer din contul greșit

Greșit
SOLIDITY
await token.transfer(cristina.address, ethers.parseEther("10")); // tokenii sunt ai lui bogdan
Corect
SOLIDITY
await token.connect(bogdan).transfer(cristina.address, ethers.parseEther("10"));

transfer scoate mereu din contul care semnează tranzacția.

Repară tu

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.

Codul care dă eroarea
SOLIDITY
// 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);
    }
}
După reparație, programul afișează
Bogdan: 100.0 LEI
Contract: 900.0 LEI
Indiciu

Contractul plătește din address(this), deci acolo trebuie emiși tokenii.

Alte forme ale mesajului

  • execution reverted: custom error 'ERC20InsufficientBalance(0x04ae6DbF040c923A896958997fc6B85B97e65f45, 0, 100000000000000000000)'
  • ERC20: transfer amount exceeds balance
  • ERC20: 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

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