Cours Blockchain et Web3 · Module 7: Interaction avec les contrats

Interagir avec les Smart Contracts

2 min de lecture ·
Dans cette leçon7

Bienvenue au Centre de Communication ! Atlas à l'appareil. Aujourd'hui tu vas apprendre à communiquer avec des mécanismes automatisés (smart contracts) en utilisant ethers.js.

ABI - Le Manuel d'Utilisation du Mécanisme

L'ABI (Application Binary Interface) est le "manuel d'utilisation" d'un contrat - il décrit quelles fonctions sont disponibles :

const abi = [
  // View function (read-only)
  "function balanceOf(address owner) view returns (uint256)",

  // State-modifying function
  "function transfer(address to, uint256 amount) returns (bool)",

  // Event
  "event Transfer(address indexed from, address indexed to, uint256 amount)"
];

Créer une Instance de Contrat

import { ethers } from "ethers";

const provider = new ethers.JsonRpcProvider("https://...");
const contractAddress = "0x...";
const abi = [...];

// Read-only (avec provider)
const contract = new ethers.Contract(contractAddress, abi, provider);

// Read-write (avec signer)
const wallet = new ethers.Wallet(privateKey, provider);
const contractWithSigner = new ethers.Contract(contractAddress, abi, wallet);
// ou
const contractConnected = contract.connect(wallet);

Lire des Données (fonctions view)

// Appeler une fonction view - ne coûte pas de gas
const balance = await contract.balanceOf("0x...");
console.log("Balance:", ethers.formatUnits(balance, 18));

// Les fonctions view sont gratuites !
const name = await contract.name();
const symbol = await contract.symbol();
const totalSupply = await contract.totalSupply();

Écrire des Données (transactions)

// Appeler une fonction modifiant l'état - coûte du gas
const tx = await contractWithSigner.transfer(
  "0x...", // to
  ethers.parseUnits("100", 18) // amount
);

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

// Attendre la confirmation
const receipt = await tx.wait();
console.log("Confirmé dans le bloc :", receipt?.blockNumber);

Écouter les Events

// Écouter les nouveaux events
contract.on("Transfer", (from, to, amount, event) => {
  console.log(`Transfer: ${from} → ${to}: ${ethers.formatUnits(amount, 18)}`);
});

// Récupérer les events historiques
const filter = contract.filters.Transfer(null, "0x..."); // to = 0x...
const events = await contract.queryFilter(filter, -1000); // 1000 derniers blocs

events.forEach(event => {
  console.log("Transfer historique :", event.args);
});

Gestion des erreurs

try {
  const tx = await contract.transfer("0x...", amount);
  await tx.wait();
} catch (error) {
  if (error.code === "CALL_EXCEPTION") {
    console.log("Le contrat a renvoyé une erreur :", error.reason);
  } else if (error.code === "INSUFFICIENT_FUNDS") {
    console.log("Fonds insuffisants pour le gas");
  } else {
    console.log("Autre erreur :", error);
  }
}

Résumé

  • ABI - interface du contrat
  • Instance de contrat avec ethers.js
  • Fonctions view - lectures gratuites
  • Fonctions d'écriture - transactions (coûtent du gas)
  • Events - écoute et historique
  • Gestion des erreurs
Code de cette leçon : index.js
// ABI - Application Binary Interface

const ERC20_ABI = [
  // Fonctions de lecture (view/pure)
  {
    "type": "function",
    "name": "name",
    "inputs": [],
    "outputs": [{ "type": "string" }],
    "stateMutability": "view"
  },
  {
    "type": "function",
    "name": "symbol",
    "inputs": [],
    "outputs": [{ "type": "string" }],
    "stateMutability": "view"
  },
  {
    "type": "function",
    "name": "decimals",
    "inputs": [],
    "outputs": [{ "type": "uint8" }],
    "stateMutability": "view"
  },
  {
    "type": "function",
    "name": "totalSupply",
    "inputs": [],
    "outputs": [{ "type": "uint256" }],
    "stateMutability": "view"
  },
  {
    "type": "function",
    "name": "balanceOf",
    "inputs": [{ "name": "account", "type": "address" }],
    "outputs": [{ "type": "uint256" }],
    "stateMutability": "view"
  },

  // Fonctions d'écriture
  {
    "type": "function",
    "name": "transfer",
    "inputs": [
      { "name": "to", "type": "address" },
      { "name": "amount", "type": "uint256" }
    ],
    "outputs": [{ "type": "bool" }],
    "stateMutability": "nonpayable"
  },
  {
    "type": "function",
    "name": "approve",
    "inputs": [
      { "name": "spender", "type": "address" },
      { "name": "amount", "type": "uint256" }
    ],
    "outputs": [{ "type": "bool" }],
    "stateMutability": "nonpayable"
  },

  // Events
  {
    "type": "event",
    "name": "Transfer",
    "inputs": [
      { "name": "from", "type": "address", "indexed": true },
      { "name": "to", "type": "address", "indexed": true },
      { "name": "value", "type": "uint256", "indexed": false }
    ]
  }
];

console.log("=== ABI - APPLICATION BINARY INTERFACE ===\n");

console.log("L'ABI est un JSON qui décrit comment communiquer avec un contrat :");
console.log("  - Quelles fonctions sont disponibles");
console.log("  - Quels paramètres elles acceptent");
console.log("  - Ce qu'elles retournent");
console.log("  - Quels events elles émettent\n");

console.log("=== STRUCTURE D'UNE FONCTION DANS L'ABI ===\n");

