Cours Blockchain et Web3 · Module 4: ethers.js & viem
Ethers.js - Ton marteau dans la Forge à Outils
Dans cette leçon5
Bienvenue à la Forge à Outils ! Atlas ici. Aujourd'hui nous allons forger ton premier marteau - ethers.js - la bibliothèque la plus puissante pour interagir avec Ethereum.
Qu'est-ce qu'Ethers.js ?
Ethers.js est une bibliothèque JavaScript/TypeScript pour interagir avec la blockchain Ethereum. C'est comme une clé universelle pour tous les tunnels et chambres de la Crypte.
┌─────────────────────────────────────────────────────────────────┐
│ ARCHITECTURE D'ETHERS.JS │
├─────────────────────────────────────────────────────────────────┤
│ │
│ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │
│ │ Ton │────▶│ Provider │────▶│ Réseau │ │
│ │ Application │ │ (Portail) │ │ Ethereum │ │
│ └─────────────┘ └─────────────┘ └─────────────┘ │
│ │ │
│ │ ┌─────────────┐ │
│ └───────────▶│ Signer │ (signature des TX) │
│ │ (Guerrier) │ │
│ └─────────────┘ │
│ │ │
│ ▼ │
│ ┌─────────────┐ │
│ │ Wallet │ (Signer + Provider) │
│ │ (Coffre) │ │
│ └─────────────┘ │
│ │
└─────────────────────────────────────────────────────────────────┘Installation
# npm
npm install ethers
# yarn
yarn add ethers
# pnpm
pnpm add ethersConcepts fondamentaux
1. Provider - Passerelle vers le réseau
Un Provider est une connexion au réseau Ethereum (lecture seule) :
import { ethers } from "ethers";
// Connexion via un RPC public
const provider = new ethers.JsonRpcProvider("https://eth-mainnet.g.alchemy.com/v2/YOUR-API-KEY");
// Infura
const infuraProvider = new ethers.InfuraProvider("mainnet", "YOUR-API-KEY");
// Alchemy
const alchemyProvider = new ethers.AlchemyProvider("mainnet", "YOUR-API-KEY");
// Pour le testnet Sepolia
const sepoliaProvider = new ethers.JsonRpcProvider("https://eth-sepolia.g.alchemy.com/v2/YOUR-API-KEY");2. Signer - Guerrier avec un sceau
Un Signer peut signer des transactions :
// Signer avec une clé privée
const privateKey = "0x...";
const signer = new ethers.Wallet(privateKey, provider);
// Adresse du Signer
console.log("Address:", signer.address);3. Wallet - Coffre (Signer + Provider)
Un Wallet est une combinaison de Signer + Provider :
// Création d'un nouveau wallet
const newWallet = ethers.Wallet.createRandom();
console.log("Address:", newWallet.address);
console.log("Private Key:", newWallet.privateKey);
console.log("Mnemonic:", newWallet.mnemonic.phrase);
// Import depuis une clé privée
const wallet = new ethers.Wallet(privateKey, provider);
// Import depuis une phrase mnémonique
const walletFromMnemonic = ethers.Wallet.fromPhrase("word1 word2 word3...", provider);Opérations de base
Vérifier le solde :
const balance = await provider.getBalance("0x742d35Cc6634C0532925a3b844Bc9e7595f8fE8c");
console.log("Balance:", ethers.formatEther(balance), "ETH");Récupérer les informations d'un bloc :
const blockNumber = await provider.getBlockNumber();
const block = await provider.getBlock(blockNumber);
console.log("Block:", block);Envoyer de l'ETH :
const tx = await wallet.sendTransaction({
to: "0x...",
value: ethers.parseEther("0.1")
});
await tx.wait();
console.log("TX Hash:", tx.hash);Résumé
- Ethers.js - la bibliothèque Web3 principale
- Provider - connexion au réseau (lecture seule)
- Signer - signature des transactions
- Wallet - Provider + Signer
- Opérations de base : solde, bloc, envoi
Code de cette leçon : index.js
// ethers.js - les bases
// Dans un vrai projet : import { ethers } from "ethers";
// Simulation d'ethers.js
const ethers = {
// Formatage
formatEther: (wei) => (Number(wei) / 1e18).toString(),
parseEther: (eth) => BigInt(Math.floor(Number(eth) * 1e18)),
formatUnits: (value, decimals) => (Number(value) / Math.pow(10, decimals)).toString(),
parseUnits: (value, decimals) => BigInt(Math.floor(Number(value) * Math.pow(10, decimals))),
// Adresses
isAddress: (address) => /^0x[a-fA-F0-9]{40}$/.test(address),
getAddress: (address) => {
if (!ethers.isAddress(address)) throw new Error("Adresse invalide");
return address.toLowerCase();
},
// Utilitaires
id: (text) => "0x" + Array.from(text).reduce((h, c) =>
((h << 5) - h + c.charCodeAt(0)) & 0xffffffff, 0
).toString(16).padStart(64, '0'),
keccak256: (data) => ethers.id(data)
};
console.log("=== LES BASES D'ETHERS.JS ===\n");
// Formatage
console.log("Formatage :");
const weiAmount = "1500000000000000000"; // 1.5 ETH
console.log(` Wei: ${weiAmount}`);
console.log(` ETH: ${ethers.formatEther(weiAmount)}`);
const ethAmount = "2.5";
console.log(`\n ETH: ${ethAmount}`);
console.log(` Wei: ${ethers.parseEther(ethAmount).toString()}`);
// Tokens (l'USDC a 6 décimales)
console.log("\nTokens (USDC, 6 décimales) :");
const usdcAmount = "1000000"; // 1 USDC
console.log(` Brut: ${usdcAmount}`);
console.log(` Formaté: ${ethers.formatUnits(usdcAmount, 6)} USDC`);
// Adresses
console.log("\nAdresses :");
const addr = "0x742d35Cc6634C0532925a3b844Bc9e7595f1dE3a";
console.log(` Adresse: ${addr}`);
console.log(` isAddress: ${ethers.isAddress(addr)}`);
console.log(` Checksummée: ${ethers.getAddress(addr)}`);
// Keccak256
console.log("\nKeccak256 :");
console.log(` keccak256("hello"): ${ethers.keccak256("hello")}`);
Tu as repéré une erreur dans cette leçon ?
Teste tes connaissances
Réponds aux questions de cette leçon. Choisis une réponse pour voir tout de suite si elle est correcte.
1. Quelle commande installe correctement ethers.js dans un projet ?
2. Quel est le rôle principal du Provider dans ethers.js ?
Voici 2 des 18 questions de cette leçon. Réponds aux autres dans le jeu.
Tâches pratiques dans le jeu
- Tri vertical
Ordonne les étapes de création d'une connexion au réseau Ethereum avec ethers.js :
- Éditeur de code
Implémente la connexion au réseau via Infura ou Alchemy
- Clique dans l'ordre
Ordonne l'import correct de la bibliothèque ethers.js
- Tri horizontal
Ordonne correctement la création de JsonRpcProvider :
- Éditeur de code
Implémente une fonction qui lit le solde d'un compte
- Éditeur de code
Crée un Wallet et connecte-le au réseau
- Tri vertical
Ordonne les unités Ethereum de la plus petite à la plus grande :
- Éditeur de code
Implémente les conversions d'unités
- Clique dans l'ordre
Ordonne l'appel correct de parseEther pour 1 ETH
- Tri vertical
Ordonne les étapes d'envoi d'une transaction ETH :
- Éditeur de code
Implémente l'envoi d'ETH
- Tri horizontal
Ordonne les éléments nécessaires à la création d'une instance de contrat :
- Éditeur de code
Implémente la lecture du solde d'un token
- Éditeur de code
Implémente le transfert de tokens ERC20
- Clique dans l'ordre
Ordonne l'écoute correcte de l'événement Transfer
- Éditeur de code
Implémente un listener pour l'événement Transfer
- Tri vertical
Ordonne les étapes pour interroger des événements passés :
- Éditeur de code
Implémente createPublicClient
- Tri horizontal
Que faut-il pour créer un Wallet Client dans viem ?
- Éditeur de code
Implémente getBalance dans viem
- Tri vertical
Ordonne la structure de gestion des erreurs dans une transaction :
- Clique dans l'ordre
Ordonne la condition qui vérifie l'erreur de fonds insuffisants
- Tri horizontal
Ordonne la fonction de validation d'une adresse Ethereum :
Exercices après cette leçon
- QuestionInstallation d'ethers.js
- QuestionLe rôle du Provider dans ethers.js
- QuestionJsonRpcProvider
- QuestionDifférence entre Provider et Signer
- Remets dans l'ordreCréer un Provider
- Exercice de codeProvider de base
- Clique dans l'ordreImporter ethers.js
- Remets dans l'ordreSyntaxe de JsonRpcProvider
- Exercice de codeLecture du solde
- QuestionMéthodes du Provider
- QuestionCréer un Wallet
- Exercice de codeWallet avec Private Key
- Remets dans l'ordreConversion des unités ETH
- QuestionparseEther
- Exercice de codeConversion des unités
- Clique dans l'ordreSyntaxe de parseEther
- QuestionEnvoyer une transaction
- Remets dans l'ordreStructure d'une transaction
- Exercice de codeEnvoyer de l'ETH
- QuestionQu'est-ce que l'ABI ?
- Remets dans l'ordreCréer une instance de Contract
- Exercice de codeLecture depuis un contrat
- QuestionFonctions Read vs Write
- Exercice de codeÉcriture dans un contrat
- QuestionÉcouter les événements
- Clique dans l'ordreSyntaxe de l'écoute
- Exercice de codeEvent listener
- Remets dans l'ordreInterroger des événements historiques
- QuestionIntroduction à viem
- QuestionClient dans viem
- Exercice de codeCréer un Public Client
- Remets dans l'ordreWallet Client dans viem
- Exercice de codeLecture du solde dans viem
- QuestionGestion des erreurs
- Remets dans l'ordreTry-catch dans les transactions
- Clique dans l'ordreTypes d'erreurs
- QuestionComparaison des bibliothèques
- QuestionestimateGas
- Remets dans l'ordreValidation des adresses
- QuestionSignature de messages
- Projet à envoyerProjet final
- QuestionBonnes pratiques
- DialogueFin du Laboratoire