Payable functions in Blockchain / Solidity

Introduction

Payable functions let a program receive money when someone uses them. This is important to handle payments safely and clearly.

When you want users to send money to your program, like buying a ticket.

When you need to accept donations or tips.

When creating a contract that sells digital items or services.

When you want to collect fees for using a service.

When you want to store money inside the program for later use.

Syntax

Blockchain / Solidity

function functionName() public payable {
    // function code
}

The keyword payable marks the function to accept money.

Without payable, the function will reject any money sent.

Examples

This function can receive money when called.

Blockchain / Solidity

function deposit() public payable {
    // Accept money sent to this function
}

This function checks if enough money was sent before proceeding.

Blockchain / Solidity

function buyItem() external payable {
    require(msg.value >= itemPrice, "Not enough money");
    // Process purchase
}

A simple function to accept donations.

Blockchain / Solidity

function donate() public payable {
    // Just accept donations
}

Sample Program

This contract lets anyone send money using deposit. The owner can check the balance and withdraw money.

Blockchain / Solidity

pragma solidity ^0.8.0;

contract SimpleWallet {
    address public owner;

    constructor() {
        owner = msg.sender;
    }

    // Payable function to receive money
    function deposit() public payable {
        // Money sent is stored in contract balance
    }

    // Function to check contract balance
    function getBalance() public view returns (uint) {
        return address(this).balance;
    }

    // Withdraw money by owner
    function withdraw(uint amount) public {
        require(msg.sender == owner, "Only owner can withdraw");
        require(amount <= address(this).balance, "Not enough balance");
        payable(owner).transfer(amount);
    }
}

Important Notes

Only functions marked payable can receive money.

Use msg.value to check how much money was sent.

Always check and handle money carefully to avoid mistakes or theft.

Summary

Payable functions let your program accept money safely.

Mark functions with payable to receive funds.

Use msg.value to know how much money was sent.

Practice

1. What is the main purpose of a payable function in a blockchain smart contract?

easy

A. To allow the function to receive cryptocurrency along with the call

B. To make the function run faster

C. To restrict the function to only the contract owner

D. To prevent the function from modifying state variables

Solution

1. Step 1: Understand the role of payable

   The payable keyword marks a function that can accept cryptocurrency (like Ether) when called.

2. Step 2: Compare other options

   Options A, C, and D describe unrelated behaviors. Only To allow the function to receive cryptocurrency along with the call correctly describes the purpose of payable.

3. Final Answer:

   To allow the function to receive cryptocurrency along with the call -> Option A

4. Quick Check:

   Payable = Receive money [OK]

Hint: Payable means function can accept money sent [OK]

Common Mistakes:

• Thinking payable makes function faster
• Confusing payable with access control
• Believing payable prevents state changes

2. Which of the following is the correct syntax to declare a payable function in Solidity?

easy

A. payable function deposit() public {}

B. function deposit() payable public {}

C. function payable deposit() public {}

D. function deposit() public payable {}

Solution

1. Step 1: Recall Solidity function declaration order

   In Solidity, the visibility modifier (e.g., public) comes before payable keyword.

2. Step 2: Check each option

   function deposit() public payable {} uses correct order: function deposit() public payable {}. Options A, B, and D have incorrect keyword order or syntax.

3. Final Answer:

   function deposit() public payable {} -> Option D

4. Quick Check:

   Correct order: visibility then payable [OK]

Hint: Visibility modifier before payable keyword [OK]

Common Mistakes:

• Placing payable before function keyword
• Switching order of public and payable
• Using payable as a function name

3. What will be the output of the following Solidity function when called with 2 Ether?

contract Test {
    uint public balance;
    function deposit() public payable {
        balance = msg.value;
    }
}

medium

A. balance will be 2000000000000000000 (2 Ether in wei)

B. balance will be 2

C. Compilation error

D. balance will be 0

Solution

1. Step 1: Understand msg.value in Solidity

   msg.value holds the amount of wei (smallest Ether unit) sent with the transaction. 2 Ether equals 2 * 10^18 wei = 2000000000000000000 wei.

2. Step 2: Analyze the assignment to balance

   The function sets balance = msg.value, so balance stores the wei amount sent, which is 2000000000000000000.

3. Final Answer:

   balance will be 2000000000000000000 (2 Ether in wei) -> Option A

4. Quick Check:

   msg.value stores wei amount sent [OK]

Hint: msg.value is in wei, not Ether [OK]

Common Mistakes:

• Assuming msg.value is in Ether
• Expecting balance to be zero
• Thinking function won't compile

4. Identify the error in this Solidity function that is intended to receive Ether:

function receiveFunds() public {
    require(msg.value > 0, "Send some Ether");
}

medium

A. require condition is incorrect

B. Function must be marked payable to receive Ether

C. Function visibility should be private

D. msg.value cannot be used inside functions

Solution

1. Step 1: Check function declaration for payable

   To receive Ether, a function must be declared with the payable keyword. This function lacks it.

2. Step 2: Validate other options

   The require condition is valid, visibility can be public, and msg.value is accessible in payable functions.

3. Final Answer:

   Function must be marked payable to receive Ether -> Option B

4. Quick Check:

   Missing payable causes Ether rejection [OK]

Hint: Add payable to accept Ether in function [OK]

Common Mistakes:

• Forgetting payable keyword
• Misusing require condition
• Changing visibility unnecessarily

5. You want to create a smart contract function that accepts Ether and updates the sender's balance only if at least 1 Ether is sent. Which of the following implementations correctly achieves this?

hard

A. function deposit() payable public {
if (msg.value > 1) {
balances[msg.sender] = msg.value;
}
}

B. function deposit() public {
require(msg.value >= 1 ether, "Minimum 1 Ether required");
balances[msg.sender] += msg.value;
}

C. function deposit() public payable {
require(msg.value >= 1 ether, "Minimum 1 Ether required");
balances[msg.sender] += msg.value;
}

D. function deposit() public payable {
if (msg.value >= 1) {
balances[msg.sender] += msg.value;
}
}

Solution

1. Step 1: Check for payable keyword and require condition

   function deposit() public payable { require(msg.value >= 1 ether, "Minimum 1 Ether required"); balances[msg.sender] += msg.value; } correctly marks the function as payable and uses require(msg.value >= 1 ether) to enforce minimum Ether sent.

2. Step 2: Validate balance update and syntax

   function deposit() public payable { require(msg.value >= 1 ether, "Minimum 1 Ether required"); balances[msg.sender] += msg.value; } updates balances[msg.sender] by adding msg.value. Other options either miss payable, use wrong comparison, or incorrect balance update.

3. Final Answer:

   function deposit() public payable { require(msg.value >= 1 ether, "Minimum 1 Ether required"); balances[msg.sender] += msg.value; } -> Option C

4. Quick Check:

   Payable + require with 1 ether check [OK]

Hint: Use require with 1 ether and payable function [OK]

Common Mistakes:

• Omitting payable keyword
• Using incorrect Ether comparison
• Not updating balance correctly