Wie benutze ich Hardhat, um einen intelligenten Vertrag zu testen?

Was ist Hardhat und warum für intelligente Vertragsprüfungen verwenden?

Hardhat ist eine Ethereum -Entwicklungsumgebung, in der Entwickler intelligente Verträge effizient zusammenstellen, bereitstellen, debuggen und testen können. Es bietet eine lokale Blockchain -Umgebung, die als Hardhat -Netzwerk bezeichnet wird und das Verhalten realer Ethereum -Netzwerke wie Mainnet oder Ropsten nachahmt und es für Testzwecke ideal macht.

Einer der Hauptgründe, warum Entwickler Hardhat bevorzugen, ist seine Flexibilität und das reichhaltige Plugin -Ökosystem. Egal, ob Sie Unit-Tests mit Mokka schreiben, Chai für Behauptungen verwenden oder mit integrierten Tools debuggen, Hardhat rationalisiert den gesamten Lebenszyklus für die Vertragsentwicklung. Dies macht es besonders nützlich, wenn Sie sicherstellen möchten, dass sich Ihre Vertragslogik korrekt verhält, bevor Sie sie in einem Live -Netzwerk bereitstellen.

Einrichten Ihrer Entwicklungsumgebung

Vor dem Testen ist es wichtig, eine ordnungsgemäße Umgebung einzurichten:

• Installieren Sie node.js : Stellen Sie sicher, dass Node.js (Version 14.x oder höher) und NPM installiert sind.
• Initialisieren Sie ein Projekt : Führen Sie npm init -y in Ihrem Projektverzeichnis aus, um eine package.json -Datei zu erstellen.
• Installieren Sie HardHat : Führen Sie npm install --save-dev hardhat aus, um Ihrem Projekt Hardhat hinzuzufügen.
• HardHat -Konfigurationsdatei erstellen : Führen Sie npx hardhat aus und wählen Sie 'ein JavaScript -Projekt erstellen', um die Datei hardhat.config.js zu generieren.

Sobald dieses Setup abgeschlossen ist, können Sie mit dem Schreiben und Testen Ihrer intelligenten Verträge beginnen.

Schreiben eines grundlegenden intelligenten Vertrags zum Testen

Um zu demonstrieren, wie Hardhat zum Testen verwendet werden kann, betrachten wir einen einfachen Soliditätsvertrag :

 // contracts/Token.sol pragma solidity ^0.8.0; Vertrags -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; }
 }

Dieser grundlegende Token -Vertrag enthält Funktionen für die Übertragung und Münzen von Token. Ziel ist es zu testen, ob sich diese Funktionen unter verschiedenen Szenarien unter Verwendung von Hardhats Test -Framework wie erwartet verhalten.

Konfigurieren der Testumgebung

Stellen Sie vor dem Schreiben von Tests sicher, dass Ihre Projektstruktur Tests unterstützt:

• Platzieren Sie Ihre Soliditätsverträge in den contracts/ den Ordner.
• Speichern Sie Testdateien im test/ Verzeichnis.
• Aktualisieren Sie bei Bedarf hardhat.config.js (z. B. Hinzufügen von Netzwerken oder Plugins).

Hier ist ein minimales Konfigurationsbeispiel:

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

Mit diesem Setup können Sie mit Mokka und Chai Tests schreiben und durchführen.

Schreiben von Tests mit Mocha und Chai

Hardhat integriert nahtlos in Mokka , ein beliebtes JavaScript -Test -Framework, und Chai , eine Assertion -Bibliothek.

Erstellen Sie zunächst eine Testdatei im test/ Verzeichnis:

 // test/token-test.js const { expect } = require('chai'); beschreiben ('Token -Vertrag', function () { token; lass hardhattoken; Eigentümer lassen; sei addr1;
voran
Token = await ethers.getContractFactory('Token'); [owner, addr1] = await ethers.getSigners(); hardhatToken = await Token.deploy(); await hardhatToken.deployed();
 });
 
IT ("sollte die Gesamtversorgung dem Eigentümer zuweisen", Async Function () {
 
await hardhatToken.mint(owner.address, 100); const ownerBalance = await hardhatToken.balances(owner.address); expect(ownerBalance).to.equal(100);
 });
 
IT ("Sollte Token zwischen Konten überweisen", asynchrische Funktion () {
 
await hardhatToken.mint(owner.address, 100); await hardhatToken.transfer(addr1.address, 50); const addr1Balance = await hardhatToken.balances(addr1.address); expect(addr1Balance).to.equal(50);
 });
 
IT ("sollte fehlschlagen, wenn der Absender nicht genug Token hat", asynchrische Funktion () {
 
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);
 }); });

In jedem Testfall wird Chai verwendet, um die erwarteten Ergebnisse zu gründen. Der beforeEach -Haken sorgt für einen neuen Einsatz für jeden Test, wodurch eine Störung zwischen Testfällen verhindert wird.

Ausführen von Tests mit Hardhat

Sobald Ihre Tests geschrieben sind, ist die Ausführung unkompliziert:

• Öffnen Sie ein Terminal in Ihrem Projekt Root Directory.
• Führen Sie den Befehl npx hardhat test aus.

Die Ausgabe zeigt die Ergebnisse jedes Tests, einschließlich bestandener und fehlgeschlagener Fälle. Wenn ein Test fehlschlägt, zeigt Hardhat detaillierte Fehlermeldungen an, um Probleme schnell zu identifizieren.

Für eine stärkere Kontrolle können Sie bestimmte Testdateien ausführen, indem Sie den Dateipfad anhängen:

 npx hardhat test test/token-test.js

Auf diese Weise können Sie sich auf bestimmte Vertragsverhalten konzentrieren, ohne die gesamte Testsuite neu zu beenden.

Häufig gestellte Fragen

F: Kann ich Hardhat ohne Solidität verwenden? Ja, während Hardhat hauptsächlich für Solidität ausgelegt ist, kann es auch mit anderen EVM-kompatiblen Sprachen wie Vyper verwendet werden, obwohl die Unterstützung der Community möglicherweise variieren kann.

F: Wie debugge ich fehlgeschlagene Tests in Hardhat? Verwenden Sie Console.log von @nomiclabs/Hardhat-Waffle oder der Hardhat Runtime Environment (HRE), um während der Testausführung Variablenwerte zu drucken. Überprüfen Sie außerdem die Transaktionsbelege und kehren Sie die im Testausgang angegebenen Gründe zurück.

F: Kann ich Vertrags -Upgrades mit Hardhat testen? Ja, Hardhat unterstützt Proxy-Muster über Plugins wie @Openzeppelin/Hardhat-Upgrades , sodass Sie auf aktualisierbare Verträge lokal simulieren und testen können.

F: Gibt es Alternativen zu Mokka und Chai zum Testen in Hardhat? Während Mokka und Chai weit verbreitet sind, können Sie andere Test -Frameworks wie Scherz in die zusätzliche Konfiguration integrieren, obwohl die native Unterstützung und Dokumentation für Mokka und Chai reifer sind.