Transaction ran out of gas
Tranzacția a consumat tot gas-ul pe care l-a primit (gasLimit) înainte să se termine, de obicei din cauza unei bucle care scrie de multe ori în storage sau a unei limite de gas setate prea mic. Fă funcția să lucreze în pași constanți (fără bucle care cresc cu datele) sau mărește gasLimit-ul.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Fiecare operație din EVM costă gas, iar fiecare tranzacție are o limită (gasLimit), dată de portofel, de script sau de estimarea automată. Dacă execuția ajunge la limită, se oprește: toate modificările sunt anulate, dar gas-ul consumat se plătește, spre deosebire de un require simulat înainte de trimitere.
Scrierea în storage este cea mai scumpă operație obișnuită (prima scriere într-un slot costă în jur de 20 000 de gas, următoarele câteva mii). O buclă care scrie la fiecare pas o variabilă de stare, peste un array care tot crește, ajunge repede la sute de mii sau milioane de gas. Peste limita blocului (30 de milioane pe mainnet), nicio tranzacție nu o mai poate executa, iar funcția devine blocată definitiv.
Dacă nu setezi gasLimit, ethers estimează gas-ul înainte de trimitere; atunci problema apare ca eroare de estimare (gas required exceeds allowance) sau ca revert fără motiv.
De ce apare: cauzele frecvente
1Buclă care scrie în storage la fiecare pas
function adaugaPuncte(uint256 puncte) external {
for (uint256 i = 0; i < puncte; i++) {
sold[msg.sender] += 1;
}
}function adaugaPuncte(uint256 puncte) external {
sold[msg.sender] += puncte;
}O singură scriere costă la fel indiferent de număr; bucla plătește o scriere pentru fiecare punct.
2Buclă peste un array care crește la nesfârșit
function platesteToti() external {
for (uint256 i = 0; i < participanti.length; i++) {
deRetras[participanti[i]] += premiu;
}
}function revendica() external {
require(!revendicat[msg.sender], "Deja revendicat");
revendicat[msg.sender] = true;
deRetras[msg.sender] += premiu;
}Cu cât sunt mai mulți participanți, cu atât bucla costă mai mult, până nu mai încape într-un bloc. Fiecare își face singur partea, cu cost constant.
3gasLimit setat manual prea mic
await c.inregistreaza("Ana", { gasLimit: 30000 });await c.inregistreaza("Ana"); // lasă ethers să estimezeO limită fixă, copiată dintr-un exemplu, poate fi sub costul real al funcției, mai ales la prima scriere în storage.
Repară eroarea, direct în pagină
Contractul PunctFidelitate adaugă puncte unui client cu o buclă care crește soldul cu câte 1. Scriptul îi adaugă anei 500 de puncte cu un gasLimit de 200 000 (ca un portofel), iar tranzacția rămâne fără gas (Transaction ran out of gas). Rescrie adaugaPuncte ca să facă o singură actualizare, cu cost constant, fără buclă. Scriptul afișează soldul anei după două adăugări.
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.20;
contract PunctFidelitate {
mapping(address => uint256) public sold;
function adaugaPuncte(uint256 puncte) external {
for (uint256 i = 0; i < puncte; i++) {
sold[msg.sender] += 1;
}
}
}Sold Ana: 750
Indiciu
Adună direct puncte la sold, într-un singur pas.
Reparația
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.20;
contract PunctFidelitate {
mapping(address => uint256) public sold;
function adaugaPuncte(uint256 puncte) external {
sold[msg.sender] += puncte;
}
}De ce merge
Fiecare pas al buclei citea și scria în storage, deci 500 de puncte însemnau 500 de scrieri, cu mult peste cele 200 000 de unități de gas primite. Tranzacția s-a oprit la jumătate și a fost anulată, cu gas-ul plătit. sold[msg.sender] += puncte; face o singură scriere, cu același cost pentru 5 sau pentru 5 milioane de puncte, iar soldul anei ajunge la 750.
Alte forme ale mesajului
out of gasgas required exceeds allowance (30000000)EvmError: OutOfGas
Cum o eviți pe viitor
- Evită buclele a căror lungime depinde de date controlate de utilizatori; preferă mapping-uri și operații cu cost constant.
- Când ai de făcut ceva pentru mulți utilizatori, folosește modelul revendicării (fiecare își cere partea).
- Măsoară gas-ul în teste (
estimateGas, raportul de gas din Hardhat) pentru cazurile mari, nu doar pentru cele mici. - Nu seta
gasLimitmanual fără motiv.
Întrebări frecvente
Primesc înapoi gas-ul dacă tranzacția rămâne fără gas?
Nu. Gas-ul consumat până la oprire se plătește, chiar dacă starea e anulată. De aceea e important ca portofelul să estimeze gas-ul înainte: o estimare eșuată te avertizează fără să plătești nimic.
Funcțiile view pot rămâne fără gas?
Da, și ele au o limită când sunt apelate de un nod (de obicei mare, dar finită). O funcție view care parcurge un array uriaș poate eșua la citire, deși nu costă bani.
Erori înrudite
Transaction reverted without a reason string Tranzacția a dat revert fără niciun mesaj: un require fără text, un revert() gol, ether trimis unui contract fără receive, o funcție care nu există în contract sau un apel către o adresă greșită. Verifică pe rând aceste cauze; pentru receive lipsă, adaugă receive() external payable {}. VM Exception while processing transaction: reverted with panic code 0x32 (Array accessed at an out-of-bounds or negative index) Ai citit sau scris un element de array la un index care nu există: indexul e egal cu length sau mai mare (de exemplu i <= v.length într-o buclă) ori array-ul e gol. Indicii merg de la 0 la length - 1, deci bucla corectă este for (i = 0; i < v.length; i++). Î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.
