Cours Blockchain et Web3 · Module 5: Portefeuilles & Transactions

Portefeuilles - Ton coffre dans la Crypte

2 min de lecture ·
Dans cette leçon6

Bienvenue au Coffre-fort des Coffres ! Atlas ici. Aujourd'hui, tu vas apprendre à créer et gérer des portefeuilles - tes coffres personnels dans la cité souterraine.

Créer un portefeuille par programmation

import { ethers } from "ethers";

// 1. Portefeuille tout neuf
const newWallet = ethers.Wallet.createRandom();
console.log("Address:", newWallet.address);
console.log("Private Key:", newWallet.privateKey);
console.log("Mnemonic:", newWallet.mnemonic?.phrase);

// 2. Import depuis une clé privée
const privateKey = "0x...";
const walletFromKey = new ethers.Wallet(privateKey);

// 3. Import depuis une phrase de récupération (seed phrase)
const mnemonic = "witch collapse practice feed shame open despair creek road again ice least";
const walletFromMnemonic = ethers.Wallet.fromPhrase(mnemonic);

// 4. Connexion à un provider
const provider = new ethers.JsonRpcProvider("https://...");
const connectedWallet = newWallet.connect(provider);

HD Wallet - Plusieurs adresses depuis une seule phrase

// Créer un HD Wallet
const mnemonic = ethers.Mnemonic.fromPhrase("witch collapse practice...");
const hdNode = ethers.HDNodeWallet.fromMnemonic(mnemonic);

// Dérivation d'adresses (chemin BIP-44 : m/44'/60'/0'/0/index)
const wallet0 = hdNode.derivePath("m/44'/60'/0'/0/0");
const wallet1 = hdNode.derivePath("m/44'/60'/0'/0/1");
const wallet2 = hdNode.derivePath("m/44'/60'/0'/0/2");

console.log("Address 0:", wallet0.address);
console.log("Address 1:", wallet1.address);
console.log("Address 2:", wallet2.address);

Vérifier le solde

const provider = new ethers.JsonRpcProvider("https://...");
const address = "0x742d35Cc6634C0532925a3b844Bc9e7595f8fE8c";

// Solde en wei
const balanceWei = await provider.getBalance(address);
console.log("Balance (wei):", balanceWei.toString());

// Solde en ETH
const balanceEth = ethers.formatEther(balanceWei);
console.log("Balance (ETH):", balanceEth);

// Conversions d'unités
const oneEth = ethers.parseEther("1.0");      // 1 ETH → wei
const oneGwei = ethers.parseUnits("1", "gwei"); // 1 gwei → wei

Envoyer des transactions

const wallet = new ethers.Wallet(privateKey, provider);

// Transaction ETH simple
const tx = await wallet.sendTransaction({
  to: "0x...",
  value: ethers.parseEther("0.1"),
  // Optionnel :
  gasLimit: 21000,
  maxFeePerGas: ethers.parseUnits("30", "gwei"),
  maxPriorityFeePerGas: ethers.parseUnits("2", "gwei"),
});

console.log("TX Hash:", tx.hash);

// Attendre la confirmation
const receipt = await tx.wait();
console.log("Confirmed in block:", receipt?.blockNumber);

Nonce - Ordre des transactions

// Obtenir le nonce actuel
const nonce = await provider.getTransactionCount(wallet.address);
console.log("Current nonce:", nonce);

// Tu peux définir le nonce manuellement
const tx = await wallet.sendTransaction({
  to: "0x...",
  value: ethers.parseEther("0.1"),
  nonce: nonce, // définition manuelle
});

Résumé

  • Créer des portefeuilles par programmation
  • Import depuis une clé privée et une seed phrase
  • HD Wallets - plusieurs adresses
  • Vérifier le solde
  • Envoyer de l'ETH
  • Nonce et ordonnancement des transactions
Code de cette leçon : index.js
// Détection et connexion de MetaMask
// Simulation de window.ethereum

const mockEthereum = {
  isMetaMask: true,
  selectedAddress: null,
  chainId: "0x1",

  async request({ method, params }) {
    switch (method) {
      case "eth_requestAccounts":
        this.selectedAddress = "0x742d35Cc6634C0532925a3b844Bc9e7595f1dE3a";
        return [this.selectedAddress];

      case "eth_accounts":
        return this.selectedAddress ? [this.selectedAddress] : [];

      case "eth_chainId":
        return this.chainId;

      case "wallet_switchEthereumChain":
        this.chainId = params[0].chainId;
        return null;

      default:
        throw new Error(`Method ${method} not supported`);
    }
  },

  on(event, callback) {
    console.log(`Listener enregistré : ${event}`);
  }
};

// Simulation du window.ethereum global
const ethereum = mockEthereum;

async function connectWallet() {
  console.log("=== CONNEXION METAMASK ===\n");

  // 1. Vérifier si MetaMask est installé
  if (!ethereum || !ethereum.isMetaMask) {
    console.log("MetaMask n'est pas installé !");
    console.log("   Télécharge depuis : https://metamask.io");
    return;
  }

  console.log("MetaMask détecté !");

  // 2. Se connecter (demander les comptes)
  try {
    console.log("\nConnexion à MetaMask...");
    const accounts = await ethereum.request({
      method: "eth_requestAccounts"
    });

    console.log("Connecté !");
    console.log("   Adresse :", accounts[0]);

    // 3. Obtenir le chain ID
    const chainId = await ethereum.request({ method: "eth_chainId" });
    console.log("   Chain ID :", parseInt(chainId, 16));

  } catch (error) {
    if (error.code === 4001) {
      console.log("L'utilisateur a rejeté la connexion");
    } else {
      console.log("Erreur :", error.message);
    }
  }
}

