Hardhat

Apa Itu Hardhat?

Hardhat adalah lingkungan pengembangan open-source yang digunakan untuk menulis, mengompilasi, menguji, men-debug, men-deploy, dan memverifikasi smart contract Ethereum.

Hardhat menyediakan ruang kerja terstruktur bagi developer mata uang kripto untuk membangun aplikasi yang berjalan di Ethereum Virtual Machine, yang biasa disebut EVM.

Hardhat bukan blockchain, mata uang kripto, wallet, token, atau bahasa pemrograman smart contract.

Hardhat adalah alat developer yang mengoordinasikan compiler, test runner, jaringan blockchain simulasi, sistem deployment, library, skrip, dan plugin.

Dokumentasi resmi Hardhat menggambarkan Hardhat sebagai lingkungan fleksibel dan extensible untuk menulis, menguji, men-debug, dan men-deploy perangkat lunak Ethereum.

Developer dapat menggunakan Hardhat untuk menguji perilaku contract secara lokal sebelum mengirim transaksi ke blockchain publik, tempat kesalahan dapat menjadi permanen dan mahal.

Hardhat dikelola oleh Nomic Foundation untuk komunitas pengembangan Ethereum.

Versi Hardhat Saat Ini

Hardhat 3 adalah versi mayor terbaru dari lingkungan pengembangan ini.

Per 13 Juli 2026, rilis berlabel terbaru adalah Hardhat 3.9.1, yang dirilis pada 2 Juli 2026.

Rangkaian rilis saat ini mencakup sistem plugin yang didesain ulang, pengujian native Solidity, code coverage bawaan, simulasi multichain, artifact bertipe, build profile, dan network manager baru.

Developer yang memelihara proyek lama sebaiknya memastikan plugin dan file konfigurasinya mendukung Hardhat 3 sebelum melakukan upgrade.

Proyek sebaiknya menetapkan versi pasti dependensi pengembangan, bukan otomatis menerima setiap rilis mayor di masa mendatang.

Mengapa Hardhat Digunakan dalam Pengembangan Kripto

Smart contract dapat mengendalikan token, treasury protokol, posisi pinjaman, sistem staking, governance terdesentralisasi, dan aset kripto bernilai lainnya.

Kesalahan pemrograman dapat membekukan dana, memungkinkan transfer tanpa izin, salah menghitung saldo, atau menciptakan kondisi ekonomi yang dapat dieksploitasi.

Hardhat membantu developer menemukan masalah sebelum contract di-deploy ke blockchain aktif.

Hardhat dapat mengompilasi kode sumber Solidity, menjalankan tes otomatis, menyimulasikan transaksi, menampilkan execution trace, memperkirakan penggunaan gas, dan men-deploy contract melalui prosedur yang dapat diulang.

Hardhat juga membantu tim pengembangan menstandardisasi struktur proyek dan mengotomatiskan pekerjaan melalui skrip dan sistem continuous integration.

Hardhat meningkatkan proses pengembangan, tetapi tidak menjamin keamanan smart contract.

Peninjauan independen, threat modeling, pengujian, pemantauan, dan kontrol akses yang cermat tetap diperlukan untuk aplikasi kripto produksi.

Arsitektur Hardhat 3

Hardhat 3 memisahkan sebagian besar fungsinya ke dalam runtime inti dan plugin opsional.

Lingkungan inti memuat konfigurasi proyek, mengelola task, membuat koneksi blockchain, dan menyediakan layanan pengembangan bagi skrip serta pengujian.

Plugin dapat menambahkan library contract, alat assertion, fungsi deployment, layanan verifikasi, test runner, dukungan penandatanganan perangkat keras, dan kemampuan lainnya.

Desain modular ini memungkinkan proyek memasang hanya alat yang benar-benar dibutuhkan.

Artinya, dua proyek Hardhat dapat berperilaku berbeda jika menggunakan kombinasi plugin yang berbeda.

Developer sebaiknya mendokumentasikan setiap plugin yang diperlukan dan menetapkan versi yang kompatibel dalam konfigurasi paket proyek.

Hardhat Runtime Environment

Hardhat Runtime Environment adalah objek utama yang digunakan skrip, task, dan plugin untuk mengakses fitur Hardhat.

Istilah ini sering disingkat menjadi HRE.

HRE dapat menyediakan data konfigurasi, koneksi jaringan, artifact, ekstensi plugin, dan fungsi terkait task.

Hardhat 3 dapat membuat lebih dari satu lingkungan runtime independen secara terprogram.

Fitur ini berguna untuk skrip tingkat lanjut, sistem pengujian, dan aplikasi yang membutuhkan konfigurasi terisolasi atau koneksi jaringan secara bersamaan.

Dokumentasi Hardhat Runtime Environment menjelaskan cara runtime menghubungkan konfigurasi proyek dengan plugin dan alur kerja pengembangan.

Struktur Proyek Hardhat

