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

DeclarationError: Only one receive function is allowed.

Pe scurt

Un contract poate avea o singură funcție receive() și o singură fallback(). Ai două, de obicei după un copy-paste sau după ce ai adăugat a doua logică. Unește-le într-o singură funcție care face ambele lucruri.

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

Ce înseamnă

receive și fallback sunt funcții speciale, fără nume și fără selector: EVM-ul le alege după forma tranzacției (fără date → receive, date necunoscute → fallback). Pentru că nu au nume, nu pot fi supraîncărcate, deci fiecare poate exista o singură dată într-un contract. A doua declarație dă Only one receive function is allowed. (sau, pentru fallback, Only one fallback function is allowed.).

Se întâmplă când adaugi o funcție nouă pentru ether (de exemplu, un eveniment sau un total) fără să observi că receive există deja mai sus în fișier. Reparația: o singură receive care face tot.

În moștenire, un contract derivat poate redefini receive doar dacă cea din bază e virtual și cea nouă are override; tot una singură rămâne activă.

De ce apare: cauzele frecvente

1Două funcții receive cu roluri diferite

Greșit
SOLIDITY
receive() external payable { depuneri += 1; }
receive() external payable { total += msg.value; }
Corect
SOLIDITY
receive() external payable {
    depuneri += 1;
    total += msg.value;
}

O singură funcție poate face ambele actualizări.

2Două funcții fallback

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

Aceeași regulă: un singur fallback pe contract.

Repară tu

Repară eroarea, direct în pagină

Contractul Donatii are două funcții receive: una numără donațiile, cealaltă adună suma, iar compilarea dă DeclarationError: Only one receive function is allowed. Unește-le într-o singură receive care face ambele lucruri. Scriptul trimite de două ori câte 100 wei și afișează numărul de donații și totalul.

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

contract Donatii {
    uint256 public numar;
    uint256 public total;

    receive() external payable {
        numar += 1;
    }

    receive() external payable {
        total += msg.value;
    }
}
După reparație, programul afișează
Donații: 2
Total: 200
Indiciu

Pune cele două instrucțiuni în aceeași funcție.

Alte forme ale mesajului

  • DeclarationError: Only one fallback function is allowed.

Cum o eviți pe viitor

  • Caută receive și fallback în contract înainte să le adaugi.
  • Ține funcțiile speciale în același loc în fișier (de obicei după constructor).
  • Păstrează-le scurte: dacă logica crește, mut-o într-o funcție internă apelată din receive.
  • La moștenire, marchează receive din contractul de bază virtual, ca derivatul să o poată extinde cu override în loc să adauge una nouă.

Întrebări frecvente

Pot avea și receive, și fallback?

Da, câte una din fiecare. Ele au roluri diferite: receive pentru ether fără date, fallback pentru apelurile cu un selector necunoscut.

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.