Comment utiliser Hardhat pour tester un contrat intelligent?

Qu'est-ce que Hardhat et pourquoi l'utiliser pour des tests de contrat intelligents?

Hardhat est un environnement de développement Ethereum qui permet aux développeurs de compiler, déployer, déboguer et tester efficacement les contrats intelligents . Il fournit un environnement blockchain local connu sous le nom de HardHat Network , qui imite le comportement de réseaux réels Ethereum comme MainNet ou Ropsten, ce qui le rend idéal à des fins de test.

L'une des principales raisons pour lesquelles les développeurs préfèrent Hardhat est sa flexibilité et son riche écosystème de plugin. Que vous écriviez des tests unitaires avec Mocha , que vous utilisez Chai pour des affirmations ou que vous déboguez avec des outils intégrés, Hardhat rationalise l'ensemble du cycle de vie de développement des contrats intelligents. Cela le rend particulièrement utile lorsque vous souhaitez vous assurer que votre logique contractuelle se comporte correctement avant de la déployer sur un réseau en direct.

Configuration de votre environnement de développement

Avant de plonger dans les tests, il est essentiel de mettre en place un environnement approprié:

• Installez Node.js : assurez-vous que Node.js (version 14.x ou supérieur) et NPM sont installés.
• Initialisez un projet : Exécutez npm init -y dans votre répertoire de projet pour créer un fichier package.json .
• Installer HardHat : Exécutez npm install --save-dev hardhat pour ajouter HardHat à votre projet.
• Créer un fichier de configuration HardHat : Exécutez npx hardhat et sélectionnez «Créer un projet JavaScript» pour générer le fichier hardhat.config.js .

Une fois cette configuration terminée, vous pouvez commencer à écrire et tester vos contrats intelligents .

Rédaction d'un contrat intelligent de base pour les tests

Pour démontrer comment utiliser HardHat pour les tests, considérons un simple contrat de solidité :

 // contracts/Token.sol pragma solidity ^0.8.0; Token contractuel {


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; }
 }

Ce contrat de jeton de base comprend des fonctions de transfert et de jetons de front et de frappe. L'objectif est de tester si ces fonctions se comportent comme prévu dans différents scénarios en utilisant le cadre de test de HardHat .

Configuration de l'environnement de test

Avant d'écrire des tests, assurez-vous que votre structure de projet prend en charge les tests:

• Placez vos contrats de solidité dans les contracts/ dossiers.
• Stockez les fichiers de test dans le test/ répertoire.
• Mettre à jour hardhat.config.js si nécessaire (par exemple, ajouter des réseaux ou des plugins).

Voici un exemple de configuration minimal:

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

Avec cette configuration, vous êtes prêt à écrire et à exécuter des tests à l'aide de moka et de chai .

Des tests d'écriture à l'aide de moka et de chai

HardHat s'intègre parfaitement à Mocha , un cadre de test JavaScript populaire, et Chai , une bibliothèque d'assertion.

Commencez par créer un fichier de test dans le test/ répertoire:

 // test/token-test.js const { expect } = require('chai'); décrire («contrat de jeton», fonction () { Laisser le jet; Que Hardhattoken; Laisser le propriétaire; Laissez addr1;


AVANTEACH (fonction asynchrone () {


Token = await ethers.getContractFactory('Token'); [owner, addr1] = await ethers.getSigners(); hardhatToken = await Token.deploy(); await hardhatToken.deployed();
 });
 
il ('devrait attribuer l'alimentation totale au propriétaire', fonction asynchrone () {
 
await hardhatToken.mint(owner.address, 100); const ownerBalance = await hardhatToken.balances(owner.address); expect(ownerBalance).to.equal(100);
 });
 
il ('devrait transférer des jetons entre les comptes', fonction asynchrone () {
 
await hardhatToken.mint(owner.address, 100); await hardhatToken.transfer(addr1.address, 50); const addr1Balance = await hardhatToken.balances(addr1.address); expect(addr1Balance).to.equal(50);
 });
 
il ('devrait échouer si l'expéditeur n'a pas assez de jetons', fonction async () {
 
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);
 }); });

Chaque cas de test utilise Chai pour affirmer les résultats attendus. Le Hook beforeEach assure un nouveau déploiement pour chaque test, empêchant les interférences entre les cas de test.

Exécution de tests avec Hardhat

Une fois vos tests écrits, les exécuter est simple:

• Ouvrez un terminal dans le répertoire des racines de votre projet.
• Exécutez le npx hardhat test .

La sortie montrera les résultats de chaque test, y compris les cas passés et défaillants. Si un test échoue, HardHat affichera les messages d'erreur détaillés pour aider à identifier rapidement les problèmes.

Pour plus de contrôle granulaire, vous pouvez exécuter des fichiers de test spécifiques en ajoutant le chemin du fichier:

 npx hardhat test test/token-test.js

Cela vous permet de vous concentrer sur des comportements contractuels spécifiques sans relancer l'ensemble de la suite de tests.

Questions fréquemment posées

Q: Puis-je utiliser Hardhat sans solidité? Oui, bien que Hardhat soit principalement conçu pour la solidité , il peut également être utilisé avec d'autres langages compatibles EVM tels que VYPER , bien que le soutien de la communauté puisse varier.

Q: Comment déboguer les tests ratés dans HardHat? Utilisez Console.log à partir de @ NomicLabs / Hardhat-Waffle ou l' environnement d'exécution de HardHat (HRE) pour imprimer des valeurs de variables pendant l'exécution du test. De plus, inspectez les reçus de transaction et réactivez les raisons fournies dans la sortie du test.

Q: Puis-je tester les mises à niveau des contrats en utilisant Hardhat? Oui, HardHat prend en charge les modèles proxy via des plugins comme @ Openzeppelin / HardHat-Upgrades , vous permettant de simuler et de tester les contrats moderniques localement.

Q: Y a-t-il des alternatives à Mocha et Chai pour les tests en hardhat? Bien que Mocha et Chai soient largement adoptés, vous pouvez intégrer d'autres cadres de test comme la plaisanterie avec une configuration supplémentaire, bien que la prise en charge et la documentation natives soient plus matures pour Mocha et Chai .