Proyek Hardhat biasanya berupa paket npm yang berisi file konfigurasi proyek dan beberapa direktori pengembangan.

File konfigurasi utamanya biasanya bernama

.

Direktori

biasanya berisi smart contract Solidity.

Direktori

berisi pengujian otomatis yang ditulis dalam Solidity atau TypeScript.

Direktori

berisi modul deployment yang digunakan Hardhat Ignition.

Direktori

berisi skrip otomatisasi khusus.

Proyek juga menyertakan file

yang mencatat Hardhat, plugin, library, dan dependensi pengembangan lainnya.

Struktur proyek yang konsisten memudahkan pengujian, peninjauan, orientasi anggota baru, dan deployment otomatis.

Memasang Hardhat

Hardhat biasanya dipasang sebagai dependensi pengembangan di dalam proyek JavaScript atau TypeScript.

Pengaturan resmi saat ini membutuhkan Node.js versi 22.13.0 atau lebih baru.

Proyek baru dapat diinisialisasi dengan perintah

.

Proses inisialisasi dapat membuat contract contoh, pengujian, konfigurasi, skrip, dan modul deployment.

Developer sebaiknya menggunakan versi Node.js yang didukung karena runtime yang tidak didukung dapat menyebabkan kegagalan instalasi atau perilaku yang tidak konsisten.

Kebijakan dukungan Node.js resmi menjelaskan lini rilis Node.js yang didukung Hardhat 3.

Konfigurasi Hardhat

File konfigurasi Hardhat menentukan cara proyek dikompilasi, diuji, dihubungkan, dan di-deploy.

File ini dapat menentukan versi compiler Solidity, pengaturan optimizer, plugin, jaringan, sumber akun, build profile, dan opsi task.

File konfigurasi Hardhat 3 menggunakan ECMAScript Modules secara default.

Skrip dan pengujian tetap dapat menggunakan format modul lain jika didukung lingkungannya.

Konfigurasi harus ditinjau dengan cermat karena pengaturan compiler atau optimizer yang berbeda dapat menghasilkan bytecode berbeda saat deployment.

Contract harus diverifikasi menggunakan versi dan pengaturan compiler yang sama dengan yang menghasilkan kode yang di-deploy.

Variabel Konfigurasi dan Rahasia

Proyek pengembangan kripto sering membutuhkan kunci privat, alamat remote procedure call, dan nilai sensitif lainnya.

Hardhat 3 mendukung variabel konfigurasi yang dimuat secara lazy hanya saat task benar-benar membutuhkannya.

Nilai tersebut dapat disimpan di luar repositori sumber untuk mengurangi risiko terpublikasi secara tidak sengaja.

Panduan variabel konfigurasi Hardhat menjelaskan cara memvalidasi, memformat, dan menyediakan nilai melalui sistem penyimpanan eksternal.

Hardhat juga menyediakan plugin keystore resmi yang dapat menyimpan nilai tertentu dalam bentuk terenkripsi.

Enkripsi tidak membuat komputer yang lemah atau kata sandi yang dicuri menjadi aman.

Kunci deployment produksi sebaiknya menggunakan kontrol akses yang kuat, saldo terbatas, penandatanganan perangkat keras, otorisasi multisignature, atau proses pengelolaan kunci lain yang telah ditinjau dengan cermat.

Mengompilasi Contract Solidity

Hardhat mengompilasi kode sumber Solidity menjadi bytecode yang dapat berjalan di EVM.

Kompilasi juga menghasilkan application binary interface, yang biasa disebut ABI.

ABI menjelaskan fungsi, event, error, dan jenis parameter contract yang dapat dipanggil.

Wallet, skrip, aplikasi front-end, dan contract lain menggunakan informasi ABI untuk mengodekan dan mendekode interaksi.

Hardhat dapat mendukung beberapa versi compiler Solidity dalam satu proyek jika file sumber yang berbeda memerlukannya.

Developer sebaiknya menghindari variasi compiler yang tidak perlu karena meningkatkan kompleksitas peninjauan dan verifikasi.

Compiler harus dikonfigurasi secara eksplisit, bukan mengandalkan asumsi pengaturan default.

Build Artifact Hardhat

Setelah kompilasi, Hardhat membuat artifact yang berisi informasi tentang setiap contract.

Artifact dapat mencakup nama contract, ABI, bytecode pembuatan, bytecode yang di-deploy, referensi link, dan informasi sumber.

Hardhat 3 juga membuat deklarasi TypeScript untuk artifact bertipe secara default.

Artifact bertipe dapat membantu alat pengembangan mendeteksi nama fungsi, jenis argumen, dan interaksi contract yang keliru sebelum runtime.

Spesifikasi artifact Hardhat mendokumentasikan struktur artifact contract dan informasi build.

Artifact sebaiknya dihasilkan dari kode sumber tepercaya dan pengaturan compiler yang dapat direproduksi.

Artifact lama sebaiknya dibersihkan ketika pengaturan compiler, nama contract, atau dependensi berubah secara signifikan.

