...
Eroare Solidity · Ether: payable, transfer și call

TypeError: Fallback function must be defined as "external".

Pe scurt

Funcția fallback() trebuie să aibă vizibilitatea external, nu public. Scrie fallback() external (cu payable dacă primește ether). La fel și receive() external payable.

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

Ce înseamnă

fallback() e funcția specială apelată când cineva cheamă contractul cu o funcție care nu există sau trimite ether cu date, iar receive() e apelată pentru transferurile simple de ether. Amândouă sunt apelate doar din afara contractului, de aceea Solidity cere vizibilitatea external. Dacă scrii public, internal sau private, primești Fallback function must be defined as "external".

Greșeala apare des după trecerea de la sintaxa veche, function () public payable { }, la cea nouă: oamenii păstrează public din obișnuință. Forma corectă este:

  • fallback() external payable { } dacă trebuie să primească ether;
  • fallback() external { } dacă doar tratează apeluri necunoscute;
  • receive() external payable { } pentru transferuri simple, unde payable e obligatoriu.

Nu se scrie cuvântul function în fața lor și nu au nume.

De ce apare: cauzele frecvente

1fallback declarat public

Greșit
SOLIDITY
fallback() public payable {
    apeluri += 1;
}
Corect
SOLIDITY
fallback() external payable {
    apeluri += 1;
}

Funcțiile speciale sunt mereu external.

2Sintaxă veche adaptată pe jumătate

Greșit
SOLIDITY
function() public payable { }
Corect
SOLIDITY
receive() external payable { }

Forma function() fără nume nu mai e acceptată din 0.6; pentru ether simplu folosești receive.

3receive declarat public

Greșit
SOLIDITY
receive() public payable { }
Corect
SOLIDITY
receive() external payable { }

Aici mesajul e Receive ether function must be defined as "external".

Repară tu

Repară eroarea, direct în pagină

Contractul Donatii primește ether trimis direct, prin funcția fallback, dar compilarea dă TypeError: Fallback function must be defined as "external".. Repară vizibilitatea funcției. Scriptul trimite 2 ETH către contract din contul anei și afișează numărul de donații și soldul contractului.

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

contract Donatii {
    uint256 public numar;

    fallback() public payable {
        numar += 1;
    }
}
După reparație, programul afișează
Donații: 1
Sold: 2.0 ETH
Indiciu

Funcțiile speciale (fallback, receive) sunt mereu external.

Alte forme ale mesajului

  • TypeError: Receive ether function must be defined as "external".

Cum o eviți pe viitor

  • Scrie mereu funcțiile speciale exact așa: receive() external payable și fallback() external [payable].
  • Folosește receive pentru ether simplu și fallback pentru apeluri necunoscute.
  • Păstrează-le scurte: un transfer simplu (transfer, send) le dă doar 2300 de gas.
  • Nu scrie cuvântul function în fața lor și nu le da nume.

Întrebări frecvente

Am nevoie și de receive, dacă am fallback payable?

Nu e obligatoriu: dacă lipsește receive, un transfer simplu de ether ajunge în fallback payable. E totuși mai clar să le ai separat: receive pentru bani, fallback pentru apeluri greșite.

Poate fallback să primească parametri?

Poate avea forma fallback(bytes calldata date) external returns (bytes memory), ca să citească datele apelului. Altfel le citești din msg.data.

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.