ハードハットを使用してスマートコントラクトをテストする方法は？

Hardhatは、MochaやChaiなどのツールでスマートコントラクトテストを合理化し、信頼できる展開を確保するイーサリアム開発環境です。

2025/07/26 23:15

Hardhatとは何ですか？また、なぜスマートコントラクトテストに使用するのですか？

Hardhatは、開発者がスマートコントラクトを効率的にコンパイル、展開、デバッグ、およびテストできるイーサリアム開発環境です。 HardHatネットワークとして知られるローカルブロックチェーン環境を提供し、MainNetやRopstenなどの実際のイーサリアムネットワークの動作を模倣しており、テスト目的に最適です。

開発者がHardhatを好む主な理由の1つは、その柔軟性とリッチプラグインのエコシステムです。 Mochaでユニットテストを書いたり、AssertionにChaiを使用したり、組み込みのツールを使用してデバッグしたりするかどうかにかかわらず、 Hardhatはスマートコントラクト開発ライフサイクル全体を合理化します。これにより、ライブネットワークに展開する前に契約ロジックが正しく動作するようにする場合に特に便利になります。

開発環境を設定します

テストに飛び込む前に、適切な環境を設定することが不可欠です。

• node.jsをインストール： node.js （バージョン14.x以下）とNPMがインストールされていることを確認してください。
• プロジェクトの初期化：プロジェクトディレクトリでnpm init -y実行して、 package.jsonファイルを作成します。
• hardhat ： npm install --save-dev hardhatを実行するには、プロジェクトにhardhatを追加します。
• hardhat構成ファイルの作成： npx hardhatを実行し、「JavaScriptプロジェクトの作成」を選択して、 hardhat.config.jsファイルを生成します。

このセットアップが完了したら、スマートコントラクトの書き込みとテストを開始できます。

テスト用の基本的なスマートコントラクトを作成します

テストにHardhatを使用する方法を示すために、単純な堅実さ契約を考えてみましょう。

 // contracts/Token.sol
 pragma solidity ^0.8.0;契約token {





mapping(address => uint256) public balances; function transfer(address to, uint256 amount) external { require(balances[msg.sender] >= amount, 'Insufficient balance'); balances[msg.sender] -= amount; balances[to] += amount; } function mint(address account, uint256 amount) external { balances[account] += amount; }
 }

この基本的なトークン契約には、トークンを転送およびミントするための関数が含まれます。目標は、 HardHatのテストフレームワークを使用して、さまざまなシナリオでこれらの関数が予想どおりに動作するかどうかをテストすることです。

テスト環境の構成

テストを作成する前に、プロジェクト構造がテストをサポートしていることを確認してください。

• 堅実さ契約をcontracts/フォルダーに配置します。
• test/ディレクトリにテストファイルを保存します。
• 必要に応じてhardhat.config.js更新します（たとえば、ネットワークやプラグインの追加）。

最小限の構成例は次のとおりです。

 // hardhat.config.js
 module.exports = {
 solidity: '0.8.0',
 };

このセットアップを使用すると、 MochaとChaiを使用してテストを作成および実行する準備ができています。

MochaとChaiを使用したテストを作成します

Hardhatは、人気のJavaScriptテストフレームワークであるMochaと、アサーションライブラリであるChaiとシームレスに統合します。

test/ディレクトリでテストファイルを作成することから始めます。

 // test/token-test.js
 const { expect } = require('chai');説明（ 'トークン契約'、function（）{
 トークンさせてください。
 Hardhattokenをさせてください。
 所有者にしましょう。
 addr1としましょう。





前に（async function（）{




Token = await ethers.getContractFactory('Token'); [owner, addr1] = await ethers.getSigners(); hardhatToken = await Token.deploy(); await hardhatToken.deployed();
 }）;
 
それ（ '総供給を所有者に割り当てる必要があります'、async function（）{
 
await hardhatToken.mint(owner.address, 100); const ownerBalance = await hardhatToken.balances(owner.address); expect(ownerBalance).to.equal(100);
 }）;
 
それ（ 'アカウント間でトークンを転送する必要があります'、async function（）{
 
await hardhatToken.mint(owner.address, 100); await hardhatToken.transfer(addr1.address, 50); const addr1Balance = await hardhatToken.balances(addr1.address); expect(addr1Balance).to.equal(50);
 }）;
 
それは（ '送信者が十分なトークンを持っていない場合に失敗するはずです'、async function（）{
 
const initialOwnerBalance = await hardhatToken.balances(owner.address); await expect( hardhatToken.transfer(addr1.address, 1) ).to.be.revertedWith('Insufficient balance'); expect(await hardhatToken.balances(owner.address)).to.equal(initialOwnerBalance);
 }）;
 }）;

各テストケースはCHAIを使用して、予想される結果を主張します。 beforeEachフックは、すべてのテストの新たな展開を保証し、テストケース間の干渉を防ぎます。

Hardhatでテストを実行します

テストが書かれたら、それらを実行するのは簡単です。

• プロジェクトルートディレクトリで端末を開きます。
• コマンドnpx hardhat testを実行します。

出力には、合格したケースや故障したケースを含む各テストの結果が表示されます。テストが失敗した場合、 Hardhatは詳細なエラーメッセージを表示して、問題を迅速に識別するのに役立ちます。

より詳細な制御のために、ファイルパスを追加して特定のテストファイルを実行できます。

 npx hardhat test test/token-test.js

これにより、テストスイート全体を再実行することなく、特定の契約行動に集中できます。

---

よくある質問

Q：堅牢性なしでHardhatを使用できますか？

はい、 Hardhatは主に堅牢性のために設計されていますが、コミュニティのサポートは異なる場合がありますが、 Vyperなどの他のEVM互換言語でも使用できます。

Q：ハードハットで失敗したテストをデバッグするにはどうすればよいですか？

@nomiclabs/hardhat-waffleまたはhardhatランタイム環境（HRE）のconsole.logを使用して、テスト実行中に変数値を印刷します。さらに、トランザクションの領収書を検査し、テスト出力で提供された理由を戻します。

Q：hardhatを使用して契約アップグレードをテストできますか？

はい、 hardhatは@openzeppelin/hardhatアップグレードなどのプラグインを介してプロキシパターンをサポートしているため、アップグレード可能な契約をローカルでシミュレートしてテストできます。

Q：HardhatでテストするためのMochaとChaiに代わるものはありますか？

MochaとChaiは広く採用されていますが、 MochaとChaiのネイティブサポートとドキュメントはより成熟していますが、 Jestなどの他のテストフレームワークを追加の構成で統合できます。