Build Profile

Hardhat 3 mendukung build profile yang menentukan pengaturan compiler berbeda untuk alur kerja yang berbeda.

Profil pengembangan dapat memprioritaskan kompilasi cepat dan informasi debugging terperinci.

Profil produksi dapat mengaktifkan pengaturan optimizer persis yang ditujukan untuk deployment.

Profil coverage dapat mengubah bytecode agar jalur kode yang dijalankan dapat diukur.

Build profile mengurangi kebutuhan untuk terus mengubah satu konfigurasi.

Namun, tim harus mencatat dengan jelas profil mana yang menghasilkan setiap deployment.

Men-deploy contract dengan profil yang tidak dimaksudkan dapat menghasilkan bytecode, perilaku gas, atau hasil verifikasi yang berbeda.

Jaringan Blockchain Simulasi

Hardhat menyediakan jaringan simulasi yang berjalan secara lokal untuk pengembangan dan pengujian.

Jaringan simulasi memungkinkan developer men-deploy contract dan mengirim transaksi tanpa mengeluarkan mata uang kripto sungguhan.

Jaringan ini dapat membuat akun uji dengan saldo, langsung menambang blok, mengubah timestamp, mengatur saldo, menyamar sebagai akun, dan mereset state.

Kemampuan ini memungkinkan pengujian kondisi tidak biasa yang sulit atau mahal direproduksi di blockchain publik.

Hardhat 3 menggunakan runtime simulasi berbasis EDR yang ditulis dalam Rust.

Lingkungan simulasi ini dirancang untuk pengujian cepat, error terperinci, execution trace, dan state blockchain yang terkontrol.

Simulasi lokal berguna, tetapi tidak dapat mereproduksi setiap kondisi jaringan nyata secara sempurna.

Simulasi Multichain

Hardhat 3 dirancang untuk mendukung pengembangan di berbagai jenis chain yang kompatibel dengan EVM.

Proyek dapat mengonfigurasi beberapa jaringan simulasi dengan perilaku berbeda.

Dokumentasi resmi menyebutkan dukungan simulasi kelas satu untuk Ethereum Mainnet dan OP Mainnet, dengan jenis chain generik yang tersedia untuk lingkungan kompatibel lainnya.

Dokumentasi multichain Hardhat menjelaskan bagaimana jenis chain memungkinkan jaringan simulasi mereproduksi perilaku khusus chain dengan lebih akurat.

Developer sebaiknya menguji contract berdasarkan aturan eksekusi sebenarnya dari setiap jaringan tempat contract akan di-deploy.

Contract yang berfungsi dengan benar dalam satu konfigurasi jaringan dapat berperilaku berbeda ketika aturan gas, predeploy, atau format transaksi berubah.

Hardhat Network Manager

Hardhat Network Manager mengelola koneksi ke jaringan blockchain simulasi dan eksternal.

Hardhat 3 memungkinkan task dan skrip membuat lebih dari satu koneksi jaringan secara bersamaan.

Fitur ini berguna untuk aplikasi lintas jaringan, pengujian bridge, koordinasi deployment, dan aplikasi yang membaca dari satu chain sambil menulis ke chain lain.

Nama jaringan dalam konfigurasi merupakan label koneksi, bukan bukti bahwa koneksi tersebut mengarah ke blockchain yang diharapkan.

Developer sebaiknya memverifikasi chain ID, blok terbaru, saldo akun, dan target deployment sebelum menandatangani transaksi.

Panduan pengelolaan jaringan menjelaskan cara Hardhat terhubung ke jaringan simulasi dan endpoint JSON-RPC jarak jauh.

Melakukan Fork Jaringan Blockchain

Fork jaringan memungkinkan simulasi Hardhat lokal menyalin state blockchain dari blok tertentu di jaringan publik.

Lingkungan lokal kemudian dapat berinteraksi dengan contract, saldo, akun, dan penyimpanan yang sudah ada tanpa mengubah jaringan nyata.

Pengujian fork berguna untuk menguji integrasi protokol, skenario likuidasi, perubahan governance, perilaku token, dan upgrade contract.

Fork sebaiknya ditetapkan pada nomor blok tertentu jika hasil yang dapat diulang diperlukan.

Pengujian terhadap blok terbaru yang tidak ditentukan dapat menghasilkan hasil berbeda saat state publik berubah.

Penyedia data jarak jauh juga dapat membatasi permintaan, mencatat aktivitas proyek, atau sementara memberikan informasi yang tidak lengkap.

Pengujian fork tidak boleh disamakan dengan otorisasi untuk mengendalikan akun atau aset nyata.

Menguji Smart Contract dengan Hardhat

Pengujian otomatis merupakan salah satu fungsi terpenting Hardhat.

Hardhat 3 mendukung pengujian yang ditulis langsung dalam Solidity dan pengujian integrasi yang ditulis dalam TypeScript.

