Kalau tujuanmu membuat smart contract pertama, jalur terpendeknya begini: buka Remix IDE di browser, buat file SimpleStorage.sol, tulis kontrak Solidity minimal (pragma, deklarasi contract, satu state variable, satu fungsi penulis, satu fungsi pembaca), compile sampai muncul status sukses, lalu deploy ke Remix VM atau testnet. Setelah ter-deploy, uji perilakunya: panggil fungsi baca, ubah nilai lewat fungsi tulis, baca lagi. Kalau nilainya berubah dan transaksinya muncul di block explorer, kontrakmu benar-benar berjalan.
Apa Itu Smart Contract dan Posisi Solidity
Smart contract adalah program yang hidup di sebuah alamat di jaringan Ethereum. Bedanya dengan skrip biasa, state atau variabel di dalamnya tersimpan permanen di blockchain selama kontrak itu ada [S1]. Jadi angka yang kamu simpan hari ini masih ada besok, bukan hilang saat tab browser ditutup.
Solidity adalah bahasa yang dipakai untuk menulis kontrak tersebut. File-nya berekstensi .sol, dan hasil compile-nya berupa dua artefak: bytecode yang dikirim ke jaringan, serta ABI yang dipakai aplikasi lain untuk memanggil fungsinya [S5]. Dua artefak ini jarang disebut di tutorial pemula, padahal keduanya yang menentukan kontrak bisa dipakai atau tidak.
Prasyarat dan Versi Solidity yang Perlu Disiapkan
Untuk percobaan pertama, kamu cuma butuh browser dan Remix IDE. Remix adalah editor berbasis web yang tidak perlu instalasi [S1] [S4]. MetaMask diperlukan begitu kamu ingin deploy ke jaringan sungguhan atau testnet, karena dompet inilah yang menandatangani transaksi [S2] [S4]. Ganache opsional: gunanya menyediakan simulasi jaringan Ethereum lokal kalau kamu ingin menguji tanpa internet [S2] [S4].
Soal versi, di sini ada jebakan kecil. Sumber yang saya baca memakai ^0.8.0 [S1] [S4] dan 0.8.13 [S3], dan saya tidak bisa memastikan mana rilis stabil terbaru saat kamu membaca ini. Karena itu, jangan hafal angka versi. Buka tab Solidity Compiler di Remix, lihat daftar compiler yang tersedia, dan pastikan versi yang kamu pilih memenuhi rentang pragma di kodemu. Kalau butuh acuan resmi soal sintaks dan rilis, dokumentasi Solidity di docs.soliditylang.org adalah rujukan primernya.
Menyiapkan Remix IDE Tanpa Instalasi
- Buka Remix di browser, lalu klik ikon File Explorer di bilah kiri [S3].
- Klik tombol buat file baru, beri nama SimpleStorage.sol — ekstensi .sol wajib [S3].
- Biarkan tab Solidity Compiler dan Deploy & Run terbuka; keduanya akan kamu pakai sebentar lagi.
Satu catatan jujur: nama panel dan tombol di Remix bisa berubah antarversi. Kalau tulisan yang kamu lihat sedikit berbeda dari daftar di atas, cari panel dengan fungsi serupa, jangan memaksakan nama yang tidak ada.
Menulis Kontrak Pertama Baris demi Baris
Mulai dari baris lisensi. Ini sepele tapi sering memunculkan warning:
// SPDX-License-Identifier: MIT
Setelah itu, isi kontraknya. Baris baru tidak memengaruhi hasil compile, jadi versi satu baris berikut sah secara sintaks:
pragma solidity ^0.8.0; contract SimpleStorage { uint256 public angka; constructor(uint256 _angkaAwal) { angka = _angkaAwal; } function simpan(uint256 _angkaBaru) public { angka = _angkaBaru; } function baca() public view returns (uint256) { return angka; } }
Sekarang bedah per bagian. pragma solidity ^0.8.0; memberi tahu compiler rentang versi yang boleh dipakai [S1]. Tanda ^ artinya versi 0.8.0 ke atas, tapi bukan 0.9.0. contract SimpleStorage adalah deklarasi kontrak, namanya bebas [S1]. uint256 public angka adalah state variable: bilangan bulat 256-bit yang tersimpan di blockchain, dan kata public membuat Solidity otomatis menyediakan fungsi pembaca [S1]. constructor berjalan sekali saat kontrak dibuat, dipakai mengisi nilai awal [S1]. Terakhir, simpan mengubah state, sedangkan baca hanya mengembalikan nilai tanpa mengubah apa pun [S1].
Compile: Arti Status Sukses dan Cara Membaca Error Versi Pragma
Buka ikon Solidity Compiler di bilah kiri, pilih versi compiler, lalu jalankan compile [S3]. Kalau lolos, muncul tanda hijau dengan pesan compilation successful [S3]. Ada juga opsi auto-compile; begitu kotaknya dicentang, versi compiler menyesuaikan diri dengan pragma di kontrak [S3]. Untuk kontrak sependek milikmu, menyalakan opsi ini menghemat satu langkah manual.
Nah, masalahnya muncul saat compile gagal. Dan untuk kontrak pertama, penyebab tersering bukan logika, melainkan tidak nyambungnya pragma dengan compiler yang dipilih. Aturannya begini: pragma mendefinisikan rentang versi yang boleh dipakai, misalnya ^0.8.0 berarti 0.8.0 ke atas tetapi bukan 0.9.0 [S1]. Kalau compiler yang kamu pilih di panel berada di luar rentang itu, file ditolak. Jadi ketika muncul pesan yang menyinggung soal compiler version, baca dulu sebelum mengutak-atik kode: biasanya itu tanda pilihanmu di panel tidak cocok dengan tulisan pragma, bukan tanda kodemu rusak.
Dua perbaikan yang sama sahnya, pilih salah satu. Samakan angka pragma dengan versi compiler yang tersedia di panel, atau ganti versi compiler supaya masuk ke rentang pragma. Soal angka mana yang paling aman, saya tidak bisa memastikan rilis stabil terbaru saat kamu membaca ini — sumber yang saya baca memakai ^0.8.0 [S1] [S4] dan 0.8.13 [S3]. Jadi buka daftar compiler yang tersedia di Remix dan cek rentangnya, bukan menghafal angka.
| Jenis pesan | Penyebab | Perbaikan |
|---|---|---|
| Pesan yang menyinggung kecocokan versi compiler | Pilihan compiler di panel berada di luar rentang pragma | Sesuaikan pragma dengan compiler yang tersedia, atau sebaliknya |
| Pesan yang menunjuk baris tertentu soal tanda baca atau tanda kurung | Titik koma hilang atau kurung tidak seimbang | Perbaiki baris yang ditunjuk, lalu compile ulang |
| Peringatan, bukan error, soal akses fungsi atau baris SPDX | Ada aturan penulisan yang belum dipenuhi | Lengkapi kata kunci akses pada fungsi dan baris SPDX di awal file |
Satu hal yang perlu kamu tahu soal tabel di atas: teks pesan error berbeda-beda antarversi compiler, jadi jangan mencari kalimat yang persis sama. Yang relatif stabil cuma dua — pesan biasanya menyebut nomor baris yang bermasalah, dan akan lebih aman kalau kamu memeriksa artinya di dokumentasi resmi Solidity di docs.soliditylang.org. Setelah compile bersih, ukurannya bukan sekadar warna hijau, tapi tidak ada error tersisa di panel bawah. Warning boleh ada, error tidak.
Deploy ke Jaringan Uji dan Membaca Transaksinya
Urutan aman untuk percobaan pertama: deploy ke Remix VM dulu, baru pindah ke testnet. Di Remix VM, transaksi berjalan instan tanpa dana sungguhan, jadi kamu bisa salah tanpa biaya. Kalau sudah lancar, pilih jaringan uji seperti Sepolia lewat MetaMask, ambil saldo test ETH dari faucet, lalu deploy. Perlu diingat, testnet bisa dihentikan sewaktu-waktu, jadi pastikan jaringan yang kamu pilih masih aktif sebelum mulai.
Verifikasi deployment punya tiga bukti konkret. Pertama, alamat kontrak muncul di panel Deploy & Run. Kedua, transaksinya tercatat di block explorer dengan status sukses. Ketiga, saat kamu buka kontrak di explorer, bytecode hasil compile benar-benar ada di sana. Alamat dan hash transaksi hanya bisa kamu dapatkan dari percobaanmu sendiri, jadi artikel ini tidak mencantumkan contoh hash — bukan karena tidak penting, tapi karena angka karangan justru menyesatkan.
Menguji Fungsi Read vs Write dan Soal Gas
Buka kontrak yang sudah ter-deploy, lalu panggil baca. Hasilnya langsung muncul tanpa transaksi dan tanpa biaya, karena fungsi view atau pure hanya membaca state, bukan mengubahnya [S1]. Sekarang isi kolom nilai pada simpan, kirim transaksi, lalu panggil baca lagi. Kalau angkanya berubah, fungsi tulis bekerja.
Di sinilah banyak pemula salah paham. Fungsi penulis state mengubah isi blockchain, jadi butuh transaksi dan gas. Fungsi pembaca tidak. Di Remix, estimasi gas biasanya tampil sebelum kamu menekan tombol transaksi; di testnet biayanya memakai test ETH, bukan uang sungguhan.
Kesalahan Umum Pemula dan Batas Aman Sebelum Mainnet
Kesalahan paling mahal bukan soal kode, tapi soal kunci. Seed phrase dan private key MetaMask tidak boleh dibagikan ke siapa pun, termasuk ke situs yang mengaku butuh verifikasi. Tidak ada alasan sah untuk menyerahkannya. Hindari juga mengisi fungsi dengan kata kunci payable kalau kamu belum paham ke mana dana mengalir, karena fungsi payable menerima ether secara otomatis [S5].
Batas aman berikutnya: kontrak contoh di artikel ini tidak diaudit dan tidak layak menyimpan dana orang lain. Kalau kontrakmu nanti menangani pembayaran, hak akses, atau aset bernilai nyata, hentikan eksperimen mandiri dan minta audit atau bantuan developer berpengalaman. Mainnet bukan tempat latihan.
Kapan Pindah ke Hardhat atau Foundry
Remix bagus untuk belajar sintaks, tapi melelahkan begitu proyekmu tumbuh. Tandanya sederhana: kamu mulai butuh test otomatis, file terpisah, kontrol versi, atau build yang jalan di CI. Di titik itu, pindah ke tooling lokal. Sebagai gambaran, alur compile manual dengan paket solc dan file build sendiri pernah jadi pendekatan yang lazim [S5], dan Ganache bisa dipakai sebagai jaringan lokal [S2].
| Kebutuhan | Remix | Hardhat / Foundry |
|---|---|---|
| Belajar sintaks dan coba cepat | Cocok | Bisa, tapi lebih berat di awal |
| Test otomatis dan struktur proyek | Terbatas | Dirancang untuk ini |
| Kolaborasi lewat repositori dan CI | Kurang praktis | Lebih praktis |
Jadi, urutannya jelas: pahami dulu satu kontrak kecil di Remix, pastikan compile dan deploy-nya kamu mengerti, baru pindah tooling. Selamat mencoba — dan simpan seed phrase itu baik-baik.
