Cours Blockchain et Web3 · Module 7: Interaction avec les contrats
Interagir avec les Smart Contracts
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. L'ABI (Application Binary Interface) est :
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 :
Exercices après cette leçon
- QuestionQuiz : ABI
- QuestionQuiz : Contract instance
- QuestionQuiz : View functions
- QuestionQuiz : Write functions
- QuestionQuiz : contract.connect()
- QuestionQuiz : Events
- QuestionQuiz : contract.on()
- QuestionQuiz : queryFilter
- QuestionQuiz : Function selector
- QuestionQuiz : Event topics
- QuestionQuiz : Interface
- QuestionQuiz : contract.interface.parseLog()
- QuestionQuiz : estimateGas
- QuestionQuiz : Custom errors
- Remets dans l'ordreTri : Parser un event depuis le receipt
- Remets dans l'ordreTri : Gérer une erreur du contrat
- Remets dans l'ordreTri : Gas estimation avant la transaction
- Remets dans l'ordreTri : Filtrer les events de l'historique
- Exercice de codeGap : Lecture depuis le contrat
- Exercice de codeGap : Envoyer une transaction au contrat
- Exercice de codeGap : Écouter les events
- Exercice de codeGap : Parser les logs du receipt
- Remets dans l'ordreTri horizontal : Signature de fonction
- Remets dans l'ordreTri horizontal : Event signature
- Remets dans l'ordreTri horizontal : Appel avec overrides
- Remets dans l'ordreTri horizontal : Interface encoding
- Exercice de codeGap : QueryFilter - récupérer l'historique
- Exercice de codeGap : Gas estimation
- Exercice de codeGap : Custom error handling
- Exercice de codeGap : ABI encoding parameters
- Clique dans l'ordreTri : Construire une interface
- Clique dans l'ordreTri : Construire une contract instance
- Clique dans l'ordreTri : Construire un event filter
- Clique dans l'ordreTri : Parser un log
- Remets dans l'ordreTri : Multicall preparation
- Remets dans l'ordreTri horizontal : Fragment ABI d'une fonction
- Exercice de codeGap : Multicall pattern
- Exercice de codeGap : Décoder les return values
- Clique dans l'ordreTri : Décoder une erreur
- Projet à envoyerEnvoie ton projet au mentor
- DialogueFin du module 7