Hardhat

Hardhat

Présentation : Hardhat est un environnement de développement Ethereum (EVM) destiné à concevoir, tester, déployer et déboguer des smart contracts de manière fiable et reproductible.

---

Vulgarisation : à quoi sert Hardhat ?

Développer des smart contracts nécessite plus qu’un simple compilateur.
Hardhat fournit un cadre de travail complet permettant de :

• compiler des contrats Solidity,
• lancer une blockchain locale,
• écrire et exécuter des tests automatisés,
• déployer des contrats sur des réseaux locaux, testnet ou mainnet,
• inspecter précisément les erreurs et le gas consommé.

Hardhat joue le rôle d’un équivalent blockchain d’un framework backend.

---

Pourquoi utiliser Hardhat dans le projet ?

Problématiques adressées

• Tester des contrats avant tout déploiement réel.
• Simuler des tournois et des transactions en local.
• Garantir la reproductibilité des déploiements.
• Sécuriser les évolutions du smart contract.

Apports concrets

• Cycle de développement rapide (compile → test → deploy).
• Intégration native avec TypeScript.
• Outils de debug avancés.
• Compatible Avalanche (EVM).

Important

Aucun smart contract ne doit être déployé sans tests automatisés.

---

Pourquoi Hardhat plutôt qu’un autre outil ?

Avantages clés

• Standard de facto dans l’écosystème Ethereum.
• Configuration explicite et lisible (hardhat.config.ts).
• Blockchain locale intégrée.
• Très bon support TypeScript.
• Écosystème mature de plugins.

Comparaison rapide

• Plus flexible que Truffle.
• Plus simple à prendre en main que Foundry pour un projet académique.
• Excellent compromis entre pédagogie et industrialisation.

---

Rôle de Hardhat dans le projet

Dans le cadre du projet :

• Compilation des smart contracts Solidity.
• Déploiement du contrat GameStorage.
• Tests unitaires des fonctions critiques.
• Simulation de l’enregistrement des snapshots de tournoi.
• Déploiement sur Avalanche Fuji.

Hardhat constitue le socle outillage blockchain du projet.

---

Installation and configuration

npm install --save-dev hardhat @nomicfoundation/hardhat-toolbox

Initialisation

npx hardhat init

Configuration

Exemple de configuration simplifiée pour Avalanche Fuji :

import { HardhatUserConfig } from "hardhat/config";
import "@nomicfoundation/hardhat-toolbox";

const config: HardhatUserConfig = {
  solidity: "0.8.20",
  networks: {
    fuji: {
      url: process.env.AVALANCHE_RPC_URL,
      accounts: [process.env.BLOCKCHAIN_PRIVATE_KEY!],
    },
  },
};

export default config;

!WARNING] Les clés privées doivent impérativement être fournies via des variables d’environnement.

---

Use cases

Note

Hardhat permet de lancer une blockchain locale identique à un réseau réel.

Important

Les tests garantissent que le hash stocké on-chain correspond aux données off-chain.

Tip

Les scripts Hardhat facilitent le redéploiement automatique des contrats.

Caution

Un contrat déployé est immuable : toute erreur impose un nouveau déploiement.

---

Do’s & Don’ts

✅ Do	❌ Don’t
Écrire des tests unitaires	Déployer sans tests
Utiliser une blockchain locale	Tester directement sur testnet
Versionner les scripts	Versionner des secrets
Documenter les déploiements	Modifier un contrat en production

Ressources

Type	Ressource	Notes
📄	https://hardhat.org/docs	Documentation officielle
💻	https://github.com/NomicFoundation/hardhat	Repository GitHub
💡	Hardhat + Ethers.js	Intégration backend
📘	Ethereum Smart Contract Dev	Bonnes pratiques