Deploy smart contract dengan Foundry

Panduan ini membahas dasar-dasar toolchain pengembangan Foundry dan menjelaskan cara membuat serta deploy smart contract dengan Foundry ke testnet Lisk Sepolia.

catatan

Anda dapat deploy contract di mainnet Lisk dengan menggunakan proses yang sama.
Untuk deploy ke mainnet, pastikan wallet Anda memiliki ETH yang cukup.

Teks berikut mencakup perintah untuk Lisk dan Lisk Sepolia demi kemudahan Anda.
Untuk informasi lebih lanjut, lihat jaringan Lisk yang tersedia dan cara menghubungkan wallet ke jaringan tersebut.

Foundry adalah rangkaian tools yang mumpuni untuk mengembangkan, menguji, dan men-debug smart contract Anda.
Foundry terdiri dari beberapa tools individu seperti:

forge: tools berbasis command-line yang disertakan dengan Foundry. Forge digunakan untuk menguji, membangun, dan deploy smart contract Anda.
cast: tools berbasis command-line untuk melakukan panggilan RPC, seperti berinteraksi dengan contract, mengirim transaksi, dan mendapatkan data on-chain.
anvil: node testnet lokal, dirancang untuk menguji perilaku contract dari frontend atau melalui RPC dalam environment pengembangan lokal.
chisel: REPL Solidity (Read–Eval–Print Loop) untuk mencoba potongan kode Solidity pada jaringan lokal atau jaringan yang di-fork.

Prasyarat

Untuk membangun dengan Foundry, Anda memerlukan:

Pemahaman dasar tentang Solidity.
Foundry terinstal pada sistem Anda.
Untuk menginstalnya, lakukan langkah-langkah berikut:
- Dari command line, jalankan:
```
curl -L https://foundry.paradigm.xyz | bash
```
- Setelah itu, untuk menginstal versi terbaru (nightly) dari Foundry, jalankan:
```
foundryup
```
Untuk informasi lebih lanjut, lihat Panduan Instalasi di Foundry Book.

Dana Wallet

Deploy contract ke blockchain memerlukan biaya gas.
Oleh karena itu, Anda perlu mendanai wallet Anda dengan ETH untuk menutupi biaya gas tersebut.

Dalam panduan ini, Anda akan deploy contract ke Lisk Sepolia Testnet.

Anda dapat men-deposit token yang diperlukan menggunakan Lisk Sepolia Bridge.

Jika wallet Anda tidak memiliki SepoliaETH yang cukup, gunakan salah satu faucet yang tersedia untuk Ethereum Sepolia Testnet seperti https://sepoliafaucet.com untuk menerima ETH Testnet secara gratis.
Kemudian, gunakan Lisk Bridge yang disebutkan sebelumnya untuk mengirim token dari Ethereum Sepolia Testnet ke Lisk Sepolia Testnet.

Membuat Proyek

Langkah pertama dalam deploy smart contract ke Lisk adalah menyiapkan environment pengembangan Anda dengan membuat proyek Foundry.

Anda dapat membuat direktori baru secara terpisah lalu menginisialisasi proyek Foundry, atau Anda dapat membiarkan Foundry membuat direktori dan menginisialisasi proyek Foundry dengan menjalankan perintah berikut:

forge init foundry_app && cd foundry_app

Perintah ini akan membuat folder bernama foundry_app dan sekaligus mengubah direktori kerja terminal ke folder tersebut.

Log Eksekusi Perintah forge init