Kedua pendekatan pengujian tersebut dapat digunakan bersama dalam satu proyek.

Pengujian Solidity berguna untuk memeriksa perilaku contract secara terfokus karena tes berjalan di lingkungan EVM.

Pengujian TypeScript berguna untuk alur kerja aplikasi, beberapa akun, logika off-chain, data eksternal, dan perilaku integrasi yang lebih luas.

Ikhtisar pengujian resmi Hardhat menjelaskan keunggulan kedua pendekatan tersebut.

Rangkaian pengujian yang kuat sebaiknya mencakup operasi yang berhasil, kegagalan yang diharapkan, pembatasan akses, masukan ekstrem, transisi state, dan urutan transaksi yang tidak biasa.

Pengujian Solidity

Hardhat mengenali file pengujian Solidity melalui konvensi direktori dan nama file yang didukung.

Fungsi pengujian publik dapat men-deploy contract, memanggil fungsi, memeriksa state, dan gagal jika kondisi yang diharapkan tidak terpenuhi.

Pengujian Solidity dapat menggunakan cheatcode untuk mengubah lingkungan pengujian.

Cheatcode dapat mengubah pemanggil, memajukan waktu, mengubah saldo, mengharapkan event, mengharapkan revert, atau memeriksa penyimpanan.

Kontrol ini memudahkan pengujian kondisi yang biasanya memerlukan waktu lama atau pengaturan rumit.

Cheatcode memengaruhi lingkungan pengujian simulasi dan bukan fungsi yang tersedia bagi pengguna biasa di blockchain publik.

Fuzz Testing

Fuzz testing menjalankan fungsi contract berulang kali dengan nilai masukan yang dihasilkan secara otomatis.

Metode ini dapat menemukan edge case yang tidak dicantumkan developer dalam contoh manual.

Perhitungan token mungkin berfungsi untuk nilai umum tetapi gagal pada nol, bilangan bulat maksimum, batas pembulatan, atau kombinasi state yang tidak terduga.

Fuzz test sebaiknya menetapkan asumsi yang realistis agar nilai yang dihasilkan tetap bermakna.

Fuzz test yang lolos tidak membuktikan contract aman karena pengujian hanya mengeksplorasi masukan dan properti yang dikonfigurasi.

Invariant penting sebaiknya ditulis secara eksplisit agar sistem pengujian mengetahui perilaku yang harus selalu benar.

Invariant Testing

Invariant adalah properti yang seharusnya tetap benar sepanjang berbagai urutan tindakan yang mungkin terjadi.

Protokol pinjaman dapat mensyaratkan agar total utang yang tercatat sama dengan jumlah utang pengguna.

Token dapat mensyaratkan total suplai sama dengan seluruh saldo yang dilacak sesuai model akuntansinya.

Sistem market maker otomatis dapat mensyaratkan agar hubungan cadangan tertentu tetap valid.

Invariant test dapat menghasilkan urutan transaksi dan memverifikasi bahwa properti tersebut tetap terjaga.

Pengujian ini sangat berguna untuk protokol kripto stateful yang kerentanannya baru muncul setelah beberapa operasi terjadi dalam urutan tertentu.

Pengujian TypeScript

Pengujian TypeScript berinteraksi dengan contract melalui library pengembangan dan koneksi blockchain.

Pengaturan Hardhat 3 yang direkomendasikan menggunakan test runner Node.js dengan viem.

Plugin resmi juga mendukung pengaturan berbasis ethers dengan Mocha.

Pengujian TypeScript dapat mengoordinasikan beberapa contract, akun, file, API, dan koneksi jaringan.

Pengujian ini juga dapat memeriksa alur kerja yang sama dengan yang digunakan perangkat lunak off-chain aplikasi terdesentralisasi.

Pengujian sebaiknya tidak bergantung secara berlebihan pada layanan eksternal aktif karena layanan yang tidak tersedia dapat membuat hasil tidak andal.

Code Coverage

Code coverage mengukur pernyataan, cabang, fungsi, dan jalur contract yang dijalankan selama pengujian.

Hardhat 3 menyertakan code coverage Solidity bawaan.

Coverage dapat diminta melalui opsi pengujian

.

Panduan code coverage Hardhat menjelaskan bahwa alat ini menyisipkan penanda ke dalam contract selama proses coverage.

Bytecode yang telah diberi instrumentasi berbeda dari bytecode produksi biasa dan mungkin menggunakan lebih banyak gas.

Coverage tinggi tidak membuktikan bahwa tes memiliki assertion yang berguna atau bahwa contract aman.

Tes dapat menjalankan setiap baris kode tanpa memeriksa hasil ekonomi yang paling penting.

Statistik Gas dan Gas Snapshot

Hardhat dapat mengukur gas yang digunakan fungsi contract publik selama pengujian.

Opsi

dapat menampilkan statistik penggunaan gas untuk tes yang didukung.

Gas snapshot dapat mencatat nilai gas yang diharapkan dan mengidentifikasi perubahan yang tidak terduga antara revisi kode.

