Hardhat

Hardhat là gì?

Hardhat là môi trường phát triển mã nguồn mở dùng để viết, biên dịch, kiểm thử, gỡ lỗi, triển khai và xác minh hợp đồng thông minh Ethereum.Công cụ cung cấp cho nhà phát triển tiền mã hóa một không gian làm việc có cấu trúc để xây dựng ứng dụng chạy trên Ethereum Virtual Machine, thường gọi là EVM.Hardhat không phải blockchain, tiền mã hóa, ví, token hay ngôn ngữ lập trình hợp đồng thông minh.Đây là công cụ dành cho nhà phát triển, giúp phối hợp trình biên dịch, bộ chạy kiểm thử, mạng blockchain mô phỏng, hệ thống triển khai, thư viện, script và plugin.

Tài liệu chính thức của Hardhat mô tả Hardhat là môi trường linh hoạt, có thể mở rộng để viết, kiểm thử, gỡ lỗi và triển khai phần mềm Ethereum.

Nhà phát triển có thể dùng Hardhat để kiểm thử hợp đồng cục bộ trước khi gửi giao dịch lên blockchain công khai, nơi sai sót có thể trở thành vĩnh viễn và tốn kém.Hardhat được Nomic Foundation duy trì cho cộng đồng phát triển Ethereum.

Phiên bản Hardhat hiện tại

Hardhat 3 là phiên bản chính hiện tại của môi trường phát triển này.

Tính đến ngày 13 tháng 7 năm 2026, bản phát hành mới nhất được gắn thẻ là Hardhat 3.9.1, phát hành ngày 2 tháng 7 năm 2026.

Dòng phát hành hiện tại gồm hệ thống plugin được thiết kế lại, kiểm thử thuần Solidity, tính năng đo độ bao phủ mã tích hợp sẵn, mô phỏng đa chain, artifact có kiểu dữ liệu, build profile và network manager mới.Nhà phát triển duy trì dự án cũ nên xác nhận plugin và tệp cấu hình có hỗ trợ Hardhat 3 trước khi nâng cấp.Dự án nên khóa phiên bản dependency phát triển thay vì tự động chấp nhận mọi bản phát hành lớn trong tương lai.

Tại sao Hardhat được dùng trong phát triển crypto?

Hợp đồng thông minh có thể kiểm soát token, ngân quỹ giao thức, vị thế cho vay, hệ thống staking, quản trị phi tập trung và tài sản crypto có giá trị khác.Lỗi lập trình có thể khiến tài sản bị đóng băng, cho phép thực hiện các giao dịch chuyển tài sản không được chủ sở hữu cho phép, tính sai số dư hoặc tạo ra những lỗ hổng kinh tế có thể bị khai thác.Hardhat giúp nhà phát triển tìm lỗi trước khi triển khai hợp đồng lên blockchain hoạt động.Công cụ có thể biên dịch mã nguồn Solidity, chạy kiểm thử tự động, mô phỏng giao dịch, hiển thị execution trace, ước tính mức dùng gas và triển khai hợp đồng theo quy trình có thể lặp lại.Công cụ cũng giúp các nhóm phát triển chuẩn hóa cấu trúc dự án và tự động hóa công việc bằng script cùng hệ thống tích hợp liên tục.Hardhat cải thiện quy trình phát triển nhưng không bảo đảm hợp đồng thông minh an toàn.Đánh giá độc lập, mô hình hóa mối đe dọa, kiểm thử, giám sát và kiểm soát quyền truy cập cẩn trọng vẫn cần thiết đối với ứng dụng crypto đưa vào sản xuất.

Kiến trúc Hardhat 3

Hardhat 3 tách phần lớn chức năng thành runtime cốt lõi và plugin tùy chọn.Môi trường cốt lõi tải cấu hình dự án, quản lý tác vụ, tạo kết nối blockchain và cung cấp dịch vụ phát triển cho script và bài kiểm thử.Plugin có thể bổ sung thư viện hợp đồng, công cụ assertion, chức năng triển khai, dịch vụ xác minh, bộ chạy kiểm thử, hỗ trợ ký bằng phần cứng và các khả năng khác.Thiết kế mô-đun này cho phép dự án chỉ cài các công cụ thực sự cần dùng.Điều đó cũng có nghĩa hai dự án Hardhat có thể hoạt động khác nhau khi sử dụng các tổ hợp plugin khác nhau.Nhà phát triển nên ghi lại mọi plugin bắt buộc và khóa phiên bản tương thích trong cấu hình package của dự án.

Môi trường Runtime của Hardhat

Hardhat Runtime Environment là đối tượng trung tâm để script, tác vụ và plugin truy cập các tính năng Hardhat.Tên này thường được viết tắt là HRE.HRE có thể cung cấp dữ liệu cấu hình, kết nối mạng, artifact, phần mở rộng plugin và các hàm liên quan đến tác vụ.Hardhat 3 có thể lập trình để tạo nhiều môi trường runtime độc lập.Điều này hữu ích cho script nâng cao, hệ thống kiểm thử và ứng dụng cần cấu hình cô lập hoặc kết nối đồng thời với nhiều mạng.

