Quels sont les événements d'un contrat intelligent Solidity et comment les utiliser?

Les événements de Solidity permettent aux DAPP de suivre et de répondre efficacement aux activités sur la chaîne comme les transferts de jetons, la ponte NFT et l'analyse en temps réel.

Jul 10, 2025 at 02:14 pm

Comprendre les événements dans Solidity Smart Contracts

Dans le domaine des contrats intelligents de Solidity , les événements servent de mécanisme crucial pour la communication entre la blockchain et les applications externes. Les événements sont essentiellement des journaux stockés sur la machine virtuelle Ethereum (EVM) et sont accessibles par des entités externes telles que les applications frontales ou les services hors chaîne. Ils permettent aux développeurs de surveiller l'activité contractuelle sans avoir à interroger constamment la blockchain pour les changements.

Un événement est déclaré dans un contrat en utilisant le mot-clé de event suivi d'un nom et des paramètres. Ces paramètres peuvent être indexés ou non indexés, ce qui affecte la façon dont ils peuvent être interrogés plus tard. Les paramètres indexés agissent comme des filtres lors de la récupération des journaux, ce qui les rend plus efficaces pour rechercher dans de grands ensembles de données.

---

Déclarer les événements de Solidity

Pour déclarer un événement dans un contrat intelligent Solidity, vous le définissez de manière similaire à une fonction mais avec le mot-clé event . Voici un exemple de base:

 pragma solidity ^0.8.0; Contracter MyContract {



event Transfer(address indexed from, address indexed to, uint amount); function sendTokens(address recipient, uint amount) public { // logic to transfer tokens emit Transfer(msg.sender, recipient, amount); }
 }

Dans ce cas, l'événement Transfer a trois paramètres: deux adresses ( from et to ) et un uint représentant le montant. Le mot-clé indexed permet à ces champs d'être consultables dans les journaux.

Les paramètres indexés doivent être utilisés stratégiquement car il y a une limite allant jusqu'à trois paramètres indexés par événement. Les paramètres non indexés sont toujours enregistrés mais ne peuvent pas être filtrés directement via l'interface de requête logarithmique.

---

Émettre des événements pendant l'exécution

Une fois un événement déclaré, il doit être déclenché lors de l'exécution d'une fonction à l'aide du mot-clé emit suivi du nom de l'événement et de ses arguments.

Voici comment les émissions fonctionnent dans la pratique:

• Lorsque la fonction sendTokens est appelée, il exécute une logique interne.
• Après le traitement de la transaction, il appelle emit Transfer(...) , qui enregistre les données de l'événement sur la blockchain.

Cet événement émis peut ensuite être capturé par des outils comme Web3.js ou Ethers.js dans des applications décentralisées (DAPP).

L'instruction emit doit toujours être placée à la fin d'une fonction si elle dépend du résultat de la logique de fonction. Cela garantit que l'événement ne tire qu'après que tous les changements d'État ont été appliqués avec succès.

---

Écoute d'événements à l'aide de bibliothèques Web3

Après avoir déployé un contrat avec des événements, l'étape suivante consiste à mettre en place des auditeurs pour capturer ces événements en temps réel. Voici comment le faire à l'aide de Web3.js :

1. Tout d'abord, assurez-vous d'avoir accès au contrat ABI et à l'adresse.
2. Créez une instance de contrat à l'aide de web3.eth.Contract(abi, address) .
3. Utilisez la méthode .events.EventName() pour commencer à écouter.

Exemple:

 const contract = new web3.eth.Contract(abi, contractAddress); contrat.events.transfer ({



fromBlock: 0
 }, fonction (erreur, événement) {
 
console.log(event);
 })
 .on ('data', fonction (événement) {
 
console.log('Event detected:', event.returnValues);
 })
 .on ('error', console.error);

Assurez-vous de gérer correctement les erreurs et de filtrer les événements en fonction de vos besoins d'application à l'aide d'options telles que filter ou topics .

---

Cas d'utilisation pratiques pour les événements

Les événements ne sont pas seulement pour l'exploitation forestière - ils alimentent plusieurs fonctionnalités critiques dans les DAPP:

• Suivi des actions des utilisateurs : comme les transferts de jetons, la ponte NFT ou les résultats de vote.
• Synchronisation des systèmes backend : les services hors chaîne peuvent réagir instantanément aux événements sur chaîne.
• Audit et analyse : les événements fournissent un moyen structuré d'analyser le comportement contractuel au fil du temps.

Par exemple, un échange décentralisé pourrait émettre un événement chaque fois qu'un commerce se produit. Un tableau de bord Analytics pourrait écouter ces événements et mettre à jour les graphiques en temps réel.

Les événements sont également utiles pour déboguer les contrats intelligents pendant le développement en fournissant un aperçu du flux d'exécution et des changements d'état.

---

FAQ sur les événements de solidité

Q: Puis-je modifier un événement après le déploiement?

Non, une fois un contrat déployé, ses définitions d'événements sont fixes. Toute modification nécessite le redéploiement du contrat.

Q: Combien de gaz consomment les événements?

Les événements sont relativement peu coûteux par rapport aux opérations de stockage, mais elles coûtent toujours du gaz. Chaque journal des événements augmente l'utilisation du gaz de la transaction en fonction du nombre et de la taille des paramètres.

Q: Les événements sont-ils accessibles sur différentes blockchains?

Les événements sont spécifiques à la chaîne où le contrat a été déployé. Les interactions transversales auraient besoin d'infrastructures supplémentaires comme des ponts ou des relais.

Q: Les événements persistent-ils pour toujours sur la blockchain?

Oui, les événements font partie de l'histoire de la blockchain et restent accessibles tant que la chaîne existe. Cependant, l'accès aux journaux historiques peut nécessiter des nœuds d'archives ou des API tiers.