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

DeclarationError: Receive ether function must be payable, but is "nonpayable".

Pe scurt

Funcția receive există ca să primească ether, deci trebuie să fie external payable. Scrie receive() external payable { }. Aceeași regulă cere external: public sau internal nu sunt permise.

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

Ce înseamnă

receive() e funcția specială care rulează când cineva trimite ether contractului fără date (un transfer simplu din portofel, transfer, send, call{value: x}("")). Rostul ei e să accepte plata, de aceea compilatorul cere ca semnătura să fie exact receive() external payable. Fără payable, funcția ar respinge orice ether, ceea ce nu are sens.

Mesajul are două forme apropiate: must be payable, but is "nonpayable" când lipsește payable (sau ai pus view), și must be defined as "external" când ai scris public. Funcția nu are parametri, nu întoarce nimic și nu are function în față.

În corpul ei poți actualiza un sold sau emite un eveniment, dar ține-o scurtă: un transfer cu transfer/send îi dă doar 2300 de gas, prea puțin pentru o scriere în storage.

De ce apare: cauzele frecvente

1receive fără payable

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

payable permite funcției să primească ether.

2receive declarat public

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

receive poate fi apelat doar din afară, la un transfer, deci vizibilitatea e mereu external.

3receive care face prea mult

Greșit
SOLIDITY
receive() external payable {
    donatori.push(msg.sender);
    total += msg.value;
}
Corect
SOLIDITY
event Donatie(address cine, uint256 suma);
receive() external payable {
    emit Donatie(msg.sender, msg.value);
}

Nu e eroare de compilare, dar cu transfer sau send funcția primește doar 2300 de gas, iar scrierile în storage nu încap. Un eveniment încape.

Repară tu

Repară eroarea, direct în pagină

Contractul Pusculita trebuie să primească ether trimis direct, dar compilarea dă DeclarationError: Receive ether function must be payable, but is "nonpayable". Repară semnătura funcției receive. Scriptul trimite 0,25 ETH din contul anei și afișează soldul pușculiței.

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

contract Pusculita {
    receive() external {}

    function sold() external view returns (uint256) {
        return address(this).balance;
    }
}
După reparație, programul afișează
Sold: 0.25 ETH
Indiciu

Funcția care primește ether trebuie să fie payable.

Alte forme ale mesajului

  • DeclarationError: Receive ether function must be defined as "external".
  • DeclarationError: Receive ether function cannot take parameters.

Cum o eviți pe viitor

  • Copiază semnătura exactă: receive() external payable { }.
  • Ține corpul scurt (un eveniment) sau gol; pentru logică, oferă o funcție normală depune() external payable.
  • Testează un transfer simplu către contract, nu doar apelurile de funcții.
  • Dacă un contract nu trebuie să primească ether direct, nu-i pune receive deloc.

Întrebări frecvente

Pot avea receive și o funcție depune payable?

Da, și e chiar recomandat: depune() pentru apelurile din aplicație (poate primi parametri, emite evenimente detaliate), receive() pentru transferurile simple din portofel.

De ce nu primește parametri?

Pentru că rulează doar când tranzacția nu are date. Dacă vin date, Solidity caută o funcție după selector sau ajunge la fallback.

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.