dochardhat_solidity
This commit is contained in:
160
docs/pedagogie/03-hardhat-et-alternatives.md
Normal file
160
docs/pedagogie/03-hardhat-et-alternatives.md
Normal file
@@ -0,0 +1,160 @@
|
||||
# Hardhat et alternatives (Remix, Truffle, Foundry…)
|
||||
|
||||
> **Contexte :** projet Tokenizer — dossier `code/` + `deployment/` ([sujet ch. IV](../sujets/tokenizer.md#chapitre-iv--partie-obligatoire)).
|
||||
> **Choix projet :** [decisions-projet.md](decisions-projet.md) → **Hardhat** + OpenZeppelin.
|
||||
|
||||
---
|
||||
|
||||
## 1. Le problème que résout une « toolchain »
|
||||
|
||||
Écrire un fichier `.sol` ne suffit pas. Il faut :
|
||||
|
||||
| Besoin | Sans outil | Avec toolchain |
|
||||
|--------|------------|----------------|
|
||||
| Traduire Solidity en bytecode | Impossible à la main | **Compilation** |
|
||||
| Vérifier que `transfer` marche | Deploy à chaque essai sur testnet (gas) | **Tests** locaux |
|
||||
| Envoyer le contrat sur BSC testnet | Tx manuelle complexe | **Scripts de déploiement** |
|
||||
| Reproduire le deploy pour l’éval | Oublis, « ça marche sur ma machine » | Scripts + config **versionnés** dans Git |
|
||||
|
||||
Le sujet cite explicitement : **IDE**, **Remix**, **Truffle** ou **Hardhat** — ce sont des **outils** pour compiler, tester et déployer, pas le standard BEP-20 lui-même.
|
||||
|
||||
---
|
||||
|
||||
## 2. C’est quoi Hardhat ?
|
||||
|
||||
**Hardhat** est un **environnement de développement** pour smart contracts sur chaînes **EVM** (Ethereum, BSC, etc.).
|
||||
|
||||
- Écrit en **JavaScript / TypeScript** (Node.js).
|
||||
- Projet typique : `hardhat.config.js`, dossier `contracts/`, `scripts/`, `test/`.
|
||||
- Commandes courantes :
|
||||
- `npx hardhat compile` — compile Solidity → artefacts dans `artifacts/`
|
||||
- `npx hardhat test` — lance les tests (souvent avec **ethers.js**)
|
||||
- `npx hardhat run scripts/deploy.js --network bscTestnet` — déploie sur le testnet
|
||||
- `npx hardhat node` — blockchain **locale** temporaire (0 tBNB réel, pour dev)
|
||||
|
||||
**Rôle dans Tokenizer :**
|
||||
|
||||
| Dossier sujet | Rôle Hardhat |
|
||||
|---------------|--------------|
|
||||
| **`code/`** | Sources `.sol`, config Hardhat, tests, `package.json` |
|
||||
| **`deployment/`** | Scripts / notes de deploy (souvent `scripts/deploy.js` appelé depuis `code/`, ou copie documentée — l’important est que l’évaluateur retrouve **comment** redéployer) |
|
||||
|
||||
Hardhat ne remplace pas **MetaMask** : MetaMask **signe** ; Hardhat utilise ta **clé privée** (via `.env`) pour envoyer la transaction de deploy depuis le terminal.
|
||||
|
||||
---
|
||||
|
||||
## 3. Les briques autour de Hardhat (vocabulaire)
|
||||
|
||||
| Terme | Rôle |
|
||||
|-------|------|
|
||||
| **Solidity** | Langage du contrat (FGC42Forge.sol) |
|
||||
| **OpenZeppelin** | Bibliothèque de contrats éprouvés (`ERC20`, `Ownable`) |
|
||||
| **ethers.js** | Bibliothèque JS pour parler à la chaîne (lire balances, envoyer txs) |
|
||||
| **RPC** | URL dans `hardhat.config` → même idée que MetaMask ([02-web3 § 3.9](02-web3-comprendre.md#39-réseau-rpc)) |
|
||||
| **@nomicfoundation/hardhat-toolbox** | Pack plugins (tests, verify, etc.) recommandé par Hardhat |
|
||||
| **artifacts/** | Sortie compilée (bytecode) — souvent **gitignoré**, régénéré par `compile` |
|
||||
| **BscScan verify** | Publier le code source sur l’explorer (étape deploy, hors Hardhat strict mais complémentaire) |
|
||||
|
||||
---
|
||||
|
||||
## 4. Alternatives citées par le sujet (et autres)
|
||||
|
||||
### Remix (IDE navigateur)
|
||||
|
||||
| | |
|
||||
|---|---|
|
||||
| **C’est quoi** | Site [remix.ethereum.org](https://remix.ethereum.org) : éditeur + compile + deploy **dans le navigateur**. |
|
||||
| **Pour** | Prototyper vite, premier contrat, démo visuelle, cours. |
|
||||
| **Contre** | Moins pratique pour un **dépôt 42** structuré (`code/`, tests, CI, scripts reproductibles). |
|
||||
| **Tokenizer** | Autorisé par le sujet ; beaucoup d’étudiants font un **premier test** sur Remix puis migrent vers Hardhat/Truffle pour le rendu. |
|
||||
|
||||
### Truffle
|
||||
|
||||
| | |
|
||||
|---|---|
|
||||
| **C’est quoi** | Framework Node.js **plus ancien** que Hardhat : Truffle Compile, Migrate, Ganache. |
|
||||
| **Pour** | Cycle complet migrations + tests ; encore vu en entreprise / anciens tutos. |
|
||||
| **Contre** | Écosystème moins « par défaut » qu’Hardhat aujourd’hui ; config parfois plus lourde. |
|
||||
| **Exemple 42** | [BdClement/Tokenizer](https://github.com/BdClement/Tokenizer) a choisi **Truffle** + Alchemy RPC — **valide** si README explique les choix. |
|
||||
|
||||
### Foundry (forge / cast)
|
||||
|
||||
| | |
|
||||
|---|---|
|
||||
| **C’est quoi** | Toolchain en **Rust** : `forge` (compile/test), `cast` (CLI), très rapide, tests souvent **en Solidity**. |
|
||||
| **Pour** | Perf, culture « smart contract pur », projets DeFi avancés. |
|
||||
| **Contre** | Courbe d’apprentissage différente (moins JS) ; moins cité dans le PDF Tokenizer. |
|
||||
| **Tokenizer** | Possible si BEP-20 + deploy testnet + doc — à **justifier** dans le README école. |
|
||||
|
||||
### Autres (hors PDF mais utiles à situer)
|
||||
|
||||
| Outil | Note |
|
||||
|-------|------|
|
||||
| **Ganache / `hardhat node`** | Blockchain locale pour tests |
|
||||
| **Brownie** | Python — plutôt écosystème Ethereum historique |
|
||||
| **Thirdweb, etc.** | Abstractions / SDK — le sujet demande de **comprendre** ce que tu déploies ; éviter le « tout no-code » en soutenance |
|
||||
|
||||
---
|
||||
|
||||
## 5. Tableau comparatif (révision soutenance)
|
||||
|
||||
| Critère | Hardhat | Remix | Truffle | Foundry |
|
||||
|---------|---------|-------|---------|---------|
|
||||
| Où ça tourne | Terminal + VS Code | Navigateur | Terminal | Terminal |
|
||||
| Langage orchestration | JS/TS | GUI | JS | Rust + Solidity tests |
|
||||
| Tests automatisés | ✅ (Mocha/Chai) | Limité | ✅ | ✅ (forge) |
|
||||
| Scripts deploy reproductibles | ✅ | Manuel | ✅ (migrations) | ✅ |
|
||||
| Cité sujet Tokenizer | ✅ | ✅ | ✅ | ❌ (mais EVM OK) |
|
||||
| Fit dossiers `code/` + `deployment/` | ✅ très bon | Moyen seul | ✅ bon | ✅ bon |
|
||||
|
||||
Le sujet **n’impose pas** Hardhat : il impose de **maîtriser un outil** et de livrer du **code commenté** + deploy documenté.
|
||||
|
||||
---
|
||||
|
||||
## 6. Pourquoi Hardhat pour *ton* parcours FGC ?
|
||||
|
||||
| Raison | Détail |
|
||||
|--------|--------|
|
||||
| Alignement doc 42 / tutoriels BEP-20 | Beaucoup d’exemples OpenZeppelin + Hardhat |
|
||||
| Un seul écosystème **Node** | `npm install`, proche d’autres stacks JS |
|
||||
| Tests avant testnet | Économise tes **0,1 tBNB** |
|
||||
| `hardhat.config.js` | Réseau **bscTestnet** chainId **97** = même logique que MetaMask |
|
||||
| Séparation claire | `contracts/` + `scripts/` → facile à expliquer en **code review** |
|
||||
|
||||
Tu pourrais dire en soutenance :
|
||||
|
||||
> « J’ai choisi **Hardhat** pour compiler et tester **FGC42Forge** en local, puis déployer sur **BSC Testnet** avec un script reproductible dans le dépôt, comme le sujet le prévoit pour la partie deployment. »
|
||||
|
||||
---
|
||||
|
||||
## 7. Flux mental : de Hardhat à la chaîne
|
||||
|
||||
```mermaid
|
||||
flowchart LR
|
||||
subgraph local [Machine dev]
|
||||
SOL[FGC42Forge.sol]
|
||||
HH[Hardhat compile / test]
|
||||
SCRIPT[script deploy.js]
|
||||
end
|
||||
subgraph chain [BSC Testnet 97]
|
||||
RPC[RPC URL]
|
||||
SC[Adresse contrat]
|
||||
end
|
||||
SOL --> HH
|
||||
HH --> SCRIPT
|
||||
SCRIPT -->|tx signée PRIVATE_KEY| RPC
|
||||
RPC --> SC
|
||||
SC --> BSCScan[testnet.bscscan.com]
|
||||
```
|
||||
|
||||
MetaMask reste utile pour **démos manuelles** (`transfer` FG42) ; Hardhat sert surtout au **deploy** et aux **tests**.
|
||||
|
||||
---
|
||||
|
||||
## 8. Liens
|
||||
|
||||
- **Index complet tutos & docs :** [ressources-solidity-hardhat.md](ressources-solidity-hardhat.md)
|
||||
- [Hardhat — Getting started](https://hardhat.org/hardhat-runner/docs/getting-started)
|
||||
- [OpenZeppelin Contracts](https://docs.openzeppelin.com/contracts/)
|
||||
- Étape suivante : [etape-02-init-hardhat.md](etapes/etape-02-init-hardhat.md)
|
||||
- [guide-realisation.md](guide-realisation.md)
|
||||
Reference in New Issue
Block a user