Initializing /XYZ/L2/25/foundry_app/foundry_app...
Installing forge-std in /XYZ/L2/25/foundry_app/foundry_app/lib/forge-std (url: Some("https://github.com/foundry-rs/forge-std"), tag: None)
Cloning into '/XYZ/L2/25/foundry_app/foundry_app/lib/forge-std'...
remote: Enumerating objects: 2181, done.
remote: Counting objects: 100% (2177/2177), done.
remote: Compressing objects: 100% (737/737), done.
remote: Total 2181 (delta 1446), reused 2066 (delta 1373), pack-reused 4
Receiving objects: 100% (2181/2181), 614.11 KiB | 766.00 KiB/s, done.
Resolving deltas: 100% (1446/1446), done.
Submodule 'lib/ds-test' (https://github.com/dapphub/ds-test) registered for path 'lib/ds-test'
Cloning into '/XYZ/L2/25/foundry_app/foundry_app/lib/forge-std/lib/ds-test'...
remote: Enumerating objects: 313, done.
remote: Counting objects: 100% (171/171), done.
remote: Compressing objects: 100% (79/79), done.
remote: Total 313 (delta 91), reused 132 (delta 83), pack-reused 142
Receiving objects: 100% (313/313), 71.35 KiB | 521.00 KiB/s, done.
Resolving deltas: 100% (130/130), done.
    Installed forge-std v1.7.6
    Initialized forge project

Secara default, setiap aplikasi yang dibuat dengan Foundry akan memiliki struktur direktori yang serupa seperti berikut ini:

.
├── .github
├── lib
├── script
│   └── Counter.s.sol
├── src
│   └── Counter.sol
├── test
│   └── Counter.t.sol
├── .gitignore
├── .gitmodules
├── foundry.toml
└── README.md

Untuk saat ini, hapus file yang ada di script/Counter.s.sol, src/Counter.sol, dan test/Counter.t.sol, karena kita akan membuat contract dan kode pengujian sendiri dalam panduan berikutnya.

Membuat Smart Contract

Untuk kemudahan dan keamanan, kita akan menggunakan contract ERC721 yang disediakan oleh OpenZeppelin Contracts library untuk membuat smart contract ERC-721 sederhana.
Dengan OpenZeppelin, kita tidak perlu menulis keseluruhan contract ERC-721.
Sebaliknya, kita dapat mengimpor contract dari library dan langsung menggunakan fungsinya.

Untuk menginstal OpenZeppelin Contracts library ke proyek Anda, jalankan perintah berikut:

forge install openzeppelin/openzeppelin-contracts

Di dalam folder src, buat sebuah smart contract bernama NFT.sol dan tambahkan kode berikut ke dalam file yang baru dibuat.

src/NFT.sol
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.23;

import "openzeppelin-contracts/contracts/token/ERC721/ERC721.sol";

contract NFT is ERC721 {
    uint256 public currentTokenId;

    // Kode berikut ini akan membuat Token ERC721 bernama Lisk.
    constructor() ERC721("Lisk", "LSK") {}

    // Agar lebih simpel, kami hanya akan mengimplementasikan fungsi mint dari token Lisk.
    function mint(address recipient) public payable returns (uint256) {
        uint256 newItemId = ++currentTokenId;
        _safeMint(recipient, newItemId);
        return newItemId;
    }
}

Mengompilasi Smart Contract

Setelah kode smart contract siap, Anda harus mengompilasinya menggunakan Foundry.
Untuk melakukannya, cukup jalankan perintah berikut:

forge build

Jika smart contract tidak memiliki eror, Anda akan melihat output berikut di terminal:

[⠢] Compiling...
[⠰] Compiling 1 files with 0.8.24
[⠔] Solc 0.8.24 finished in 40.36ms
Compiler run successful!

Menguji Smart Contract

Dengan menguji smart contract, Anda dapat memastikan bahwa smart contract berperilaku sesuai harapan dan tidak ada bug sebelum men-deploynya ke Lisk.

Foundry menyediakan banyak framework testing untuk mendukung Anda dalam menulis test untuk smart contract.
Lihat Tests - Foundry Book untuk contoh dan referensi terkait framework testing.

Untuk melakukan testing pada smart contract NFT, buat file baru bernama NFT.t.sol di dalam direktori test/, dan tambahkan konten berikut:

foundry_app/test/NFT.t.sol
// SPDX-License-Identifier: UNLICENSED
pragma solidity ^0.8.20;

import {Test, console} from "forge-std/Test.sol";
import {NFT} from "../src/NFT.sol";

contract NFTTest is Test {

    NFT public lsk;

    // Membuat alamat dummy untuk alice dan bob
    address alice = makeAddr("alice");
    address bob = makeAddr("bob");

    // Menginisialisasi objek contract NFT
    function setUp() public{
        lsk = new NFT();
    }

    // Berikan alamat alice dan bob untuk melihat apakah fungsi mint berhasil berjalan
    function testMintPass() public {
        lsk.mint(alice);
        lsk.mint(bob);
    }

    // Untuk dengan sengaja membuat pengujian gagal, bandingkan alamat alice dan bob
    function testMintFail() public {
        assertEq(alice, bob);
    }
}

Untuk menjalankan test, eksekusi perintah berikut. Flag -vv akan menghasilkan informasi detail tentang test yang dijalankan menggunakan perintah berikut:

forge test -vv

Outputnya seharusnya terlihat seperti ini:

[⠢] Compiling...
No files changed, compilation skipped

Ran 2 tests for test/NFT.t.sol:NFTTest
[FAIL. Reason: assertion failed] testMintFail() (gas: 147160)
Logs:
  Error: a == b not satisfied [address]
        Left: 0x328809Bc894f92807417D2dAD6b7C998c1aFdac6
       Right: 0x1D96F2f6BeF1202E4Ce1Ff6Dad0c2CB002861d3e

[PASS] testMintPass() (gas: 132327)
Test result: FAILED. 1 passed; 1 failed; 0 skipped; finished in 1.13ms

Ran 1 test suite in 1.13ms: 1 tests passed, 1 failed, 0 skipped (2 total tests)

Failing tests:
Encountered 1 failing test in test/NFT.t.sol:NFTTest
[FAIL. Reason: assertion failed] testMintFail() (gas: 147160)

Encountered a total of 1 failing tests, 1 tests succeeded

Test pertama: testMintPass berhasil dijalankan karena kriteria untuk fungsi mint() terpenuhi.
Kita memberikan alamat penerima ke fungsi mint() sebagaimana yang diminta, sehingga test berhasil.

Test kedua: testMintFail gagal karena kita mengasumsikan bahwa alamat alice dan bob adalah sama.
Log output yang disorot diatas menjelaskan mengapa asumsi tersebut salah.

Deploy Smart Contract

Setelah berhasil membangun smart contract, Anda sekarang dapat men-deploynya ke jaringan Lisk.
Untuk contoh ini, kita akan menggunakan jaringan Lisk Sepolia untuk deploy contract NFT.

Tambahkan flag --verify, --verifier, --verifier-url, dan --private-key dari akun pengirim ke perintah forge create untuk langsung memverifikasi smart contract di BlockScout.

Lisk
Lisk Sepolia

forge create --rpc-url https://rpc.api.lisk.com \
--etherscan-api-key 123 \
--verify \
--verifier blockscout \
--verifier-url https://blockscout.lisk.com/api \
--private-key <PRIVATE_KEY> \
src/NFT.sol:NFT

forge create --rpc-url https://rpc.sepolia-api.lisk.com \
--etherscan-api-key 123 \
--verify \
--verifier blockscout \
--verifier-url https://sepolia-blockscout.lisk.com/api \
--private-key <PRIVATE_KEY> \
src/NFT.sol:NFT

Jika deployment berhasil, outputnya akan terlihat seperti berikut:

# Perintah yang disebutkan di atas akan terlebih dahulu deploy contract dan menampilkan output berikut:

[⠒] Compiling...
No files changed, compilation skipped
Deployer: 0x5e1A92F84cA1CE280B3Cb29d79C3368f45b41EBB
Deployed to: 0x108872F713A27bc22ca1db8CEefCAC8CbeDdF9E5
Transaction hash: 0xf465528f43e5cbc9b5206e46048feba0b920179813c3eb8c3bdbccbfd13d731e

# Setelah contract berhasil di-deploy, perintah yang disebutkan di atas akan langsung memverifikasi contract tersebut!

Starting contract verification...
Waiting for blockscout to detect contract deployment...
Start verifying contract `0x108872F713A27bc22ca1db8CEefCAC8CbeDdF9E5` deployed on 4202

Submitting verification for [src/NFT.sol:NFT] 0x108872F713A27bc22ca1db8CEefCAC8CbeDdF9E5.
Submitted contract for verification:
        Response: `OK`
        GUID: `108872f713a27bc22ca1db8ceefcac8cbeddf9e565e71790`
        URL: https://sepolia-blockscout.lisk.com/address/0x108872f713a27bc22ca1db8ceefcac8cbeddf9e5
Contract verification status:
Response: `OK`
Details: `Pending in queue`
Contract verification status:
Response: `OK`
Details: `Pass - Verified`
Contract successfully verified

Setelah smart contract berhasil di-deploy dan diverifikasi, Anda dapat berinteraksi dengan memanggil fungsi-fungsi publiknya.

Memverifikasi Smart Contract

Setiap contract yang di-deploy harus diverifikasi agar pengguna dan developer lainnya dapat memeriksa source code-nya dan memastikan bahwa source code tersebut sesuai dengan bytecode yang di-deploy di blockchain.

Selain itu, jika Anda ingin orang lain dapat berinteraksi dengan contract Anda melalui block explorer seperti interface Read Contract dan Write Contract di Blockscout, contract tersebut harus diverifikasi terlebih dahulu.

Contract di atas sudah diverifikasi, sehingga Anda seharusnya dapat melihat versi Anda di block explorer, tetapi kami tetap akan menjelaskan langkah-langkah untuk memverifikasi contract di Lisk Sepolia testnet.

info

Anda tidak dapat memverifikasi ulang contract yang identik dengan yang sudah diverifikasi. Jika Anda mencoba melakukannya, seperti memverifikasi contract di atas, Anda akan mendapatkan pesan error seperti:

Start verifying contract `0x108872F713A27bc22ca1db8CEefCAC8CbeDdF9E5` deployed on 4202

Contract [src/NFT.sol:NFT] "0x108872F713A27bc22ca1db8CEefCAC8CbeDdF9E5" is already verified. Skipping verification.

Jika smart contract Anda belum diverifikasi, ambil alamat contract yang sudah di-deploy dan jalankan:

Lisk
Lisk Sepolia

forge verify-contract <CONTRACT_ADDRESS> \
./src/<CONTRACT_FILE>.sol:<CONTRACT_NAME> \
--chain 1135 \
--watch \
--verifier blockscout \
--verifier-url https://blockscout.lisk.com/api

forge verify-contract <CONTRACT_ADDRESS> \
./src/<CONTRACT_FILE>.sol:<CONTRACT_NAME> \
--chain 4202 \
--watch \
--verifier blockscout \
--verifier-url https://sepolia-blockscout.lisk.com/api

Anda akan melihat output yang serupa dengan berikut:

Starting contract verification...
Waiting for blockscout to detect contract deployment...
Start verifying contract `0xcCaA1C3eb8FEb5b09a5Eac1359BC4c70E18e29d9` deployed on 4202

Submitting verification for [src/NFT.sol:NFT] 0xcCaA1C3eb8FEb5b09a5Eac1359BC4c70E18e29d9.
Submitted contract for verification:
       Response: `OK`
       GUID: `ccaa1c3eb8feb5b09a5eac1359bc4c70e18e29d965e5c95a`
       URL: https://sepolia-blockscout.lisk.com/address/0xccaa1c3eb8feb5b09a5eac1359bc4c70e18e29d9
Contract verification status:
Response: `OK`
Details: `Pending in queue`
Contract verification status:
Response: `OK`
Details: `Pass - Verified`
Contract successfully verified

Gunakan alamat contract, misalnya 0xcCaA1C3eb8FEb5b09a5Eac1359BC4c70E18e29d9, untuk mencari contract Anda di Blockscout dan memastikan bahwa contract tersebut telah diverifikasi.

Berinteraksi dengan Smart Contract

Seperti yang disebutkan sebelumnya, jika Anda telah memverifikasi smart contract di Blockscout, Anda dapat menggunakan bagian Read contract dan Write contract di bawah tab Contract untuk berinteraksi dengan contract yang telah di-deploy.

Tab Read contract dapat digunakan tanpa menghubungkan wallet, namun, untuk menggunakan tab Write contract, Anda harus terlebih dahulu menghubungkan wallet Anda.
Anda dapat melakukannya dengan mengklik tombol Connect wallet.

Menggunakan cast untuk Berinteraksi

Dengan tool command-line dari Foundry: cast, Anda dapat berinteraksi dengan contract yang telah di-deploy, baik untuk membaca maupun menulis data di blockchain.
Mari kita lakukan panggilan tanpa mempublikasikan transaksi (read), lalu menandatangani dan mempublikasikan transaksi (write) ke contract yang telah di-deploy.

Melakukan Panggilan

Sebagai salah satu komponen utama dari toolkit Foundry, cast memungkinkan kita untuk berinteraksi dengan contract, mengirim transaksi, dan mendapatkan data on-chain menggunakan panggilan RPC Ethereum.
Pertama, kita akan melakukan panggilan dari sebuah akun tanpa mempublikasikan transaksi.

Isi <PLACEHOLDERS> berikut, lalu jalankan perintah:

Lisk
Lisk Sepolia

cast call <DEPLOYED_CONTRACT_ADDRESS> --rpc-url https://rpc.api.lisk.com "balanceOf(address)" <YOUR_ACCOUNT_ADDRESS_HERE>

cast call <DEPLOYED_CONTRACT_ADDRESS> --rpc-url https://rpc.sepolia-api.lisk.com "balanceOf(address)" <YOUR_ACCOUNT_ADDRESS_HERE>

Anda akan menerima respons berupa 0x0000000000000000000000000000000000000000000000000000000000000000, yang setara dengan 0 dalam format heksadesimal.
Hal ini masuk akal karena Anda baru saja deploy contract NFT, namun belum ada NFT yang di-mint, sehingga saldo akun Anda adalah nol.

Menandatangani dan Mengirim Transaksi

Sekarang, mari kita tandatangani dan kirim transaksi dengan memanggil fungsi mint(address) pada contract NFT yang baru saja kita deploy.

Isi <PLACEHOLDERS> berikut, lalu jalankan perintah:

Lisk
Lisk Sepolia

cast send <DEPLOYED_CONTRACT_ADDRESS> --rpc-url https://rpc.api.lisk.com "mint(address)" <RECIPIENT_ADDRESS_HERE> --private-key <SENDER_PRIVATE_KEY>

cast send <DEPLOYED_CONTRACT_ADDRESS> --rpc-url https://rpc.sepolia-api.lisk.com "mint(address)" <RECIPIENT_ADDRESS_HERE> --private-key <SENDER_PRIVATE_KEY>

info

Karena perintah cast send menulis data ke blockchain, maka diperlukan private key akun pengirim yang harus diberikan ke flag --private-key.
Transaksi akan berhasil dikirim jika akun pengirim memiliki dana yang cukup.

Hal ini tidak diperlukan untuk perintah cast call, karena perintah tersebut hanya mengambil data yang sudah dipublikasikan dari smart contract.

Jika eksekusi transaksi berhasil, Foundry akan memberikan respons berisi informasi tentang transaksi, termasuk blockNumber, gasUsed, transactionHash, dan banyak lagi.

blockHash               0xfa9d32794b0fc9c1a10d39c5289613dfe80b55f8ead06475ca877a389e088e67
blockNumber             2165375
contractAddress
cumulativeGasUsed       137472
effectiveGasPrice       3000000253
from                    0x5e1A92F84cA1CE280B3Cb29d79C3368f45b41EBB
gasUsed                 93597
logs                    [{"address":"0x108872f713a27bc22ca1db8ceefcac8cbeddf9e5","topics":["0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef","0x0000000000000000000000000000000000000000000000000000000000000000","0x000000000000000000000000488ba3c013020bd1712ed6a1997c4212d9711954","0x0000000000000000000000000000000000000000000000000000000000000001"],"data":"0x","blockHash":"0xfa9d32794b0fc9c1a10d39c5289613dfe80b55f8ead06475ca877a389e088e67","blockNumber":"0x210a7f","transactionHash":"0x76750ee1aaeed89c8f165d6f547002eb3bb833a142f73d63c1c3c9980fce8796","transactionIndex":"0x1","logIndex":"0x0","removed":false}]
logsBloom               0x00000000000000000000000000040000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000040000000000000000200000000008000000000000000000040000000000000000000000000000020000000000000000080800000000000000000000000010000000000100000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000002000001000000000000400000000000000000000000000000000060000000000000000000000000000000000000000000000000000000000000000000
root
status                  1
transactionHash         0x76750ee1aaeed89c8f165d6f547002eb3bb833a142f73d63c1c3c9980fce8796
transactionIndex        1
type                    2
to                      0x1088…f9e5
l1Fee             "0x30fb62bfb0c"
l1GasPrice             "0x6d49929"
l1GasUsed             "0x8a4"

Terakhir, Anda dapat mengonfirmasi proses minting dengan melakukan panggilan lagi.
Anda seharusnya melihat saldo Anda meningkat dari 0 menjadi 1.

Lisk
Lisk Sepolia

cast call <DEPLOYED_CONTRACT_ADDRESS> --rpc-url https://rpc.api.lisk.com "balanceOf(address)" <YOUR_ACCOUNT_ADDRESS_HERE>

cast call <DEPLOYED_CONTRACT_ADDRESS> --rpc-url https://rpc.sepolia-api.lisk.com "balanceOf(address)" <YOUR_ACCOUNT_ADDRESS_HERE>

Dan responsnya: 0x0000000000000000000000000000000000000000000000000000000000000001 (1 dalam format heksadesimal) — selamat, Anda berhasil deploy contract dan mint NFT dengan Foundry!

Lihat token yang telah di-mint dalam panduan ini di Blockscout explorer.

Itu dia! Meskipun ini hanya permulaan, masih banyak hal yang dapat dipelajari tentang Foundry.
Untuk semua hal tentang Foundry, kunjungi Foundry book, atau bergabunglah dengan dev chat atau support chat resmi di Telegram.

Prasyarat​

Dana Wallet​

Membuat Proyek​

Membuat Smart Contract​

Mengompilasi Smart Contract​

Menguji Smart Contract​

Deploy Smart Contract​

Memverifikasi Smart Contract​

Berinteraksi dengan Smart Contract​

Menggunakan cast untuk Berinteraksi​

Melakukan Panggilan​

Menandatangani dan Mengirim Transaksi​