...
Eroare Solidity · Importuri și erorile OpenZeppelin

VM Exception while processing transaction: reverted with custom error 'ERC20InsufficientAllowance("0x5FbDB2315678afecb367f032d93F642f64180aa3", 0, 30000000000000000000)'

Pe scurt

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.

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

Ce înseamnă

La ERC-20, un contract nu îți poate lua tokenii fără aprobare. Fluxul are doi pași: întâi tu apelezi token.approve(spender, suma), prin care dai voie contractului spender să cheltuiască până la suma din tokenii tăi; apoi contractul apelează token.transferFrom(tu, el, suma).

Eroarea custom ERC20InsufficientAllowance(address spender, uint256 allowance, uint256 needed) din OpenZeppelin 5 apare la al doilea pas, când aprobarea lipsește sau e prea mică. Parametrii spun tot: spender este contractul care a încercat să ia tokenii (magazinul, nu tu), allowance cât i-ai aprobat (aici 0), needed cât a încercat să ia, în unitatea cea mai mică (30 de tokeni cu 18 zecimale = 30000000000000000000).

În OpenZeppelin 4, mesajul echivalent era ERC20: insufficient allowance.

De ce apare: cauzele frecvente

1Ai uitat approve înainte de cumpărare

Greșit
SOLIDITY
await magazin.connect(bogdan).cumpara(1);
Corect
SOLIDITY
await token.connect(bogdan).approve(magazin.target, pret);
await magazin.connect(bogdan).cumpara(1);

approve trebuie făcut de cel care plătește, către adresa contractului care face transferFrom.

2Ai aprobat altă adresă sau altă sumă

Greșit
SOLIDITY
await token.connect(bogdan).approve(ana.address, ethers.parseEther("30"));
await magazin.connect(bogdan).cumpara(2); // costă 60
Corect
SOLIDITY
await token.connect(bogdan).approve(magazin.target, ethers.parseEther("60"));
await magazin.connect(bogdan).cumpara(2);

Aprobarea e per pereche (proprietar, spender) și per sumă. Trebuie aprobat contractul, pentru cel puțin suma cheltuită.

3Contractul își trimite propriii tokeni cu transferFrom

Greșit
SOLIDITY
token.transferFrom(address(this), client, suma);
Corect
SOLIDITY
token.transfer(client, suma);

Pentru tokenii pe care îi deține, contractul folosește transfer. transferFrom cere aprobare chiar și când from este chiar contractul.

Repară tu

Repară eroarea, direct în pagină

Scriptul de mai jos (fișierul test.js) publică tokenul Moneda și MagazinTokeni (un produs costă 30 MON), îi dă lui bogdan 100 MON și îl pune să cumpere un produs. Cumpărarea dă ERC20InsufficientAllowance, pentru că magazinul ia plata cu transferFrom. Adaugă pasul lipsă înaintea cumpărării, ca bogdan să-i dea magazinului voie să ia 30 MON. Scriptul afișează apoi soldurile.

Codul care dă eroarea
SOLIDITY
const eth = (x) => ethers.parseEther(x);
const fmt = (x) => ethers.formatEther(x);
const t = await deploy("Moneda");
const m = await deploy("MagazinTokeni", t.target, eth("30"));
await t.transfer(bogdan.address, eth("100"));

await m.connect(bogdan).cumpara(1);

console.log("Bogdan:", fmt(await t.balanceOf(bogdan.address)), "MON");
console.log("Magazin:", fmt(await t.balanceOf(m.target)), "MON");
console.log("Cumpărate:", await m.cumparate(bogdan.address));
După reparație, programul afișează
Bogdan: 70.0 MON
Magazin: 30.0 MON
Cumpărate: 1
Indiciu

Bogdan trebuie să apeleze approve pe token, pentru adresa magazinului (m.target).

Alte forme ale mesajului

  • execution reverted: custom error 'ERC20InsufficientAllowance(0x5FbDB2315678afecb367f032d93F642f64180aa3, 0, 30000000000000000000)'
  • ERC20: insufficient allowance

Cum o eviți pe viitor

  • În aplicații și teste, scrie mereu perechea: approve (de la cel care plătește, pentru contract), apoi apelul care face transferFrom.
  • Citește allowance(proprietar, spender) înainte de cumpărare, ca să ceri aprobare doar când lipsește.
  • În contracte, folosește transfer pentru tokenii proprii și transferFrom doar pentru tokenii altora.

Întrebări frecvente

De ce e nevoie de doi pași? Nu se poate plăti direct?

Un contract nu poate fi anunțat automat când primește tokeni ERC-20 printr-un transfer simplu, deci nu știe cine a plătit și pentru ce. Cu approve + transferFrom, contractul ia el plata în aceeași tranzacție în care îți dă produsul.

E periculos să aprob o sumă foarte mare (MaxUint256)?

E comod, dar dacă acel contract are un bug sau e compromis, îți poate lua toți tokenii de acel tip. Pentru siguranță, aprobă doar suma necesară.

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.