Dokumentasi Solidity - Rian010/Journal GitHub Wiki

Penjelasan Umum

Solidity adalah bahasa pemrograman yang digunakan untuk menuliskan kontrak intelijen (smart contract) pada jaringan blockchain Ethereum. Solidity dikembangkan oleh Gavin Wood, Christian Reitwiessner, Alex Beregszaszi, Yoichi Hirai, dan brogan Ambrus pada tahun 2014. Solidity ditulis dalam style syntax yang mirip dengan ECMAScript (JavaScript) dan dapat digunakan untuk menuliskan kontrak intelijen yang kompleks.

Struktur Dasar

Berikut ini adalah contoh dasar dari kontrak intelijen Solidity:

// SPDX-License-Identifier: MIT
pragma solidity ^0.8.0;

contract HelloWorld {
    string public message;

    constructor () {
        message = "Hello World!";
    }

    function displayMessage () public view returns (string memory) {
        return message;
    }
}

Dalam contoh di atas, terdapat beberapa elemen dasar dari kontrak intelijen Solidity:

Komentar: Komentar dapat dituliskan menggunakan // atau /* ... */ .
Identifier: Identifier adalah label atau nama yang digunakan untuk mengidentifikasi variabel, fungsi, atau kontrak.
Pragma: Pragma digunakan untuk mendefinisikan versi Solidity yang digunakan.
Kontrak: Kontrak adalah unit dasar dari kontrak intelijen Solidity.
State Variables: State variables adalah variabel global yang dapat diakses oleh semua fungsi dalam kontrak.
Konstruktor: Konstruktor adalah fungsi yang dipanggil saat kontrak pertama kali dibuat.
Fungsi: Fungsi adalah unit dasar dari logika operasi pada kontrak intelijen.
Return Type: Return type adalah tipe data yang dikembalikan oleh fungsi.

Data Types

Berikut ini adalah daftar data types yang dapat digunakan pada Solidity:

Boolean: Boolean digunakan untuk menyimpan nilai benar atau salah (true/false).
Integer: Integer digunakan untuk menyimpan bilangan bulat positif atau negatif.
Address: Address digunakan untuk menyimpan alamat ETH.
String: String digunakan untuk menyimpan teks.
Array: Array digunakan untuk menyimpan koleksi data.
Struct: Struct digunakan untuk menyimpan data yang terdiri dari beberapa field.
Enum: Enum digunakan untuk menyimpan nilai konstan.

Control Flow

Berikut ini adalah contoh control flow pada Solidity:

// SPDX-License-Identifier: MIT
pragma solidity ^0.8.0;

contract Example {
    uint public num;

    constructor () {
        num = 10;
    }

    function increment () public {
        num++;
    }

    function decrement () public {
        num--;
    }

    function reset () public {
        if (num > 0) {
            num = 0;
        } else {
            num = 10;
        }
    }

    function loop () public view returns (uint[]) {
        uint[] memory arr;
        for (uint i = 0; i < 10; i++) {
            arr.push(i);
        }
        return arr;
    }
}

Dalam contoh di atas, terdapat beberapa contoh control flow, yaitu:

Perulangan: Perulangan dapat dilakukan menggunakan statement for.
Kondisi: Kondisi dapat diformulasikan menggunakan operator comparision dan logical.
Switch Case: Switch case dapat digunakan untuk mengelola aliran control berdasarkan nilai variabel.

Event

Berikut ini adalah contoh event pada Solidity:

// SPDX-License-Identifier: MIT
pragma solidity ^0.8.0;

contract Example {
    event Transfer (
        address indexed from,
        address indexed to,
        uint value
    );

    function transfer (address _to, uint _value) public {
        emit Transfer(msg.sender, _to, _value);
    }
}

Dalam contoh di atas, terdapat contoh event Transfer yang digunakan untuk mengirim notifikasi saat terjadi transfer token. Event dapat digunakan untuk mengirim notifikasi kepada klient off-chain atau untuk melakukan logging.

Error Handling

Berikut ini adalah contoh error handling pada Solidity:

// SPDX-License-Identifier: MIT
pragma solidity ^0.8.0;

contract Example {
    function divide (uint a, uint b) public pure returns (uint) {
        require(b != 0, "Division by zero");
        return a / b;
    }
}

Dalam contoh di atas, terdapat contoh error handling menggunakan require statement. Require statement digunakan untuk memeriksa kondisi dan throw exception jika kondisi tidak terpenuhi. Exception dapat digunakan untuk menghentikan eksekusi fungsi dan mengirim pesan error.

Security Best Practices

Berikut ini adalah beberapa best practices security yang dapat dilakukan pada Solidity:

Avoid floating point numbers: Floating point numbers dapat menimbulkan bug dan vulnerabilities.
Use latest version of Solidity: Latest version of Solidity mengandung bug fixes dan optimisasi.
Use secure libraries: Secure libraries dapat membantu mencegah vulnerabilities.
Validate inputs: Validasi inputs dapat membantu mencegah attack injection.
Minimize surface area: Minimizing surface area dapat membantu mencegah attack.
Use modifiers: Modifiers dapat digunakan untuk memvalidasi input dan mencegah vulnerabilities.
Use encryption: Encryption dapat digunakan untuk melindungi data sensitive.