Tài liệu về Hardhat Runtime Environment giải thích cách runtime kết nối cấu hình dự án với plugin và quy trình phát triển.

Cấu trúc dự án Hardhat

Dự án Hardhat thông thường là package npm gồm tệp cấu hình dự án và một số thư mục phát triển.

Tệp cấu hình chính thường có tên

.

Thư mục

thường chứa hợp đồng thông minh Solidity.

Thư mục

chứa bài kiểm thử tự động viết bằng Solidity hoặc TypeScript.

Thư mục

chứa module triển khai dùng bởi Hardhat Ignition.

Thư mục

chứa script tự động hóa tùy chỉnh.

Dự án cũng có tệp

ghi lại Hardhat, plugin, thư viện và dependency phát triển khác.

Duy trì cấu trúc dự án nhất quán giúp việc kiểm thử, rà soát, hướng dẫn thành viên mới và triển khai tự động dễ dàng hơn.

Cài đặt Hardhat

Hardhat thường được cài làm dependency phát triển trong dự án JavaScript hoặc TypeScript.Quy trình thiết lập chính thức hiện tại yêu cầu Node.js phiên bản 22.13.0 trở lên.

Có thể khởi tạo dự án mới bằng lệnh

.

Quy trình khởi tạo có thể tạo hợp đồng mẫu, bài kiểm thử, cấu hình, script và module triển khai.Nhà phát triển nên dùng phiên bản Node.js được hỗ trợ vì runtime không được hỗ trợ có thể gây lỗi cài đặt hoặc hoạt động không nhất quán.

Chính sách hỗ trợ Node.js chính thức giải thích các dòng phát hành Node.js được Hardhat 3 hỗ trợ.

Cấu hình Hardhat

Tệp cấu hình Hardhat quy định cách dự án biên dịch, kiểm thử, kết nối và triển khai.Tệp có thể xác định phiên bản trình biên dịch Solidity, cài đặt optimizer, plugin, mạng, nguồn tài khoản, build profile và tùy chọn tác vụ.Tệp cấu hình Hardhat 3 mặc định sử dụng ECMAScript Modules.Script và bài kiểm thử vẫn có thể sử dụng định dạng module khác nếu môi trường hỗ trợ.Cần rà soát cấu hình cẩn thận vì cài đặt compiler hoặc optimizer khác nhau có thể tạo bytecode triển khai khác nhau.Hợp đồng phải được xác minh bằng cùng phiên bản compiler và cài đặt đã tạo mã được triển khai.

Biến cấu hình và bí mật

Dự án phát triển crypto thường cần khóa riêng tư, địa chỉ Remote Procedure Call và các giá trị nhạy cảm khác.Hardhat 3 hỗ trợ biến cấu hình tải theo nhu cầu, chỉ được nạp khi tác vụ thực sự cần đến.Có thể lưu các giá trị này bên ngoài kho mã nguồn để giảm nguy cơ vô tình công bố.

Hướng dẫn biến cấu hình Hardhat giải thích cách xác thực, định dạng và cung cấp giá trị qua hệ thống lưu trữ bên ngoài.

Hardhat cũng cung cấp plugin keystore chính thức để lưu một số giá trị dưới dạng mã hóa.Mã hóa không thể làm cho máy tính yếu hoặc mật khẩu bị đánh cắp trở nên an toàn.Khóa triển khai production nên dùng kiểm soát truy cập mạnh, số dư giới hạn, ký bằng phần cứng, ủy quyền đa chữ ký hoặc quy trình quản lý khóa được đánh giá cẩn trọng khác.

Biên dịch hợp đồng Solidity

Hardhat biên dịch mã nguồn Solidity thành bytecode có thể chạy trên EVM.Quá trình biên dịch cũng tạo application binary interface, thường gọi là ABI.ABI mô tả hàm có thể gọi, event, lỗi và kiểu tham số của hợp đồng.Ví, script, ứng dụng front-end và hợp đồng khác dùng thông tin ABI để mã hóa và giải mã tương tác.Hardhat có thể hỗ trợ nhiều phiên bản compiler Solidity trong cùng một dự án khi các tệp nguồn khác nhau yêu cầu.Nhà phát triển nên tránh sử dụng nhiều phiên bản compiler không cần thiết vì việc này làm tăng độ phức tạp khi rà soát và xác minh.Nên cấu hình rõ compiler thay vì dựa vào giá trị mặc định giả định.

Build artifact của Hardhat

Sau khi biên dịch, Hardhat tạo artifact chứa thông tin về từng hợp đồng.Artifact có thể bao gồm tên hợp đồng, ABI, bytecode khởi tạo, bytecode đã triển khai, tham chiếu thư viện và thông tin mã nguồn.Hardhat 3 cũng mặc định tạo khai báo TypeScript cho artifact có kiểu dữ liệu.Artifact có kiểu dữ liệu có thể giúp công cụ phát triển phát hiện tên hàm, kiểu đối số và tương tác hợp đồng không chính xác trước khi chạy.

Đặc tả artifact Hardhat ghi lại cấu trúc artifact hợp đồng và thông tin build.