connectWallet();

// Écouteurs d'événements
ethereum.on("accountsChanged", (accounts) => {
  console.log("Comptes modifiés :", accounts);
});

ethereum.on("chainChanged", (chainId) => {
  console.log("Réseau modifié :", chainId);
  // Rechargement recommandé
});

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. 1. Quel type de portefeuille est le plus sûr pour le stockage à long terme de grosses sommes de cryptomonnaies ?

  2. 2. Qu'est-ce qui distingue un 'hot wallet' d'un 'cold wallet' ?

Voici 2 des 17 questions de cette leçon. Réponds aux autres dans le jeu.

Tâches pratiques dans le jeu

  • Tri vertical

    Classe les types de portefeuilles du plus sûr au moins sûr :

  • Tri vertical

    Classe les étapes d'installation et de configuration de MetaMask :

  • Éditeur de code

    Implémente une fonction qui se connecte à MetaMask et renvoie l'adresse de l'utilisateur :

  • Tri horizontal

    Assemble l'appel correct de la méthode eth_requestAccounts :

  • Éditeur de code

    Implémente une fonction qui vérifie la disponibilité de MetaMask :

  • Tri vertical

    Classe les étapes du cycle de vie d'une transaction blockchain :

  • Clique dans l'ordre

    Clique sur les boutons dans le bon ordre pour créer le paramètre 'to' dans une transaction :

  • Tri horizontal

    Assemble les paramètres de base de l'objet transaction :

  • Éditeur de code

    Implémente une fonction qui envoie 0.1 ETH à l'adresse indiquée :

  • Éditeur de code

    Implémente la conversion d'ETH en Wei en utilisant ethers.js :

  • Clique dans l'ordre

    Clique sur les boutons dans le bon ordre pour créer le paramètre value avec la valeur 0.1 ETH :

  • Éditeur de code

    Implémente une fonction qui signe un message texte :

  • Tri horizontal

    Assemble les paramètres de la méthode personal_sign dans le bon ordre :

  • Éditeur de code

    Implémente une fonction qui vérifie si la signature a été effectuée par le propriétaire de l'adresse :

  • Clique dans l'ordre

    Clique sur les boutons dans le bon ordre décrivant le processus de WalletConnect :

  • Tri vertical

    Classe les étapes du changement de réseau dans MetaMask par programmation :

  • Éditeur de code

    Implémente une fonction qui bascule vers le réseau Polygon :

  • Tri horizontal

    Assemble les paramètres requis pour ajouter un nouveau réseau :

  • Éditeur de code

    Implémente une fonction qui récupère les dernières transactions pour une adresse :

  • Éditeur de code

    Implémente une fonction qui attend la confirmation d'une transaction :

  • Clique dans l'ordre

    Clique sur les boutons présentant les règles de sécurité les plus importantes du portefeuille :

  • Tri vertical

    Classe les étapes de protection contre le phishing :

  • Éditeur de code

    Implémente un listener qui réagit au changement du compte actif :

  • Tri horizontal

    Assemble l'appel d'écoute du changement de réseau :

  1. QuestionTypes de portefeuilles
  2. QuestionHot wallet vs Cold wallet
  3. Remets dans l'ordreOrdre des types de portefeuilles selon la sécurité
  4. Remets dans l'ordreInstallation de MetaMask
  5. Exercice de codeConnexion du portefeuille à une dApp
  6. QuestionAPI MetaMask
  7. Remets dans l'ordreStructure de l'appel eth_requestAccounts
  8. Exercice de codeVérification de la connexion du portefeuille
  9. Remets dans l'ordreCycle de vie d'une transaction
  10. QuestionParamètres d'une transaction
  11. Clique dans l'ordreClique sur les paramètres de la transaction
  12. Remets dans l'ordreConstruction de l'objet transaction
  13. Exercice de codeEnvoi d'une transaction ETH
  14. QuestionLe champ 'data' dans une transaction
  15. Exercice de codeConversion des valeurs ETH
  16. QuestionUnités de valeur
  17. Clique dans l'ordreClique sur le paramètre value
  18. QuestionSignature de messages
  19. Exercice de codeSignature de messages - personal_sign
  20. Remets dans l'ordreStructure de l'appel personal_sign
  21. Exercice de codeVérification d'une signature
  22. QuestionWalletConnect
  23. Clique dans l'ordreClique sur les étapes de WalletConnect
  24. Remets dans l'ordreChangement de réseau
  25. Exercice de codeChangement de réseau blockchain
  26. QuestionChain ID
  27. Remets dans l'ordreAjout d'un réseau personnalisé
  28. Exercice de codeRécupération de l'historique des transactions
  29. QuestionStatut d'une transaction
  30. Exercice de codeVérification du statut d'une transaction
  31. QuestionNombre de confirmations
  32. QuestionSeed phrase (phrase de récupération)
  33. Clique dans l'ordreClique sur les règles de sécurité
  34. Remets dans l'ordreAttaques de phishing
  35. QuestionReconnaître le phishing
  36. Exercice de codeSurveillance des événements du portefeuille
  37. QuestionÉvénements MetaMask
  38. Remets dans l'ordreStructure du handler chainChanged
  39. QuestionValidation d'une adresse Ethereum
  40. QuestionPortefeuille multisig
  41. Projet à envoyerProjet : Système de gestion de portefeuille
  42. QuestionENS (Ethereum Name Service)
  43. DialogueRésumé du module