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

TypeError: Errors can only be used with revert statements: "revert MyError(args);", or require functions: "require(condition, MyError(args))".

Pe scurt

Ai apelat o eroare custom ca pe o funcție (StocInsuficient(5, 2);) fără revert. O eroare custom nu oprește nimic singură: scrie revert StocInsuficient(5, 2); sau, din 0.8.26, require(conditie, StocInsuficient(5, 2)).

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

Ce înseamnă

O eroare custom (error StocInsuficient(uint256 cerut, uint256 disponibil);) descrie motivul unui revert, cu parametri. Ea nu se „aruncă” singură: o folosești cu revert StocInsuficient(cerut, stoc);, care oprește tranzacția și trimite eroarea apelantului. Dacă o scrii ca pe un apel de funcție, fără revert, compilatorul spune Errors can only be used with revert statements: "revert MyError(args);", or require functions: "require(condition, MyError(args))". (MyError din mesaj e doar un exemplu, nu numele erorii tale).

Greșeala apare des la cei obișnuiți cu throw new Eroare() din alte limbaje sau când transformi un require(cond, "mesaj") în eroare custom și uiți cuvântul revert.

Din Solidity 0.8.26 poți folosi erorile custom și direct în require: require(cerut <= stoc, StocInsuficient(cerut, stoc));. În versiunile mai vechi, mesajul se termina după "revert MyError();".

De ce apare: cauzele frecvente

1Eroare apelată fără revert

Greșit
SOLIDITY
if (cantitate > stoc) {
    StocInsuficient(cantitate, stoc);
}
Corect
SOLIDITY
if (cantitate > stoc) {
    revert StocInsuficient(cantitate, stoc);
}

revert oprește tranzacția și trimite eroarea cu parametrii ei.

2Varianta cu require (0.8.26+)

Greșit
SOLIDITY
require(cantitate <= stoc, "Stoc insuficient");
Corect
SOLIDITY
require(cantitate <= stoc, StocInsuficient(cantitate, stoc));

Același efect, cu o eroare custom în loc de text.

3Eroare folosită ca valoare

Greșit
SOLIDITY
error Interzis();
bool ok = Interzis();
Corect
SOLIDITY
error Interzis();
if (!autorizat) revert Interzis();

O eroare nu are valoare; se folosește doar pentru a opri execuția.

Repară tu

Repară eroarea, direct în pagină

Contractul Depozit are eroarea custom StocInsuficient, dar funcția scoate o folosește fără revert, iar compilarea dă TypeError: Errors can only be used with revert statements. Repară funcția, ca să oprească tranzacția cu această eroare când se cere mai mult decât e în stoc. Scriptul scoate 3 bucăți din 10 și apoi încearcă să scoată 20.

Codul care dă eroarea
SOLIDITY
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.20;

contract Depozit {
    error StocInsuficient(uint256 cerut, uint256 disponibil);

    uint256 public stoc = 10;

    function scoate(uint256 cantitate) external {
        if (cantitate > stoc) {
            StocInsuficient(cantitate, stoc);
        }
        stoc -= cantitate;
    }
}
După reparație, programul afișează
Stoc: 7
Scoate 20: StocInsuficient(20, 7)
Indiciu

O eroare custom se folosește cu revert în față.

Alte forme ale mesajului

  • TypeError: Errors can only be used with revert statements: "revert MyError();".

Cum o eviți pe viitor

  • Scrie mereu erorile custom împreună cu revert sau în require(conditie, Eroare(...)).
  • Pune parametri în erori: cât s-a cerut și cât era disponibil ajută la depanare.
  • În teste, verifică eroarea cu revertedWithCustomError(contract, "StocInsuficient").
  • Declară erorile la începutul contractului, ca să fie ușor de găsit.

Întrebări frecvente

De ce să folosesc erori custom în loc de mesaje text?

Sunt mai ieftine (doar un selector de 4 bytes plus parametrii, în loc de tot textul), au parametri și pot fi decodate de ethers din ABI. Mesajele text sunt mai ușor de citit direct în consolă.

Merge require cu eroare custom în versiunea mea?

Din 0.8.26 cu compilatorul IR, iar din 0.8.27 și cu cel obișnuit. În cursul nostru (0.8.30) merge. Pe versiuni mai vechi, folosește if (...) revert Eroare(...);.

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.