Artifact nên được tạo từ mã nguồn đáng tin cậy và cài đặt compiler có thể tái lập.Nên xóa artifact cũ khi cài đặt compiler, tên hợp đồng hoặc dependency thay đổi đáng kể.

Build profile

Hardhat 3 hỗ trợ build profile để xác định cài đặt compiler khác nhau cho từng quy trình.Profile phát triển có thể ưu tiên biên dịch nhanh và thông tin gỡ lỗi chi tiết.Profile production có thể bật chính xác cài đặt optimizer dự kiến dùng khi triển khai.Profile đo độ bao phủ có thể sửa bytecode để đo các nhánh mã đã chạy.Build profile giúp giảm nhu cầu viết lại cấu hình liên tục.Tuy nhiên, các nhóm phải xác định rõ profile nào đã tạo từng bản triển khai.Triển khai hợp đồng bằng profile không dự kiến có thể tạo bytecode, mức tiêu thụ gas hoặc kết quả xác minh khác.

Mạng blockchain mô phỏng

Hardhat có các mạng mô phỏng chạy cục bộ để phát triển và kiểm thử.Mạng mô phỏng cho phép nhà phát triển triển khai hợp đồng và gửi giao dịch mà không tốn tiền mã hóa thật.Mạng có thể tạo tài khoản thử nghiệm đã nạp tiền, đào block ngay lập tức, sửa dấu thời gian, thay đổi số dư, giả lập tài khoản và đặt lại trạng thái.Những khả năng này cho phép kiểm thử các tình huống bất thường khó hoặc tốn kém để tái hiện trên blockchain công khai.Hardhat 3 dùng runtime mô phỏng do EDR vận hành, được viết bằng Rust.Môi trường mô phỏng được thiết kế để kiểm thử nhanh, báo lỗi chi tiết, tạo execution trace và kiểm soát trạng thái blockchain.Mô phỏng cục bộ hữu ích nhưng không thể tái tạo hoàn hảo mọi điều kiện mạng thực tế.

Mô phỏng đa chain

Hardhat 3 được thiết kế để hỗ trợ phát triển trên nhiều loại chain tương thích EVM.Dự án có thể cấu hình nhiều mạng mô phỏng với hành vi khác nhau.Tài liệu chính thức nêu rõ hỗ trợ mô phỏng hạng nhất cho Ethereum Mainnet và OP Mainnet; đồng thời có loại chain chung cho các môi trường tương thích khác.

Tài liệu đa chain của Hardhat giải thích cách loại chain cho phép mạng mô phỏng tái tạo chính xác hơn hành vi riêng của từng chain.

Nhà phát triển nên kiểm thử theo quy tắc thực thi thực tế của mọi mạng dự kiến triển khai hợp đồng.Hợp đồng hoạt động đúng với cấu hình mạng này có thể hoạt động khác khi quy tắc gas, hợp đồng triển khai sẵn hoặc định dạng giao dịch thay đổi.

Hardhat Network Manager

Hardhat Network Manager quản lý kết nối với mạng blockchain mô phỏng và bên ngoài.Hardhat 3 cho phép tác vụ và script tạo nhiều kết nối mạng cùng lúc.Điều này hữu ích cho ứng dụng đa mạng, kiểm thử bridge, phối hợp triển khai và ứng dụng đọc dữ liệu từ chain này trong khi ghi lên chain khác.Tên mạng trong cấu hình là nhãn kết nối, không phải bằng chứng kết nối đến đúng blockchain dự kiến.Nhà phát triển nên xác minh chain ID, block mới nhất, số dư tài khoản và mục tiêu triển khai trước khi ký giao dịch.

Hướng dẫn quản lý mạng giải thích cách Hardhat kết nối với mạng mô phỏng và endpoint JSON-RPC từ xa.

Fork mạng blockchain

Fork mạng cho phép mô phỏng Hardhat cục bộ sao chép trạng thái blockchain từ một block được chọn trên mạng công khai.Môi trường cục bộ sau đó có thể tương tác với hợp đồng, số dư, tài khoản và dữ liệu lưu trữ hiện có mà không làm thay đổi mạng thật.Kiểm thử fork hữu ích để kiểm tra tích hợp giao thức, tình huống thanh lý, thay đổi quản trị, hành vi token và nâng cấp hợp đồng.Nên cố định fork vào một block cụ thể khi cần kết quả có thể lặp lại.Kiểm thử với block mới nhất không xác định có thể tạo kết quả khác nhau khi trạng thái công khai thay đổi.Nhà cung cấp dữ liệu từ xa cũng có thể giới hạn yêu cầu, ghi nhận hoạt động dự án hoặc tạm thời trả về thông tin chưa đầy đủ.Không được nhầm kiểm thử fork với quyền kiểm soát tài khoản hoặc tài sản thật.

Kiểm thử hợp đồng thông minh bằng Hardhat

Kiểm thử tự động là một trong những chức năng quan trọng nhất của Hardhat.Hardhat 3 hỗ trợ bài kiểm thử viết trực tiếp bằng Solidity và kiểm thử tích hợp viết bằng TypeScript.Có thể kết hợp hai phương pháp trong cùng một dự án.Kiểm thử Solidity hữu ích để kiểm tra hành vi ở cấp hợp đồng vì bài kiểm thử chạy trong môi trường EVM.Kiểm thử TypeScript hữu ích cho quy trình ứng dụng, nhiều tài khoản, logic off-chain, dữ liệu bên ngoài và hành vi tích hợp rộng hơn.