Alat ini membantu developer menemukan fungsi yang mahal, pola yang banyak menggunakan penyimpanan, dan regresi gas yang tidak disengaja.

Hasil gas dari jaringan simulasi mungkin tidak mencakup setiap biaya yang dialami pengguna di jaringan produksi.

Biaya khusus Layer, biaya publikasi data, kepadatan jaringan, dan perubahan aturan protokol dapat memengaruhi biaya transaksi akhir.

Optimasi gas tidak boleh mengurangi keamanan validasi, otorisasi, atau akuntansi.

Debugging dengan Hardhat

Hardhat dapat menampilkan error Solidity, log yang didekode, stack trace, dan execution trace.

Execution trace menunjukkan urutan pemanggilan contract dan operasi dalam suatu transaksi.

Panduan execution trace Hardhat menjelaskan cara pengaturan verbosity mengendalikan jumlah keluaran debugging.

Trace terperinci dapat menunjukkan pemanggilan yang mengalami revert, fungsi yang dijalankan, dan perkembangan interaksi contract bertingkat.

Tracing sangat berguna untuk protokol dengan proxy, callback, hook, transfer token, dan beberapa contract yang terhubung.

Keluaran debugging dapat memuat alamat, parameter, atau informasi pengembangan sensitif lainnya sehingga harus ditangani dengan hati-hati dalam log bersama.

Console Logging Solidity

Hardhat mendukung console logging untuk pengembangan dari kode Solidity di lingkungan simulasi.

Developer dapat mencetak nilai saat tes atau transaksi lokal berjalan.

Fitur ini memudahkan pemeriksaan state, pemanggil, saldo, dan perhitungan antara.

Logging pengembangan tidak sebaiknya dibiarkan dalam kode produksi tanpa alasan yang jelas.

Helper logging dapat memengaruhi bytecode, ukuran contract, dan perilaku deployment.

Assertion dan tes otomatis sebaiknya menggantikan pernyataan debug sementara sebelum rilis.

Task Hardhat

Task Hardhat adalah perintah bernama yang mengotomatiskan bagian dari alur kerja pengembangan.

Task dapat mengompilasi contract, memeriksa akun, membuat laporan, mengelola deployment, atau menjalankan operasi khusus proyek.

Plugin dapat mendaftarkan task yang tersedia melalui antarmuka command line.

Task khusus sebaiknya memvalidasi identitas jaringan dan masukan pengguna sebelum mengirim transaksi.

Task berisiko tidak boleh diam-diam menggunakan akun pertama yang tersedia atau menetapkan jaringan produksi sebagai default.

Nama perintah yang jelas dan pemeriksaan konfirmasi mengurangi risiko deployment atau transfer dana yang tidak disengaja.

Skrip Hardhat

Skrip Hardhat adalah program TypeScript atau JavaScript yang menggunakan runtime environment dan plugin terpasang.

Skrip dapat men-deploy contract, memanggil fungsi, membaca state, mentransfer peran administratif, atau membuat catatan deployment.

Skrip bersifat fleksibel, tetapi memberi developer tanggung jawab lebih besar daripada sistem deployment terstruktur.

Skrip yang gagal dapat menyisakan beberapa transaksi yang sudah selesai sementara transaksi berikutnya belum dijalankan.

Skrip sebaiknya dirancang untuk mendeteksi state yang sudah ada dan menghindari pengulangan operasi berbahaya.

Skrip produksi sebaiknya mencatat hash transaksi, alamat contract yang di-deploy, parameter, ID jaringan, dan hasilnya.

Hardhat Ignition

Hardhat Ignition adalah sistem deployment deklaratif resmi yang disediakan untuk proyek Hardhat.

Developer menjelaskan instance contract dan operasi yang diinginkan melalui modul deployment.

Ignition menganalisis definisi tersebut dan menentukan cara menjalankan deployment.

Ignition dapat mengirim transaksi independen secara paralel, memulihkan diri dari error tertentu, dan melanjutkan deployment yang terputus.

Panduan deployment Hardhat Ignition menjelaskan cara contract dan pemanggilan pascadeployment dikelompokkan ke dalam modul.

Deployment deklaratif mengurangi beberapa risiko skrip manual, tetapi logika dan parameter modul tetap harus ditinjau dengan cermat.

Sistem otomatis dapat mengulangi kesalahan secara konsisten jika definisi deployment keliru.

Men-deploy Smart Contract

Deployment mengirim transaksi pembuatan contract ke jaringan blockchain.

Transaksi memuat bytecode pembuatan yang telah dikompilasi dan parameter constructor.

Setelah dikonfirmasi, contract menerima alamat yang ditentukan oleh aturan pembuatan blockchain.

Deployment sebaiknya menggunakan compiler, optimizer, argumen constructor, akun, chain, dan pengaturan gas yang dimaksud.

