DeclarationError: Receive ether function must be payable, but is "nonpayable".
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
receive() external {}receive() external payable {}payable permite funcției să primească ether.
2receive declarat public
receive() public payable {}receive() external payable {}receive poate fi apelat doar din afară, la un transfer, deci vizibilitatea e mereu external.
3receive care face prea mult
receive() external payable {
donatori.push(msg.sender);
total += msg.value;
}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ă 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.
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.20;
contract Pusculita {
receive() external {}
function sold() external view returns (uint256) {
return address(this).balance;
}
}Sold: 0.25 ETH
Indiciu
Funcția care primește ether trebuie să fie payable.
Reparația
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.20;
contract Pusculita {
receive() external payable {}
function sold() external view returns (uint256) {
return address(this).balance;
}
}De ce merge
receive rulează la transferurile simple de ether, deci trebuie să poată primi ether: compilatorul cere external payable. Fără payable, funcția ar respinge orice transfer, așa că declarația e refuzată. Cu receive() external payable {}, cei 0,25 ETH ajung în pușculiță.
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
receivedeloc.
Î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
ParserError: Expected a state variable declaration. If you intended this as a fallback function or a function to handle plain ether transactions, use the "fallback" keyword or the "receive" keyword instead. Ai scris funcția fără nume din versiunile vechi, function() external payable { }. Din Solidity 0.6 ea s-a împărțit în două: receive() external payable { } pentru ether trimis direct și fallback() external { } pentru apeluri necunoscute. Transaction reverted without a reason string Tranzacția a dat revert fără niciun mesaj: un require fără text, un revert() gol, ether trimis unui contract fără receive, o funcție care nu există în contract sau un apel către o adresă greșită. Verifică pe rând aceste cauze; pentru receive lipsă, adaugă receive() external payable {}. TypeError: "msg.value" and "callvalue()" can only be used in payable public functions. Make the function "payable" or use an internal function to avoid this error. Folosești msg.value (ether-ul trimis cu tranzacția) într-o funcție care nu e payable, deci nu poate primi ether. Adaugă payable în declarația funcției: function doneaza() external payable. Î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.