Tổng quan chính thức về kiểm thử Hardhat giải thích ưu điểm của cả hai phương pháp.

Bộ kiểm thử tốt nên bao gồm thao tác thành công, lỗi dự kiến, giới hạn truy cập, đầu vào cực trị, chuyển đổi trạng thái và thứ tự giao dịch bất thường.

Kiểm thử Solidity

Hardhat nhận diện tệp kiểm thử Solidity dựa trên quy ước thư mục và tên tệp được hỗ trợ.Hàm kiểm thử công khai có thể triển khai hợp đồng, gọi hàm, kiểm tra trạng thái và thất bại khi điều kiện dự kiến không được đáp ứng.Kiểm thử Solidity có thể dùng cheatcode để thay đổi môi trường kiểm thử.Cheatcode có thể thay đổi bên gọi, tăng thời gian, chỉnh số dư, kỳ vọng event, kỳ vọng revert hoặc kiểm tra bộ nhớ.Các công cụ này giúp kiểm thử điều kiện vốn cần thời gian chờ lâu hoặc thiết lập phức tạp.Cheatcode tác động đến môi trường kiểm thử mô phỏng và không phải hàm dành cho người dùng thông thường trên blockchain công khai.

Kiểm thử fuzz

Kiểm thử fuzz chạy một hàm hợp đồng lặp lại với các giá trị đầu vào được tạo tự động.Phương pháp này có thể phát hiện trường hợp biên mà nhà phát triển không đưa vào ví dụ viết thủ công.Phép tính token có thể hoạt động với giá trị thông thường nhưng lỗi ở giá trị bằng 0, số nguyên tối đa, ranh giới làm tròn hoặc tổ hợp trạng thái bất ngờ.Kiểm thử fuzz nên xác định giả định thực tế để giá trị tạo ra vẫn có ý nghĩa.Chiến dịch fuzz thành công không chứng minh hợp đồng an toàn vì chỉ khảo sát đầu vào và thuộc tính đã cấu hình.Cần viết rõ các bất biến quan trọng để hệ thống kiểm thử biết hành vi nào phải luôn được duy trì.

Kiểm thử bất biến

Bất biến là thuộc tính phải luôn đúng qua nhiều chuỗi thao tác khả dĩ.Giao thức cho vay có thể yêu cầu tổng nợ đã ghi nhận bằng tổng nợ của người dùng.Token có thể yêu cầu tổng nguồn cung bằng tổng số dư đã theo dõi theo mô hình hạch toán.Hệ thống tạo lập thị trường tự động có thể yêu cầu một số quan hệ dự trữ nhất định luôn hợp lệ.Kiểm thử bất biến có thể tạo các chuỗi giao dịch và xác minh thuộc tính vẫn đúng.Kiểm thử này đặc biệt hữu ích cho giao thức crypto có trạng thái, nơi lỗ hổng chỉ xuất hiện sau nhiều thao tác theo một thứ tự nhất định.

Kiểm thử TypeScript

Kiểm thử TypeScript tương tác với hợp đồng thông qua thư viện phát triển và kết nối blockchain.Thiết lập Hardhat 3 được khuyến nghị sử dụng bộ chạy kiểm thử Node.js cùng viem.Plugin chính thức cũng hỗ trợ thiết lập dựa trên ethers với Mocha.Kiểm thử TypeScript có thể điều phối nhiều hợp đồng, tài khoản, tệp, API và kết nối mạng.Kiểm thử cũng có thể kiểm tra cùng quy trình mà phần mềm off-chain của ứng dụng phi tập trung sử dụng.Không nên để kiểm thử phụ thuộc không cần thiết vào dịch vụ bên ngoài đang hoạt động vì dịch vụ không khả dụng có thể khiến kết quả thiếu tin cậy.

Độ bao phủ mã

Độ bao phủ mã đo lường các câu lệnh, nhánh, hàm và đường dẫn hợp đồng đã được chạy trong quá trình kiểm thử.Hardhat 3 tích hợp tính năng đo độ bao phủ mã Solidity.

Có thể yêu cầu đo độ bao phủ thông qua tùy chọn kiểm thử

.

Hướng dẫn đo độ bao phủ mã của Hardhat giải thích công cụ thêm marker vào hợp đồng trong các lượt đo độ bao phủ.

Bytecode đã thêm công cụ đo khác với bytecode production thông thường và có thể tiêu thụ nhiều gas hơn.Độ bao phủ cao không chứng minh bài kiểm thử có assertion hữu ích hoặc hợp đồng an toàn.Bài kiểm thử có thể chạy mọi dòng lệnh nhưng không kiểm tra kết quả kinh tế quan trọng nhất.

Thống kê gas và gas snapshot

Hardhat có thể đo lượng gas mà các hàm hợp đồng công khai tiêu thụ trong quá trình kiểm thử.

Tùy chọn

có thể hiển thị thống kê sử dụng gas cho các bài kiểm thử được hỗ trợ.

