...
Eroare Solidity · Revert la rulare: require, erori custom, gas

Transaction ran out of gas

Pe scurt

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

Greșit
SOLIDITY
function adaugaPuncte(uint256 puncte) external {
    for (uint256 i = 0; i < puncte; i++) {
        sold[msg.sender] += 1;
    }
}
Corect
SOLIDITY
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

Greșit
SOLIDITY
function platesteToti() external {
    for (uint256 i = 0; i < participanti.length; i++) {
        deRetras[participanti[i]] += premiu;
    }
}
Corect
SOLIDITY
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

Greșit
SOLIDITY
await c.inregistreaza("Ana", { gasLimit: 30000 });
Corect
SOLIDITY
await c.inregistreaza("Ana"); // lasă ethers să estimeze

O limită fixă, copiată dintr-un exemplu, poate fi sub costul real al funcției, mai ales la prima scriere în storage.

Repară tu

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.

Codul care dă eroarea
SOLIDITY
// 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;
        }
    }
}
După reparație, programul afișează
Sold Ana: 750
Indiciu

Adună direct puncte la sold, într-un singur pas.

Alte forme ale mesajului

  • out of gas
  • gas 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 gasLimit manual 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

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