Tim sebaiknya melakukan deployment simulasi final menggunakan artifact produksi yang persis sama sebelum mengirim transaksi aktif.

Tim juga sebaiknya segera memverifikasi peran administratif, kepemilikan, izin upgrade, alamat treasury, dan kontrol darurat setelah deployment.

Kunci privat tidak boleh disimpan langsung dalam file konfigurasi Hardhat atau repositori sumber.

Verifikasi Smart Contract

Verifikasi smart contract menghubungkan bytecode yang di-deploy dengan kode sumber dan pengaturan compiler yang diklaim.

Kode sumber terverifikasi memungkinkan pengguna, auditor, wallet, dan alat pemantauan memeriksa perilaku yang dimaksud contract.

Hardhat menyediakan plugin verifikasi resmi.

Panduan verifikasi Hardhat menjelaskan bahwa verifikasi membuktikan bytecode yang di-deploy dihasilkan dari kode sumber tertentu.

Verifikasi tidak membuktikan bahwa kode sumber aman, adil, atau bebas dari risiko ekonomi tersembunyi.

Parameter constructor, library yang ditautkan, pengaturan optimizer, metadata, dan versi compiler harus sesuai dengan deployment.

Tim sebaiknya menyimpan informasi build agar verifikasi dapat direproduksi di kemudian hari.

Plugin Hardhat

Plugin memperluas Hardhat dengan fungsi pengembangan tambahan.

Plugin resmi mendukung viem, ethers, assertion, helper jaringan, verifikasi contract, deployment Ignition, penyimpanan konfigurasi terenkripsi, hardware signer, dan test runner.

Direktori plugin resmi mencantumkan plugin yang dikelola Nomic Foundation.

Plugin komunitas dapat menyediakan fitur berguna, tetapi mungkin tidak mendapatkan peninjauan atau pemeliharaan yang sama.

Plugin berbahaya berpotensi membaca file proyek, variabel lingkungan, kunci, data deployment, dan lalu lintas jaringan.

Developer sebaiknya memeriksa kepemilikan plugin, riwayat pembaruan, kode sumber, dependensi, izin, dan kompatibilitas sebelum memasangnya.

Keamanan Dependensi

Proyek Hardhat bergantung pada paket Node.js yang dapat menjalankan kode selama instalasi, pengujian, atau deployment.

Dependensi yang disusupi dapat berupaya mencuri variabel lingkungan, kunci privat, kode sumber, atau kredensial deployment.

Proyek sebaiknya menyimpan lockfile dalam repositori dan meninjau perubahan dependensi yang tidak terduga.

Deployment produksi sebaiknya menggunakan sistem bersih dengan perangkat lunak minimal dan versi paket yang terverifikasi.

Pembaruan dependensi otomatis tidak boleh digabungkan tanpa pengujian dan peninjauan.

Popularitas sebuah paket tidak menjamin semua rilisnya aman.

Hardhat dan Kunci Privat

Hardhat mungkin memerlukan akses ke akun penandatangan saat men-deploy atau memanggil contract di jaringan eksternal.

Menyimpan kunci privat mentah dalam file konfigurasi teks biasa menimbulkan risiko keamanan serius.

Kunci pengembangan sebaiknya hanya memiliki dana uji.

Kunci produksi sebaiknya dilindungi melalui penyimpanan terenkripsi, penandatanganan perangkat keras, izin terbatas, atau prosedur multisignature.

Jika memungkinkan, akun deployment sebaiknya hanya menyimpan jumlah yang diperlukan untuk transaksi yang direncanakan.

Kepemilikan administratif dapat dipindahkan ke akun yang lebih aman setelah deployment.

Log dan laporan error sebaiknya diperiksa untuk memastikan tidak mengungkap nilai konfigurasi sensitif.

Hardhat dan Hardware Wallet

Hardware wallet dapat menandatangani transaksi deployment atau administrasi Hardhat melalui plugin dan alur kerja yang kompatibel.

Dengan demikian, kunci privat dapat tetap berada di luar komputer pengembangan.

Jika didukung, perangkat keras sebaiknya menampilkan tujuan, jaringan, nilai, dan data contract.

Deployment contract yang rumit mungkin sulit dipahami pada layar perangkat yang kecil.

Hardware wallet tidak dapat mengenali deployment berbahaya hanya karena transaksinya dibuat oleh Hardhat.

Kode sumber, artifact hasil kompilasi, argumen constructor, dan data transaksi tetap harus ditinjau secara independen.

Kesalahan Keamanan Hardhat yang Umum

Salah satu kesalahan umum adalah memasukkan kunci privat atau frasa pemulihan ke repositori sumber.

Kesalahan lain adalah men-deploy ke blockchain yang keliru karena label jaringan dipercaya tanpa memeriksa chain ID.

Kesalahan ketiga adalah menggunakan pengaturan compiler yang berbeda untuk pengujian, deployment, dan verifikasi.

Kesalahan keempat adalah hanya menguji tindakan yang berhasil dan mengabaikan pemanggil tanpa izin serta kondisi kegagalan.