Gas snapshot có thể ghi lại giá trị gas dự kiến và xác định thay đổi bất thường giữa các phiên bản mã.Các công cụ này giúp nhà phát triển tìm hàm tốn kém, cách sử dụng bộ nhớ lớn và tình trạng gas tăng ngoài ý muốn.Kết quả gas trên mạng mô phỏng có thể không bao gồm mọi chi phí mà người dùng gặp trên mạng production.Phí riêng của Layer, chi phí công bố dữ liệu, tắc nghẽn và quy tắc giao thức thay đổi có thể ảnh hưởng đến chi phí giao dịch cuối cùng.Không nên tối ưu gas bằng cách làm suy yếu xác thực, quyền ủy quyền hoặc an toàn hạch toán.

Gỡ lỗi bằng Hardhat

Hardhat có thể hiển thị lỗi Solidity, log đã giải mã, stack trace và execution trace.Execution trace cho thấy chuỗi lệnh gọi hợp đồng và thao tác liên quan đến giao dịch.

Hướng dẫn execution trace của Hardhat giải thích cách cài đặt mức độ chi tiết kiểm soát lượng thông tin gỡ lỗi đầu ra.

Trace chi tiết có thể cho biết lệnh gọi nào bị revert, hàm nào được gọi và tương tác hợp đồng lồng nhau diễn ra ra sao.Trace đặc biệt hữu ích cho giao thức có proxy, callback, hook, chuyển token và nhiều hợp đồng kết nối.Thông tin gỡ lỗi có thể chứa địa chỉ, tham số hoặc dữ liệu phát triển nhạy cảm khác; cần xử lý cẩn trọng trong log được chia sẻ.

Ghi log console Solidity

Hardhat hỗ trợ ghi log console hướng đến phát triển từ mã Solidity trong môi trường mô phỏng.Nhà phát triển có thể in giá trị trong khi bài kiểm thử hoặc giao dịch cục bộ chạy.Cách này giúp kiểm tra trạng thái, bên gọi, số dư và phép tính trung gian.Không nên để log phát triển trong mã production nếu không có lý do rõ ràng.Trợ giúp ghi log có thể ảnh hưởng đến bytecode, kích thước hợp đồng và hành vi triển khai.Trước khi phát hành, nên thay câu lệnh gỡ lỗi tạm thời bằng kiểm thử tự động và assertion.

Tác vụ Hardhat

Tác vụ Hardhat là lệnh có tên dùng để tự động hóa một phần quy trình phát triển.Tác vụ có thể biên dịch hợp đồng, kiểm tra tài khoản, tạo báo cáo, quản lý triển khai hoặc thực hiện thao tác riêng của dự án.Plugin có thể đăng ký tác vụ để dùng qua giao diện dòng lệnh.Tác vụ tùy chỉnh nên xác thực danh tính mạng và dữ liệu đầu vào của người dùng trước khi gửi giao dịch.Tác vụ nguy hiểm không nên âm thầm dùng tài khoản đầu tiên có sẵn hoặc mặc định chọn mạng production.Tên lệnh rõ ràng và bước xác nhận giúp giảm rủi ro triển khai hoặc chuyển tiền nhầm.

Script Hardhat

Script Hardhat là chương trình TypeScript hoặc JavaScript sử dụng môi trường runtime và plugin đã cài.Script có thể triển khai hợp đồng, gọi hàm, đọc trạng thái, chuyển quyền quản trị hoặc tạo hồ sơ triển khai.Script linh hoạt nhưng đặt nhiều trách nhiệm lên nhà phát triển hơn so với hệ thống triển khai có cấu trúc.Script gặp lỗi có thể để lại một số giao dịch đã hoàn tất trong khi giao dịch tiếp theo chưa được thực hiện.Nên thiết kế script để phát hiện trạng thái hiện có và tránh lặp lại thao tác nguy hiểm.Script production nên ghi lại hash giao dịch, địa chỉ triển khai, tham số, ID mạng và kết quả.

Hardhat Ignition

Hardhat Ignition là hệ thống triển khai khai báo chính thức dành cho dự án Hardhat.Nhà phát triển mô tả các instance hợp đồng và thao tác mong muốn thông qua module triển khai.Ignition phân tích các định nghĩa đó và xác định cách thực hiện triển khai.Hệ thống có thể gửi song song các giao dịch độc lập, xử lý lại một số lỗi và tiếp tục triển khai bị gián đoạn.

Hướng dẫn triển khai bằng Hardhat Ignition giải thích cách nhóm hợp đồng và lệnh gọi sau triển khai vào các module.

Triển khai khai báo giảm một số rủi ro khi viết script thủ công, nhưng vẫn cần rà soát cẩn thận logic module và tham số.Hệ thống tự động có thể lặp lại sai sót một cách nhất quán nếu định nghĩa triển khai sai.

Triển khai hợp đồng thông minh