const transferFn = ERC20_ABI.find(item => item.name === "transfer");
console.log("Fonction Transfer :");
console.log(JSON.stringify(transferFn, null, 2));

console.log("\n=== FUNCTION SELECTOR ===\n");

// Simulation du calcul du selector
function getFunctionSelector(signature) {
  // En réalité : keccak256(signature).slice(0,4)
  const hash = signature.split('').reduce((h, c) =>
    ((h << 5) - h) + c.charCodeAt(0), 0);
  return "0x" + Math.abs(hash).toString(16).slice(0, 8);
}

console.log("Signature de fonction -> selector 4 octets :");
console.log(`  transfer(address,uint256) -> ${getFunctionSelector("transfer(address,uint256)")}`);
console.log(`  approve(address,uint256) -> ${getFunctionSelector("approve(address,uint256)")}`);
console.log(`  balanceOf(address) -> ${getFunctionSelector("balanceOf(address)")}`);

console.log("\nL'ABI est généré automatiquement lors de la compilation de Solidity");

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. L'ABI (Application Binary Interface) est :

  2. 2. Pour créer une instance de contrat dans ethers.js, tu as besoin de :

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

Tâches pratiques dans le jeu

  • Tri vertical

    Ordonne les étapes du parsing d'un event depuis un transaction receipt :

  • Tri vertical

    Ordonne les étapes de gestion d'une custom error du contrat :

  • Tri vertical

    Ordonne les étapes d'optimisation du gas avant l'envoi d'une transaction :

  • Tri vertical

    Ordonne les étapes de récupération des events historiques :

  • Éditeur de code

    Complète le code de lecture du solde d'un token

  • Éditeur de code

    Complète le code de transfert de tokens

  • Éditeur de code

    Complète le listener de l'event Transfer

  • Éditeur de code

    Complète le code de parsing des events depuis le receipt

  • Tri horizontal

    Ordonne la signature correcte de la fonction transfer :

  • Tri horizontal

    Ordonne la signature correcte de l'event Transfer :

  • Tri horizontal

    Ordonne l'appel de fonction avec un gas limit personnalisé :

  • Tri horizontal

    Ordonne l'appel d'encodage des données d'une fonction :

  • Éditeur de code

    Complète le code queryFilter pour les events historiques

  • Éditeur de code

    Complète le code d'estimate gas

  • Éditeur de code

    Complète le code de gestion d'une custom error

  • Éditeur de code

    Complète le code d'ABI encoding

  • Clique dans l'ordre

    Clique sur les éléments dans l'ordre de création d'une Interface :

  • Clique dans l'ordre

    Clique sur les éléments dans l'ordre de création d'une instance de contrat :

  • Clique dans l'ordre

    Clique sur les éléments dans l'ordre de création d'un filtre d'events :

  • Clique dans l'ordre

    Clique sur les éléments dans l'ordre du parsing d'un log :

  • Tri vertical

    Ordonne les étapes de préparation d'un multicall :

  • Tri horizontal

    Ordonne le fragment ABI de la fonction balanceOf :

  • Éditeur de code

    Complète le code du multicall

  • Éditeur de code

    Complète le code de décodage des résultats

  • Clique dans l'ordre

    Clique sur les éléments dans l'ordre du décodage d'une custom error :

  1. QuestionQuiz : ABI
  2. QuestionQuiz : Contract instance
  3. QuestionQuiz : View functions
  4. QuestionQuiz : Write functions
  5. QuestionQuiz : contract.connect()
  6. QuestionQuiz : Events
  7. QuestionQuiz : contract.on()
  8. QuestionQuiz : queryFilter
  9. QuestionQuiz : Function selector
  10. QuestionQuiz : Event topics
  11. QuestionQuiz : Interface
  12. QuestionQuiz : contract.interface.parseLog()
  13. QuestionQuiz : estimateGas
  14. QuestionQuiz : Custom errors
  15. Remets dans l'ordreTri : Parser un event depuis le receipt
  16. Remets dans l'ordreTri : Gérer une erreur du contrat
  17. Remets dans l'ordreTri : Gas estimation avant la transaction
  18. Remets dans l'ordreTri : Filtrer les events de l'historique
  19. Exercice de codeGap : Lecture depuis le contrat
  20. Exercice de codeGap : Envoyer une transaction au contrat
  21. Exercice de codeGap : Écouter les events
  22. Exercice de codeGap : Parser les logs du receipt
  23. Remets dans l'ordreTri horizontal : Signature de fonction
  24. Remets dans l'ordreTri horizontal : Event signature
  25. Remets dans l'ordreTri horizontal : Appel avec overrides
  26. Remets dans l'ordreTri horizontal : Interface encoding
  27. Exercice de codeGap : QueryFilter - récupérer l'historique
  28. Exercice de codeGap : Gas estimation
  29. Exercice de codeGap : Custom error handling
  30. Exercice de codeGap : ABI encoding parameters
  31. Clique dans l'ordreTri : Construire une interface
  32. Clique dans l'ordreTri : Construire une contract instance
  33. Clique dans l'ordreTri : Construire un event filter
  34. Clique dans l'ordreTri : Parser un log
  35. Remets dans l'ordreTri : Multicall preparation
  36. Remets dans l'ordreTri horizontal : Fragment ABI d'une fonction
  37. Exercice de codeGap : Multicall pattern
  38. Exercice de codeGap : Décoder les return values
  39. Clique dans l'ordreTri : Décoder une erreur
  40. Projet à envoyerEnvoie ton projet au mentor
  41. DialogueFin du module 7