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.
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
await magazin.connect(bogdan).cumpara(1);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ă
await token.connect(bogdan).approve(ana.address, ethers.parseEther("30"));
await magazin.connect(bogdan).cumpara(2); // costă 60await 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
token.transferFrom(address(this), client, suma);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ă 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.
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));Bogdan: 70.0 MON Magazin: 30.0 MON Cumpărate: 1
Indiciu
Bogdan trebuie să apeleze approve pe token, pentru adresa magazinului (m.target).
Reparația
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 t.connect(bogdan).approve(m.target, eth("30"));
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));De ce merge
cumpara apelează token.transferFrom(bogdan, magazin, 30 MON), iar ERC-20 permite asta doar dacă bogdan a aprobat dinainte magazinul ca spender. Fără aprobare, allowance-ul era 0 și tokenul a dat revert cu ERC20InsufficientAllowance(adresa magazinului, 0, 30 MON). După t.connect(bogdan).approve(m.target, eth("30")), plata trece: bogdan rămâne cu 70 MON, magazinul are 30.
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 facetransferFrom. - Citește
allowance(proprietar, spender)înainte de cumpărare, ca să ceri aprobare doar când lipsește. - În contracte, folosește
transferpentru tokenii proprii șitransferFromdoar 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
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 '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(...). 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. Î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.