Triển khai gửi giao dịch tạo hợp đồng lên mạng blockchain.Giao dịch chứa bytecode tạo hợp đồng đã biên dịch và tham số constructor.Sau khi được xác nhận, hợp đồng nhận địa chỉ theo quy tắc tạo địa chỉ của blockchain.Triển khai nên sử dụng compiler, optimizer, đối số constructor, tài khoản, chain và cài đặt gas dự kiến.Trước khi gửi giao dịch thật, nhóm nên thực hiện lần triển khai mô phỏng cuối cùng bằng đúng artifact production.Ngay sau khi triển khai, cũng cần xác minh vai trò quản trị, quyền sở hữu, quyền nâng cấp, địa chỉ ngân quỹ và quyền kiểm soát khẩn cấp.Không bao giờ commit khóa riêng tư trực tiếp vào tệp cấu hình Hardhat hoặc kho mã nguồn.

Xác minh hợp đồng thông minh

Xác minh hợp đồng thông minh liên kết bytecode đã triển khai với mã nguồn và cài đặt compiler được khai báo.Mã nguồn đã xác minh cho phép người dùng, kiểm toán viên, ví và công cụ giám sát kiểm tra hành vi dự kiến của hợp đồng.Hardhat cung cấp plugin xác minh chính thức.

Hướng dẫn xác minh của Hardhat giải thích rằng xác minh chứng minh bytecode đã triển khai được tạo từ mã nguồn cụ thể.

Xác minh không chứng minh mã nguồn an toàn, công bằng hoặc không có rủi ro kinh tế tiềm ẩn.Tham số constructor, thư viện liên kết, cài đặt optimizer, metadata và phiên bản compiler phải khớp với bản triển khai.Nhóm nên lưu thông tin build để có thể tái tạo quy trình xác minh sau này.

Plugin Hardhat

Plugin mở rộng các chức năng phát triển của Hardhat.Plugin chính thức hỗ trợ viem, ethers, assertion, trình trợ giúp mạng, xác minh hợp đồng, triển khai Ignition, lưu trữ cấu hình mã hóa, ký bằng phần cứng và bộ chạy kiểm thử.

Danh mục plugin chính thức liệt kê các plugin do Nomic Foundation duy trì.

Plugin cộng đồng có thể bổ sung tính năng hữu ích nhưng có thể chưa được rà soát hoặc duy trì ở mức tương tự.Plugin độc hại có thể đọc tệp dự án, biến môi trường, khóa, dữ liệu triển khai và lưu lượng mạng.Trước khi cài, nhà phát triển nên kiểm tra chủ sở hữu plugin, lịch sử cập nhật, mã nguồn, dependency, quyền truy cập và khả năng tương thích.

Bảo mật dependency

Dự án Hardhat phụ thuộc vào package Node.js có thể thực thi mã trong quá trình cài đặt, kiểm thử hoặc triển khai.Dependency bị xâm phạm có thể tìm cách đánh cắp biến môi trường, khóa riêng tư, mã nguồn hoặc thông tin xác thực triển khai.Dự án nên commit lockfile và rà soát các thay đổi dependency bất ngờ.Triển khai production nên dùng hệ thống sạch, phần mềm tối thiểu và phiên bản package đã xác minh.Không nên gộp cập nhật dependency tự động nếu chưa kiểm thử và rà soát.Mức độ phổ biến của package không bảo đảm mọi bản phát hành đều an toàn.

Hardhat và khóa riêng tư

Hardhat có thể cần truy cập tài khoản ký khi triển khai hoặc gọi hợp đồng trên mạng bên ngoài.Dùng khóa riêng tư thô trong tệp cấu hình văn bản thuần tạo rủi ro bảo mật nghiêm trọng.Khóa phát triển chỉ nên chứa tiền thử nghiệm.Khóa production nên được bảo vệ bằng lưu trữ mã hóa, ký phần cứng, quyền hạn giới hạn hoặc quy trình đa chữ ký.Nếu thực tế cho phép, tài khoản triển khai chỉ nên giữ lượng tiền cần cho giao dịch dự kiến.Sau khi triển khai, có thể chuyển quyền sở hữu quản trị sang tài khoản an toàn hơn.Cần kiểm tra log và báo cáo lỗi để đảm bảo chúng không làm lộ giá trị cấu hình nhạy cảm.

Hardhat và ví phần cứng

Ví phần cứng có thể ký giao dịch triển khai hoặc quản trị Hardhat thông qua plugin và quy trình tương thích.Cách này có thể giữ khóa riêng tư bên ngoài máy tính phát triển.Nếu được hỗ trợ, thiết bị nên hiển thị đích, mạng, giá trị và dữ liệu hợp đồng.Triển khai hợp đồng phức tạp có thể khó diễn giải trên màn hình thiết bị nhỏ.Ví phần cứng không thể nhận diện việc triển khai gây hại chỉ vì giao dịch được tạo bằng Hardhat.Mã nguồn, artifact đã biên dịch, đối số constructor và dữ liệu giao dịch vẫn cần được rà soát độc lập.

Lỗi bảo mật Hardhat thường gặp