Kesalahan kelima adalah bergantung pada fork state blockchain yang berubah tanpa menetapkan nomor blok.

Kesalahan keenam adalah memasang plugin yang belum ditinjau dan memberinya akses ke rahasia deployment.

Kesalahan ketujuh adalah menganggap code coverage penuh setara dengan audit keamanan.

Kesalahan kedelapan adalah memberikan kendali permanen atas seluruh fungsi protokol kepada akun deployment.

Kesalahan kesembilan adalah tidak memverifikasi alamat yang di-deploy dan kepemilikan setelah deployment selesai.

Kesalahan kesepuluh adalah mengirim dana sungguhan ke alamat pengembangan yang dibuat secara lokal, tetapi kuncinya tidak pernah diamankan.

Praktik Terbaik Hardhat

Tetapkan versi Hardhat, plugin, library, dan compiler dalam file dependensi proyek.

Gunakan rilis Node.js yang didukung dan lockfile paket yang tersimpan di repositori.

Simpan kunci privat dan endpoint sensitif di luar repositori sumber.

Gunakan akun terpisah untuk pengujian lokal, pengujian publik, deployment, dan administrasi jangka panjang.

Tulis pengujian unit, integrasi, fuzz, invariant, kontrol akses, dan kondisi kegagalan.

Jalankan code coverage, tetapi ingat bahwa coverage mengukur eksekusi, bukan kebenaran.

Gunakan pengujian fork pada blok yang telah ditetapkan untuk pengujian integrasi protokol yang dapat diulang.

Tinjau perubahan gas dan ukuran contract sebelum deployment.

Verifikasi kode sumber dan simpan informasi build setelah deployment.

Gunakan peninjauan keamanan independen untuk contract yang mengendalikan aset kripto bernilai signifikan.

Keterbatasan Hardhat

Hardhat tidak dapat membuktikan bahwa desain ekonomi contract aman.

Hardhat tidak dapat menjamin rangkaian pengujian mencakup setiap jalur serangan.

Hardhat tidak dapat mereproduksi setiap kondisi jaringan produksi secara sempurna.

Hardhat tidak dapat mencegah developer menandatangani transaksi dengan akun atau jaringan yang salah.

Hardhat tidak dapat mengamankan kunci privat yang disimpan secara ceroboh dalam proyek.

Hardhat tidak dapat membuat dependensi pihak ketiga yang tidak aman menjadi tepercaya.

Hardhat tidak dapat menggantikan verifikasi formal, audit, bug bounty, pemantauan, dan perencanaan respons insiden.

Hardhat paling efektif jika digunakan sebagai bagian dari proses pengembangan aman yang lebih luas.

FAQ

Apa itu Hardhat dalam mata uang kripto?

Hardhat adalah lingkungan pengembangan yang digunakan untuk mengompilasi, menguji, men-debug, men-deploy, dan memverifikasi smart contract Ethereum serta yang kompatibel dengan EVM.

Apakah Hardhat merupakan blockchain?

Bukan. Hardhat adalah alat pengembangan perangkat lunak, bukan jaringan blockchain.

Apakah Hardhat merupakan mata uang kripto?

Bukan. Hardhat bukan koin atau token.

Siapa yang mengembangkan Hardhat?

Hardhat dikembangkan oleh Nomic Foundation untuk komunitas pengembangan Ethereum.

Apa versi mayor Hardhat saat ini?

Hardhat 3 adalah lini rilis mayor saat ini.

Apa versi Hardhat terbaru?

Per 13 Juli 2026, rilis berlabel terbaru adalah Hardhat 3.9.1.

Bahasa pemrograman apa yang digunakan Hardhat?

Proyek Hardhat biasanya menggunakan Solidity untuk smart contract dan TypeScript atau JavaScript untuk konfigurasi, skrip, dan pengujian integrasi.

Apa yang dikompilasi Hardhat?

Hardhat mengompilasi kode sumber Solidity menjadi bytecode EVM, ABI, artifact, dan informasi build terkait.

Apakah Hardhat menyertakan blockchain lokal?

Hardhat menyediakan jaringan blockchain simulasi yang dirancang untuk pengembangan lokal dan pengujian otomatis.

Apakah Hardhat mendukung pengujian Solidity?

Ya. Hardhat 3 mendukung tes yang ditulis langsung dalam Solidity serta tes berbasis TypeScript.

Bisakah Hardhat menjalankan fuzz testing?

Bisa. Tes Solidity dapat menghasilkan beragam masukan untuk menguji properti dan edge case.

Bisakah Hardhat menguji invariant contract?

Bisa. Developer dapat menetapkan properti yang harus tetap benar dalam berbagai urutan tindakan contract yang dihasilkan.

Apa itu Hardhat Ignition?

Hardhat Ignition adalah sistem deployment deklaratif resmi untuk menetapkan, menjalankan, melanjutkan, dan mencatat deployment smart contract.

