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

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.

Pe scurt

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.

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

Ce înseamnă

msg.value este suma de ether (în wei) trimisă împreună cu apelul. Doar funcțiile marcate payable pot primi ether; o funcție obișnuită respinge automat orice apel care vine cu ether. De aceea, într-o funcție ne-payable, msg.value ar fi mereu 0, iar compilatorul consideră că folosirea lui e aproape sigur o greșeală.

Mesajul îți dă două reparații: marchezi funcția payable (cazul obișnuit: funcția chiar trebuie să primească bani) sau, dacă ai pus logica într-o funcție ajutătoare, o faci internal și o apelezi dintr-o funcție payable. Funcțiile internal și private pot citi msg.value, pentru că rulează în aceeași tranzacție ca funcția care le apelează.

callvalue() este echivalentul din assembly (Yul) al lui msg.value.

De ce apare: cauzele frecvente

1Funcție de plată fără payable

Greșit
SOLIDITY
function doneaza() external {
    donatii[msg.sender] += msg.value;
}
Corect
SOLIDITY
function doneaza() external payable {
    donatii[msg.sender] += msg.value;
}

payable permite funcției să primească ether, iar msg.value capătă sens.

2Verificare de preț într-o funcție public ajutătoare

Greșit
SOLIDITY
function verificaPlata() public view {
    require(msg.value == PRET, "Pret gresit");
}
Corect
SOLIDITY
function _verificaPlata() internal view {
    require(msg.value == PRET, "Pret gresit");
}

O funcție internal citește msg.value-ul funcției payable care o apelează.

3Constructor care primește ether

Greșit
SOLIDITY
constructor() {
    depozitInitial = msg.value;
}
Corect
SOLIDITY
constructor() payable {
    depozitInitial = msg.value;
}

Și constructorul trebuie marcat payable dacă vrei să trimiți ether la publicarea contractului.

Repară tu

Repară eroarea, direct în pagină

Contractul FondDonatii nu se compilează și dă TypeError: "msg.value" and "callvalue()" can only be used in payable public functions. Funcția doneaza trebuie să primească ether și să salveze cât a donat fiecare. Repară declarația ei. Scriptul o pune pe ana să doneze 0,5 ETH și pe bogdan 0,2 ETH, apoi afișează donația anei și soldul fondului.

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

contract FondDonatii {
    mapping(address => uint256) public donatii;

    function doneaza() external {
        require(msg.value > 0, "Donatie zero");
        donatii[msg.sender] += msg.value;
    }
}
După reparație, programul afișează
Ana a donat: 0.5 ETH
Sold fond: 0.7 ETH
Indiciu

Funcțiile care primesc ether sunt marcate cu un cuvânt special lângă external.

Cum o eviți pe viitor

  • Când o funcție trebuie să primească bani, scrie payable din prima, lângă vizibilitate.
  • Nu marca payable funcțiile care nu au nevoie: așa, ether-ul trimis din greșeală e respins automat.
  • Pentru ether trimis direct la contract, fără apel de funcție, folosește receive() external payable.

Întrebări frecvente

Ce se întâmplă dacă trimit ether unei funcții care nu e payable?

Tranzacția dă revert înainte să ruleze codul funcției, iar banii rămân la tine (plătești doar gas-ul consumat). În Hardhat mesajul este non-payable function was called with value ....

msg.value e în ether sau în wei?

Mereu în wei: 1 ether = 10^18 wei. În cod poți scrie msg.value == 0.01 ether, iar compilatorul convertește unitatea în wei.

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.