Một lỗi thường gặp là commit khóa riêng tư hoặc cụm từ khôi phục vào kho mã nguồn.Lỗi khác là triển khai lên sai blockchain vì tin vào nhãn mạng mà không kiểm tra chain ID.Lỗi thứ ba là dùng cài đặt compiler khác nhau giữa kiểm thử, triển khai và xác minh.Lỗi thứ tư là chỉ kiểm thử thao tác thành công mà bỏ qua bên gọi trái phép và điều kiện thất bại.Lỗi thứ năm là phụ thuộc vào fork của trạng thái blockchain luôn thay đổi mà không cố định số block.Lỗi thứ sáu là cài plugin chưa được rà soát có quyền truy cập bí mật triển khai.Lỗi thứ bảy là cho rằng độ bao phủ mã hoàn chỉnh tương đương với kiểm toán bảo mật.Lỗi thứ tám là để tài khoản triển khai nắm quyền kiểm soát vĩnh viễn mọi chức năng giao thức.Lỗi thứ chín là không xác minh địa chỉ triển khai và quyền sở hữu sau khi hoàn tất.Lỗi thứ mười là gửi tiền thật vào địa chỉ phát triển được tạo cục bộ mà khóa chưa bao giờ được bảo vệ.

Thực hành tốt với Hardhat

Khóa phiên bản Hardhat, plugin, thư viện và compiler trong tệp dependency của dự án.Dùng bản Node.js được hỗ trợ và lockfile package đã commit.Giữ khóa riêng tư và endpoint nhạy cảm bên ngoài kho mã nguồn.Dùng tài khoản riêng cho kiểm thử cục bộ, kiểm thử công khai, triển khai và quản trị dài hạn.Viết kiểm thử unit, tích hợp, fuzz, bất biến, kiểm soát truy cập và điều kiện thất bại.Chạy đo độ bao phủ mã nhưng cần nhớ rằng độ bao phủ đo việc thực thi, không phải tính đúng đắn.Dùng kiểm thử fork cố định ở block đã biết để kiểm thử tích hợp giao thức có thể lặp lại.Rà soát thay đổi gas và kích thước hợp đồng trước khi triển khai.Xác minh mã nguồn và lưu thông tin build sau khi triển khai.Dùng đánh giá bảo mật độc lập cho hợp đồng kiểm soát lượng tài sản crypto có giá trị đáng kể.

Giới hạn của Hardhat

Hardhat không thể chứng minh thiết kế kinh tế của hợp đồng an toàn.Công cụ không thể bảo đảm bộ kiểm thử bao gồm mọi hướng tấn công.Công cụ không thể tái tạo hoàn hảo mọi điều kiện mạng production.Công cụ không thể ngăn nhà phát triển ký giao dịch bằng sai tài khoản hoặc mạng.Công cụ không thể bảo mật khóa riêng tư được lưu trữ cẩu thả trong dự án.Công cụ không thể khiến dependency bên thứ ba không an toàn trở nên đáng tin cậy.Công cụ không thể thay thế xác minh hình thức, kiểm toán, chương trình thưởng tìm lỗi, giám sát và kế hoạch ứng phó sự cố.Hardhat phát huy hiệu quả nhất khi là một phần trong quy trình phát triển an toàn rộng hơn.

FAQ

Hardhat trong tiền mã hóa là gì?

Hardhat là môi trường phát triển dùng để biên dịch, kiểm thử, gỡ lỗi, triển khai và xác minh hợp đồng thông minh Ethereum và tương thích EVM.

Hardhat có phải blockchain không?

Không, Hardhat là công cụ phát triển phần mềm chứ không phải mạng blockchain.

Hardhat có phải tiền mã hóa không?

Không, Hardhat không đại diện cho coin hoặc token.

Ai phát triển Hardhat?

Hardhat do Nomic Foundation phát triển cho cộng đồng phát triển Ethereum.

Phiên bản lớn hiện tại của Hardhat là gì?

Hardhat 3 là dòng phiên bản lớn hiện tại.

Phiên bản Hardhat mới nhất là gì?

Tính đến ngày 13 tháng 7 năm 2026, bản phát hành mới nhất được gắn thẻ là Hardhat 3.9.1.

Hardhat sử dụng ngôn ngữ lập trình nào?

Dự án Hardhat thường dùng Solidity cho hợp đồng thông minh và TypeScript hoặc JavaScript cho cấu hình, script và kiểm thử tích hợp.

Hardhat biên dịch những gì?

Hardhat biên dịch mã nguồn Solidity thành bytecode EVM, ABI, artifact và thông tin build liên quan.

Hardhat có tích hợp blockchain cục bộ không?

Hardhat có mạng blockchain mô phỏng dành cho phát triển cục bộ và kiểm thử tự động.

Hardhat có hỗ trợ kiểm thử Solidity không?

Có, Hardhat 3 hỗ trợ bài kiểm thử viết trực tiếp bằng Solidity cũng như kiểm thử dựa trên TypeScript.

Hardhat có thể kiểm thử fuzz không?

Có, bài kiểm thử Solidity có thể tạo nhiều đầu vào khác nhau để kiểm tra thuộc tính và trường hợp biên.

Hardhat có thể kiểm thử bất biến của hợp đồng không?

Có, nhà phát triển có thể xác định các thuộc tính cần luôn đúng qua những chuỗi thao tác hợp đồng được tạo tự động.

Hardhat Ignition là gì?