Bisakah Hardhat men-deploy contract ke jaringan publik?

Bisa. Hardhat dapat terhubung ke endpoint JSON-RPC eksternal dan mengirim transaksi deployment bertanda tangan.

Apakah Hardhat memerlukan mata uang kripto sungguhan untuk pengujian lokal?

Tidak. Jaringan simulasi menyediakan akun dan saldo pengembangan yang tidak memiliki nilai di dunia nyata.

Apa itu fork jaringan di Hardhat?

Fork jaringan menyalin state blockchain dari blok jaringan publik tertentu ke simulasi lokal untuk pengujian.

Bisakah Hardhat memverifikasi smart contract?

Bisa. Plugin verifikasi resmi dapat mengirim kode sumber dan informasi build ke layanan verifikasi yang didukung.

Apakah verifikasi contract membuktikan contract aman?

Tidak. Verifikasi menghubungkan kode sumber dengan bytecode yang di-deploy, tetapi tidak membuktikan bahwa logikanya aman atau sehat secara ekonomi.

Apakah code coverage tinggi berarti contract aman?

Tidak. Coverage tinggi hanya menunjukkan bahwa kode dijalankan selama pengujian dan tidak membuktikan bahwa properti yang benar telah diperiksa.

Bisakah Hardhat memperkirakan penggunaan gas?

Bisa. Hardhat dapat menghasilkan statistik dan snapshot gas selama pengujian yang didukung.

Bisakah Hardhat terhubung ke beberapa jaringan blockchain?

Bisa. Hardhat 3 dapat mengelola beberapa koneksi jaringan dan konfigurasi chain simulasi.

Apakah aman menyimpan kunci privat dalam konfigurasi Hardhat?

Tidak. Kunci privat sebaiknya dimuat melalui sistem eksternal yang terlindungi, bukan disimpan sebagai teks biasa dalam repositori.

Bisakah Hardhat menggunakan hardware wallet?

Bisa. Plugin dan alur kerja yang kompatibel dapat menggunakan perangkat keras untuk menandatangani transaksi deployment dan administrasi tertentu.

Apakah semua plugin Hardhat aman?

Tidak. Plugin dapat mengakses sumber daya proyek yang sensitif dan harus ditinjau sebelum dipasang.

Bisakah Hardhat menggantikan audit smart contract?

Tidak. Hardhat mendukung pengembangan dan pengujian, tetapi tidak menggantikan penilaian keamanan independen.

Mengapa pengujian fork sebaiknya menggunakan blok tetap?

Penetapan blok membuat state blockchain yang disalin tetap stabil sehingga pengujian di masa mendatang dapat direproduksi.

Bisakah Hardhat mencegah deployment ke jaringan yang salah?

Hardhat dapat mendukung pemeriksaan, tetapi developer tetap harus memverifikasi chain ID, akun, endpoint, dan parameter deployment.

Kesimpulan

Hardhat adalah lingkungan pengembangan menyeluruh untuk membuat perangkat lunak smart contract Ethereum dan yang kompatibel dengan EVM.

Hardhat menggabungkan kompilasi, artifact, jaringan simulasi, pengujian, debugging, deployment, verifikasi, skrip, task, dan plugin dalam satu struktur proyek.

Hardhat 3 adalah rilis mayor saat ini dan menghadirkan pengujian native Solidity, simulasi multichain, artifact bertipe, build profile, code coverage, serta pengelolaan jaringan yang lebih fleksibel.

Developer dapat menggunakan Hardhat untuk menguji contract secara lokal sebelum mengeluarkan mata uang kripto sungguhan atau mempertaruhkan aset pengguna.

Hardhat Ignition menyediakan sistem deployment terstruktur yang dapat melanjutkan pekerjaan yang terputus dan mencatat state deployment.

Pengujian fork memungkinkan developer mereproduksi state blockchain publik dan menguji interaksi dengan contract yang sudah ada.

Execution trace, laporan coverage, fuzz test, invariant, dan statistik gas dapat mengungkap banyak masalah teknis sebelum deployment.

Alat-alat ini tidak menjamin keamanan karena kualitas hasil tetap bergantung pada kode sumber, pengujian, asumsi, dependensi, kunci, dan proses deployment.

Kunci privat harus berada di luar repositori sumber dan dilindungi dengan prosedur penandatanganan serta kontrol akses yang kuat.

Plugin dan dependensi paket perlu ditinjau karena dapat mengakses sumber daya pengembangan yang sensitif.

Contract produksi sebaiknya menggunakan pengaturan compiler yang ditetapkan, build yang dapat direproduksi, kode sumber terverifikasi, peninjauan independen, dan pemantauan pascadeployment.

Bagi developer mata uang kripto, Hardhat paling tepat dipahami sebagai ruang kerja andal untuk mengurangi risiko pengembangan smart contract, bukan sebagai pengganti rekayasa dan peninjauan keamanan yang cermat.