Hardhat Ignition là hệ thống triển khai khai báo chính thức để xác định, thực thi, tiếp tục và ghi lại quá trình triển khai hợp đồng thông minh.

Hardhat có thể triển khai hợp đồng lên mạng công khai không?

Có, Hardhat có thể kết nối với endpoint JSON-RPC bên ngoài và gửi giao dịch triển khai đã ký.

Hardhat có cần tiền mã hóa thật để kiểm thử cục bộ không?

Không, mạng mô phỏng cung cấp tài khoản và số dư phát triển không có giá trị thực tế.

Fork mạng trong Hardhat là gì?

Fork mạng sao chép trạng thái blockchain từ một block được chọn trên mạng công khai vào mô phỏng cục bộ để kiểm thử.

Hardhat có thể xác minh hợp đồng thông minh không?

Có, plugin xác minh chính thức có thể gửi mã nguồn và thông tin build đến các dịch vụ xác minh được hỗ trợ.

Xác minh hợp đồng có chứng minh hợp đồng an toàn không?

Không, xác minh liên kết mã nguồn với bytecode đã triển khai nhưng không chứng minh logic an toàn hoặc vững chắc về kinh tế.

Độ bao phủ mã cao có nghĩa hợp đồng an toàn không?

Không, độ bao phủ cao chỉ cho thấy mã đã chạy trong quá trình kiểm thử, không chứng minh các thuộc tính đúng đã được kiểm tra.

Hardhat có thể ước tính mức dùng gas không?

Có, Hardhat có thể tạo thống kê và snapshot gas trong các lượt kiểm thử được hỗ trợ.

Hardhat có thể kết nối nhiều mạng blockchain không?

Có, Hardhat 3 có thể quản lý nhiều kết nối mạng và cấu hình chain mô phỏng.

Lưu khóa riêng tư trong cấu hình Hardhat có an toàn không?

Không, khóa riêng tư nên được tải từ hệ thống bên ngoài được bảo vệ thay vì commit dưới dạng văn bản thuần.

Hardhat có thể dùng ví phần cứng không?

Có, plugin và quy trình tương thích có thể dùng thiết bị phần cứng để ký một số giao dịch triển khai và quản trị.

Mọi plugin Hardhat đều an toàn phải không?

Không, plugin có thể truy cập tài nguyên nhạy cảm của dự án và cần được rà soát trước khi cài.

Hardhat có thể thay thế kiểm toán hợp đồng thông minh không?

Không, Hardhat hỗ trợ phát triển và kiểm thử nhưng không thay thế đánh giá bảo mật độc lập.

Tại sao kiểm thử fork nên dùng block cố định?

Cố định block giúp trạng thái blockchain được sao chép ổn định để các lần kiểm thử sau vẫn có thể tái lập.

Hardhat có thể ngăn triển khai lên sai mạng không?

Hardhat có thể hỗ trợ các bước kiểm tra nhưng nhà phát triển vẫn phải xác minh chain ID, tài khoản, endpoint và tham số triển khai.

Kết luận

Hardhat là môi trường phát triển toàn diện để tạo phần mềm hợp đồng thông minh Ethereum và tương thích EVM.Công cụ kết hợp biên dịch, artifact, mạng mô phỏng, kiểm thử, gỡ lỗi, triển khai, xác minh, script, tác vụ và plugin trong một cấu trúc dự án.Hardhat 3 là phiên bản lớn hiện tại, bổ sung kiểm thử thuần Solidity, mô phỏng đa chain, artifact có kiểu dữ liệu, build profile, đo độ bao phủ mã và quản lý mạng linh hoạt hơn.Nhà phát triển có thể dùng Hardhat kiểm thử hợp đồng cục bộ trước khi tiêu tiền mã hóa thật hoặc khiến tài sản người dùng gặp rủi ro.Hardhat Ignition cung cấp hệ thống triển khai có cấu trúc, có thể tiếp tục công việc bị gián đoạn và ghi lại trạng thái triển khai.Kiểm thử fork cho phép nhà phát triển tái tạo trạng thái blockchain công khai và thử nghiệm tương tác với hợp đồng hiện có.Execution trace, báo cáo độ bao phủ, kiểm thử fuzz, bất biến và thống kê gas có thể phát hiện nhiều vấn đề kỹ thuật trước khi triển khai.Các công cụ này không bảo đảm an toàn vì chất lượng kết quả vẫn phụ thuộc vào mã nguồn, bài kiểm thử, giả định, dependency, khóa và quy trình triển khai.Khóa riêng tư nên được giữ ngoài kho mã nguồn và cần có quy trình ký cùng kiểm soát truy cập mạnh.Cần rà soát plugin và dependency package vì chúng có thể truy cập tài nguyên phát triển nhạy cảm.Hợp đồng production nên dùng cài đặt compiler đã khóa phiên bản, build có thể tái lập, mã nguồn đã xác minh, đánh giá độc lập và giám sát sau triển khai.Đối với nhà phát triển tiền mã hóa, nên xem Hardhat là không gian làm việc mạnh mẽ giúp giảm rủi ro phát triển hợp đồng thông minh, chứ không phải công cụ thay thế kỹ thuật cẩn trọng và đánh giá bảo mật.